newgrp(1) [php man page]

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.5                                                    01/25/2018                                                           NEWGRP(1)

NEWGRP(1)						    BSD General Commands Manual 						 NEWGRP(1)

NAME

     newgrp -- change to a new primary group

SYNOPSIS

     newgrp [-l] [group]

DESCRIPTION

     The newgrp command changes a user to a new primary group (real and effective group ID) by starting a new shell.  The user remains logged in
     and the current directory and file creation mask remain unchanged.  The user is always given a new shell even if the primary group change
     fails.

     The newgrp command accepts the following options:

     -l      The environment is changed to what would be expected if the user actually logged in again.  This simulates a full login.

     The group is a group name or non-negative numeric group ID from the group database.  The real and effective group IDs are set to group or the
     group ID associated with the group name.

     If group is not specified, newgrp restores the user's real and effective group IDs to the user's primary group specified in the password
     database.	The user's supplementary group IDs are restored to the set specified for the user in the group database.

     If the user is not a member of the specified group, and the group requires a password, the user will be prompted for the group password.

FILES

     /etc/group 	 The group database
     /etc/master.passwd  The user database
     /etc/passwd	 A Version 7 format password file

EXIT STATUS

     If a new shell is started the exit status is the exit status of the shell.  Otherwise the exit status will be >0.

SEE ALSO

     csh(1), groups(1), login(1), sh(1), su(1), umask(2), group(5), passwd(5), environ(7)

STANDARDS

     The newgrp command conforms to IEEE Std 1003.1-2001 (``POSIX.1'').

HISTORY

     A newgrp command appeared in Version 6 AT&T UNIX.	A newgrp command appeared in NetBSD 5.0.

BUGS

     There is no convenient way to enter a password into /etc/group.  The use of group passwords is strongly discouraged since they are inherently
     insecure.	It is not possible to stop users from obtaining the encrypted password from the group database.

BSD
								   June 6, 2007 							       BSD