rcapadm(8) 맨 페이지 - 윈디하나의 솔라나라

개요

섹션
맨 페이지 이름
검색(S)

rcapadm(8)

System Administration Commands                                      rcapadm(8)



NAME
       rcapadm - configure resource capping daemon

SYNOPSIS
       rcapadm


       rcapadm [ [-n] -E | -D]
            [-i {sample|mode}=value]....
            [-z zonename -m maxvalue]

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. See rcapd(8) for more information.


       In the current release of the  Solaris  operating  system,  rcapadm  is
       available  to  users  with  all  privileges  and  to users who have the
       Process Management profile in their list of profiles. The System Admin‐
       istrator role includes the Process Management profile.

OPTIONS
       -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.


       -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 run‐
           ning.


       -i {sample|mode}=value,....

           Set configuration for rcapd operations.  Two  parameters  that  are
           used by rcapd can be set by using this option.

           sample    The  interval  of  sampling resident set size for collec‐
                     tions. The default sample interval  is  30  seconds.  The
                     minimum value is 5 seconds.


           mode      Set  the  mode of operation for rcapd. You can either set
                     the mode for rcapd to just log the results of the scan or
                     enforce the rss caps by paging out resident pages.

                     The following values are allowed by mode:


                     log-only    Do  not  enforce  caps.  Log  the rss cap and
                                 usage statistics for all capped collections.


                     pageout     Pageout resident pages for processes of  col‐
                                 lections  that are above their rss caps. This
                                 is the default mode for rcapd(8).





       -m maxvalue

           Used in conjunction with the  -z  option.  Specifies  a  value  for
           rcap.max-rss, a dynamically-set cap on the usage of physical memory
           for the zone specified by -z. You can apply a scale (K, M, G, T) to
           the  value you specify. K means kilobyte; M, megabyte; G, gigabyte;
           and T, terabyte. For example, 100M is 100 megabytes.

           To remove an existing cap, specify 0M.


       -n

           Do not affect the running state of the resource capping daemon when
           enabling or disabling it.


       -z zonename

           Used  in  conjunction  with  the  -m option. Specifies the zone for
           which you are dynamically specifying a cap on physical memory usage
           (using -m).


       Note -



         To  set  a  persistent  cap  on  memory  usage  within  a  zone,  use
         zonecfg(8).


EXAMPLES
       Example 1 Configuring the  Resource  Capping  Daemon  with  Memory  Cap
       Enforcement With a 5 Second RSS Sampling Interval


         # rcapadm -E -i sample=5,mode=pageout


       Example  2  Configuring the Resource Capping Daemon With Log Mode and a
       60 Second RSS Sampling Interval


         # rcapadm -E -i sample=60,mode=log-only



       Example 3 Specifying a Resource Cap for a Zone



       The command shown below specifies the maximum amount of memory that can
       be  consumed by a specified zone. Note that this value lasts only until
       the next reboot. To set a persistent cap, use zonecfg(8).


         # rcapadm -z testzone -m 512M


EXIT STATUS
       The following exit values are returned:

       0    Successful completion. The modifications to the current configura‐
            tion 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(7) for descriptions of the following attributes:


       tab() box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) ATTRIBUTE  TYPEAT‐
       TRIBUTE VALUE _ Availabilitysystem/resource-mgmt/resource-caps _ Inter‐
       face StabilityCommitted



       The -z and -m options are committed interfaces.

SEE ALSO
       rcapstat(1), project(5), attributes(7), zones(7), rcapd(8), zonecfg(8)



Oracle Solaris 11.4               11 Dec 2020                       rcapadm(8)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3