id(1)                 MPE/iX Shell and Utilities                 id(1)
  ______________________________________________________________________

  NAME
       id -- display user and group names

  SYNOPSIS
       id [user]
       id -G [-n] [user]
       id -g [-nr] [user]
       id -u [-nr] [user]

  DESCRIPTION

       Note: The MPE/iX implementation of this utility does not function
       exactly as this man page describes.  For details, see the MPE/iX
       NOTES section at the end of this man page.

       Invoking id without arguments displays the user name and group
       affiliations of the person who issues the command.  Specifying a
       user argument on the command line displays the same information
       for the given user instead of the person invoking id.  In this
       case, you require appropriate permissions.

       The output has the format

          uid=runum(username) gid=rgnum(groupname)

       where runum is the user's real user ID number, username is the
       user's real user name, rgnum is the user's real group ID number,
       and groupname is the user's real group name.

       On POSIX-compliant systems, a user's real and effective IDs may
       differ.  In this case, there may be separate entries for effec-
       tive user ID with the format

          euid=eunum(euname)

       where eunum is the effective user ID number and euname is the
       effective user name.  An entry for effective group ID has the
       format

          egid=egnum(egname)

       where egnum is the effective group ID number and egname is the
       effective group name.

  Options
       id recognizes the following options:

       -G   displays all different group ID's (effective, real, and sup-
            plementary) as numbers separated by spaces.

       -g   displays only the effective group ID number.

       -n   with -G, -g, or -u, displays the name rather than number.

                                                                       1

  id(1)                 MPE/iX Shell and Utilities                 id(1)
  ______________________________________________________________________

       -r   with -g or -u, displays the real ID rather than the effec-
            tive one.

       -u   displays only the effective user ID number.

  DIAGNOSTICS
       Possible exit status values are:

       0  Successful completion.

       1  You specified an invalid user with the -u option.

       2  Failure due to an invalid command line argument.

  Messages

       Message:  getgroups failed
       Cause:    See syserror(3).
       Action:   See syserror(3).

       Message:  Insufficient memory
       Cause:    There were not enough free system resources to perform
                 the specified operation.
       Action:   Free up more resources.

       Message:  invalid user name: "user"
       Cause:    You specified a user name that was not found in the
                 passwd file.
       Action:   Check that you spelled the user name correctly.

       Message:  Unknown option "-option"
       Cause:    You specified an option that is not valid for id.
       Action:   Check the DESCRIPTION section of this man page for a
                 list of valid id options.

  PORTABILITY
       x/OPEN Portability Guide 4.0.  UNIX System V.

  MPE/iX NOTES
       The current release of MPE/iX does not allow a user to belong to
       more than one group.

       For more information on how the current MPE/iX implementation may
       affect the operation of this utility, see Appendix A, MPE/iX
       Implementation Considerations.

  SEE ALSO
       logname(1)

                                                                       2