aboutsummaryrefslogtreecommitdiffstats
path: root/README
diff options
context:
space:
mode:
authorMattias Andrée <maandree@kth.se>2021-01-31 16:25:38 +0100
committerMattias Andrée <maandree@kth.se>2021-01-31 16:25:38 +0100
commit4b919350b70451e1d93d6ecfe485bdaf3aace38b (patch)
treed744fff823c2a17f9e99d87f274d632e34705e4e /README
parentAdd man page (diff)
downloadasroot-4b919350b70451e1d93d6ecfe485bdaf3aace38b.tar.gz
asroot-4b919350b70451e1d93d6ecfe485bdaf3aace38b.tar.bz2
asroot-4b919350b70451e1d93d6ecfe485bdaf3aace38b.tar.xz
Add README and m fixes to man page
Signed-off-by: Mattias Andrée <maandree@kth.se>
Diffstat (limited to 'README')
-rw-r--r--README35
1 files changed, 35 insertions, 0 deletions
diff --git a/README b/README
new file mode 100644
index 0000000..01c8b13
--- /dev/null
+++ b/README
@@ -0,0 +1,35 @@
+NAME
+ asroot - run a process as the root user
+
+SYNOPSIS
+ asroot [-e] command [argument] ...
+
+DESCRIPTION
+ The asroot utility asks for the user's password and runs the specified
+ command with sanitised and updated environment variables.
+
+ Only users in the wheel group are allowed to run the asroot utility,
+ unless it is installed with non-standard permissions.
+
+OPTIONS
+ The asroot utility conforms to the Base Definitions volume of
+ POSIX.1-2017, Section 12.2, Utility Syntax Guidelines.
+
+ The following option is supported:
+
+ -e Keep the environment variables as is. Neither sanitise nor
+ update them.
+
+OPERANDS
+ The following operands are supported:
+
+ command
+ The command that shall be run with as the root user. This will
+ be both the process image and the process's zeroth command line
+ argument.
+
+ argument ...
+ Command line arguments for the command to run.
+
+SEE ALSO
+ sudo(8), doas(1), su(1)