Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
newgrp(1)		    General Commands Manual		     newgrp(1)

NAME
       newgrp -	switch to a new	group

SYNOPSIS
       [group]

DESCRIPTION
       The command changes your	group ID without changing your user ID and re-
       places your current shell with a	new one.

       If you specify group, the change	is successful if group exists and  ei-
       ther your user ID is a member of	the new	group, or group	has a password
       and you can supply it from the terminal.

       If you omit group, changes to the group specified in your entry in  the
       password	file,

       Whether	the  group is changed successfully or not, or the new group is
       the same	as the old one or not, proceeds	to replace your	current	 shell
       with  the one specified in the shell field of your password file	entry.
       If that field is	empty, uses the	POSIX shell, (see sh-posix(1)).

       If you specify (hyphen) as the first argument, the new shell starts  up
       as  if  you had just logged in.	If you omit the	new shell starts up as
       if you had invoked it as	a subshell.

       You remain logged in and	the current directory is unchanged, but	calcu-
       lations	of  access  permissions	to files are performed with respect to
       the new real and	effective group	IDs.

       Exported	variables retain their values and are passed to	the new	shell.
       All  unexported variables are deleted, but the new shell	may reset them
       to default values.

       Since the current process is replaced when the new  shell  is  started,
       exiting	from  the  new	shell  has the same effect as exiting from the
       shell in	which was executed.

EXTERNAL INFLUENCES
   International Code Set Support
       Characters from the 7-bit USASCII code set are supported	in group names
       (see ascii(5)).

DIAGNOSTICS
       The command issues the following	error messages:

       Your user		     ID	does not qualify as a group member.

       The group name does not exist in

       If a password is	required, it must come from a terminal.

       Standard	input is not a terminal	file,
				     causing the new shell to fail.

EXAMPLES
       To  change from your current group to group without executing the login
       routines:

       To change from your current group to group and execute the  login  rou-
       tines:

WARNINGS
       There is	no convenient way to enter a password into

       The  use	 of  group passwords is	not recommended	because, by their very
       nature, they encourage poor security practices.	Group passwords	may be
       eliminated in future HP-UX releases.

FILES
       System group file
       System password file

SEE ALSO
       csh(1), ksh(1), login(1), sh-posix(1), group(4),	passwd(4), environ(5).

STANDARDS CONFORMANCE
								     newgrp(1)

NAME | SYNOPSIS | DESCRIPTION | EXTERNAL INFLUENCES | DIAGNOSTICS | EXAMPLES | WARNINGS | FILES | SEE ALSO | STANDARDS CONFORMANCE

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=newgrp&sektion=1&manpath=HP-UX+11.22>

home | help