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).