newgrp(1)

NAME

   newgrp - log in to a new group

SYNOPSIS

   newgrp [-] [group]

DESCRIPTION

   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.

CONFIGURATION

   The following configuration variables in /etc/login.defs change the
   behavior of this tool:

   SYSLOG_SG_ENAB (boolean)
       Enable "syslog" logging of sg activity.

FILES

   /etc/passwd
       User account information.

   /etc/shadow
       Secure user account information.

   /etc/group
       Group account information.

   /etc/gshadow
       Secure group account information.

SEE ALSO

   id(1), login(1), su(1), sg(1), gpasswd(1), group(5), gshadow(5).

---

Free and Open Source Software