dg_setauthinfo(2) — DG/UX R4.11MU05



dg_setauthinfo(2)        DG/UX B2 Security R4.12MU02       dg_setauthinfo(2)


NAME
       dgsetauthinfo - change a subject's authinfo information.

SYNOPSIS
       #include <sys/types.h>
       #include <sys/dgauthinfo.h>

       int     dgsetauthinfo(pid, bufp, lenp)
       const pidt  pid;
       void        *bufp;
       sizet      *lenp;

   where:
       pid    The process ID corresponding to the subject whose authinfo
              information is to be changed.  (A value of zero denotes the
              calling process.)

       bufp  The address of a buffer containing the new authinfo
              information.

       lenp  The address of a variable containing the length (in bytes) of
              the new authinfo information.

DESCRIPTION
       This system call replaces the target subject's authinfo information
       by the contents of the specified buffer.

       If the specified buffer length exceeds the system maximum, the target
       subject's authinfo information is not changed and the value of the
       buffer length variable is replaced by the value of the system
       maximum.

ACCESS CONTROL
       To change any subject's authinfo information (including its own), the
       caller must have appropriate privilege.

       For systems supporting the DG/UX Capability Option, appropriate
       privilege is defined as having one or more specific capabilities
       enabled in the effective capability set of the calling process.  See
       capdefaults(5) for the default capability for this system call.  On
       systems without the DG/UX Capability Option, appropriate privilege
       means that the caller has an effective UID of root. See the
       appropriateprivilege(5) man page for more information.

RETURN VALUE
       0         Successful completion.

       -1        An error occurred. errno is set to indicate the error.

EXCEPTIONS
       errno may be set to one of the following error codes:

       ENOSYS The system call was made on a system that does not support
              this operation.

       EPERM  The caller does not have appropriate privilege to perform this
              operation.

       ESRCH  The process pid does not exist.

       EFAULT The parameter lenp points to a memory area not accessible to
              the calling process.

       E2BIG  The specified authinfo length exceeds the system maximum
              value.

       EFAULT The parameter bufp points to a memory area not accessible to
              the calling process.

       ENOMEM The operating system was unable to allocate internal memory to
              process the system call.

SEE ALSO
       dggetauthinfo(2), capdefaults(5).


Licensed material--property of copyright holder(s)
Museum
