Managing ObjectStore

ossvrclntkill: Disconnecting a Client Thread on a Server

The ossvrclntkill utility disconnects a client thread on the Server running on the specified host. This disconnects the client from the Server and releases the client locks.

Syntax

ossvrclntkill hostname -h client-host | -p client-pid | -n client-name 
[ -a ]
ossvrclntkill hostname client-pid
(The second form is supported for compatibility with earlier releases.)

Options
hostname 
Specifies the name of the host of the Server that is connected to the client process being disconnected.

-h client-host 
Specifies the name of the host of the client being disconnected, as determined with ossvrstat.

-p client-pid 
Specifies an unsigned number that is the process ID of the client process being disconnected.

-n client-name 
Specifies the name of the client process being disconnected. This name is set by objectstore::set_client_name().

-a 
Specifies that all clients matching the specified criteria should be disconnected.

Description

Run the ossvrclntkill utility on the Servers connected to the client that you want to kill.

You can use ossvrstat to determine the client-hostname and client-pid.

When needed

Use the ossvrclntkill utility when a client that no longer exists is still attached to the Server. This can happen because of network failure or because the client process terminates abnormally. In most cases, the operating system disconnects the client from the Servers gracefully, but some operating systems are not completely dependable in this regard.

UNIX

You must specify -h, -p, or -n. The -a option deletes all matching clients; otherwise, a unique match is required.

If the Server's authentication is set to something other than NONE (authentication is SYS by default), the following rule applies:

Any user can disconnect clients that user owns. If the -a option is used (kill all clients matching the given search pattern), the user must own all matching processes; otherwise, authentication fails and no clients are killed.

Otherwise, no authentication is required.

Example

ossvrclntkill hostess -h cupcake -a
This disconnects all clients on cupcake that are attached to the Server on hostess.

API

Class: os_dbutil
Method: svr_client_kill



[previous] [next]

Copyright © 1999 Object Design, Inc. All rights reserved.

Updated: 03/11/99 11:19:07