NAME

netmgt_kill_request - terminate a request

SYNOPSIS

bool_t

netmgt_kill_request(agent_host, agent_prog, agent_vers,
                        manager_host, timestamp, timeout)
        char    * agent_host;
        u_long agent_prog;
        u_long agent_vers;
        char    * manager_host;
        struct  timeval timestamp;
        struct  timeval timeout;

DESCRIPTION

netmgt_kill_request terminates the request running on agent_host for the agent with RPC program number agent_prog and RPC version number agent_vers started by a manager process on manager_host at time timestamp.

INPUT ARGUMENTS

agent_host

name of the system where the request is running.

agent_prog

agent's RPC program number.

agent_vers

agent's RPC version number.

manager_host

name of the system where the request was started. If manager_host is NULL, requests started by any manager will be terminated.

timestamp

request timestamp. If timestamp contains zero seconds and zero microseconds, requests with any timestamp that meets the selection criteria in the other arguments will be terminated.

timeout maximum amount of time to wait for a response from the remote system.

RETURN VALUE

TRUE if successful, otherwise FALSE.

DIAGNOSTICS

If FALSE is returned, global variable netmgt_error indicates the error. The caller can get the reason for the error with netmgt_fetch_error(3N).

SEE ALSO

netmgt_fetch_error(3N)