Annotation of src/usr.bin/doas/doas.1, Revision 1.2
1.2 ! tedu 1: .\" $OpenBSD: doas.1,v 1.1 2015/07/16 20:44:21 tedu Exp $
1.1 tedu 2: .\"
3: .\"Copyright (c) 2015 Ted Unangst <tedu@openbsd.org>
4: .\"
5: .\"Permission to use, copy, modify, and distribute this software for any
6: .\"purpose with or without fee is hereby granted, provided that the above
7: .\"copyright notice and this permission notice appear in all copies.
8: .\"
9: .\"THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
10: .\"WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
11: .\"MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
12: .\"ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
13: .\"WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
14: .\"ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
15: .\"OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
1.2 ! tedu 16: .Dd $Mdocdate: July 16 2015 $
1.1 tedu 17: .Dt DOAS 1
18: .Os
19: .Sh NAME
20: .Nm doas
21: .Nd execute commands as another user
22: .Sh SYNOPSIS
23: .Nm doas
24: .Op Fl u Ar user
25: command
26: .Op Ar args
27: .Sh DESCRIPTION
28: The
29: .Nm
30: utility executes the given command as another user.
31: .Pp
32: The options are as follows:
33: .Bl -tag -width tenletters
34: .It Fl u Ar user
35: Execute the command as
36: .Ar user .
37: The default is root.
38: .El
39: .Sh EXIT STATUS
40: .Ex -std doas
41: It may fail because of one of the following reasons:
42: .Pp
43: .Bl -bullet -compact
44: .It
45: The config file could not be parsed.
46: .It
1.2 ! tedu 47: The user attempted to run a command which is not permitted.
1.1 tedu 48: .It
1.2 ! tedu 49: The password was incorrect.
1.1 tedu 50: .El
1.2 ! tedu 51: .Sh SEE ALSO
! 52: .Xr doas.conf 5
1.1 tedu 53: .Sh HISTORY
54: The
55: .Nm
56: command first appeared in
57: .Ox 5.8 .
58: .Sh AUTHORS
59: .An Ted Unangst Aq Mt tedu@openbsd.org