1*48832Scael.\" Copyright 1980, 1991 The Regents of the University of California. 2*48832Scael.\" All rights reserved. 320776Smckusick.\" 4*48832Scael.\" %sccs.include.redist.roff% 5*48832Scael.\" 6*48832Scael.\" @(#)group.5 6.2 (Berkeley) 04/29/91 7*48832Scael.\" 8*48832Scael.Dd 9*48832Scael.Dt GROUP 5 10*48832Scael.Os 11*48832Scael.Sh NAME 12*48832Scael.Nm group 13*48832Scael.Nd format of the group permissions file 14*48832Scael.Sh DESCRIPTION 15*48832ScaelThe file 16*48832Scael.Aq Pa /etc/group 17*48832Scaelconsists of newline separated 18*48832Scael.Tn ASCII 19*48832Scaelrecords, one per group, containing four colon 20*48832Scael.Ql \&: 21*48832Scaelseparated fields. These fields are as follows: 22*48832Scael.Bl -tag -width password -offset indent -compact 23*48832Scael.It group 24*48832ScaelName of the group. 25*48832Scael.It passwd 26*48832ScaelGroup's 27*48832Scael.Em encrypted 28*48832Scaelpassword. 29*48832Scael.It gid 30*48832ScaelThe group's decimal ID. 31*48832Scael.It member 32*48832ScaelGroup members. 33*48832Scael.El 34*48832Scael.Pp 3520776SmckusickThe 36*48832Scael.Ar group 37*48832Scaelfield is the group name used for granting file access to users 38*48832Scaelwho are members of the group. 39*48832ScaelThe 40*48832Scael.Ar gid 41*48832Scaelfield is the number associated with the group name. 42*48832ScaelThey should both be unique across the system (and often 43*48832Scaelacross a group of systems) since they control file access. 44*48832ScaelThe 45*48832Scael.Ar passwd 46*48832Scaelfield 47*48832Scaelis an optional 48*48832Scael.Em encrypted 49*48832Scaelpassword. 50*48832ScaelThis field is rarely used 51*48832Scaeland an asterisk is normally placed in it rather than leaving it blank. 52*48832ScaelThe 53*48832Scael.Ar member 54*48832Scaelfield contains the names of users granted the priviledges of 55*48832Scael.Ar group . 56*48832ScaelThe member names are separated by commas with out spaces or newlines. 57*48832ScaelA user is automatically in a group if that group was specified 58*48832Scaelin their 59*48832Scael.Pa /etc/passwd 60*48832Scaelentry and does not need to be added to that group in the 61*48832Scael.Pa /etc/group file. 62*48832Scael.\" .Pp 63*48832Scael.\" When the system reads the file 64*48832Scael.\" .Pa /etc/group 65*48832Scael.\" the fields are read into the structure 66*48832Scael.\" .Fa group 67*48832Scael.\" declared in 68*48832Scael.\" .Aq Pa grp.h : 69*48832Scael.\" .Bd -literal -offset indent 70*48832Scael.\" struct group { 71*48832Scael.\" char *gr_name; /* group name */ 72*48832Scael.\" char *gr_passwd; /* group password */ 73*48832Scael.\" int gr_gid; /* group id */ 74*48832Scael.\" char **gr_mem; /* group members */ 75*48832Scael.\" }; 76*48832Scael.\" .Ed 77*48832Scael.Sh FILES 78*48832Scael.Bl -tag -width /etc/group -compact 79*48832Scael.It Pa /etc/group 80*48832Scael.El 81*48832Scael.Sh SEE ALSO 82*48832Scael.Xr setgroups 2 , 83*48832Scael.Xr initgroups 3 , 84*48832Scael.Xr crypt 3 , 85*48832Scael.Xr passwd 1 , 86*48832Scael.Xr passwd 5 87*48832Scael.Sh BUGS 88*48832ScaelThe 89*48832Scael.Xr passwd 1 90*48832Scaelcommand does not change the 91*48832Scael.Nm group 92*48832Scaelpasswords. 93*48832Scael.Sh HISTORY 94*48832ScaelA 95*48832Scael.Nm 96*48832Scaelfile format appeared in 97*48832Scael.At v6 . 98