Administering the Resource Capping Daemon With rcapadm

This section contains procedures for configuring the resource capping daemon with rcapadm. See rcapd Configuration and the rcapadm(1M) man page for more information.

If used without arguments, rcapadm displays the current status of the resource capping daemon if it has been configured.

How to Set the Memory Cap Enforcement Threshold

Caps can be configured so that they will not be enforced until the physical memory available to processes is low. See Memory Cap Enforcement Threshold for more information.

The minimum (and default) value is 0, which means that memory caps are always enforced. To set a different minimum, follow this procedure.

1. Become superuser.

2. Use the -c option of rcapadm to set a different physical memory utilization value for memory cap enforcement.

   # rcapadm -c percent

   percent is in the range 0 to 100. Higher values are less restrictive. A higher value means capped project workloads can execute without having caps enforced until the system's memory utilization exceeds this threshold.

To display the current physical memory utilization and the cap enforcement threshold, see Reporting Memory Utilization and the Memory Cap Enforcement Threshold.

How to Set Operation Intervals

rcapd Operation Intervals contains information about the intervals for the periodic operations performed by rcapd. To set operation intervals using rcapadm, follow this procedure.

1. Become superuser.

2. Use the -i option to set interval values.

   # rcapadm -i interval=value,...,interval=value

All interval values are specified in seconds.

How to Enable Resource Capping

There are two ways to enable resource capping on your system.

1. Become superuser.

2. Enable the resource capping daemon in one of the following ways:

   • To enable the resource capping daemon so that it will be started now and also be started each time the system is booted, type:

     # rcapadm -E

   • To enable the resource capping daemon at boot without starting it now, also specify the -n option:

     # rcapadm -n -E

How to Disable Resource Capping

There are two ways to disable resource capping on your system.

1. Become superuser.

2. Disable the resource capping daemon in one of the following ways:

   • To disable the resource capping daemon so that it will be stopped now and not be started when the system is booted, type:

     # rcapadm -D

   • To disable the resource capping daemon without stopping it, also specify the -n option:

     # rcapadm -n -D

Use rcapadm -D to safely disable rcapd. If the daemon is killed (see the kill(1) man page), processes might be left in a stopped state and need to be manually restarted. To resume a process running, use the prun command. See the prun(1) man page for more information.