char
*
cuserid(
char *buf
)
The
cuserid()
function returns a character string representation of the user name
associated with the effective user ID of the calling process.
If
buf
is not the
NULL
pointer, the user name is copied into the memory referenced by
buf
.
The argument
buf
is assumed to point to an array at least
L_cuserid
(as defined in the include
file
<stdio.h
>)
bytes long.
Otherwise, the user name is copied to a static buffer.
buf
is not the
NULL
pointer,
buf
is returned;
otherwise the address of the static buffer is returned.
If the user name could not be determined, if
buf
is not the
NULL
pointer, the null character
`\0'
will be stored at
*buf
;
otherwise
the
NULL
pointer is returned.
)
function conforms to
IEEE Std 1003.1-1988 (``POSIX.1'') .
)
was removed from the
ISO/IEC 9945-1:1990 (``POSIX.1'')
standard.
This implementation exists purely for compatibility with existing programs.
New programs should use one of the following three alternatives to
obtain the user name:
)
to return the user's login name.
))
to return the user name associated with the calling process' effective user ID.
))
to return the user name associated with the calling process' real user ID.