newgrp

NAME

newgrp - change to a new group

SYNOPSIS

newgrp [-l] group ...

DESCRIPTION

The newgrp(1) utility changes the shell execution environment to have the specified real and effective group. This new shell environment keeps the working directory, file creation mask, and exported variables of the previous environment. Even if the newgrp(1) fails to assign a new group, it still creates a new shell environment.

newgrp(1) takes the following options:

-l
Change back to the login environment; that is, the environment the user gets when logging in.

The group is the name or numeric group identifier (ID) of a group in the group database. If you do not specify a group, newgrp(1) changes the real and effective group ID back to your login group.

If you are not listed as a member of the group and the group requires a password, you are prompted to enter the password. If you are listed as a member of the group, you are not prompted.

DIAGNOSTICS

If it succeeds, the exit status is the exit status of the shell. Otherwise, it returns a value >0.

NOTES

By default, Interix does not execute files with the set-user-ID (setuid) or set-group-ID (setgid) mode bit set for security reasons. If an attempt is made to execute such a file, the ENOSETUID error is returned. For more information and and instructions for enabling execution of files with these mode bits set, see The superuser account and appropriate privileges in Windows Services for UNIX Help.

Because of the security mechanisms of Windows, there is no way to get the appropriate permissions to change groups. Therefore, this command always fails to change the effective group. It does, however, create a new shell environment, as described above.

SEE ALSO

sh(1)