HPUX cuserid[3s]






 cuserid(3S)                                                     cuserid(3S)





 NAME
      cuserid() - get character login name of the user

 SYNOPSIS
      #include <stdio.h>

      char *cuserid(char *s);

    Remarks:
      Because this function behaved differently in previous releases of HP-
      UX, and behaves differently on other systems, its use is not
      recommended.  It is provided only for conformance to current industry
      standards, and is subject to withdrawal in future releases of HP-UX.

      For portability and security, application writers and maintainers
      should search their existing code and replace references to cuserid()
      with equivalent calls to getpwuid(getuid()), getpwuid(geteuid()), or
      getlogin(), depending on which user name is desired.

 DESCRIPTION
      cuserid() generates a character-string representation of the user name
      corresponding to the effective user ID of the process.  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 L_cuserid characters; the representation is left
      in this array.  The constant L_cuserid is defined in the <stdio.h>
      header file.

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

 SEE ALSO
      geteuid(2), getlogin(3C) getpwuid(3C).

 STANDARDS CONFORMANCE
      cuserid(): AES, XPG2, XPG3, XPG4, FIPS 151-2, POSIX.1

















 Hewlett-Packard Company            - 1 -     HP-UX Release 9.0: August 1992