[ man7.org ](../../../index.html) > Linux > [ man-pages ](../index.html) |  [ Linux/UNIX system programming training ](http://man7.org/training/)  
---|---  
  
* * *

#  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)](../man1/id.1.html), [login(1)](../man1/login.1.html), [su(1)](../man1/su.1.html), [sg(1)](../man1/sg.1.html), [gpasswd(1)](../man1/gpasswd.1.html), [group(5)](../man5/group.5.html), [gshadow(5)](../man5/gshadow.5.html).
    

##  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 2023-12-22.  (At that
           time, the date of the most recent commit that was found in the
           repository was 2023-12-15.)  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.11.1            12/22/2023                      _NEWGRP_(1)
    

* * *

Pages that refer to this page: [ flock(1) ](../man1/flock.1.html) , [
gpasswd(1) ](../man1/gpasswd.1.html) , [ groups(1@@shadow-utils)
](../man1/groups.1@@shadow-utils.