NAME

       semanage-fcontext - SELinux Policy Management file context tool

SYNOPSIS

       semanage  fcontext  [-h]  [-n] [-N] [-S STORE] [ --add ( -t TYPE -f FTYPE -r RANGE -s SEUSER | -e EQUAL )
       FILE_SPEC | --delete ( -t TYPE -f FTYPE | -e EQUAL ) FILE_SPEC | --deleteall | --extract | --list [-C]  |
       --modify ( -t TYPE -f FTYPE -r RANGE -s SEUSER | -e EQUAL ) FILE_SPEC ]

DESCRIPTION

       semanage  is  used  to  configure certain elements of SELinux policy without requiring modification to or
       recompilation from policy sources.  semanage fcontext is used to  manage the default file system labeling
       on an SELinux system.  This command maps file paths using regular expressions to SELinux labels.

       FILE_SPEC may contain either a fully qualified path, or a  Perl  compatible  regular  expression  (PCRE),
       describing  fully  qualified  path(s). The only PCRE flag in use is PCRE2_DOTALL, which causes a wildcard
       '.' to match anything, including a new line.  Strings representing  paths  are  processed  as  bytes  (as
       opposed to Unicode), meaning that non-ASCII characters are not matched by a single wildcard.

       Note,  that  file  context  definitions  specified  using  'semanage  fcontext'  (i.e. local file context
       modifications stored in file_contexts.local) have higher priority than those specified in policy modules.
       This means that whenever a match for given file path is  found  in  file_contexts.local,  no  other  file
       context definitions are considered.  Entries in file_contexts.local are processed from most recent one to
       the  oldest,  with  first  match  being  used  (as opposed to the most specific match, which is used when
       matching other file context definitions).  All regular expressions should therefore  be  as  specific  as
       possible, to avoid unintentionally impacting other parts of the filesystem.

OPTIONS

       -h, --help
              show this help message and exit

       -n, --noheading
              Do not print heading when listing the specified object type

       -N, --noreload
              Do not reload policy after commit

       -C, --locallist
              List local customizations

       -S STORE, --store STORE
              Select an alternate SELinux Policy Store to manage

       -a, --add
              Add a record of the specified object type

       -d, --delete
              Delete a record of the specified object type

       -m, --modify
              Modify a record of the specified object type

       -l, --list
              List records of the specified object type

       -E, --extract
              Extract customizable commands, for use within a transaction

       -D, --deleteall
              Remove all local customizations

       -e EQUAL, --equal EQUAL
              Substitute  target path with sourcepath when generating default label. This is used with fcontext.
              Requires source and target path arguments. The context labeling for the  target  subtree  is  made
              equivalent to that defined for the source.

       -f [{a,f,d,c,b,s,l,p}], --ftype [{a,f,d,c,b,s,l,p}]
              File Type. This is used with fcontext. Requires a file type as shown in the mode field by ls, e.g.
              use  'd'  to  match  only  directories or 'f' to match only regular files. The following file type
              options can be passed: f (regular file),d (directory),c (character  device),  b  (block  device),s
              (socket),l  (symbolic link),p (named pipe).  If you do not specify a file type, the file type will
              default to "all files".

       -s SEUSER, --seuser SEUSER
              SELinux user name

       -t TYPE, --type TYPE
              SELinux Type for the object

       -r RANGE, --range RANGE
              MLS/MCS Security Range (MLS/MCS Systems only) SELinux Range for SELinux login mapping defaults  to
              the SELinux user record range. SELinux Range for SELinux user defaults to s0.

EXAMPLE

       remember to run restorecon after you set the file context
       Add file-context for everything under /web
       # semanage fcontext -a -t httpd_sys_content_t "/web(/.*)?"
       # restorecon -R -v /web

       Substitute /home1 with /home when setting file context
       # semanage fcontext -a -e /home /home1
       # restorecon -R -v /home1

       For home directories under top level directory, for example /disk6/home,
       execute the following commands.
       # semanage fcontext -a -t home_root_t "/disk6"
       # semanage fcontext -a -e /home /disk6/home
       # restorecon -R -v /disk6

SEE ALSO

       selinux(8), semanage(8)

AUTHOR

       This man page was written by Daniel Walsh <dwalsh@redhat.com>

                                                    20130617                                semanage-fcontext(8)