groupls(ADM)

Syntax

Administrative syntax:
/etc/groupls -a|-D [-o] [-S system_name] [-x extendedOptionString]
[-X optionsFile]

/etc/groupls [-A] -g group1,group2,... [-o] [-x extendedOptionString] [-X
optionsFile]

Description

The first form of the administrative syntax provides a list of all groups on the specified system (-a) or lists the group defaults (-D) for the specified system. Extended option strings allow you to view other attributes. For example, groupls -D -x "maxGid maxSuggestGid" outputs the values associated with maxGid and maxSuggestGid, one per line.

The second form generates a list of GIDs and members of the groups specified.

The output of groupls is attribute value pairs enclosed in braces, which is suitable for use in an option file for groupadd(ADM).

Options

-A

When used in conjunction with -g, lists all attributes associated with the specified group(s).

-D

Lists the system-wide defaults for attributes specified with the -x or -X options. Without any other options, lists the next available GID.

-g group_name

Reports all attributes associated with group group_name.

-o

Causes displayed information to be delimited with colons (:).

-S hostname

Specifies the host from which the information is to be taken.

-x extendedOptionString

Lists extended group account attributes. Most attributes are group parameters that can be changed; the groupls command can only be used to query them. See groupadd(ADM) for a list of group account attributes.

-X optionsFile

Specify the file from which the group attributes are to be taken.

Exit values

0

The operation was successful.

>0

An error occurred.

Files

/etc/group

group file

/etc/group.local

local group file for NIS servers

/etc/group.yp

distributed group file for NIS servers

/etc/auth/?/

Subsystem Authorizations database

/etc/default/accounts

user/group account creation defaults

See also

Standards conformance