libcgroup: Add cgrulesengd man page

From: Jan Safranek <jsafrane@redhat.com>

Add cgrulesengd man page and install it on 'make install'.

Rebased to lastes trunk and fixed file name.

Signed-off-by: Jan Safranek <jsafrane@redhat.com>
Signed-off-by: Dhaval Giani <dhaval@linux.vnet.ibm.com>
git-svn-id: https://libcg.svn.sourceforge.net/svnroot/libcg/trunk@353 4f4bb910-9a46-0410-90c8-c897d4f1cd53

diff --git a/Makefile.in b/Makefile.in
index 4ceea4b9805c934097de2a8a9ae77c61459ed57b..f5e6a6d534a4afd58af5bc63feb4c3d32c27eaab 100644 (file)
--- a/Makefile.in
+++ b/Makefile.in
@@ -80,6 +80,7 @@ install: $(TARGETS)
        $(INSTALL) -D doc/man/cgconfig.conf.5 $(DESTDIR)$(mandir)/man5/cgconfig.conf.5
        $(INSTALL) -D doc/man/cgrules.conf.5 $(DESTDIR)$(mandir)/man5/cgrules.conf.5
        $(INSTALL) -D doc/man/cgconfigparser.8 $(DESTDIR)$(mandir)/man8/cgconfigparser.8
+       $(INSTALL) -D doc/man/cgrulesengd.8 $(DESTDIR)$(mandir)/man8/cgrulesengd.8
        $(INSTALL) -D pam_cgroup.so $(DESTDIR)$(libdir)/security/pam_cgroup.so
 
 uninstall: libcgroup.so
@@ -92,6 +93,7 @@ uninstall: libcgroup.so
        rm -f $(DESTDIR)$(bindir)/cgclassify
        rm -f $(DESTDIR)$(bindir)/cgrulesengd
        rm -f $(DESTDIR)$(mandir)/man5/cgconfig.conf.5
+       rm -f $(DESTDIR)$(mandir)/man8/cgrulesengd.8
        rm -f $(DESTDIR)$(libdir)/security/pam_cgroup.so
 
 clean:

diff --git a/doc/man/cgrulesengd.8 b/doc/man/cgrulesengd.8
new file mode 100644 (file)
index 0000000..2e4f60c
--- /dev/null
+++ b/doc/man/cgrulesengd.8
@@ -0,0 +1,60 @@
+.\" Copyright (C) 2009 Red Hat, Inc. All Rights Reserved.
+.\" Written by Jan Safranek <jsafrane@redhat.com>.
+.TH CGRULESENGD  8 2009-02-18 "Linux" "libcgroup Manual"
+.SH NAME
+cgrulesengd \- control group rules daemon
+
+.SH SYNOPSIS
+\fBcgrulesengd\fR [options]
+
+.SH DESCRIPTION
+\fBcgrulesengd\fR is a daemon, which distributes processes to control groups. When
+any process changes its effective UID or GID, \fBcgrulesengd\fR inspects list
+of rules loaded from \fIcgrules.conf\fR file and moves the process to
+the appropriate control group.
+
+The list of rules is read during the daemon startup and are cached in daemon's memory.
+The daemon reloads the list of rules when it receives SIGUSR2 signal.
+
+.SH OPTIONS
+.TP
+.B -h|--help
+Display help.
+.TP
+.B -f <path>|--logfile=<path>
+Write log messages to the given log file. When '-' is used as <path>, log messages
+are written to the standard output. Both '\fB-f\fR' and '\fB-s\fR' can be used together then logs
+are sent to both destinations.
+.TP
+.B -s[facility]|--syslog=[facility]
+Write log messages to syslog. The default facility is DAEMON. Both '\fB-f\fR'
+and '\fB-s\fR' can be used together then logs are sent to both destinations.
+.TP
+.B -n|--nodaemon
+Don't fork the daemon, stay in foreground.
+.TP
+.B -v|--verbose
+Display more log messages. This option can be used twice to enable even more log
+messages.
+.TP
+.B -q|--quiet
+Display less log messages. This option can be used twice to enable even less log
+messages and log errors only.
+.TP
+.B -Q|--nolog
+Disable logging.
+.TP
+.B -d|--debug
+Equivalent to '-nvvf -', i.e. don't fork the daemon, display all log messages and
+write them to the standard output.
+
+.SH FILES
+.LP
+.PD .1v
+.TP 20
+.B /etc/cgrules.conf
+.TP
+the default libcgroup configuration file
+
+.SH SEE ALSO
+cgrules.conf (5)