Provided by: ax25-tools_0.0.10-rc2+cvs20120204-3ubuntu1_amd64 bug

NAME

       nrparms - Configure the NET/ROM interface.

SYNOPSIS

       nrparms -nodes node +|- ident quality count port neighbour [digicall...]

       nrparms -routes port nodecall [digicall...] +|- quality

       nrparms -version

DESCRIPTION

       This  program is used to manipulate the routing tables of the NET/ROM network layer, or to
       get and set many of the network and transport layer parameters for the  NET/ROM  protocol.
       The  program  has  three  basic  modes  of  operation, node setting, neighbour setting and
       general parameter setting. The syntax for the node and neighbour setting is taken from the
       original  NET/ROM  manual  and is therefore not very UNIXy but should be familiar to those
       familiar with NET/ROMs or TheNet.

       To set up a new route to a NET/ROM node in the routing  tables  you  must  use  the  nodes
       option.  All  of  the  parameters  are  needed  to  add  the  node. It is probably best to
       illustrate with an example:

            nrparms -nodes GB7BPQ + NMCLUS 120 6 vhf G8ROU-3

       This creates a new route to a distant node with the callsign GB7BPQ and the alias  NMCLUS,
       it  has a quality of 120 (out of 255) and has an obsolescence count of six and packets for
       that node should be sent on the AX.25 port named vhf to my  immediate  neighbour  G8ROU-3.
       The  callsigns  of  the  node and the neighbour may be the same. For example to set up the
       node G8ROU-3 which is also my immediate neighbour, I would use:

            nrparms -nodes G8ROU-3 + MATLCK 200 6 vhf G8ROU-3

       If the ident of the remote node is not known, it is possible to add a node  with  a  blank
       ident.  To  do  this  an  ident of '*' must be entered on the command line. Because of the
       command line expansion that shells do, the * must be escaped by enclosing it in quotes.

       It is also possible to remove a route to a distant node with the same command except  that
       the  +  is replaced by a -. The other parameters must also be present. If the node has not
       other routes then the node will be deleted, and the neighbour node that the connections go
       via  may  also be deleted if no other node route uses it, and it is not a locked neighbour
       entry.

       When setting up a new node, a new neighbour entry may also be created. This  will  have  a
       default  value.  For  that neighbour to be meaningful in the automatic routing process, it
       must have a more reasonable entry in the neighbours list. To do this the routes option  of
       the command must be used.  An example:

            nrparms -routes ax0 G8ROU-3 + 120

       This  will create (or update) the neighbour entry for G8ROU-3 with a quality of 120 and it
       will be locked, it will not create a node entry for the neighbour. This  quality  will  be
       used  by  the  netromd(8)  program  when  calculating  route qualities via this neighbour.
       Normally once a neighbour has zero node routes going via it, it will be deleted. Locking a
       neighbour  prevents  the  deletion  from  occurring. To unlock a neighbour entry, the same
       command is used but with the + replaced by a -.

FILES

       /etc/ax25/axports
       /etc/ax25/nrports

SEE ALSO

       call(1), netrom(4), nrports(5), axparms(8), netromd(8), nrparms(8).

AUTHOR

       Jonathan Naylor G4KLX <g4klx@g4klx.demon.co.uk>