test

TotalNET Advanced Server 5.2 Reference Manual

tnkill

This command disconnects one or more service clients. The client name, either the UNIX name of a connected user or the name of the client computer as reported by tnwho or tninfo, has case-sensitivity. You must specify at least one client. Precede each client name with a -u.

You can include the minutes until disconnection and an explanation for disconnection on the command line. This warns clients and gives them time to log off. A client's screen displays increasingly frequent warning messages as the shutdown time approaches. To display the messages, the client's network software must enable the receiver capability. You must include minutes when you give a reason.

Location

TNHOME/usr/sbin

Usage

tnkill [-C] [-f] [-r realm] [-t type] [-s service]
 	{-u user|-c client} [minutes... [reason...]]

Options

-C 

Cancel the tnkill command currently in progress.

-f 

Terminate all TAS client connections immediately, without sending a default system-shutdown message to connected clients. 

-u user

Specify the user to disconnect. You may specify user names or client network names and use multiple -u and -c options.

-c client

Specify the client to disconnect. You may specify user names or client network names and use multiple -u and -c options.

minutes

Specify the minutes before disconnection. You must define reason to use this option. This option defaults to 0 and has no upper limit. 

reason

Give the reason for the disconnection. You must define minutes to use this option. Your explanation can contain any text of up to 60 characters. If the explanation includes any of the following characters, you may need to enclose it in quotes, depending on the UNIX shell you use: 

# $ & * [ ' " ` ? \ |^ ! 

Note

Using this command to disconnect a client does not prevent the client from reconnecting.

Examples

  1. Use the following command to terminate the connections for users peter, paul, and mary immediately, without stating a reason:


    tnkill -u peter -u paul -u mary

  2. Use the following command to cancel all tnkill commands you have initiated:


    tnkill -C

  3. Use the following command to terminate all TAS client connections immediately, without sending a default system shutdown message to connected clients:


    tnkill -f

  4. Use the command below to terminate the connections for users scotty and spock in five minutes, in order to do system backups on the superserver. These users receive the message, "Superuser shutting down in 5 minutes - system backup."


    tnkill -u scotty -u spock 5 system backup -s superserver:file