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

FreeBSD Manual Pages

  
 
  

home | help
DOAS(1)			FreeBSD	General	Commands Manual		       DOAS(1)

NAME
     doas -- execute commands as another user

SYNOPSIS
     doas [-nSs] [-a style] [-C	config]	[-u user] [--] command [args]

DESCRIPTION
     The doas utility executes the given command as another user.  The command
     argument is mandatory unless -C, -S, or -s	is specified.

     The options are as	follows:

     -a	style	 Use the specified authentication style	when validating	the
		 user, as allowed by /etc/login.conf.  A list of doas-specific
		 authentication	methods	may be configured by adding an
		 `auth-doas' entry in login.conf(5).

     -C	config	 Parse and check the configuration file	config,	then exit.  If
		 command is supplied, doas will	also perform command matching.
		 In the	latter case either `permit', `permit nopass' or	`deny'
		 will be printed on standard output, depending on command
		 matching results.  No command is executed.

     -n		 Non interactive mode, fail if doas would prompt for password.

     -S		 Same as -s but	simulates a full login.

     -s		 Execute the shell from	SHELL or /etc/passwd.

     -u	user	 Execute the command as	user.  The default is root.

     --		 Any dashes after a combined double dash (--) will be inter-
		 preted	as part	of the command to be run or its	paramters. Not
		 an argument passed to doas itself.

EXIT STATUS
     The doas utility exits 0 on success, and >0 if an error occurs.  It may
     fail for one of the following reasons:

     o	 The config file /usr/local/etc/doas.conf could	not be parsed.
     o	 The user attempted to run a command which is not permitted.
     o	 The password was incorrect.
     o	 The specified command was not found or	is not executable.

SEE ALSO
     su(1), doas.conf(5)

HISTORY
     The doas command first appeared in	OpenBSD	5.8.

AUTHORS
     Ted Unangst <tedu@openbsd.org>

FreeBSD	13.0			 June 11, 2016			  FreeBSD 13.0

NAME | SYNOPSIS | DESCRIPTION | EXIT STATUS | SEE ALSO | HISTORY | AUTHORS

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

home | help