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 perform  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 corresponding
	    to	the group ID of the account.  The -g option may be used to spec-
	    ify 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 spec-
	    ified  with the -g option.	The -S option will additionally set sup-
	    plemental group permissions as given  in  the  grplist  argument,  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 exclu-
	    sive.

     -s     Supplemental (/etc/group).	Normally runuid sets only a single group
	    permission corresponding to the group ID of the account, or as spec-
	    ified with the -g option.  The -s option will additionally	set  all
	    supplemental group permissions defined for the account in /etc/group
	    as	described in initgroups(3).  The -s option 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 status.

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)

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

home | help