HP UX Operating Systems 370

groups(1)

NAME

groups - show group memberships

SYNOPSIS

groups [-p][-g][-l] [ user ]

DESCRIPTION

groups shows the groups to which the caller or the optionally speci®ed user belong. If invoked with no arguments, groups prints the current access list returned by getgroups() (see getgroups(2)).

Each user belongs to a group speci®ed in the password ®le /etc/passwd and possibly to other groups as speci®ed in the ®les /etc/group and /etc/logingroup. A user is granted the permissions of those groups speci®ed in /etc/passwd and /etc/logingroup at login time. The permissions of the groups speci®ed in /etc/group are normally available only with the use of newgrp (see newgrp(1)). If a user name is speci®ed with no options, groups prints the union of all these groups.

The -p, -g, and -loptions limit the printed list to those groups speci®ed in /etc/passwd , /etc/group, and /etc/logingroup, respectively. If a user name is not speci®ed with any of these options, cuserid() is called to determine the default user name (see cuserid(3S)).

The printed list of groups is sorted in ascending collation order (see Environment Variables below).

EXTERNAL INFLUENCES

Environment Variables

LC_COLLATE determines the order in which the output is sorted.

If LC_COLLATE is not speci®ed in the environment or is set to the empty string, the value of LANG is used as a default. If LANG is not speci®ed or is set to the empty string, a default of ``C'' (see lang(5)) is used instead of LANG. If any internationalization variable contains an invalid setting, groups behaves as if all internationalization variables are set to ``C'' (see environ(5)).

EXAMPLES

Check ®le /etc/logingroup and display all groups to which user tim belongs:

groups -l tim

AUTHOR

groups was developed by the University of California, Berkeley.

FILES

/etc/group

/etc/logingroup

/etc/passwd