selinux/libselinux/man/man3/selinux_restorecon_set_sehandle.3
Richard Haines bdd4e6d2b1 libselinux: Add selinux_restorecon function
The selinux_restorecon(3) man page details this function.

It has been built using the work from Android where an SHA1 hash
of the specfiles is held in an extended attribute to enhance
performance. Also contains components from policycoreutils/setfiles.

The utils/selinux_restorecon.c utility demonstrates the functionality.

Signed-off-by: Richard Haines <richard_c_haines@btinternet.com>
2016-02-17 09:12:50 -05:00

40 lines
1.1 KiB
Groff

.TH "selinux_restorecon_set_sehandle" "3" "20 Oct 2015" "Security Enhanced Linux" "SELinux API documentation"
.SH "NAME"
selinux_restorecon_set_sehandle \- set a labeling handle for use by
.BR selinux_restorecon (3)
.
.SH "SYNOPSIS"
.B #include <selinux/restorecon.h>
.br
.B #include <selinux/label.h>
.sp
.BI "void selinux_restorecon_set_sehandle(struct selabel_handle *" handle ");"
.in +\w'void selinux_restorecon_set_sehandle('u
.
.SH "DESCRIPTION"
.BR selinux_restorecon_set_sehandle ()
sets the
.I handle
to be use by
.BR selinux_restorecon (3)
when relabeling files.
.sp
.BR selinux_restorecon_set_sehandle ()
is generally used when customised
.BR selabel_open (3)
parameters are required to perform relabeling operations with
.BR selinux_restorecon (3).
.sp
.BR selinux_restorecon_set_sehandle ()
will output to the default SELinux log information regarding whether a digest
is available or not. If it were available, the message will contain the SHA1
digest and a list of specfiles used to compute the digest.
.
.SH "SEE ALSO"
.BR selinux_restorecon (3),
.br
.BR selinux_restorecon_set_exclude_list (3),
.br
.BR selinux_restorecon_default_handle (3)