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 informa-
tion.
In Solaris 9, rcapadm is available to users who have the
Process Management profile in their list of profiles. The
System Administrator role includes the Process Management
profile.
The resource capping daemon (rcapd(1M)) is an optional
feature.
OPTIONS
-n Do not affect the running state of the resource cap-
ping 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 per-
formed 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 sam-
pling. 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 statis-
tics can be viewed by using rcapstat(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 reconfigura-
tion 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 success-
fully.
1 An error occurred. A fatal error occurred either in
obtaining or modifying the resource capping configura-
tion.
2 Invalid command-line options were specified.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
____________________________________________________________
| 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: Resource Management and Net-
work Services
Man(1) output converted with
man2html