newgrp(1) — Linux manual page


NEWGRP(1)                       User Commands                      NEWGRP(1)

NAME         top

       newgrp - log in to a new group

SYNOPSIS         top

       newgrp [-] [group]

DESCRIPTION         top

       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.


       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         top

           User account information.

           Secure user account information.

           Group account information.

           Secure group account information.

SEE ALSO         top

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

COLOPHON         top

       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 ⟨⟩.  If
       you have a bug report for this manual page, send it to  This page was obtained
       from the project's upstream Git repository
       ⟨⟩ on 2020-09-18.  (At that
       time, the date of the most recent commit that was found in the repos‐
       itory was 2020-08-28.)  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

shadow-utils 4.8.1               09/18/2020                        NEWGRP(1)

Pages that refer to this page: flock(1)gpasswd(1)groups(1@@shadow-utils)pmdammv(1)sg(1)group(5)gshadow(5)credentials(7)