setpagvalue or setpagvalue64 Subroutine
Purpose
Sets the Process Authentication Group (PAG) value for a given PAG type.
Library
Security Library (libc.a)
Syntax
#include <pag.h>
int setpagvalue ( name, value )
char * name;
int value;
uint64_t setpagvalue64( name, value );
char * name;
uint64 value;
Description
The setpagvalue or setpagvalue64 subroutine sets the PAG value for a given PAG name. For these functions to succeed, the PAG name must be registered with the operating system before these subroutines are called.
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. |
| value | New PAG value for the given name. |
Return Values
The setpagvalue and setpagvalue64 subroutines
return a PAG value upon successful completion. Upon a failure, a value
of -1 is returned and the errno global
variable is set to indicate the error.
Error Codes
The setpagvalue and setpagvalue64 subroutines fail 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 setpagvalue and setpagvalue64 subroutines.