==============================================================
Test Suite for the Control Group Freezer and Signal Subsystems
==============================================================
Author: Matt Helsley
Date: June, 2008
Last update: January 19th, 2009
About:
------
These tests exercise the freezer and signal subsystems (aka controllers)
available since kernel 2.6.28 or later.
These tests exercise the freezer control group controller. This controller is
a useful for implementing container checkpointing or if you wish to gradually
freeze tasks in cgroups before doing a suspend.
The common case is embodied in the freeze_thaw.sh test file. However,
the scripts are also designed to test a few obscure cases such as:
	freeze self -- freeze the control group that the current process is
		in
	freeze cancellation -- freeze but then backout of the freeze processing
		and issue a "thaw" command before reaching the frozen state
	signalling freezing/frozen tasks -- this should delay delivery of the
		signal until the task is unfrozen
	vfork -- The vfork system call introduces an obscure special case for
		the freezer kernel code. This test case attempts to trigger any
		unanticipated corner cases involving vfork.
NOTES:
	Using the cgroup freezer prevents the tasks from being automatically
		woken up upon a "Power Management Resume". You will need to
		manually unfreeze cgroups.
	These tests assume that most of the library functions in
	libcgroup_subsys take much less than $sample_sleep time to execute. If
	this assumption is incorrect then many of these tests may fail in
	unusual ways. So make sure $sample_sleep is a "reasonable" amount of
	time.
Building:
---------
Run the command line:
	make all
Installing:
-----------
Run the command line:
Cleaning:
---------
Run the command line:
	make clean
Running:
--------
Run the command line:
	./run.sh
Results:
--------
The results should show up as PASS/FAIL in the LTP logs for each script. The
output frequently will be more specific (beyond which test script failed)
about where and what failure occurred.