Provided by: ax25-tools_0.0.8-13.1ubuntu1_i386 bug

NAME

       ax25d.conf - ax25d configuration file.

DESCRIPTION

       Ax25d.conf  controls  the  functioning  of  ax25d.   Its  purpose is to
       specify on which ports to listen on, which applications are  available,
       and  to whom they are available to. The configuration file is common to
       both AX.25, NET/ROM and Rose and their is similarity  between  the  two
       parts of the file.

       The general layout for an entry for a given port is as follows:

              interface control
              callsign entry 1
               .
               .
              callsign entry n

       The interface control line determines which port and callsigns apply to
       the following callsign entry lines, until the next interface control is
       read. There are four different variants of the interface control line:

              1. [AX.25 Port Name]
              2. [Callsign VIA AX.25 Port Name]
              3. <NET/ROM Port Name>
              4. {Callsign VIA Rose Port Name}

       Version  1  allows  the following callsign entry lines to listen on the
       AX.25 port specified by the AX.25 port name using the default  callsign
       of that AX.25 port.

       Version  2  allows  the following callsign entry lines to listen on the
       AX.25 port  specified  by  the  AX.25  port  name  using  the  callsign
       specified   instead  of  the  default  callsign  of  that  AX.25  port.
       Specifying a * for the AX.25 port name allows  the  following  callsign
       entries  to  be  valid  for  all  the  operating  AX.25 ports using the
       callsign specified. VIA can be abbreviated to just V. If  the  callsign
       has an asterisk appended to it then the system will be listening on the
       port with the callsign, but as a pseudo-digipeater instead of being the
       normal destination callsign.

       Version  3  allows  the following callsign entry lines to listen on the
       NET/ROM port specified by the  NET/ROM  port  name  using  the  default
       callsign of that NET/ROM port.

       Version  4  allows  the following callsign entry lines to listen on the
       Rose port using  the  specified  Rose  port  name  using  the  callsign
       specified as the service access point (SAP). A * may be specified for a
       callsign to allow matching to any incoming Call Requests with any  SAP.

       The  callsign entry lines have a similar layout for both AX.25, NET/ROM
       and Rose, the layout is:

              peer window t1 t2 t3 idle n2 mode uid exec args...

       All values must be entered for all entries even when they are not  used
       (ie  window  for NET/ROM, just enter a * instead), The meanings of each
       of the fields is given below. All timings apart from the idle value are
       given in seconds, the idle values is given in minutes.

              peer      This  specifies  the callsign of the remote end of the
                        connection that should have the  following  parameters
                        and executable set up for them. The syntax of the peer
                        argument is explained below.

              window    This sets the the value of the window size, if a value
                        of  *  is entered in this field then the default value
                        for the port is taken from the “parameters” entry (see
                        below)  or  lacking  such an entry, the kernel default
                        value is used.  This entry is used by AX.25 but not by
                        NET/ROM or Rose.

              t1        This sets the the value of the T1 timer, if a value of
                        * is entered in this field then the default value  for
                        the  port  is  taken  from the “parameters” entry (see
                        below) or lacking such an entry,  the  kernel  default
                        value  is  used.  This entry is used by both AX.25 and
                        NET/ROM but not by Rose.

              t2        This sets the the value of the T2 timer, if a value of
                        *  is entered in this field then the default value for
                        the port is taken from  the  “parameters”  entry  (see
                        below)  or  lacking  such an entry, the kernel default
                        value is used.  This entry is used by both  AX.25  and
                        NET/ROM but not by Rose.

              t3        This sets the the value of the T3 timer, if a value of
                        * is entered in this field then the default value  for
                        the  port  is  taken  from the “parameters” entry (see
                        below) or lacking such an entry,  the  kernel  default
                        value is used.  This entry is used by AX.25 but not by
                        NET/ROM or Rose.

              idle      This sets the the value of the idle timer, if a  value
                        of  *  is entered in this field then the default value
                        for the port is taken from the “parameters” entry (see
                        below)  or  lacking  such an entry, the kernel default
                        value is used.

              n2        This sets the the value of the N2 counter, if a  value
                        of  *  is entered in this field then the default value
                        for the port is taken from the “parameters” entry (see
                        below)  or  lacking  such an entry, the kernel default
                        value is used.  This entry is used by both  AX.25  and
                        NET/ROM but not by Rose.

              mode      This  is  a  set  of  flags  that  control the various
                        properties associated with  the  incoming  connection.
                        The  flags  are single letters, may be in either upper
                        or lower case, and there may not be any spaces between
                        them. If no flags are to be specified either a 0, - or
                        a * must be  entered  instead.  The  valid  mode  flag
                        letters are:

                        D    Do not allow connections that have passed via any
                             digi-peaters. AX.25 only.

                        L    Do not allow this station to  connect,  they  are
                             Locked out.

                        N    Check  that  the  NET/ROM  neighbour  is allowed,
                             currently unused.

                        Q    Do not make an entry into the log file  for  this
                             connection.

                        V    Validate the callsign of the incoming connection,
                             currently unused.

              uid       This is the userid that the following  command  should
                        run under when executing.

              exec      This is the executable that should be executed when an
                        incoming connection matches the criteria of  both  the
                        interface control and the callsign entry .

              args...   These  are  the  optional arguments that are passed to
                        the  executable.  All  of  the  arguments  are  passed
                        literally apart from the following:

                        %d   The name of the port that the connection is on.

                        %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 of the remote station in upper case
                             without the  SSID.   This  is  only  valid  under
                             NET/ROM  and Rose, under AX.25 a % is substituted
                             instead.

                        %p   The nodename of the remote station in lower  case
                             without  the  SSID.   This  is  only  valid under
                             NET/ROM and Rose, under AX.25 a % is  substituted
                             instead.

                        %R   The  nodename of the remote station in upper case
                             with the SSID.  This is only valid under  NET/ROM
                             and Rose, under AX.25 a % is substituted instead.

                        %r   The nodename of the remote station in lower  case
                             with  the SSID.  This is only valid under NET/ROM
                             and Rose, under AX.25 a % is substituted instead.

                        %%   A %.

       The  peer  argument is dependant upon whether AX.25, NET/ROM or Rose is
       being used. There are five formats of this argument:

              1. default
              2. parameters
              3. callsign
              4. callsign@node
              5. @node

       The first version is used by AX.25, NET/ROM and Rose  to  specify  that
       all  callsigns  on  a given port are to be matched. The default line is
       usually the last of the callsign entry lines,  so  that  more  specific
       entries may have the chance to be matched first.

       The second version is not a callsign entry that is used by any incoming
       connections. It is a means to specify  default  values  for  parameters
       such  as  Window,  T1,  T2, T3, Idle and N2. It is used for both AX.25,
       NET/ROM and Rose.

       The third version is used by both AX.25, NET/ROM and  Rose  to  specify
       the callsign of the remote station to match the callsign entry line. If
       no SSID is specified then the callsign will be matched  with  any  that
       has  the  same  callsign  and  any  SSID. Specifying an SSID causes the
       callsign to be matched exactly. In the case of NET/ROM  and  Rose  this
       entry  does not specify which node the originating callsign comes from.

       The fourth version is used by NET/ROM and Rose to specify the  callsign
       of  the  remote station and the remote node to match the callsign entry
       line. If no SSID is specified in the callsign section then the callsign
       will  be  matched  with  any  that  has the same callsign and any SSID.
       Specifying an SSID causes the callsign to be matched exactly.

       The fifth version is used by NET/ROM  and  Rose  to  specify  only  the
       address of the remote node to match the callsign entry line. This entry
       will mean that all remote users at the given node will match the entry.

       Comments  may  be  embedded in the configuration file by placing a # in
       the first column.

FILES

       /etc/ax25/ax25d.conf

SEE ALSO

       ax25(4),  netrom(4),  rose(4),  axports(5),   nrports(5),   rsports(5),
       ax25d(8).