InterruptDetach(), InterruptDetach_r()

Detach an interrupt handler by ID

Synopsis:

#include <sys/neutrino.h>

int InterruptDetach( int id );

int InterruptDetach_r( int id );

Library:

libc

Description:

The InterruptDetach() and InterruptDetach_r() functions are identical except in the way they indicate errors. See the Returns section for details.

These kernel calls detach the interrupt handler specified by the id argument. The id variable is the value returned by an InterruptAttach() or InterruptAttachEvent() call. If, after detaching, no thread is attached to the interrupt then the interrupt is masked off.

Before calling either of these functions, the thread must request I/O privity by calling:

ThreadCtl( _NTO_TCTL_IO, 0 );

If the thread doesn't do this, it might SIGSEGV when InterruptUnlock() is called.

Blocking states

These calls don't block.

Returns:

The only difference between these functions is the way they indicate errors:

InterruptDetach()

If an error occurs, -1 is returned and errno is set. Any other value returned indicates success.

InterruptDetach_r()

EOK is returned on success. This function does NOT set errno. If an error occurs, any value in the Errors section may be returned.

Errors:

EINVAL

The value of id doesn't exist for this process.

EPERM

The process doesn't have superuser capabilities.

Classification:

QNX 6

See also:

InterruptAttach(), InterruptAttachEvent()