policycoreutils: genhomedircon: manual page improvements

The following patch aims to improve the manual page (section 8) for the
"genhomedircon" script (policycoreutils).

- remove probably redundant GNU licence notice;
- try to further clarify the functionality made available by the
  "genhomedircon" script as well as all the configurable options that
  control its execution and affect its behavior;
- extend the references section (SEE ALSO).

Signed-off-by: Guido Trentalancia <guido@trentalancia.com>
Signed-off-by: Eric Paris <eparis@redhat.com>
This commit is contained in:
Guido Trentalancia 2012-08-22 12:48:30 +02:00 committed by Eric Paris
parent f05a71b92d
commit 876f5faede

View File

@ -1,37 +1,24 @@
.\" Hey, Emacs! This is an -*- nroff -*- source file.
.\" Copyright (c) 2010 Dan Walsh <dwalsh@redhat.com>
.\"
.\" This is free documentation; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License as
.\" published by the Free Software Foundation; either version 2 of
.\" the License, or (at your option) any later version.
.\"
.\" The GNU General Public License's references to "object code"
.\" and "executables" are to be interpreted as the output of any
.\" document formatting or typesetting system, including
.\" intermediate and printed output.
.\"
.\" This manual is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public
.\" License along with this manual; if not, write to the Free
.\" Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139,
.\" USA.
.\"
.\"
.TH GENHOMEDIRCON "8" "May 2010" "Security Enhanced Linux" "SELinux"
.TH GENHOMEDIRCON "12" "Sep 2011" "Security Enhanced Linux" "SELinux"
.SH NAME
genhomedircon \- generate SELinux file context configuration entries for user home directories
.SH SYNOPSIS
.B genhomedircon
is a script that executes semodule to rebuild policy and create the
labels for HOMEDIRS based on home directories returned by the getpw calls.
is a script that executes
.B semodule
to rebuild the currently active SELinux policy (without reloading it) and to create the
labels for each user home directory based on directory paths returned by calls to getpwent().
This functionality is enabled via the usepasswd flag in /etc/selinux/semanage.conf.
The latter functionality depends on the "usepasswd" parameter being set to "true" (default)
in /etc/selinux/semanage.conf.
This script is usually executed by
.B semanage
although this default behavior can be optionally modified by setting to "true" the
"disable-genhomedircon" in /etc/selinux/semanage.conf.
.SH AUTHOR
This manual page was written by
.I Dan Walsh <dwalsh@redhat.com>
.SH "SEE ALSO"
semanage.conf(5), semodule(8), semanage(8), getpwent(3), getpwent_r(3)