The newgrp command is used to change the current group ID during a
login session. If the optional - flag is given, the user's
environment will be reinitialized as though the user had logged in,
otherwise the current environment, including current working
directory, remains unchanged.
newgrp changes the current real group ID to the named group, or to
the default group listed in /etc/passwd if no group name is given.
newgrp 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.
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.
This page is part of the shadow-utils (utilities for managing
accounts and shadow password files) project. Information about the
project can be found at ⟨http://pkg-shadow.alioth.debian.org/⟩. If
you have a bug report for this manual page, see
⟨http://pkg-shadow.alioth.debian.org/getinvolved.php⟩. This page was
obtained from the project's upstream Git repository
⟨git://anonscm.debian.org/git/pkg-shadow/shadow.git⟩ on 2016-10-04.
If you discover any rendering problems in this HTML version of the
page, or you believe there is a better or more up-to-date source for
the page, or you have corrections or improvements to the information
in this COLOPHON (which is not part of the original manual page),
send a mail to email@example.com
shadow-utils 4.3 10/04/2016 NEWGRP(1)