GROUP(5)

NAME
group - group file

SYNOPSIS
/etc/group

DESCRIPTION

The group file contains a one-line entry for each group recognized by the system, of the form:

    groupname:password: gid:user-list

where:

    groupname
        is the name of the group.

    gid is the group's numerical ID within the system; it must be unique.

    user-list
        is a comma-separated list of users allowed in the group.

If the password field is empty, no password is demanded. The group file is an ASCII file. Because of the encrypted passwords, the group file can and does have general read permission, and can be used as a mapping of numerical group IDs to user names.

A group entry beginning with a `+' (plus sign), means to incorporate an entry or entries from the Network Information Service. A `+' on a line by itself means to insert the entire contents of the Network Information Service group file at that point in the file. An entry of the form: `+groupname' means to insert the entry (if any) for groupname. If a `+' entry has a non-empty password or user-list field, the contents of that field override the corresponding field from the Network Information Service. The gid field cannot be overridden in this way.

An entry of the form: -groupname indicates that the group is disallowed. All subsequent entries for the indicated groupname, whether originating from the Network Information Service, or the local group file, are ignored.

Malformed entries cause routines that read this file to halt, in which case group assignments specified further along are never made.

EXAMPLE

Here is a sample group file:

    primary:q.mJzTnu8icF.:10:fred,mary
    +myproject:::bill,steve
    +:

If these entries appear at the end of a group file, then the group primary will have members fred and mary, and a group ID of 10. The group myproject will have members bill and steve, and the password and group ID of the Network Information Service entry for the group myproject. All groups listed in the Network Information Service are pulled in and placed after the entry for myproject.

FILES
/etc/group

SEE ALSO
passwd(1), su(1), getgroups(2), initgroups(3), crypt(3), passwd(5),

BUGS

The passwd(1) command will not change group passwords.