You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

67 lines
1.7 KiB

.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 ", char *" con );
.sp
.BI "int setfilecon_raw(const char *" path ", char *" con );
.sp
.BI "int lsetfilecon(const char *" path ", char *" con );
.sp
.BI "int lsetfilecon_raw(const char *" path ", char *" con );
.sp
.BI "int fsetfilecon(int "fd ", char *" con );
.sp
.BI "int fsetfilecon_raw(int "fd ", char *" con );
.
.SH "DESCRIPTION"
.BR setfilecon ()
sets the security context of the file system object.
.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.
.BR fsetfilecon ()
is identical to setfilecon, only the open file pointed to by filedes (as
returned by
.BR open (2))
has it's context set in place of path.
.BR setfilecon_raw (),
.BR lsetfilecon_raw (),
and
.BR fsetfilecon_raw ()
behave identically to their non-raw counterparts but do not perform context
translation.
.
.SH "RETURN VALUE"
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,
.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)"