InterruptUnmask()

Enable a hardware interrupt

Synopsis:

#include <sys/neutrino.h>

int InterruptUnmask( int intr, 
                     int id );

Since:

BlackBerry 10.0.0

Arguments:

intr
The interrupt you want to unmask.
id
The value returned by InterruptAttach() or InterruptAttachEvent(), or -1 if you don't want the kernel to track interrupt maskings and unmaskings for each handler.

The id is ignored unless you use the _NTO_INTR_FLAGS_TRK_MSK flag when you attach the handler.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The InterruptUnmask() kernel call enables the hardware interrupt specified by intr for the interrupt handler specified by intr for the handler specified by id when the mask count reaches zero. You can call this function from a thread or from an interrupt handler. Before calling this function, the thread must:

  • have the PROCMGR_AID_IO ability enabled. For more information, see procmgr_ability().
  • request I/O privileges by calling:
    ThreadCtl( _NTO_TCTL_IO, 0 );
    

If the thread doesn't do these things, it might SIGSEGV when it calls InterruptUnmask().

Calls to InterruptMask() are nested; the interrupt isn't unmasked until InterruptUnmask() has been called once for every call to InterruptMask().

Returns:

The current mask count, or -1 if an error occurs ( errno is set).

Errors:

EINVAL
Not a supported hardware interrupt intr.
ESRCH
The id parameter isn't something returned by InterruptAttach() or InterruptAttachEvent(), or -1.

Classification:

QNX Neutrino

Safety:  
Cancellation point No
Interrupt handler Yes
Signal handler Yes
Thread Yes

Last modified: 2014-06-24



Got questions about leaving a comment? Get answers from our Disqus FAQ.

comments powered by Disqus