stopsrc Command

Purpose

Stops a subsystem, a group of subsystems, or a subserver.

Syntax

To Stop a Subsystem

stopsrc [ -h Host] [ -f | -c] { -a | -g Group | -p SubsystemPID | -s Subsystem }

To Stop a Subserver

stopsrc [ -h Host] [ -f] -t Type [ -p SubsystemPID] [ -P SubserverPID | -o Object]

Description

The stopsrc command sends a request to the System Resource Controller (SRC) to stop a subsystem, a group of subsystems, or all subsystems. The stopsrc command sends the System Resource Controller a subsystem request packet that is forwarded to the subsystem for a stop subserver request.

In the absence of the -f (stop force) flag, a normal stop action is assumed. A normal stop requests that a subsystem or subserver complete all current processing, release resources when all application activity has been completed, and then end. No new requests for work should be accepted by the subsystem.

A forced stop requests that a subsystem or subserver end quickly, releasing all resources, but not wait for application activity to complete.

A cancel action stops the subsystem after the subsystem's resources are released and after a grace period. This grace period is specified in the subsystem object class. The cancel stop is used only for subsystem stops and is always sent to the subsystem as the SIGTERM signal. The subsystem should catch this signal, perform subsystem clean up operations, and end. If the subsystem does not end within the wait time period, specified in the subsystem object class, the subsystem is sent a SIGKILL signal to ensure that the subsystem stops.

If the subsystem uses sockets or message queues for communication, a packet is constructed and sent to the subsystem. If the subsystem uses signals for communication, the subsystem is sent the appropriate signal from the subsystem object class.

Flags

Item Description
-a Specifies that all subsystems are to be stopped.
-c Specifies that the stop request is a canceled stop request. For a cancel stop request, a SIGTERM signal is sent to the subsystem. After the wait time contained in the subsystem object class has passed, if the subsystem has not yet ended, the subsystem is sent a SIGKILL signal.
-f Specifies a forced stop request.
-g Group Specifies that a group of subservers is to be stopped. The command is unsuccessful if the Group name is not contained in the subsystem object class.
-h Host Specifies the foreign Host machine on which this stop 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 value is to be passed to the subsystem as a character string.
-p SubsystemPID Specifies a particular instance of the subsystem to stop, or a particular instance of the subsystem to which the stop 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 a subsystem to be stopped. The Subsystem parameter can be the actual subsystem name or the synonym name for the subsystem. The stopsrc command stops all currently active instances of the subsystem. The command is unsuccessful if the Subsystem name is not contained in the subsystem object class.
-t Type Specifies that a subserver is to be stopped. The stopsrc command is unsuccessful if the Type specified 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 stop force a subsystem on a foreign host, enter:

    stopsrc  -h zork  -s srctest  -f

    This forces a stop on all the instances of the srctest subsystem on the zork machine.
  2. To stop cancel a subsystem group, enter:

    stopsrc  -g tcpip  -c

    This activates a stop cancel on all the subsystems in the tcpip group.
  3. To stop a subserver, enter:

    stopsrc  -t tester  -p 1234

    This stops the tester subserver that belongs to the srctest subsystem with a subsystem PID of 1234.
  4. To stop all subsystems, enter:

    stopsrc  -a

    This stops all the active subsystems on the local machine.

Files

Item Description
/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.