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