MAN page from Other ax25-utils-2.1.42a-3.i386.rpm

NODE.CONF

Section: Linux Programmer's Manual (5)
Updated: 26 April 1997
Index

NAME

node.conf - LinuxNode configuration file.

DESCRIPTION

Node.conffile is read by LinuxNode at program startup and is used to modify thebehaviour of the node.

The lines withinnode.confmust either be a comment line, which starts with a # in the first column, orone of the commands listed below. Commands and arguments are delimitedby white space. Arguments can contain white space if they are enclosedin double quotes. Also C-style escapes (\n, \x0A, \012 etc.) are parsedwithin double quotes.

Available configuration commands are:

Alias <NAme> lq<command> [<args...>]rq

Sets up a command alias. The number of uppercase characters at thebeginning of <NAme> specifies how much the user may abbreviate thecommand. The uppercase part should be long enough to separate the commandfrom other commands starting with the same letters. If there are nouppercase letters in the beginning, the whole name is converted to uppercase and user can not abbreviate the command.The command and arguments are subject toparameter expansion(see below).

ConnTimeout <timeout>

When user is connected to another system via this system and theconnection is idle (no data flowing in either direction) for <timeout>seconds the connection is dropped and user disconnected from node.Default is 3600 seconds(1 hour).

EscapeChar <escape>

Specifies the escape character. <escape> should be the decimal representation of the ASCII code of the wanted escape character.Setting escape character to -1 disables the feature altogether.The default is 20 (ctrl-t).

Note that the escape mechanism breaks 8-bit transparency of LinuxNodeand you should either disable it or set the no-escape flag in node.permsfor the forwarding stations if (compressed) forward is run troughLinuxNode.

ExtCmd <NAme> <flags> <uid> <exec> <args...>

NAme

This is the name under which the command appears at nodes command list.The number of uppercase characters at the beginning of <NAme> specifieshow much the user may abbreviate the command.The uppercase part should be long enough to separate the commandfrom other commands starting with the same letters. If there are nouppercase letters in the beginning, the whole name is converted to uppercase and user can not abbreviate the command.

flags

This is a sum of flags that control the way the externalcommand is executed. Currently two flags are implemented:

1: Run command through pipe. Without this flag node just fork()s and exec()sthe specified command and then waits for it to terminate. The command mustit self be aware about the underlying protocol. It must handle packetisingand any end of line conversions. With this flag however node sets up a pipebetween it self and the command and handles packetising and end of lineconversions for it.
2: Reconnected to flag. If this flag is set, the user gets a reconnected toprompt after the external command is finished.

uid

This is the userid that the following command should run under whenexecuting.

exec

This is the executable that should be executed.

args...

These are the optional arguments that are passed to the executable.The arguments are subject toparameter expansion(see below).

HiddenPorts <portname> ...

Marks <portname> as hidden. Hidden ports are not shown to users inLinks, Mheard, Ports and Routes commands and can not be used to makeAX.25 downlink connections unless user is specially permitted to doso (see node.perms(5)). Up to 32 hidden ports can be specified withthis command.

HostName <hostname>

This is the visible hostname of the node. It will be shown at telnetlogin and in the node welcome message.

IdleTimeout <timeout>

After <timeout> seconds of inactivity while waiting for a command useris disconnected from node. Default is 900 seconds (15 mins).

LocalNet <network>

Defines a "local" network. Users telneting from hosts in this networkare treated separately (see node.perms(5)). <network> is a KA9Q NOSstyle network address consisting of a dotted quad ip address of thenetwork and a number of significant bits separated by a slash. Notethat 127.0.0.0/8 (loopback net) is also considered "local" by default.

LogLevel <loglevel>

Specifies what node should log. The available levels are:

0: Don't log anything.
1: Log only critical errors.
2: Log errors and logins/logouts.
3: Log errors, logins/logouts and all gateway commands.

Default is to log only critical errors.

NodeId <nodeid>

This is the node id that is shown in every message from node. Defaultis "LinuxNode".

NrPort <portname>

This is the name of the netrom port that is used when making outgoingnetrom connects. Normally it should match the portname that is usedin ax25d.conf to listen for incoming netrom calls. Default is the firstnetrom port.

ReConnect on|off

ReConnect flag. If this is on, users gatewaying to another hostget reconnected to this node after the remote host closes connection.If it's off connection to the user will also be closed. User canoverride the default behaviour with a single `s' or `d' at the endof the gatewaying command (connect or telnet). Default is off.

PARAMETER EXPANSION

The arguments passed to the real command by the Alias and ExtCmdcommands are subject to parameter expansion. If a word starts with a %,it is expanded. The following formats are expanded:

%parameter: This is substituted with the value ofparameter
%{parameter}: The same as above.
%{parameter:default}: Ifparameteris defined this is susbtituted with the value of it. If not, the defaultvalue is substituted. This currently applies only to positional parameters0...9.

The following parameters are defined:

0...9: The positional parameters.
U: The username (callsign) of the remote station in upper case without the SSID.
u: The username (callsign) of the remote station in lower case without the SSID.
S: The username (callsign) of the remote station in upper case with the SSID.
s: The username (callsign) of the remote station in lower case with the SSID.
P: The nodename (callsign) of the remote station (NET/ROM), the portname theuser is coming in via (AX.25) or the ip address of the remote host (TCP).In upper case without the SSID.
p: The nodename (callsign) of the remote station (NET/ROM), the portname theuser is coming in via (AX.25) or the ip address of the remote host (TCP).In lower case without the SSID.
R: The nodename (callsign) of the remote station (NET/ROM), the portname theuser is coming in via (AX.25) or the ip address of the remote host (TCP).In upper case with the SSID.
r: The nodename (callsign) of the remote station (NET/ROM), the portname theuser is coming in via (AX.25) or the ip address of the remote host (TCP).In lower case with the SSID.
t: The type of the user connection (ax25, netrom, rose, inet, host) in lower case.
T: The type of the user connection (ax25, netrom, rose, inet, host) in upper case.

Anything else after a % is substituted with a %.

FILES

/etc/ax25/node.conf

This document was created byman2html,using the manual pages.