aboutsummaryrefslogtreecommitdiffstats
path: root/libselinux/man/man3/setfilecon.3
diff options
context:
space:
mode:
Diffstat (limited to 'libselinux/man/man3/setfilecon.3')
-rw-r--r--libselinux/man/man3/setfilecon.354
1 files changed, 33 insertions, 21 deletions
diff --git a/libselinux/man/man3/setfilecon.3 b/libselinux/man/man3/setfilecon.3
index 18030cd2..7da024ba 100644
--- a/libselinux/man/man3/setfilecon.3
+++ b/libselinux/man/man3/setfilecon.3
@@ -1,41 +1,53 @@
.TH "setfilecon" "3" "1 January 2004" "russell@coker.com.au" "SELinux API documentation"
.SH "NAME"
setfilecon, fsetfilecon, lsetfilecon \- set SELinux security context of a file
-
+.
.SH "SYNOPSIS"
.B #include <selinux/selinux.h>
.sp
.BI "int setfilecon(const char *" path ", security_context_t "con );
-
+.sp
.BI "int lsetfilecon(const char *" path ", security_context_t "con );
-
+.sp
.BI "int fsetfilecon(int "fd ", security_context_t "con );
-
+.
.SH "DESCRIPTION"
-.B setfilecon
+.BR setfilecon ()
sets the security context of the file system object.
-.B lsetfilecon
+.BR lsetfilecon ()
is identical to setfilecon, except in the case of a symbolic link, where the
link itself has it's context set, not the file that it refers to.
-.B fsetfilecon
+.BR fsetfilecon ()
is identical to setfilecon, only the open file pointed to by filedes (as
-returned by open(2)) has it's context set in place of path.
-
+returned by
+.BR open (2))
+has it's context set in place of path.
+.
.SH "RETURN VALUE"
-On success, zero is returned. On failure, -1 is returned and errno is
-set appropriately.
-
+On success, zero is returned. On failure, \-1 is returned and
+.I errno
+is set appropriately.
+.
+.SH "ERRORS"
If there is insufficient space remaining to store the extended
-attribute, errno is set to either ENOSPC, or EDQUOT if quota enforce-
-ment was the cause.
-
-If extended attributes are not supported by the filesystem, or are dis-
-abled, errno is set to ENOTSUP.
-
-The errors documented for the stat(2) system call are also applicable
-here.
-
+attribute,
+.I errno
+is set to either
+.BR ENOSPC ,
+or
+.B EDQUOT
+if quota enforcement was the cause.
+
+If extended attributes are not supported by the filesystem, or are disabled,
+.I errno
+is set to
+.BR ENOTSUP .
+
+The errors documented for the
+.BR stat (2)
+system call are also applicable here.
+.
.SH "SEE ALSO"
.BR selinux "(3), " freecon "(3), " getfilecon "(3), " setfscreatecon "(3)"