tnadmin

NAME

tnadmin - Windows command-line utility to administer Telnet Server

SYNOPSIS

tnadmin [server] [-u usr [-p pword]]
tnadmin [server] -s [session] 
tnadmin [server] -k session 
tnadmin [server] -m session message 
tnadmin [server] start [-u usr [-p pword]]
tnadmin [server] stop [-u usr [-p pword]]
tnadmin [server] pause [-u usr [-p pword]]
tnadmin [server] continue [-u usr [-p pword]]
tnadmin [server] config option=value [-u usr [-p pword]]

DESCRIPTION

The tnadmin(1w) Windows command-line utility administers Windows Services for UNIX Telnet Server on the local computer or on the computer specified by server. If you are logged on with an account that does not have the required privileges, you can specify a user name and password of an account that does. You cannot use an Internet Protocol version 6 (IPv6) address to specify a remote computer to administer, other than to list sessions (the -s option).

In addition to specific command options and arguments, tnadmin accepts the following options and arguments:

server

Specifies the remote computer you want to administer. You can specify the computer using a Windows Internet Name Service (WINS) or Domain Name System (DNS) name, or by Internet Protocol (IP) address.

-u usr

Specifies the user name of the user whose credentials are to be used. It might be necessary to add the domain name to the user name in the form domain\username.

-p pword

Specifies the password of the user designated by the -u option. If you specify the -u option but omit the -p option, you are prompted for the user's password.

The action that tnadmin performs depends on the command option or argument you specify:

-s session

Lists information about the specified session. The session argument is a session identifier (ID). If session is omitted, information about all sessions is listed. To use this option to administer a remote computer, you must be logged on with an account that belongs to the Administrators group on that computer.

-k session

Terminates the specified session. The session argument is either a session ID or all to terminate all sessions. To use this option to administer a remote computer, you must be logged on with an account that belongs to the Administrators group on that computer.

-m session message

Sends the string specified by message to the specified session. If you use the -u or -p options with this option, place them before the -m option to avoid sending them as part of the message. The session argument is either a session ID or all to send the message to all sessions. To use this option to administer a remote computer, you must be logged on with an account that belongs to the Administrators group on that computer.

start

Starts the Telnet Server service.

stop

Stops the Telnet Server service.

pause

Pauses the Telnet Server service.

continue

Resumes the Telnet Server service.

config option=value

Specifies general settings for Telnet Server. You must supply at least one of the following options and values with config:

dom=defaultDomain

Sets the default domain for an unqualified user name.

ctrlakeymap={yes | no}

Specifies whether CTRL+A is interpreted as the ALT key.

timeout=[hh:[mm:]]ss

Specifies how long Telnet Server will wait before disconnecting an idle session (in hours (hh), minutes (mm), and seconds (ss)) if config timeoutactive is set to yes.

timeoutactive={yes | no}

Specifies whether idle sessions will be disconnected.

maxfail=value

Sets the maximum number of logon failure attempts before Telnet Server disconnects the client.

maxconn=value

Sets the maximum number of connections.

port=value

Sets the port number to be used for Telnet sessions.

killall={yes | no}

Specifies whether applications started in a Telnet session will be terminated when the session is disconnected.

sec=[[+|-]NTLM] [[+|-]passwd]

Sets the authentication mechanism. You can configure Telnet Server to use NTLM authentication (NTLM), plain-text passwords (passwd), or both. Precede the mechanism name with a plus sign (+) to enable the mechanism and with a dash (-) to disable the mechanism.

mode={console | stream}

Specifies the mode of operation. Console mode is useful to run screen-oriented programs such as vi. Stream mode operates similar to UNIX dumb terminal types and is not suitable to use with programs such as vi.

If you do not supply a command option or argument, tnadmin displays current configuration and status information.

NOTE

You can use tnadmin only to administer Telnet Server provided with Windows Services for UNIX. The tnadmin utility does not work with other Telnet servers.

SEE ALSO

Telnet Server