traceson Command

Purpose

Turns on tracing of a subsystem, a group of subsystems, or a subserver.

Syntax

Subsystem

traceson [ -h Host] [ -l] { -g Group | -p SubsystemPID| -s Subsystem}

Subserver

traceson [ -h Host] [ -l] -t Type [ -o Object] [ -p SubsystemPID] [ -P SubserverPID]

Description

The traceson command sends the System Resource Controller a subsystem request packet that is forwarded to the subsystem to turn tracing on. Tracing is unsuccessful if the communication method for the subsystems is signals.

Note: Tracing is subsystem dependent.

Tracing may occur in either short or long form. When the -l flag is absent, the trace request is assumed to be a short trace.

Flags

Item Description
-g Group Specifies a group of subsystems to turn tracing on. The command is unsuccessful if the Group name is not contained in the subsystem object class.
-h Host Specifies the foreign host on which this trace action is requested. The local user must be running as "root". The remote system must be configured to accept remote System Resource Controller requests. That is, the srcmstr daemon (see /etc/inittab) must be started with the -r flag and the /etc/hosts.equiv or .rhosts file must be configured to allow remote requests.
-l Specifies that a long trace is requested.
-o Object Specifies that a subserver object is to be passed to the subsystem as a character string.
-p SubsystemPID Specifies a particular instance of the subsystem to turn tracing on, or a particular instance of the subsystem to which the trace subserver request is to be passed.
-P SubserverPID Specifies that a subserver PID is to be passed to the subsystem as a character string.
-s Subsystem Specifies the subsystem to turn tracing on. The Subsystem name can be either the actual subsystem name or the synonym name for the subsystem. The command is unsuccessful if the Subsystem name is not contained in the subsystem object class.
-t Type Specifies a subserver to turn tracing on. The command is unsuccessful if the Type is not contained in the subserver object class.

Security

Attention RBAC users and Trusted AIX users: This command can perform privileged operations. Only privileged users can run privileged operations. For more information about authorizations and privileges, see Privileged Command Database in AIX® Version 7.1 Security. For a list of privileges and the authorizations associated with this command, see the lssecattr command or the getcmdattr subcommand.

Examples

  1. To turn on tracing of the tcpip group on a foreign host, enter the following command: 
    traceson -h odin  -g tcpip

    This turns on the tracing for the tcpip group on the odin foreign host.

  2. To turn on tracing of the sendmail subsystem on a foreign host, enter the following command: 
    traceson -h odin  -s sendmail

    This turns on the tracing for the sendmail subsystem on the odin foreign host.

Files

Item Description
/usr/bin/traceson Contains the traceson command.
/etc/objrepos/SRCsubsys Specifies the SRC Subsystem Configuration Object Class.
/etc/objrepos/SRCsubsvr Specifies the SRC Subserver Configuration Object Class.
/etc/services Defines the sockets and protocols used for Internet services.
/dev/SRC Specifies the AF_UNIX socket file.
/dev/.SRC-unix Specifies the location for temporary socket files.