snm_kill manual page
Table of Contents

NAME

snm_kill - stop one or more agent requests

SYNOPSIS

snm_kill -h agent_host -m manager_host [ -a agent_name | -A ] [ -d debug_level ] [ -t timeout ] [ -v agent_version_number ] [ -s timestamp (seconds) -u timestamp (microseconds) ]

DESCRIPTION

snm_kill stops an agent's requests according to the given options.
You can stop requests from other than where they were started. For example, you can kill an agent from host1 that was started from host2. This is useful when host2 is inaccessible.

OPTIONS

Each option is recognized as a separate argument.

-aagent_name
name of the agent, as it appears in the NIS rpc.bynumber map or local rpc(5) database.

-A
kill all requests started from the local host. snm_kill reads the activity daemon's request log (as specified by the activity-log keyword in snm.conf(5) ) and sends a kill request for each entry in the log.

-ddebug_level
set trace level (0 to 3). Usually not needed nor interesting.

-hagent_host
host where the agent is running.

-mmanager_host
host where the request originated.

-stimestamp(seconds)
request ID, uniquely identified by a timestamp in seconds (that is, UNIX time). The -u option is required with this option.

-ttimeout
maximum time to wait for agent confirmation, in seconds. The default is NETMGT_TIMEOUT (60 seconds).

-vagent_version_number
protocol version of the agent. Use 10 for the current release.

-utimestamp(microseconds)

request ID, uniquely identified by a timestamp in microseconds (that is, UNIX time). The -s option is required with this option.

NOTES

The values for the -s and -u options are the seconds and microseconds values, respectively, of the request timestamp. These are displayed by snm_cmd(1) when a request is started. If you do not use the -s and -u options, all agent name requests running on agent host that were started from manager host are terminated.

The ability to kill requests you didn't start could be considered a security hole.

Killing agents started by the Site/SunNet/Domain Manager Console will cause the Console to complain about agents suddenly dying.


Table of Contents