rcapd(1M)
NAME
rcapd - resource cap enforcement daemon
SYNOPSIS
rcapd [-d]
DESCRIPTION
The rcapd daemon enforces resource caps on collections of
processes. Per-project physical memory caps are supported.
For information about projects, see project(4).
When the resident set size (RSS) of a collection of
processes exceeds its cap, rcapd takes action and reduces
the RSS of the collection.
The virtual memory system divides physical memory into seg-
ments known as pages. To read data from a file into memory,
the virtual memory system reads in individual pages. To
reduce resource consumption, the daemon can page out, or
relocate, infrequently used pages to an area outside of phy-
sical memory.
In the project file, caps are defined for projects that have
positive values for the following project attribute:
rcap.max-rss
The total amount of physical memory, in bytes,
that is available to the project's member
processes
See project(4) for a description of project attributes.
You can configure rcapd through the use of rcapadm(1M). The
daemon can be monitored with rcapstat(1). Configuration
changes are incorporated into rcapd by sending it SIGHUP
(see kill(1)), or according to the configuration interval
(see rcapadm(1M)).
rcapd is an optional feature.
OPTIONS
The following option is supported:
-d Enable debug mode. Messages are displayed on the
invoking user's terminal.
EXAMPLES
Example 1: Setting Resident Set Size Cap Attribute
The following line in the /etc/project database sets an RSS
cap of 1073741824 bytes for a project named foo.
foo:100::foo,root::rcap.max-rss=10737418240
EXIT STATUS
The following exit values are returned:
0 Successful completion.
1 An error occurred.
2 Invalid command-line options were specified.
FILES
/etc/project
Project database.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWrcapu |
|_____________________________|_____________________________|
| Interface Stability | Evolving |
|_____________________________|_____________________________|
SEE ALSO
rcapstat(1), rcapadm(1M), project(4), attributes(5)
"Physical Memory Control Using the Resource Capping Daemon"
in System Administration Guide: Resource Management and Net-
work Services
NOTES
If killed with SIGKILL, rcapd can leave processes in a
stopped state. Use SIGTERM to cause rcapd to terminate prop-
erly.
A collection's RSS can exceed its cap for some time before
the cap is enforced, even if sufficient pageable memory is
available. This period of time can be reduced by shortening
the RSS sampling interval with rcapadm.
Man(1) output converted with
man2html