summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorThomas Voss <mail@thomasvoss.com> 2022-11-15 12:57:00 +0100
committerThomas Voss <mail@thomasvoss.com> 2022-11-15 12:58:23 +0100
commitff14faea7e2b9be2cd1b15d8c86f80e0d5ff5461 (patch)
treed1d144ddfcd68015be176056f3fe9ae4897d52e0
parentaed6e88edb43878e98620cf7c938a74040174f2b (diff)
Add the doasutils(7) manual
-rw-r--r--Makefile3
-rw-r--r--doasutils.754
2 files changed, 56 insertions, 1 deletions
diff --git a/Makefile b/Makefile
index 9cd5b66..77b717c 100644
--- a/Makefile
+++ b/Makefile
@@ -6,7 +6,8 @@ DOAS_CONF = /etc/doas.conf
all:
install:
- mkdir -p ${DPREFIX}/bin ${MANDIR}/man8
+ mkdir -p ${DPREFIX}/bin ${MANDIR}/man7 ${MANDIR}/man8
+ cp doasutils.7 ${MANDIR}/man7
cp doasedit ${DPREFIX}/bin
cp doasedit.8 ${MANDIR}/man8
sed 's|@DOAS_CONF@|${DOAS_CONF}|g' vidoas >${DPREFIX}/bin/vidoas
diff --git a/doasutils.7 b/doasutils.7
new file mode 100644
index 0000000..0954117
--- /dev/null
+++ b/doasutils.7
@@ -0,0 +1,54 @@
+.\"
+.\" Copyright (c) 2022 Thomas Voss <mail@thomasvoss.com>
+.\"
+.\" Permission to use, copy, modify, and distribute this software for
+.\" any purpose with or without fee is hereby granted, provided that
+.\" the above copyright notice and this permission notice appear in all
+.\" copies.
+.\"
+.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL
+.\" WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE
+.\" AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
+.\" DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA
+.\" OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
+.\" TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+.\" PERFORMANCE OF THIS SOFTWARE.
+.\"
+.Dd November 15, 2022
+.Dt DOASUTILS 7
+.Os
+.Sh NAME
+.Nm doasutils
+.Nd tools to use alongside doas
+.Sh DESCRIPTION
+.Nm
+is a collection of utilities intended for use on a doas-based system.
+They allow you to perform a variety of potentially common tasks in a safer
+manner.
+.Pp
+The utilities are as follows:
+.Pp
+.Bl -tag -width Ds
+.It Xr doasedit 8
+Edit a text file requiring root access in your prefered editor, but without
+running your editor as the root user.
+.It Xr vidoas 8
+Edit the doas configuration file and check it for syntax errors before
+installing it.
+.El
+.Sh SEE ALSO
+.Xr doas 1 ,
+.Xr doasedit 8 ,
+.Xr vidoas 8
+.Pp
+.Lk https://git.thomasvoss.com/doasutils "Source Repository"
+.Sh HISTORY
+The utilities that form this collection were forked from a port of
+.Xr doas 1
+by
+.An Jesse Smith Aq Mt jessefrgsmith@yahoo.ca .
+The original utilities can be found at
+.Lk https://github.com/slicer69/doas .
+.Sh AUTHOR
+.An Thomas Voss Aq Mt mail@thomasvoss.com