Provided by: ax25-tools_0.0.8-13.1ubuntu1_i386 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),  nrctl(8),
       nrparms(8).

AUTHOR

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