Return to doas.1 CVS log

Up to [local] / src / usr.bin / doas

Annotation of src/usr.bin/doas/doas.1, Revision 1.3

1.3     ! tedu        1: .\" $OpenBSD: doas.1,v 1.2 2015/07/17 17:11:18 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.3     ! tedu       16: .Dd $Mdocdate: July 17 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
1.3     ! tedu       41: It may fail for one of the following reasons:
1.1       tedu       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