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.