161609Sbostic.\" Copyright (c) 1980, 1991, 1993 261609Sbostic.\" The Regents of the University of California. All rights reserved. 320776Smckusick.\" 448832Scael.\" %sccs.include.redist.roff% 548832Scael.\" 6*66976Sbostic.\" @(#)group.5 8.3 (Berkeley) 04/19/94 748832Scael.\" 848832Scael.Dd 948832Scael.Dt GROUP 5 1048832Scael.Os 1148832Scael.Sh NAME 1248832Scael.Nm group 1348832Scael.Nd format of the group permissions file 1448832Scael.Sh DESCRIPTION 1548832ScaelThe file 1648832Scael.Aq Pa /etc/group 1748832Scaelconsists of newline separated 1848832Scael.Tn ASCII 1948832Scaelrecords, one per group, containing four colon 2048832Scael.Ql \&: 2148832Scaelseparated fields. These fields are as follows: 2248832Scael.Bl -tag -width password -offset indent -compact 2348832Scael.It group 2448832ScaelName of the group. 2548832Scael.It passwd 2648832ScaelGroup's 2748832Scael.Em encrypted 2848832Scaelpassword. 2948832Scael.It gid 3048832ScaelThe group's decimal ID. 3148832Scael.It member 3248832ScaelGroup members. 3348832Scael.El 3448832Scael.Pp 3520776SmckusickThe 3648832Scael.Ar group 3748832Scaelfield is the group name used for granting file access to users 3848832Scaelwho are members of the group. 3948832ScaelThe 4048832Scael.Ar gid 4148832Scaelfield is the number associated with the group name. 4248832ScaelThey should both be unique across the system (and often 4348832Scaelacross a group of systems) since they control file access. 4448832ScaelThe 4548832Scael.Ar passwd 4648832Scaelfield 4748832Scaelis an optional 4848832Scael.Em encrypted 4948832Scaelpassword. 5048832ScaelThis field is rarely used 5148832Scaeland an asterisk is normally placed in it rather than leaving it blank. 5248832ScaelThe 5348832Scael.Ar member 54*66976Sbosticfield contains the names of users granted the privileges of 5548832Scael.Ar group . 5665101SmckusickThe member names are separated by commas without spaces or newlines. 5748832ScaelA user is automatically in a group if that group was specified 5848832Scaelin their 5948832Scael.Pa /etc/passwd 6048832Scaelentry and does not need to be added to that group in the 6148832Scael.Pa /etc/group file. 6248832Scael.\" .Pp 6348832Scael.\" When the system reads the file 6448832Scael.\" .Pa /etc/group 6548832Scael.\" the fields are read into the structure 6648832Scael.\" .Fa group 6748832Scael.\" declared in 6848832Scael.\" .Aq Pa grp.h : 6948832Scael.\" .Bd -literal -offset indent 7048832Scael.\" struct group { 7148832Scael.\" char *gr_name; /* group name */ 7248832Scael.\" char *gr_passwd; /* group password */ 7348832Scael.\" int gr_gid; /* group id */ 7448832Scael.\" char **gr_mem; /* group members */ 7548832Scael.\" }; 7648832Scael.\" .Ed 7748832Scael.Sh FILES 7848832Scael.Bl -tag -width /etc/group -compact 7948832Scael.It Pa /etc/group 8048832Scael.El 8148832Scael.Sh SEE ALSO 8248832Scael.Xr setgroups 2 , 8348832Scael.Xr initgroups 3 , 8448832Scael.Xr crypt 3 , 8548832Scael.Xr passwd 1 , 8648832Scael.Xr passwd 5 8748832Scael.Sh BUGS 8848832ScaelThe 8948832Scael.Xr passwd 1 9048832Scaelcommand does not change the 9148832Scael.Nm group 9248832Scaelpasswords. 9348832Scael.Sh HISTORY 9448832ScaelA 9548832Scael.Nm 9648832Scaelfile format appeared in 9748832Scael.At v6 . 98