listusers(1) — Reliant UNIX 5.44c4

listusers(1)                                                   listusers(1)

NAME
     listusers - list user login information

SYNOPSIS
     listusers [option ...]

DESCRIPTION
     listusers prints information on user logins entered in the /etc/passwd
     file. A user login is defined as a login name that has a user ID (UID)
     of 100 or greater. A user group is defined as a group with a group ID
     (GID) of 100 or greater.

OPTIONS
     No option specified:
          listusers displays the following information:

          -  a list of all user logins entered in the /etc/passwd file,

          -  any associated entries in the comment field of the /etc/passwd
             file.

     -ggroup[,group ...]
          Lists all user logins belonging to the specified user group. Mul-
          tiple groups can be specified as a comma-separated list. Users
          who belong to more than one of the selected groups are only
          listed once.

     -llogin[,login ...]
          Lists the user login specified by login if that login name is
          entered in the /etc/passwd file. If there is an entry associated
          with the login in the comment field of the /etc/passwd file, that
          entry is also displayed. Multiple logins may be specified as a
          comma-separated list.

ERROR MESSAGES

     [group] is not a user group

     With the -g option you have specified a group with a GID below 100.

     [group] was not found

     With the -g option you have specified an illegal group or listed mul-
     tiple groups without separating them with commas.

     [login] is not a user login

     With the -l option you have specified a login with a UID below 100.







Page 1                       Reliant UNIX 5.44                Printed 11/98

listusers(1)                                                   listusers(1)

     [login] was not found

     With the -l option you have specified an illegal login or listed mul-
     tiple logins without separating them with commas.

LOCALE
     The LCMESSAGES environment variable governs the language in which
     message texts are displayed. If LCMESSAGES is undefined or is defined
     as the null string, it defaults to the value of LANG. If LANG is like-
     wise undefined or null, the system acts as if it were not internation-
     alized.

     The LCALL environment variable governs the entire locale. LCALL
     takes precedence over all the other environment variables which affect
     internationalization.

EXAMPLES
     Example 1

     All login names entered in the /etc/passwd file are to be listed.
     Associated entries in the comment field of /etc/passwd are shown in
     the second column.

     $ listusers
     carstens     Cons. 1.4. to 30.09., Tel. 43196
     cmd          Command project '93
     guest
     install      Initial login
     martin
     lab24
     nobody       non-privileged user
     andrew
     vmsys        FACE executables

     Example 2

     All users belonging to the groups consult and usrother are to be
     listed. The user with the login name carstens belongs to both groups,
     but is only listed once.

     $ listusers -gconsult,usrother
     carstens     Cons. 1.4. to 30.09., Tel. 43196
     guest
     lab24

FILES
     /etc/group
          File containing group names

     /etc/passwd
          File containing login names



Page 2                       Reliant UNIX 5.44                Printed 11/98

Museum