1URONODE.CONF(5) Linux Programmer's Manual URONODE.CONF(5)
2
6 uronode.conf - URONode configuration file.
7
9 uronode.conf file is read by URONode at program startup and is used to
10 modify the behaviour of the node. The URONode node.conf is no compati‐
11 ble with the LinuxNode file, as it add new entries: FlexId Prompt and
12 PassPromt.
13 The lines within uronode.conf must either be a comment line, which
15 starts with a # in the first column, or one of the commands listed
16 below. Commands and arguments are delimited by white space. Arguments
17 can contain white space if they are enclosed in double quotes. Also C-
18 style escapes (\n, \x0A, \012 etc.) are parsed within double quotes.
19 Tabs may also be used for delimiting columns.
20 Available configuration commands are:
22 Alias <NAme> “<command> [<args...>]”
24 Sets up a command alias. The number of uppercase charac‐
25 ters at the beginning of <NAme> specifies how much the
26 user may abbreviate the command. The uppercase part
27 should be long enough to separate the command from other
28 commands starting with the same letters. If there are no
29 uppercase letters in the beginning, the whole name is
30 converted to upper case and user can not abbreviate the
31 command. The command and arguments are subject to param‐
32 eter expansion (see below).
33 ConnTimeout <timeout>
35 When user is connected to another system via this system
36 and the connection is idle (no data flowing in either
37 direction) for <timeout> seconds the connection is
38 dropped and user disconnected from node. Default is 3600
39 seconds (1 hour).
40 Email <your@node.ampr.org>
42 This is your amprnet or commercial email address that's
43 displayed to users on interfaces you require having a
44 password on to access your node, highly suggested on inet
45 interfaces. You may leave off the <>'s. If you do not
46 have an Email line in node.conf then your email address
47 to users will display as (null) and will make you look
48 sloppy :-)
49 EscapeChar <escape>
51 Specifies the escape character. <escape> should be the
52 decimal representation of the ASCII code of the wanted
53 escape character. Setting escape character to -1 dis‐
54 ables the feature altogether. The default is 20 (ctrl-
55 t).
56 Note that the escape mechanism breaks 8-bit transparency
58 of URONode and you should either disable it or set the
59 no-escape flag in node.perms for the forwarding stations
60 if (compressed) forward is run trough URONode.
61 ExtCmd <NAme> <flags> <uid> <exec> <args...>
63 NAme This is the name under which the command
65 appears at nodes command list. The number of
66 uppercase characters at the beginning of <NAme>
67 specifies how much the user may abbreviate the
68 command. The uppercase part should be long
69 enough to separate the command from other com‐
70 mands starting with the same letters. If there
71 are no uppercase letters in the beginning, the
72 whole name is converted to upper case and user
73 can not abbreviate the command.
74 flags This is a sum of flags that control the way the
76 external command is executed. Currently two
77 flags are implemented:
78 1 Run command through pipe. Without this
80 flag node just fork()s and exec()s the
81 specified command and then waits for it to
82 terminate. The command must it self be
83 aware about the underlying protocol. It
84 must handle packetising and any end of
85 line conversions. With this flag however
86 node sets up a pipe between it self and
87 the command and handles packetising and
88 end of line conversions for it.
89 2 Reconnected to flag. If this flag is set,
91 the user gets a reconnected to prompt
92 after the external command is finished.
93 uid This is the userid that the following command
95 should run under when executing.
96 exec This is the executable that should be executed.
98 args... These are the optional arguments that are
100 passed to the executable. The arguments are
101 subject to parameter expansion (see below).
102 HiddenPorts <portname> ...
104 Marks <portname> as hidden. Hidden ports are not shown to
105 users in Links, Mheard, Ports and Routes commands and can
106 not be used to make AX.25 downlink connections unless
107 user is specially permitted to do so (see node.perms(5)).
108 Up to 32 hidden ports can be specified with this command.
109 HostName <hostname>
111 This is the visible hostname of the node. It will be
112 shown at telnet login and in the node welcome message.
113 IdleTimeout <timeout>
115 After <timeout> seconds of inactivity while waiting for a
116 command user is disconnected from node. Default is 900
117 seconds (15 mins).
118 LocalNet <network>
120 Defines a "local" network. Users telneting from hosts in
121 this network are treated separately (see node.perms(5)).
122 <network> is a KA9Q NOS style network address consisting
123 of a dotted quad ip address of the network and a number
124 of significant bits separated by a slash. Note that
125 127.0.0.0/8 (loopback net) is also considered "local" by
126 default.
127 LogLevel <loglevel>
129 Specifies what node should log. The available levels are:
130 0 Don't log anything.
132 1 Log only critical errors.
134 2 Log errors and logins/logouts.
136 3 Log errors, logins/logouts and all gateway commands.
138 Default is to log only critical errors.
140 NodeId <nodeid>
142 This is the node id that is shown in every message from
143 node. Default is "URONode".
144 FlexID <flexid>
146 This is typically your ax25 callsign-ssid that links to
147 flexnet and/or to your user interface set by the sysop in
148 ax25d.conf.
149 RoseID <rosecall@dnic,######>
151 This is your node's rosecall-ssid and your full dnic num‐
152 ber typically consisting of your country code, area code,
153 and phone extension. An example is: 3100,860906. The full
154 string would be for this part of the conf file using my
155 config: RoseID n1uro-8@3100860906 or if you do not use
156 rose enter: RoseID none
157 NrPort <portname>
159 This is the name of the netrom port that is used when
160 making outgoing netrom connects. Normally it should match
161 the portname that is used in ax25d.conf to listen for
162 incoming netrom calls. Default is the first netrom port.
163 ReConnect on|off
165 ReConnect flag. If this is on, users gatewaying to
166 another host get reconnected to this node after the
167 remote host closes connection. If it's off connection to
168 the user will also be closed. User can override the
169 default behaviour with a single `s' or `d' at the end of
170 the gatewaying command (connect or telnet). Default is
171 off.
172 Prompt <NodePrompt>
174 This is the prompt string of the node. It's delimited by
175 double quotes. You can use also a "\n" character for a
176 multi-lines prompt.
177 PassPrompt <PasswordPrompt>
179 This is the prompt string for sysop password request.
180 It's delimited by double quotes. You can use also a "\n"
181 character for a multi-lines prompt.
182
184 The arguments passed to the real command by the Alias and ExtCmd com‐
185 mands are subject to parameter expansion. If a word starts with a %, it
186 is expanded. The following formats are expanded:
187 %parameter This is substituted with the value of parameter
189 %{parameter} The same as above.
191 %{parameter:default}
193 If parameter is defined this is susbtituted with the
194 value of it. If not, the default value is substituted.
195 This currently applies only to positional parameters
196 0...9.
197 The following parameters are defined:
199 0...9 The positional parameters.
201 U The username (callsign) of the remote station in upper case
203 without the SSID.
204 u The username (callsign) of the remote station in lower case
206 without the SSID.
207 S The username (callsign) of the remote station in upper case
209 with the SSID.
210 s The username (callsign) of the remote station in lower case
212 with the SSID.
213 P The nodename (callsign) of the remote station (NET/ROM), the
215 portname the user is coming in via (AX.25) or the ip address of
216 the remote host (TCP). In upper case without the SSID.
217 p The nodename (callsign) of the remote station (NET/ROM), the
219 portname the user is coming in via (AX.25) or the ip address of
220 the remote host (TCP). In lower case without the SSID.
221 R The nodename (callsign) of the remote station (NET/ROM), the
223 portname the user is coming in via (AX.25) or the ip address of
224 the remote host (TCP). In upper case with the SSID.
225 r The nodename (callsign) of the remote station (NET/ROM), the
227 portname the user is coming in via (AX.25) or the ip address of
228 the remote host (TCP). In lower case with the SSID.
229 t The type of the user connection (ax25, netrom, rose, inet,
231 host) in lower case.
232 T The type of the user connection (ax25, netrom, rose, inet,
234 host) in upper case.
235 Anything else after a % is substituted with a %.
237
239 /usr/local/etc/ax25/uronode.conf
240
242 uronode(8), uronode.perms(5), axports(5), ax25(4).
243Linux 28 April 1998 URONODE.CONF(5)