1semanage-fcontext(8) semanage-fcontext(8)
2
3
4
6 semanage-fcontext - SELinux Policy Management file context tool
7
8
10 semanage fcontext [-h] [-n] [-N] [-S STORE] [ --add ( -t TYPE -f FTYPE
11 -r RANGE -s SEUSER | -e EQUAL ) FILE_SPEC | --delete ( -t TYPE -f FTYPE
12 | -e EQUAL ) FILE_SPEC | --deleteall | --extract | --list [-C] | --mod‐
13 ify ( -t TYPE -f FTYPE -r RANGE -s SEUSER | -e EQUAL ) FILE_SPEC ]
14
15
17 semanage is used to configure certain elements of SELinux policy with‐
18 out requiring modification to or recompilation from policy sources.
19 semanage fcontext is used to manage the default file system labeling
20 on an SELinux system. This command maps file paths using regular ex‐
21 pressions to SELinux labels.
22
23 FILE_SPEC may contain either a fully qualified path, or a Perl compati‐
24 ble regular expression (PCRE), describing fully qualified path(s). The
25 only PCRE flag in use is PCRE2_DOTALL, which causes a wildcard '.' to
26 match anything, including a new line. Strings representing paths are
27 processed as bytes (as opposed to Unicode), meaning that non-ASCII
28 characters are not matched by a single wildcard.
29
30 Note, that file context definitions specified using 'semanage fcontext'
31 (i.e. local file context modifications stored in file_contexts.local)
32 have higher priority than those specified in policy modules. This
33 means that whenever a match for given file path is found in file_con‐
34 texts.local, no other file context definitions are considered. Entries
35 in file_contexts.local are processed from most recent one to the old‐
36 est, with first match being used (as opposed to the most specific
37 match, which is used when matching other file context definitions).
38 All regular expressions should therefore be as specific as possible, to
39 avoid unintentionally impacting other parts of the filesystem.
40
41
43 -h, --help
44 show this help message and exit
45
46 -n, --noheading
47 Do not print heading when listing the specified object type
48
49 -N, --noreload
50 Do not reload policy after commit
51
52 -C, --locallist
53 List local customizations
54
55 -S STORE, --store STORE
56 Select an alternate SELinux Policy Store to manage
57
58 -a, --add
59 Add a record of the specified object type
60
61 -d, --delete
62 Delete a record of the specified object type
63
64 -m, --modify
65 Modify a record of the specified object type
66
67 -l, --list
68 List records of the specified object type
69
70 -E, --extract
71 Extract customizable commands, for use within a transaction
72
73 -D, --deleteall
74 Remove all local customizations
75
76 -e EQUAL, --equal EQUAL
77 Substitute target path with sourcepath when generating default
78 label. This is used with fcontext. Requires source and target
79 path arguments. The context labeling for the target subtree is
80 made equivalent to that defined for the source.
81
82 -f [{a,f,d,c,b,s,l,p}], --ftype [{a,f,d,c,b,s,l,p}]
83 File Type. This is used with fcontext. Requires a file type as
84 shown in the mode field by ls, e.g. use 'd' to match only direc‐
85 tories or 'f' to match only regular files. The following file
86 type options can be passed: f (regular file),d (directory),c
87 (character device), b (block device),s (socket),l (symbolic
88 link),p (named pipe). If you do not specify a file type, the
89 file type will default to "all files".
90
91
92 -s SEUSER, --seuser SEUSER
93 SELinux user name
94
95 -t TYPE, --type TYPE
96 SELinux Type for the object
97
98 -r RANGE, --range RANGE
99 MLS/MCS Security Range (MLS/MCS Systems only) SELinux Range for
100 SELinux login mapping defaults to the SELinux user record range.
101 SELinux Range for SELinux user defaults to s0.
102
103
105 remember to run restorecon after you set the file context
106 Add file-context for everything under /web
107 # semanage fcontext -a -t httpd_sys_content_t "/web(/.*)?"
108 # restorecon -R -v /web
109
110 Substitute /home1 with /home when setting file context
111 # semanage fcontext -a -e /home /home1
112 # restorecon -R -v /home1
113
114 For home directories under top level directory, for example /disk6/home,
115 execute the following commands.
116 # semanage fcontext -a -t home_root_t "/disk6"
117 # semanage fcontext -a -e /home /disk6/home
118 # restorecon -R -v /disk6
119
120
122 selinux(8), semanage(8)
123
124
126 This man page was written by Daniel Walsh <dwalsh@redhat.com>
127
128
129
130 20130617 semanage-fcontext(8)