kcred_getpag or kcred_getpag64 Kernel Service

Purpose

Copies a process authentication group (PAG) ID from a credentials structure.

Syntax

#include <sys/cred.h>

int kcred_getpag ( crp, which, pag )
struct ucred * cr;
int which;
int * pag;

int kcred_getpag64 ( crp, which, pag )
struct ucred * cr;
int which;
uint64 * pag;

Parameters

Item	Description
crp	Pointer to a credentials structure
which	PAG ID to get
pag	Process authentication group

Description

The kcred_getpag or kcred_getpag64 kernel service copies the requested PAG from the credentials structure referenced by crp into pag. The value of which must be a defined PAG ID. The PAG ID for the Distributed Computing Environment (DCE) is 0. crp must be a valid, referenced credentials structure.

Execution Environment

The kcred_getpag or kcred_getpag64 kernel service can be called from the process environment only.

Return Values

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned, and the errno global variable is set to indicate the error.

Error Codes

Thekcred_getpag kernel service fails if the following condition is true:

Item	Description
-EOVERFLOW	PAG value is 64-bit (should be using kcred_getpag64)