newgrp(1) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | CONFIGURATION | FILES | SEE ALSO | COLOPHON

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.

CONFIGURATION         top

       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

       /etc/passwd
           User account information.

       /etc/shadow
           Secure user account information.

       /etc/group
           Group account information.

       /etc/gshadow
           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 
       ⟨https://github.com/shadow-maint/shadow⟩.  If you have a bug
       report for this manual page, send it to
       pkg-shadow-devel@alioth-lists.debian.net.  This page was obtained
       from the project's upstream Git repository
       ⟨https://github.com/shadow-maint/shadow⟩ on 2024-06-15.  (At that
       time, the date of the most recent commit that was found in the
       repository was 2024-06-13.)  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
       man-pages@man7.org

shadow-utils 4.14.0            06/15/2024                      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)