trcctl Command

Purpose

Changes and displays system trace parameters.

Syntax

trcctl [ -d Directory -l -L LogfileSize -M LMT_log_dir -N NonrootUserBufferMax -o Logfile -r -T BufferSize -R disable|enable -S disable|enable]

Description

The trcctl command will display or change the system trace default parameters. If the -l option (or no parameter) is specified, trcctl will show the values as follows: 
Default Buffer Size: 131072 
Default Log File Size: 1310720 
Default Log File: /var/adm/ras/trcfile 
Non-root User Buffer Size Maximum: 1048576
Default Components Directory File: /var/adm/ras/trc_ct
Default LMT Log Dir: /var/adm/ras/mtrcdir
Restrict non-privileged users from using trace Channel-0:  disable
Restrict non-privileged users from using trcrpt Channel-0: disable
Note that the default buffer and log file sizes initially depend upon the kernel. However, once they are set using this command, the effected value is the same for both kernels. The other parameters allow these default values to be changed. To change a default value, the user must be a member of the system group. Many of the flags used with trcctl correspond to those used by the trace daemon.

Flags

Item Description
-d Directory Specifies the default Component Trace log directory path. The default value is /var/adm/ras/trc_ct.
-l Lists the current values.
-L Value Specifies the default log file size. The original default value is 1310720 bytes for the 32-bit kernel, and 2621440 bytes for the 64-bit kernel. If specified with -L, the default will apply to both kernels.
-M LMT_log_dir Specifies the default Lightweight Memory Trace log directory path. The default value is /var/adm/ras/mtrcdir.
-N Value Specifies the maximum buffer size a non-root user may specify. The default is 1 MB, 1048576 bytes.
-o Path Specifies the default log file path. The default value is /var/adm/ras/trcfile.
-R disable | enable Restricts the trace facility of channel 0 to only the privileged users. If the -R option is disabled, the trace facility of channel 0 is available to all users. The default value is disable. For more information, see the Security section of the trcrpt command.
-S disable | enable Restricts the trcrpt facility of channel 0 to only the privileged users. If the -S option is disabled, the trcrpt facility of channel 0 is available to all users. The default value is disable. For more information, see the Security section of the trace command
-r Restores original default value.
   
-T Value Specifies the default trace buffer size. The original default values are 128 KB and 256 KB for a 32- or 64-bit kernel. If specified with -T, the default will apply to both kernels.

Parameters

If you use 'k', 'm', or '#k', '#m' as parameters for the -N, -L, and -T options, trcctl will translate these into their respective byte totals.
  • k = 1024
  • m = 1048576
Using only 'k' or 'm', trcctl assumes you mean 1 kilobyte or 1 megabyte respectively. This way a root user can execute : 
trcctl -L 10m -N m -T 256k

Security

The user must be a member of the system group.