getprivid Subroutine
Purpose
Converts a privilege name into a numeric value.
Library
Security Library (libc.a)
Syntax
#include <userpriv.h>
#include <sys/priv.h>
int getprivid(char *privname)Description
The getprivid subroutine converts a given privilege name specified by the privname parameter into a numeric value of the privilege index that is defined in the <sys/priv.h> header file.
Parameters
| Item | Description |
|---|---|
| privname | Specifies the privilege name that is in string format. |
Return Values
The getprivid subroutine
returns one of the following values:
| Item | Description |
|---|---|
| privilege index | The subroutine successfully completes. |
| -1 | The subroutine cannot find the privilege name specified by the privname parameter. |
Errors
No errno value is set.