tracesoff Command

Purpose

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

Syntax

Subsystem

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

Subserver

tracesoff [ -h Host ] -t Type [ -p SubsystemPID] { -o Object | -P SubserverPID }

Description

The tracesoff command sends the System Resource Controller a subsystem request packet that is forwarded to the subsystem to turn tracing off. Tracing is unsuccessful if the communication method for the subsystems is signals.
Note: Tracing is subsystem dependent.

Flags

Item Description
-g Group Specifies a group of subsystems to turn tracing off. 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.
-o Object Specifies that a subserver Object name is to be passed to the subsystem as a character string.
-p SubsystemPID Specifies a particular instance of the subsystem to turn tracing off, or a particular instance of the subsystem to which the trace off subserver request is to be passed.
-P SubserverPID Specifies that a SubserverPID is to be passed to the subsystem as a character string.
-s Subsystem Specifies a subsystem to turn tracing off. The Subsystem name can be 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 subsystem subserver to turn tracing off. 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 off the tracing of a group, enter the following command:
    tracesoff  -g tcpip

    This turns the tracing off for the tcpip group.

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

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

Files

Item Description
/usr/bin/tracesoff Contains the tracesoff 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.