get_pag or get_pag64 Kernel Service

Purpose

Retrieves a Process Authentication Group (PAG) value for the current process.

Syntax

#include <sys/cred.h>

int get_pag ( type, pag )
int type;
int *pag;

int get_pag64 ( type, pag )
int type;
uint64_t *pag;

Parameters

Item Description
type PAG type to retrieve
pag Pointer to buffer where operating system returns the PAG

Description

The get_pag and get_pag64 kernel services copy the requested PAG from the current process into pag. The value of type must be a defined PAG ID. The PAG ID for the Distributed Computing Environment (DCE) is 0.

Execution Environment

The get_pag and get_pag64 kernel services can be called from the process environment only.

Return Values

A value of 0 is returned upon successful completion. If unsuccessful, errno is set to a value that explains the error.

Error Codes

The get_pag kernel service fails if one or both of the following conditions are true:

Item Description
EINVAL Invalid PAG specification
EOVERFLOW PAG value is 64-bit (should be using get_pag64)

The get_pag64 kernel service fails if the following condition is true:

Item Description
EINVAL Invalid PAG specification