newgrp(1)                                               newgrp(1)



NAME
     newgrp - logs you into a new group

SYNOPSIS
     newgrp [-] [group]

ARGUMENTS
     -    Changes the environment to what would be expected if
          the user actually logged in again.

     group
          Specifies the group you wish to be a part of.

DESCRIPTION
     newgrp changes a user's group identification.  The user
     remains logged in, and the current directory is unchanged,
     but calculations of access permissions to files are
     performed with respect to the new real and effective group
     IDs.  The user is always given a new shell, replacing the
     current shell, by newgrp, regardless of whether it
     terminated successfully or terminated due to an error
     condition (that is, unknown group).

     Exported variables retain their values after invoking
     newgrp; however, all unexported variables are either reset
     to their default value or set to null.  System variables
     (such as PS1, PS2, PATH, MAIL, and HOME), unless exported by
     the system or explicitly exported by the user, are reset to
     default values.  For example, a user has a primary prompt
     string (PS1) other than $ (default) and has not exported
     PS1.  After an invocation of newgrp, successful or not,
     their PS1 will now be set to the default prompt string $.
     Note that the shell command export (see sh(1)) is the method
     used to export variables so that their assigned value is
     retained when invoking new shells.

     With no arguments, newgrp changes the group identification
     back to the group specified in the user's password file
     entry.

     A password is demanded if the group has a password and the
     user does not, or if the group has a password and the user
     is not listed in /etc/group as being a member of that group.

EXAMPLES
     The command:

        newgrp grpnam

     would set the user's group ID to that of the group named
     grpnam.




January 1992                                                    1

newgrp(1)                                               newgrp(1)



LIMITATIONS
     There is no convenient way to enter a password into
     /etc/group.  Use of group passwords is not encouraged,
     because, by their very nature, they encourage poor security
     practices.  Group passwords may disappear in the future.

FILES
     /bin/newgrp
          Executable file
     /etc/group
          File containing a list of groups
     /etc/passwd
          File containing a list of passwords

SEE ALSO
     login(1), sh(1)

     group(4), passwd(4), environ(5) in A/UX Programmer's
     Reference




































2                                                    January 1992