[Pkg-shadow-devel] Bug#325558: Patch for a more complete documentaiton of newgrp behaviour

[Christian Perrier]

tags 325558 patch
thanks

Attached to this mail is Nicolas modifications to newgrp(1) so that it
better explains the issues experienced by the bug submitter in
http://bugs.debian.org/325558

Tomasz, can you mention us if you apply this to your CVS?


-- 




-------------- next part --------------
--- newgrp.1.xml.ori	2005-10-08 14:21:45.688113532 +0200
+++ newgrp.1.xml	2005-10-08 14:28:27.614288250 +0200
@@ -30,20 +30,24 @@
     </para>
 
     <para>
-      <command>newgrp</command> changes the current real group ID to the
-      named group, or to the default group listed in
-      <filename>/etc/passwd</filename> if no group name is given. 
-      <command>newgrp</command> also tries to add the group to the user
-      groupset. If not root, the user will be prompted for a password if she
-      do not have a password and the group does, or if the user is not
-      listed as a member and the group has a password. The user will be
-      denied access if the group password is empty and the user is not
-      listed as a member. The password of the user (and respectively, if
-      compiled with SHADOWGRP, the password and the members of the group)
-      will be overwritten by the value defined
-      <filename>/etc/shadow</filename> (respectively in
-      <filename>/etc/gshadow</filename>) if an entry exists for this user
-      (resp. group).
+      <command>newgrp</command> changes the current real group ID to
+      the named group, or to the default group listed in
+      <filename>/etc/passwd</filename> if no group name is
+      given. <command>newgrp</command> also tries to add the group to
+      the user groupset. If not root, the user will be prompted for a
+      password if she does not have a password (in /etc/shadow if this
+      user has an entry in the shadowed password file, or in
+      /etc/passwd otherwise) and the group does, or if the user is not
+      listed as a member and the group has a password. The user will
+      be denied access if the group password is empty and the user is
+      not listed as a member. 
+    </para>
+
+    <para>
+      If there is an entry for this group in /etc/gshadow, then the
+      list of members and the password of this group will be taken
+      from this file, otherwise, the entry in /etc/group is
+      considered.
     </para>
   </refsect1>