From d529707547ae73fdd19221a43fdd0f7438e21b92 Mon Sep 17 00:00:00 2001 From: Mattias Andrée Date: Fri, 19 Dec 2025 16:44:15 +0100 Subject: First commit MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Mattias Andrée --- README | 36 ++++++++++++++++++++++++++++++++++++ 1 file changed, 36 insertions(+) create mode 100644 README (limited to 'README') diff --git a/README b/README new file mode 100644 index 0000000..e5e34b7 --- /dev/null +++ b/README @@ -0,0 +1,36 @@ +NAME + gasroot - run a process as the root user + +SYNOPSIS + gasroot [-e] command [argument] ... + +DESCRIPTION + The gasroot utility asks for the user's password, using a graphical + interface, 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 + asroot(8), key2root(8), sudo(8), doas(1), su(1) -- cgit v1.2.3-70-g09d2