procmgr_ability_lookup()

Look up a process-manager ability

Synopsis:

#include <sys/procmgr.h>

int procmgr_ability_lookup( const char *name );

Arguments:

name
The name of the ability. This should by convention consist of a service identifier followed by a capability identifier (e.g., "fs-qnx6/some_devctl").

Library:

libc

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

Description:

The procmgr_ability_lookup() function looks up a process-manager ability that was (or will be) created by a call to procmgr_ability_create().

Note: There's no requirement for a call to procmgr_ability_create() to precede calls to procmgr_ability_lookup(). This avoids forcing any specific ordering of process initialization.

In QNX Neutrino 7.0 or later, if the ability hasn't yet been created:

Returns:

A numeric ability identifier, or a negative errno value if an error occurred. You can use the ability identifier in calls to procmgr_ability() or to verify the abilities of a client.

Classification:

QNX Neutrino

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