aboutsummaryrefslogtreecommitdiffstats
path: root/README
blob: e5e34b7169dd214c7febcd2f2f6bb5fef224c31f (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
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)