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