rctladm man page on SmartOS

Man page or keyword search:  
man Server   16655 pages
apropos Keyword Search (all sections)
Output format
SmartOS logo
[printable version]

RCTLADM(1M)							   RCTLADM(1M)

       rctladm - display or modify global state of system resource controls

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

       The  rctladm  command allows the examination and modification of active
       resource controls on the running system. An instance of a resource con‐
       trol  is referred to as an rctl. See setrctl(2) for a description of an
       rctl; see resource_controls(5) for a list of the rctls supported in the
       current release of the Solaris operating system. Logging of rctl viola‐
       tions can be activated or deactivated system-wide and active rctls (and
       their state) can be listed.

       An rctladm command without options is the equivalent of an rctladm with
       the -l option. See the description of -l below.

       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 dis‐
	   able option to deactivate 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 sys‐
	   log(3C).  You can omit the  common  LOG_  prefix  on	 the  severity
	   level.  Note	 that  not  all	 rctls	support the syslog action. See


	   List information about rctls. The name, global  event  actions  and
	   statuses, and global flags are displayed. If one or more name oper‐
	   ands are specified, only those rctls matching the  names  are  dis‐


	   Configure  resource	controls  based	 on  the contents of /etc/rct‐
	   ladm.conf.  Any name operands are ignored.

       The following operands are supported:


	   The name of the rctl to operate on.	Multiple  rctl	names  can  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.

       Example 1 Activating System Logging for Specific Violations

       The  following  command	activates  system logging of all violations of

	 # rctladm -e syslog task.max-lwps

       Example 2 Examining the Current Status of a Specific Resource

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

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

       The following exit values are returned:


	   Successful completion.


	   A  fatal  error occurred. A message is written to standard error to
	   indicate each resource control for which the operation failed.  The
	   operation  was successful for any other resource controls specified
	   as operands.


	   Invalid command line options were specified.


	   Each time rctladm is executed, it  updates  the  contents  of  rct‐
	   ladm.conf with the current configuration.

       setrctl(2),  getrctl(2),	 prctl(1), rctlblk_get_global_flags(3C), rctl‐
       blk_get_global_action(3C), attributes(5), resource_controls(5)

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

				  Jul 2, 2007			   RCTLADM(1M)

List of man pages available for SmartOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
Vote for polarhome
Free Shell Accounts :: the biggest list on the net