Clarify the use of the "-M" and "-m" options to "pw groupmod" in

the "Groups" section.  Specifically, explain that "-M" sets the group
memberlist to the exact userlist specified, while "-m" adds to
the current list.

PR:		122476
Submitted by:	db
This commit is contained in:
Peter Pentchev 2008-04-24 16:17:44 +00:00
parent e2a1f89163
commit 7b5a6d66de
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=31900

View file

@ -982,7 +982,7 @@ teamtwo:*:1100:</screen>
the <groupname>teamtwo</groupname> group.</para>
<example>
<title>Adding Somebody to a Group Using &man.pw.8;</title>
<title>Setting the List of Members of a Group Using &man.pw.8;</title>
<screen>&prompt.root; <userinput>pw groupmod teamtwo -M jru</userinput>
&prompt.root; <userinput>pw groupshow teamtwo</userinput>
@ -990,7 +990,7 @@ teamtwo:*:1100:jru</screen>
</example>
<para>The argument to the <option>-M</option> option is a
comma-delimited list of users who are members of the group. From the
comma-delimited list of users who are to be in the group. From the
preceding sections, we know that the password file also contains a
group for each user. The latter (the user) is automatically added to
the group list by the system; the user will not show up as a member
@ -1000,6 +1000,19 @@ teamtwo:*:1100:jru</screen>
<filename>/etc/group</filename> file; it will never attempt to read
additionally data from <filename>/etc/passwd</filename>.</para>
<example>
<title>Adding a New Member to a Group Using &man.pw.8;</title>
<screen>&prompt.root; <userinput>pw groupmod teamtwo -m db</userinput>
&prompt.root; <userinput>pw groupshow teamtwo</userinput>
teamtwo:*:1100:jru,db</screen>
</example>
<para>The argument to the <option>-m</option> option is a
comma-delimited list of users who are to be added to the group. Unlike
the previous example, these users are added to the group and do not
replace the list of users in the group.</para>
<example>
<title>Using &man.id.1; to Determine Group Membership</title>