summaryrefslogtreecommitdiffstats
path: root/man/runcon.1
blob: 8380026efa47c12ec306ba82dc3126431277544a (plain)
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
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.48.5.
.TH RUNCON "1" "August 2023" "GNU coreutils 9.4" "User Commands"
.SH NAME
runcon \- run command with specified security context
.SH SYNOPSIS
.B runcon
\fI\,CONTEXT COMMAND \/\fR[\fI\,args\/\fR]
.br
.B runcon
[ \fI\,-c \/\fR] [\fI\,-u USER\/\fR] [\fI\,-r ROLE\/\fR] [\fI\,-t TYPE\/\fR] [\fI\,-l RANGE\/\fR] \fI\,COMMAND \/\fR[\fI\,args\/\fR]
.SH DESCRIPTION
Run COMMAND with completely-specified CONTEXT, or with current or
transitioned security context modified by one or more of LEVEL,
ROLE, TYPE, and USER.
.PP
If none of \fI-c\fR, \fI-t\fR, \fI-u\fR, \fI-r\fR, or \fI-l\fR, is specified,
the first argument is used as the complete context.  Any additional
arguments after \fICOMMAND\fR are interpreted as arguments to the
command.
.PP
Note that only carefully-chosen contexts are likely to successfully
run.
.PP
Run a program in a different SELinux security context.
With neither CONTEXT nor COMMAND, print the current security context.
.PP
Mandatory arguments to long options are mandatory for short options too.
.TP
CONTEXT
Complete security context
.TP
\fB\-c\fR, \fB\-\-compute\fR
compute process transition context before modifying
.TP
\fB\-t\fR, \fB\-\-type\fR=\fI\,TYPE\/\fR
type (for same role as parent)
.TP
\fB\-u\fR, \fB\-\-user\fR=\fI\,USER\/\fR
user identity
.TP
\fB\-r\fR, \fB\-\-role\fR=\fI\,ROLE\/\fR
role
.TP
\fB\-l\fR, \fB\-\-range\fR=\fI\,RANGE\/\fR
levelrange
.TP
\fB\-\-help\fR
display this help and exit
.TP
\fB\-\-version\fR
output version information and exit
.SS "Exit status:"
.TP
125
if the runcon command itself fails
.TP
126
if COMMAND is found but cannot be invoked
.TP
127
if COMMAND cannot be found
.TP
\-
the exit status of COMMAND otherwise
.SH AUTHOR
Written by Russell Coker.
.SH "REPORTING BUGS"
GNU coreutils online help: <https://www.gnu.org/software/coreutils/>
.br
Report any translation bugs to <https://translationproject.org/team/>
.SH COPYRIGHT
Copyright \(co 2023 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
.br
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
.SH "SEE ALSO"
Full documentation <https://www.gnu.org/software/coreutils/runcon>
.br
or available locally via: info \(aq(coreutils) runcon invocation\(aq