newgrp - Change Current Group ID

newgrp.man

28906b52015f727feb4312869a468b8f792bca8e5dc7309c0000000300000875

NEWGRP(1)                                                                                                 User Commands                                                                                                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).

shadow-utils 4.13                                                                                          02/06/2024                                                                                                  NEWGRP(1)

Chunks

e35ed74e (1st chunk of `newgrp.man`)

Title: newgrp - Change Current Group ID

Summary

The `newgrp` command allows a user to change their current group ID during a login session. It reinitializes the user's environment if the optional '-' flag is provided. The command prompts for a password if required and uses `/etc/gshadow` or `/etc/group` for group membership and password information. Configuration options in `/etc/login.defs` control its behavior, such as enabling syslog logging.