From ff14faea7e2b9be2cd1b15d8c86f80e0d5ff5461 Mon Sep 17 00:00:00 2001 From: Thomas Voss Date: Tue, 15 Nov 2022 12:57:00 +0100 Subject: Add the doasutils(7) manual --- Makefile | 3 ++- doasutils.7 | 54 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 56 insertions(+), 1 deletion(-) create mode 100644 doasutils.7 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 +.\" +.\" 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 -- cgit v1.2.3