rctladm(1M)

NAME

     rctladm - display or modify global state of system  resource
     controls

SYNOPSIS

     rctladm [-lu] [-e action] [-d action] [name...]

DESCRIPTION

     The rctladm command allows the examination and  modification
     of  active  resource  controls  on  the  running  system. An
     instance of a resource control is referred to  as  an  rctl.
     See  setrctl(2)  for further description of an rctl. Logging
     of rctl violations can be activated or  deactivated  system-
     wide and active rctls (and their state) can be listed.

OPTIONS

     The following options are supported:

     -d action

     -e action
           Disable (-d) or enable (-e) the global action  on  the
           specified rctls. If no rctl is specified, no action is
           taken and an error status is returned. You can use the
           special  token  all  with  the disable option to deac-
           tivate all global actions on a resource control.

           You can set the syslog action to a specific degree  by
           assigning  a  severity  level.  To  do  this,  specify
           syslog=level, where level is one of the string  tokens
           given  as valid severity levels in syslog(3C). You can
           omit the common LOG_ prefix on the severity level.

     -l    List available rctls with event  status.  This  option
           displays  the  global event actions available for each
           rctl, and by the action name used with the enable (-e)
           and disable (-d) options below. The global flag values
           for the control are also displayed.  If  one  or  more
           name operands are specified, only those rctls matching
           the given names is displayed.

           This is the default action if no  options  are  speci-
           fied.

     -u    Configure resource controls based on the  contents  of
           /etc/rctladm.conf. Any name operands are ignored.

OPERANDS

     The following operands are supported:

     name  The name of the rctl to operate on.  You  can  specify
           multiple  rctl names may be specified. If no names are
           specified, and the list  action  has  been  specified,
           then  all  rctls  are listed. If the enable or disable
           action is specified, one or more rctl  names  must  be
           specified.

EXAMPLES

     Example 1: Activating System Logging for Specific Violations

     The following command activates system logging of all viola-
     tions of task.max-lwps.

     example# rctladm -e syslog task.max-lwps
     example#

     Example 2: Examining Current Status of a Specific Resource

     The following command examines the  current  status  of  the
     task.max-lwps resource.

     example$ rctladm -l task.max-lwps
     task.max-lwps               syslog=DEBUG
     example$

EXIT STATUS

     The following exit values are returned:

     0     Successful completion.

     1     Fatal error occurred.

     2     Invalid command line options were specified

FILES

     /etc/rctladm.conf
           Each time rctladm is executed, it updates the contents
           of rctladm.conf with the current configuration.

ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWesu                     |
    |_____________________________|_____________________________|

SEE ALSO

     setrctl(2),              getrctl(2),               prctl(1),
     rctlblk_get_global_flags(3C), rctlblk_get_global_action(3C),
     attributes(5)

NOTES

     The base operating system provides a variety of controls  by
     default:

     process.max-address-space
     process.max-file-descriptor
     process.max-core-size
     process.max-stack-size
     process.max-data-size
     process.max-file-size
     process.max-cpu-time

     task.max-cpu-time
     task.max-lwps

     project.cpu-shares

     The default properties of the process resource controls  are
     described  on  setrlimit(2).  Task and project resource con-
     trols are unenforced by default.

     By default, there is no global logging of rctl violations.