rcapd(1m) [opensolaris man page]
rcapd(1M) System Administration Commands rcapd(1M) NAME
rcapd - resource cap enforcement daemon SYNOPSIS
rcapd [-d] DESCRIPTION
The rcapd daemon enforces resource caps on collections of processes. Per-project and per-zone physical memory caps are supported. For information about projects, see project(4). For zones information, see zones(5) 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 segments 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 physical 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. For a system with one or more zones, you can dynamically set the rcap.max-rss value for a zone with rcapadm(1M). To set a persistent cap on memory usage within a zone, you use zonecfg(1M). You 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)). 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 attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Availability |SUNWrcapu | +-----------------------------+-----------------------------+ |Interface Stability |Evolving | +-----------------------------+-----------------------------+ SEE ALSO
rcapstat(1), svcs(1), rcapadm(1M), zonecfg(1M), svcadm(1M), project(4), attributes(5), smf(5), zones(5) "Physical Memory Control Using the Resource Capping Daemon" in System Administration Guide: Solaris Containers-Resource Management, and Solaris Zones NOTES
If killed with SIGKILL, rcapd can leave processes in a stopped state. Use SIGTERM to cause rcapd to terminate properly. 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. The rcapd service is managed by the service management facility, smf(5), under the service identifier: svc:/system/rcap:default Administrative actions on this service, such as enabling, disabling, or requesting restart, can be performed using svcadm(1M). The ser- vice's status can be queried using the svcs(1) command. SunOS 5.11 19 Dec 2006 rcapd(1M)
Check Out this Related Man Page
rcapadm(1M) System Administration Commands rcapadm(1M) NAME
rcapadm - configure resource capping daemon SYNOPSIS
rcapadm rcapadm [ [-n] -E | -D] [ -i interval=value,...,interval=value] [-c percent] DESCRIPTION
The rcapadm command allows a user with the privileges described below to configure various attributes of the resource capping daemon. If used without arguments, rcapadm displays the current status of the resource capping daemon if it has been configured. See rcapd(1M) for more information. In the current release of the Solaris operating environment, rcapadm is available to users with all privileges and to users who have the Process Management profile in their list of profiles. The System Administrator role includes the Process Management profile. OPTIONS
-n Do not affect the running state of the resource capping daemon when enabling or disabling it. -E Enable the resource capping daemon so that it will be started each time the system is booted. Also start the resource capping daemon now, if the -n option is not specified and it is not currently running. -D Disable the resource capping daemon so that it will not be started when the system is booted. Also stop the resource capping daemon now, if the -n option is not specified and it is currently running. -i interval=value,...,interval=value Set intervals for various periodic operations performed by rcapd. All intervals are specified in seconds. You can set the following intervals: scan The interval at which rcapd scans for new processes. The default scan interval is every 15 seconds. The minimum value is 1 second. sample The interval of process resident set size sampling. The default sample interval is every 5 seconds. The minimum value is 1 second. report The interval at which various paging statistics are updated by rcapd, in seconds. These statistics can be viewed by using rcap- stat(1SRM). The default reporting interval is every 5 seconds. When the interval is set to 0, statistics will not be updated. Note - Paging refers to the act of relocating portions of memory, called pages, to or from physical memory. rcapd pages out the most infrequently used pages. config The reconfiguration interval, in seconds. At each reconfiguration event, rcapd checks its configuration file for updates, and scans the project databases for new project caps. The default reconfiguration interval is every 60 seconds. The minimum interval is 0. When the interval is set to 0, no periodic reconfiguration occurs, although the running daemon can still be reconfigured by sending it SIGHUP. -c percent Set the minimum physical memory utilization for memory cap enforcement. Caps will not be enforced until the physical memory available to processes is low. The percent value should be in the range 0 to 100. The minimum (and default) value is 0, which means that memory caps are always enforced. EXAMPLES
Example 1: Configuring the Resource Capping Daemon with Immediate Enforcement # rcapadm -E -i scan=15,sample=5,report=5,config=60 -c 0 EXIT STATUS
The following exit values are returned: 0 Successful completion. The modifications to the current configuration were valid and made successfully. 1 An error occurred. A fatal error occurred either in obtaining or modifying the resource capping configuration. 2 Invalid command-line options were specified. ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Availability |SUNWrcapu | +-----------------------------+-----------------------------+ |Interface Stability |Evolving | +-----------------------------+-----------------------------+ SEE ALSO
rcapstat(1), rcapd(1M), project(4), attributes(5) "Physical Memory Control Using the Resource Capping Daemon" in System Administration Guide: Network Services SunOS 5.10 10 Dec 2003 rcapadm(1M)