Parent topic: P

procmgr_ability_name()

Updated: October 28, 2024

Get the name of a custom ability

Synopsis:

#include <sys/procmgr.h>

int procmgr_ability_name( const unsigned ability, char * const buffer,
                          const size_t size);

Arguments:

ability: A numeric ability identifier (returned by procmgr_ability_lookup()) that specifies which custom ability to get the name of.
buffer: The buffer to store the ability name in.
size: The size of the buffer. Make sure it is no smaller than PROCMGR_ABILITY_NAME_MAX, which is the maximum name length including the NUL terminator.

Library:

libc

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

Description:

The procmgr_ability_name() function retrieves the name of a custom ability.

Returns:

0: Success.
-1: An error occurred (errno is set).

Classification:

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

Parent topic: P