AX25D.CONF(5)						     Linux Programmer's Manual						     AX25D.CONF(5)

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 con-
       trol 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 speci-
       fied 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 des-
       tination 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 speci-
       fied 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 speci-
			fied 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 digipeaters. 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 con-
			trol 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.

       ax25d  can  now	honour	AX.25  TCP/IP mode-VC connections in a special way.  Therefore, a new port specific option "parameters_extAX25" is
       available, with the following options, which are seperated by space.

       parameters_extAX25
	    VC-debug
	    VC-reject-login|VC-wait-login|VC-login-ok
	    VC-disc-on-linkfailure-msg, VC-send-failure-msg, VC-log-connections
	    Recommended settings in ax25d.conf:
	      parameters_extAX25 VC-wait-login VC-disc-on-linkfailure-msg VC-log-connections
	    or
	      parameters_extAX25 VC-reject-login VC-send-failure-msg VC-log-connections

FILES

       /etc/ax25/ax25d.conf

SEE ALSO

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

Linux								  17 January 1997						     AX25D.CONF(5)