AXPARMS(8)

NAME
axparms - Configure AX.25 interfaces.

SYNOPSIS
axparms -assoc|-parms|-route|-setcall ...

DESCRIPTION

The axparms command is designed to be a multi-function command that allows miscellaneous commands to be issued to the Linux AX.25 protocol layer. It includes the functionality of axassociate and axsetcall which this command superceedes. The different modes of the command are chosen by the first argument. Sunsequent arguments depend upon this argument and so no generalised command format can be given.

-assoc Argument

The format of this option is:

axparms -assoc <callsign> <username>
axparms -assoc <callsign> delete
axparms -assoc policy [default|deny]
axparms -assoc show

This option mainpulates the kernel uid/callsign mapping table, allowing callsigns to be associated and dis-associated with a user. The policy option permits the superuser to have all other uid's either default to the actual port name, or to block traffic.

At power up the table is blank and the policy is 'default', which is thus backward compatible.

-parms Argument

The parms argument is used to get or set the parameters in use by each of the AX.25 interfaces, be they serial ports to a KISS TNC, a BPQ Ether link or an 8530 SCC board. Many of these parameters may be overridden by calls to setsockopt(2) or may be dynamically overridden by the kernel code itself.

Some of the options may be used to control the usage of a particular interface, for example disabling connected mode on a given interface will also disable NET/ROM and standard AX.25 connected mode, regardless of the settings for the flags for these two modes. Using the command with just the basic parameters will display the parameters for the given interface, these parameters may be changed by use of option flags followed by the values.

OPTIONS

-ipmode D|V
    Sets the default mode for IP. The values for mode are 'D' for Datagram and track the mode of incoming IP packets.

-axmode S|E
    Sets the default for connected mode AX.25. The values are 'S' for standard AX.25 version 2, and 'E' for AX.25 using extended sequence numbers. The kernel default is standard AX.25, but the kernel will accept incoming connects of either mode.

-con Y|N
    This sets whether the kernel AX.25 code will accept any form of connected mode packets. The kernel default is Yes, setting this to No will only allow for Datagram mode ARP and IP operation.

-netrom Y|N
    Sets whether incoming NET/ROM packets are passed to the NET/ROM layer, if present. The kernel default is Yes.

-text Y|N
    Sets whether incoming text mode AX.25 packets are passed onto user level applications. The kernel default is Yes.

-window window
    Sets the window size for standard AX.25 mode. The limits are between 1 and 7 with the kernel default being 2.

-ewindow window
    Sets the window size for extended AX.25 mode. The limits are between 1 and 63 with the kernel default being 32.

-t1 t1-timeout
    Sets the initial T1 timeout value for connected mode. The value is given in seconds and may not be less than 1. The kernel default is 10 seconds.

-t2 t2-timeout
    Sets the T2 timeout value for connected mode. The value is given in seconds and may not be less than 1. The kernel default is 3 seconds.

-t3 t3-timeout
    Sets the T3 timeout value for connected mode. The value is given in seconds and may not be less than 1. The kernel default is 300 seconds.

-n2 retries
    Sets the retry count for connected mode. The value must be between 1 and 31, the kernel default being 10.

-route Argument

This option allows the internal AX.25 routing table to be manipulated. This table is available for reading in /proc/net/ax25_route, and will be built up dynamically by stations heard. However it is possible to add and delete entries via this option.

The format of this options is:

axparms -route add <port> <callsign> [<digipeater> ...]
axparms -route del <port> <callsign>

Routes added via this command will not be removed from the internal routing table when they are ``old'' as normal entries are.

-setcall Argument

The format of this option is:

axparms -setcall <serial-device> <callsign>

This changes the callsign associated with the given serial device in KISS mode. The change is permanent until the link is downed or another ``axparms -setcall'' is made.

The interface must already have been attached with axattach to use this option.

FILES

/usr/local/ax25/axports

SEE ALSO
call(1), getsockopt(2), setsockopt(2), ax25(4), axports(5).

AUTHORS
Alan Cox GW4PTS <A.Cox@swansea.ac.uk>
Jonathan Naylor G4KLX <jsn@cs.nott.ac.uk>