Daemon Configuration

About

This document describes the daemon configuration options.

Configuration Sections

Terminals

The terminals section will configure the terminal management.

Configuration Keys and Values

terminals: comma separated list of terminal names, each of which should be defined in the configuration
term.<name>.class: Fully qualified class name of a class that implements the net.wimpi.telnetd.io.terminal.Terminal interface.
term.<name>.aliases: comma separated list of aliases for the terminal

Note

The alias default should be placed to the terminal implementation you would like to make default (i.e. if negotiation fails or the type negotiated is not available).

Warning

The name and the aliases are directly used to map from the result of the terminal type negotiation to a terminal implementation.

Shells

The shells section will configure the shell management.

Configuration Keys and Values

shells: comma separated list of shell names, each of which should be defined in the configuration
shell.<name>.class: Fully qualified class name of a class that implements the net.wimpi.telnetd.shell.Shell interface.

Listeners

The listeners section will configure the listeners to be started when the daemon is started.

Configuration Keys and Values

listeners: (=name[(,name)*]An enumeration of the listeners that are configured with the following key-value pairs.
name.port: Port the listener will listen to.
name.floodprotection: The maximum queue length for incoming connection indications (a request to connect) is set to this parameter. If a connection indication arrives when the queue is full, the connection is refused.
name.maxcon: Maximum number of concurrent connections allowed.
If there is space in the queue, the connection will be queued.
name.time_to_warning: Maximum idle time until an idle warning will be issued. This happens in form of a connection event, which each shell can handle it's own way.
name.time_to_timedout: Maximum idle time after an idle warning, until a timedout event will be issued. Each shell can handle this it's own way.
name.housekeeping: Time interval for the connection manager to check for idle and timedout warnings.
name.inputmode: line or character
When put in linemode, the server will try to negotiate line mode with the client. If not possible, it will fall back to character mode and set the line mode flag in the ConnectionData instance.
When put in charactermode, the server will negotiate server side echo.
name.loginshell: The name of the default login shell of this listener. The shell should be configured in the shells section.
name.connectionfilter: Fully qualified class name of a class implementing the net.wimpi.telnetd.net.ConnectionFilter interface.
The connection manager will instantiate it, and call initialize, passing the listener properties.

Note

All time intervals are to be given in milliseconds (milliseconds/1000=seconds/60=minutes). They are to be understood as best-effort values.

Example

#Unified telnet proxy properties
#Daemon configuration example.
#Created: 15/11/2004 wimpi


############################
# Telnet daemon properties #
############################

#####################
# Terminals Section #
#####################

# List of terminals available and defined below
terminals=vt100,ansi,windoof,xterm

# vt100 implementation and aliases
term.vt100.class=net.wimpi.telnetd.io.terminal.vt100
term.vt100.aliases=default,vt100-am,vt102,dec-vt100

# ansi implementation and aliases
term.ansi.class=net.wimpi.telnetd.io.terminal.ansi
term.ansi.aliases=color-xterm,xterm-color,vt320,vt220,linux,screen

# windoof implementation and aliases
term.windoof.class=net.wimpi.telnetd.io.terminal.Windoof
term.windoof.aliases=

# xterm implementation and aliases
term.xterm.class=net.wimpi.telnetd.io.terminal.xterm
term.xterm.aliases=

##################
# Shells Section #
##################

# List of shells available and defined below
shells=dummy

# shell implementations
shell.dummy.class=net.wimpi.telnetd.shell.DummyShell

#####################
# Listeners Section #
#####################
listeners=std


# std listener specific properties

#Basic listener and connection management settings
std.port=6666
std.floodprotection=5
std.maxcon=25


# Timeout Settings for connections (ms)
std.time_to_warning=3600000
std.time_to_timedout=60000

# Housekeeping thread active every 1 secs
std.housekeepinginterval=1000

std.inputmode=character

# Login shell
std.loginshell=dummy

# Connection filter class
std.connectionfilter=none