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>

Linux                                             15 July 2011                                        NRPARMS(8)