dg_getauthid(2) DG/UX B2 Security R4.12MU02 dg_getauthid(2)
NAME
dggetauthid - get the authentication ID of a process
SYNOPSIS
#include <sys/dgtparms.h>
authidt dggetauthid (pidt pid);
where:
pid The ID of the process whose authentication identifier (AUTHID)
is returned. As a special case, when pid is 0, the
authentication ID of the calling process is returned.
DESCRIPTION
The dggetauthid system call returns the authentication ID of the
process identified by pid. If pid is 0, the authentication ID of the
calling process is returned.
ACCESS CONTROL
The caller must have appropriate privilege to get the authentication
ID of another process.
RETURN VALUE
Returns the authentication ID of the specified process unless an
error occurs, in which case -1 is returned.
ERRORS
On failure, errno is set to one of the following values:
EPERM The caller does not have appropriate privilege.
ESRCH No process with ID pid exists.
SEE ALSO
dgsetauthid(2).
Licensed material--property of copyright holder(s)