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

개요

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

rcapadm(8)

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 us‐
                                 age 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 0.


       -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  En‐
       forcement 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               30 Mar 2023                       rcapadm(8)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3