NRPARMS(8)

NAME
nrparms - Configure the NET/ROM interface.

SYNOPSIS
nrparms -nodes node +|- ident qual count dev neigh

nrparms -parms [-option value] ...

nrparms -routes dev call +|- qual

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 sl0 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 device sl0 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 sl0 G8ROU-3

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 sl0 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 netromt(8) and netromr(8) programs 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 -.

The final use of this command is to display or update the NET/ROM parameters. Just giving the commmand:

nrparms -parms

will display the parameters in use. In order to update these parameters, the same command is used but with options following the parms flag.

The axparms command may also have an effect on the performance of the NET/ROM links as it controls the parameters of the link layer in use.

OPTIONS

-qual quality
    Sets the default quality of a new neighbour

-obs obs-count
    Sets the default obsolescence count for a new route to a node

-ttl time-to-live
    The default time-to-live value

-tto transport-time-out
    Sets the transport layer retry timer value

-tries tries
    Sets the number of transport layer tries.

-ack ack-time-out
    Sets the transport layer delayed acknowledgement timer value

-busy busy-time-out
    Sets the transport layer peer choked timer value

-win window
    Sets the default window size in frames, this will be negotiated on connection start up.

FILES

/usr/local/etc/nrports

SEE ALSO
call(1), netrom(4), nrports(5), axparms(8), netromr(8), netromt(8).

AUTHOR
Jonathan Naylor G4KLX <jsn@cs.nott.ac.uk>