Attachment 117 Details for Bug 283 – Manpage for AIX usrinfo(). Needed to setup proper user context for some legacy AIX applications.

Manpage for AIX usrinfo(). Needed to setup proper user context for some legacy AIX applications.

usrinfo.man (text/plain), 2.82 KB, created by Gert Doering on 2002-06-22 22:16:27 AEST

(hide)

Description:

Filename:

MIME Type:

Creator: Gert Doering

Created: 2002-06-22 22:16:27 AEST

Size: 2.82 KB

patch

obsolete

>  
>                                   Search ]
>-------------------------------------------------------------------------------
>      Base Operating System and Extensions Technical Reference, Volume 2
>-------------------------------------------------------------------------------
>
>usrinfo Subroutine
>
>Purpose
>
>Gets and sets user information about the owner of the current process.
>
>Library
>
>Standard C Library (libc.a)
>
>Syntax
>
>#include <uinfo.h>
>
>int usrinfo (Command, Buffer, Count)
>
>int Command;
>
>char *Buffer;
>
>int Count;
>
>Description
>
>The usrinfo subroutine gets and sets information about the owner of the current
>process. The information is a sequence of null-terminated name=value strings.
>The last string in the sequence is terminated by two successive null characters.
>A child process inherits the user information of the parent process.
>
>Parameters
>
>Command Specifies one of the following constants:
>
>GETUINFO Copies user information, up to the number of bytes specified by the
>Count parameter, into the buffer pointed to by the Buffer parameter.
>
>SETUINFO Sets the user information for the process to the number of bytes
>specified by the Count parameter in the buffer pointed to by the Buffer
>parameter. The calling process must have root user authority to set the user
>information.
>
>The minimum user information consists of four strings typically set by the login
>program:
>
>NAME=UserName
>
>LOGIN=LoginName
>
>LOGNAME=LoginName
>
>TTY=TTYName
>
>If the process has no terminal, the TTYName parameter should be null.
>
>Buffer Specifies a pointer to a user buffer. This buffer is usually UINFOSIZ
>bytes long.
>
>Count Specifies the number of bytes of user information copied from or to the
>user buffer.
>
>Return Values
>
>If successful, the usrinfo subroutine returns a non-negative integer giving the
>number of bytes transferred. Otherwise, a value of -1 is returned and the errno
>global variable is set to indicate the error.
>
>Error Codes
>
>The usrinfo subroutine fails if one of the following is true:
>
>EPERM The Command parameter is set to SETUINFO, and the calling process does not
>have root user authority.
>
>EINVAL The Command parameter is not set to SETUINFO or GETUINFO.
>
>EINVAL The Command parameter is set to SETUINFO, and the Count parameter is
>larger than UINFOSIZ.
>
>EFAULT The Buffer parameter points outside of the address space of the process.
>
>Implementation Specifics
>
>This subroutine is part of Base Operating System (BOS) Runtime.
>
>Related Information
>
>The getuinfo subroutine, setpenv subroutine.
>
>The login command.
>
>List of Security and Auditing Subroutines in AIX Version 4.3 General Programming
>Concepts: Writing and Debugging Programs.
>
>Subroutines Overview in AIX Version 4.3 General Programming Concepts: Writing
>and Debugging Programs.
>-------------------------------------------------------------------------------
>  
>                                   Search ]
>

Actions: View

Attachments on bug 283: 117