getpaginfo Subroutine
Purpose
Retrieves a Process Authentication Group (PAG) flags for a given PAG type.
Library
Security Library (libc.a)
Syntax
#include <pag.h>
int getpaginfo ( name, infop, infosz )
char * name;
struct paginfo * infop;
int infosz;Description
The getpaginfo subroutine retrieves the PAG flags for a given PAG name. For this function to succeed, the PAG name must be registered with the operating system before this subroutine is called. The infop parameter must be a valid, referenced PAG info structure of the size specified by infosz.
Parameters
| Item | Description |
|---|---|
| name | A 1-character to 4-character, NULL-terminated
name for the PAG type. Typical values include afs, dfs, pki,
and krb5. |
| infop | Points to a paginfo struct where the operating system returns the PAG flags. |
| infosz | Indicates the size of the PAG info structure. |
Return Values
A
value of 0 is returned upon successful completion.
If the getpaginfo subroutine fails a value
of -1 is returned and the errno global
variable is set to indicate the error.
Error Codes
The getpaginfo subroutine fails if the following condition is true:
| Item | Description |
|---|---|
| EINVAL | The named PAG type does not exist as part of the table. |
Other errors might be set by subroutines invoked by the getpaginfo subroutine.