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

FreeBSD Manual Pages

  
 
  

home | help
runuid(8)			   runtools			     runuid(8)

NAME
       runuid -	run a program with specific user and group permissions

SYNOPSIS
       runuid  [-hV] [-g group ] [-s | -S grplist ] account program [ args ...
       ]

DESCRIPTION
       runuid runs program with	the uid	and gid	set according to the user  and
       group ID	of account.

       If  program  does not contain a ``/'' slash character, runuid will per-
       form a shell-like search	for the	executable using the PATH variable  in
       the current environment.

       runuid itself needs root	privilege to run.

OPTIONS
       -g group
	      Group.   Normally	 runuid	 sets the base group permission	corre-
	      sponding to the group ID of the account.	The -g option  may  be
	      used to specify a	different base group permission.

       -h     Help.  Print a brief usage message to stderr and exit.

       -S grplist
	      Supplemental (listed).  Normally runuid sets only	a single group
	      permission corresponding to the group ID of the account,	or  as
	      specified	 with  the -g option.  The -S option will additionally
	      set supplemental group permissions as given in the grplist argu-
	      ment,  a	colon-delimited	 list  of  one or more arbitrary group
	      names as defined in /etc/group.  The -S option and the -s	option
	      are mutually exclusive.

       -s     Supplemental  (/etc/group).   Normally runuid sets only a	single
	      group permission corresponding to	the group ID of	 the  account,
	      or  as  specified	 with the -g option.  The -s option will addi-
	      tionally set all supplemental group permissions defined for  the
	      account in /etc/group as described in initgroups(3).  The	-s op-
	      tion and the -S option are mutually exclusive.

       -V     Version.	Print the version number to stderr and exit.

EXIT STATUS
       runuid exits with one of	the following values:

       0      program was invoked and completed	successfully.  In  this	 case,
	      the  exit	code is	returned by the	program, rather	than by	runuid
	      itself.

       100    runuid failed because of a usage error, such as an invalid  com-
	      mand-line	 option	 or  argument.	 In this case, runuid prints a
	      brief error message and usage help to stderr on exit.

       111    runuid failed due	to some	system or  resource  error.   In  this
	      case,  runuid  prints  a	brief  diagnostic message to stderr on
	      exit.

       1-127  program was invoked and failed with its own non-zero  exit  sta-
	      tus.

AUTHOR
       Wayne Marshall, http://b0llix.net/perp/

SEE ALSO
       runtools_intro(8),  runargs(8), runargv0(8), runchoom(8), rundetach(8),
       rundeux(8),    runenv(8),    runfile(8),	   runlimit(8),	   runlock(8),
       runpause(8),   runsession(8),  runtool(8),  runtrap(8),	initgroups(3),
       setgroups(2)

runtools-2.07			 January 2013			     runuid(8)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXIT STATUS | AUTHOR | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=runuid&sektion=8&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help