chcon - Man Page
change file security context
Examples (TL;DR)
- View security context of a file:
ls [-lZ|-l --context] path/to/file - Change the security context of a target file, using a reference file:
chcon --reference reference_file target_file - Change the full SELinux security context of a file:
chcon user:role:type:range/level filename - Change only the user part of SELinux security context:
chcon [-u|--user] user filename - Change only the role part of SELinux security context:
chcon [-r|--role] role filename - Change only the type part of SELinux security context:
chcon [-t|--type] type filename - Change only the range/level part of SELinux security context:
chcon [-l|--range] range/level filename
Synopsis
chcon [OPTION]... CONTEXT FILE...
chcon [OPTION]... [-u USER] [-r ROLE] [-l RANGE] [-t TYPE] FILE...
chcon [OPTION]... --reference=RFILE FILE...
Description
Change the SELinux security context of each FILE to CONTEXT. With --reference, change the security context of each FILE to that of RFILE.
Mandatory arguments to long options are mandatory for short options too.
- --dereference
affect the referent of each symbolic link (this is the default), rather than the symbolic link itself
- -h, --no-dereference
affect symbolic links instead of any referenced file
- -u, --user=USER
set user USER in the target security context
- -r, --role=ROLE
set role ROLE in the target security context
- -t, --type=TYPE
set type TYPE in the target security context
- -l, --range=RANGE
set range RANGE in the target security context
- --no-preserve-root
do not treat '/' specially (the default)
- --preserve-root
fail to operate recursively on '/'
- --reference=RFILE
use RFILE's security context rather than specifying a CONTEXT value
- -R, --recursive
operate on files and directories recursively
- -v, --verbose
output a diagnostic for every file processed
The following options modify how a hierarchy is traversed when the -R option is also specified. If more than one is specified, only the final one takes effect. -P is the default.
- -H
if a command line argument is a symlink to a directory, traverse it
- -L
traverse every symbolic link to a directory encountered
- -P
do not traverse any symbolic links
- --help
display this help and exit
- --version
output version information and exit
Author
Written by Russell Coker and Jim Meyering.
Reporting Bugs
Report bugs to: <bug-coreutils@gnu.org>.
Report any translation bugs to: <https://translationproject.org/team/>.
GNU coreutils home page: <https://www.gnu.org/software/coreutils/>
General help using GNU software: <https://www.gnu.org/gethelp/>
Copyright
Copyright © 2026 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.
See Also
Full documentation <https://www.gnu.org/software/coreutils/chcon>
or available locally via: info '(coreutils) chcon invocation'