cuserid(3S)                    DG/UX 5.4R3.00                    cuserid(3S)


NAME
       cuserid - get character login name or user name associated with
       effective UID

SYNOPSIS
       #include <stdio.h>

       char *cuserid (char *s);

DESCRIPTION
       cuserid generates either

       ⊕    a character-string representation of the login name that the
            owner of the current process is logged in under (the default).

                 or

       ⊕    a character-string representation for the user name associated
            with the effective user ID of the process (the default behavior
            when linking with the COFF SDE).

       If s is a NULL pointer, this representation is generated in an
       internal static area, the address of which is returned.  Otherwise, s
       is assumed to point to an array of at least Lcuserid characters; the
       representation is left in this array.  The constant Lcuserid is
       defined in the stdio.h header file.


   Considerations for Threads Programming
                     +---------+-----------------------------+
                     |         |                      async- |
                     |function | reentrant   cancel   cancel |
                     |         |              point    safe  |
                     +---------+-----------------------------+
                     |cuserid  |     Y          N        N   |
                     +---------+-----------------------------+

DIAGNOSTICS
       If the login name cannot be found, cuserid returns a NULL pointer; if
       s is not a NULL pointer, a null character `\0' will be placed at
       s[0].

SEE ALSO
       intro(3), reentrant(3), getlogin(3C), getpwent(3C).













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