.telnetrc(4) CLIX .telnetrc(4)
NAME
.telnetrc - File containing configuration information used by the telnet
command
DESCRIPTION
The .telnetrc file is an optional configuration file that resides (as a
hidden file) in the user's home directory and is read by telnet when the
command is invoked. The .telnetrc file can define certain parameters that
can also be keyed in on the command line with the telnet command.
The following list includes the parameters that can be set in the
.telnetrc file. Refer to the telnet(1) manual page for additional
information on these parameters.
mode line
Sets the mode to line-by-line mode.
mode char
Sets the mode to character-at-a-time mode.
send ao
Sends the TELNET AO (Abort Output) sequence, which should cause the
remote system to flush all output from the remote system to the
user's terminal.
send ayt
Sends the TELNET AYT (Are You There) sequence, to which the remote
system may or may not choose to respond.
send brk
Sends the TELNET BRK (BReaK) sequence, which may be significant to
the remote system."
send ec
Sends the TELNET EC (Erase Character) sequence, which should cause
the remote system to erase the last character entered.
send el
Sends the TELNET EL (Erase Line) sequence, which should cause the
remote system to erase the line currently being entered.
send escape
Sends the current telnet escape character, by default the <Ctrl-]>
sequence.
send ga
Sends the TELNET GA (Go Ahead) sequence, which likely is not
significant to the remote system.
2/94 - Intergraph Corporation 1
.telnetrc(4) CLIX .telnetrc(4)
send ip
Sends the TELNET IP (Interrupt Process) sequence, which should
cause the remote system to abort the currently running process.
send nop
Sends the TELNET NOP (No OPeration) sequence.
send synch
Sends the TELNET SYNCH sequence. This sequence causes the remote
system to discard all previously entered (but not yet read) input.
This sequence is sent as Transmission Control Protocol (TCP) urgent
data. (This may not work if the remote system is a 4.2 Berkeley
Software Distribution (BSD) system. If it does not work, a
lowercase r'' may be echoed on the terminal).
set echo char
This is the value (by default the <Ctrl-E> sequence) that, when in
line-by-line mode toggles between echoing entered characters
locally (for normal processing), and suppressing echoing of entered
characters (such as for entering a password).
set escape char
This is the telnet escape character, initially the <Ctrl-]>
sequence, that causes telnet to enter command mode (when connected
to a remote system).
set erase char
If telnet is in localchars mode (see the toggle localchars
description) and telnet is operating in character-at-a-time mode,
when this character is entered, a TELNET EC sequence (see the send
ec description) is sent to the remote system. The initial value
for the erase character is interpreted as the terminal's ERASE
character.
set interrupt char
If telnet is in localchars mode (see the toggle localchars
description) and the INTR character is keyed in, a TELNET IP
sequence (see the send ip description) is sent to the remote host.
The initial value for the interrupt character is interpreted as the
terminal's INTR character.
set kill char
If telnet is in localchars mode (see the toggle localchars
description) and telnet is operating in character-at-a-time mode,
when this character is entered, a TELNET EL sequence (see the send
el description) is sent to the remote system. The initial value
for the kill character is interpreted as the terminal's KILL
character.
set quit char
If telnet is in localchars mode (see the toggle localchars
2 Intergraph Corporation - 2/94
.telnetrc(4) CLIX .telnetrc(4)
description) and the QUIT character is entered, a TELNET BRK
sequence (see the send brk description) is sent to the remote host.
The initial value for the quit character is interpreted as the
terminal's QUIT character.
set eof char
If telnet is operating in line-by-line mode, entering this
character as the first character on a line will cause this
character to be sent to the remote system. The initial value of
the end-of-file character is interpreted as the terminal's EOF
character.
status
Shows the current status of telnet. This includes the peer the
user is connected to and the current mode.
toggle autosync
If autosynch and localchars are both TRUE, when the INTR or QUIT
characters are entered, the resulting TELNET sequence sent is
followed by the TELNET SYNCH sequence. (See the set description
for descriptions of the INTR and QUIT characters.) This procedure
should cause the remote system to begin discarding all previously
entered input until both of the TELNET sequences have been read and
acted on. The initial value of this toggle is FALSE.
toggle crmod
Toggles carriage return mode. When this mode is enabled, most
carriage return characters received from the remote host will be
mapped to a carriage return followed by a linefeed. This mode does
not affect characters entered by the user; only those received from
the remote host are affected. This mode is not useful unless the
remote host only sends a carriage return, but it never sends a
linefeed. The initial value for this toggle is FALSE.
toggle debug
Toggles socket-level debugging. (This is useful only to the
superuser.) The initial value for this toggle is FALSE.
toggle localchar
If this is TRUE, the INTR, QUIT, ERASE, and KILL characters (see
the set description) are recognized locally and transformed into
appropriate TELNET control sequences (ao for TRUE, ip for INTR, brk
for QUIT, ec for ERASE, and el for KILL; see the send description).
The initial value for this toggle is TRUE in line-by-line mode and
FALSE in character-at-a-time mode.
toggle netdata
Toggles the display of all network data (in hexadecimal format).
The initial value for this toggle is FALSE.
toggle options
2/94 - Intergraph Corporation 3
.telnetrc(4) CLIX .telnetrc(4)
Toggles the display of some internal telnet protocol processing
(concerning TELNET options). The initial value for this toggle is
FALSE.
NOTES
Characters to the right of a number sign (#) are treated as a comment.
An invalid parameter will result in an error message notifying the user of
an error in the file, but the telnet command will continue processing.
EXAMPLES
1. The following file sets the escape character to a dollar sign ($),
sets the erase character to the at sign (@), and displays the current
status of telnet when the connection is made.
set escape $
set erase @
status
Using this telnetrc file, the beginning of a telnet session might
appear as follows:
$ telnet gator.ingr.com
Trying...
Connected to gator.ingr.com.
Escape character is '^]'.
Setting escape character to '$'.
Setting erase character to '@'.
Connected to gator.ingr.com.
Escape character is '$'.
CLIX R3.1 Vr.7.0.14 (gator) 2430
login:
2. The following example file contains an error on the third line. All
other lines are correct and the specified settings will be set
properly in the telnet session.
mode line
set escape !
toggle debgu
send ayt
The following example telnet session shows the result of using the
4 Intergraph Corporation - 2/94
.telnetrc(4) CLIX .telnetrc(4)
file with the error. Note that after the error message appears the
telnet session proceeds normally.
$ telnet gator.ingr.com
Trying...
Connected to gator.ingr.com.
Escape character is '^]'.
Setting Escape to '!'.
Invalid Entry toggle debgu ignored
[Yes]
CLIX R3.1 Vr.7.0.14 (gator) 2430
login:
RELATED INFORMATION
Commands: telnet(1)
2/94 - Intergraph Corporation 5