1URONODE.CONF(5)            Linux Programmer's Manual           URONODE.CONF(5)
2
3
4

NAME

6       uronode.conf - URONode configuration file.
7

DESCRIPTION

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
14       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
21       Available configuration commands are:
22
23       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
34       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
41       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
50       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
57                     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
62       ExtCmd <NAme> <flags> <uid> <exec> <args...>
63
64                     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
75                     flags     This is a sum of flags that control the way the
76                               external command  is  executed.  Currently  two
77                               flags are implemented:
78
79                               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
90                               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
94                     uid       This is the userid that the  following  command
95                               should run under when executing.
96
97                     exec      This is the executable that should be executed.
98
99                     args...   These  are  the  optional  arguments  that  are
100                               passed to the executable.   The  arguments  are
101                               subject to parameter expansion (see below).
102
103       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
110       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
114       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
119       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
128       LogLevel <loglevel>
129                     Specifies what node should log. The available levels are:
130
131                     0    Don't log anything.
132
133                     1    Log only critical errors.
134
135                     2    Log errors and logins/logouts.
136
137                     3    Log errors, logins/logouts and all gateway commands.
138
139                     Default is to log only critical errors.
140
141       NodeId <nodeid>
142                     This is the node id that is shown in every  message  from
143                     node. Default is "URONode".
144
145       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
150       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
158       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
164       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
173       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
178       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

PARAMETER EXPANSION

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
188       %parameter    This is substituted with the value of parameter
189
190       %{parameter}  The same as above.
191
192       %{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
198       The following parameters are defined:
199
200       0...9   The positional parameters.
201
202       U       The username (callsign) of the remote  station  in  upper  case
203               without the SSID.
204
205       u       The  username  (callsign)  of  the remote station in lower case
206               without the SSID.
207
208       S       The username (callsign) of the remote  station  in  upper  case
209               with the SSID.
210
211       s       The  username  (callsign)  of  the remote station in lower case
212               with the SSID.
213
214       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
218       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
222       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
226       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
230       t       The type of the user  connection  (ax25,  netrom,  rose,  inet,
231               host) in lower case.
232
233       T       The  type  of  the  user  connection (ax25, netrom, rose, inet,
234               host) in upper case.
235
236       Anything else after a % is substituted with a %.
237

FILES

239       /usr/local/etc/ax25/uronode.conf
240

SEE ALSO

242       uronode(8), uronode.perms(5), axports(5), ax25(4).
243
244
245
246Linux                            28 April 1998                 URONODE.CONF(5)
Impressum