From fb2b381355123c48cbdd21c52d2881e6f7f87a14 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jan=20=C5=A0afr=C3=A1nek?= <jsafrane@fedoraproject.org>
Date: Mon, 18 Jan 2010 13:27:12 +0000
Subject: [PATCH] Added README.Fedora to describe initscript integration

---
 README.Fedora  | 35 +++++++++++++++++++++++++++++++++++
 libcgroup.spec |  6 +++++-
 2 files changed, 40 insertions(+), 1 deletion(-)
 create mode 100644 README.Fedora

diff --git a/README.Fedora b/README.Fedora
new file mode 100644
index 0000000..2f64d60
--- /dev/null
+++ b/README.Fedora
@@ -0,0 +1,35 @@
+Libcgroup integration into Fedora
+=================================
+
+Apart from standard libcgroup features, Fedora adds support for starting system
+services in given control group(s).
+
+If a service init script
+1) uses daemon() function from /etc/init.d/functions to start the service
+2) and uses /etc/sysconfig/<service name> for its configuration,
+you can add CGROUP_DAEMON="<space separated list of groups>" to the
+/etc/sysconfig/<service name> to start the service in given group.
+
+
+Example
+-------
+How to start Apache web server in group cpu,cpuacct:/daemons/http:
+1. Configure your group in /etc/cgconfig.conf (see cgconfig.conf man page).
+2. Add following line to /etc/sysconfig/httpd:
+CGROUP_DAEMON="cpu,cpuacct:/daemons/http"
+
+During next boot (or after restart of cgconfig and httpd services), your http
+daemon and all its children should be started in the given groups.
+
+
+Details
+-------
+The daemon() function in /etc/init.d/functions was modified to start the daemon
+in control group(s) specified by CGROUP_DAEMON environment variable. Therefore it
+won't work on all services, but only those which satisfy the two aforementioned
+conditions.
+
+CGROUP_DAEMON can contain more than one control group, separate them with space
+then:
+CGROUP_DAEMON="cpu:/daemons/http cpuacct:/daemons"
+
diff --git a/libcgroup.spec b/libcgroup.spec
index 94ca4a9..80e95d9 100644
--- a/libcgroup.spec
+++ b/libcgroup.spec
@@ -4,10 +4,11 @@ Name: libcgroup
 Summary: Tools and libraries to control and monitor control groups
 Group: Development/Libraries
 Version: 0.34
-Release: 3%{?dist}
+Release: 4%{?dist}
 License: LGPLv2+
 URL: http://libcg.sourceforge.net/
 Source0: http://downloads.sourceforge.net/libcg/%{name}-%{version}.tar.bz2
+Source1: README.Fedora
 Patch0: fedora-fix-initscripts.patch
 Patch1: fedora-workaround-for-sysdefault.patch
 Patch2: fedora-config.patch
@@ -121,6 +122,9 @@ fi
 
 
 %changelog
+* Mon Jan 18 2010 Jan Safranek <jsafrane@redhat.com> 0.34-4
+- Added README.Fedora to describe initscript integration
+
 * Mon Oct 19 2009 Jan Safranek <jsafrane@redhat.com> 0.34-3
 - Change the default configuration to mount everything to /cgroup