MAN page from RedHat Other ax25-utils-2.1.22-1.i386.rpm

NRPARMS

Section: Linux System Managers Manual (8)
Updated: 25 January 1997
Index

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 networklayer, or to get and set many of the network and transport layer parametersfor the NET/ROM protocol. The program has three basic modes of operation,node setting, neighbour setting and general parameter setting. The syntaxfor the node and neighbour setting is taken from the original NET/ROM manualand is therefore not very UNIXy but should be familiar to those familiarwith NET/ROMs or TheNet.

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

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

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

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

If the ident of the remote node is not known, it is possible to add anode with a blank ident. To do this an ident of '*' must be entered onthe 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 samecommand except that the + is replaced by a -. The other parameters must alsobe 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 noother 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. Thiswill have a default value. For that neighbour to be meaningful in theautomatic routing process, it must have a more reasonable entry in theneighbours 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 qualityof 120 and it will be locked, it will not create a node entry for theneighbour. This quality will be used by thenetromd(8)program when calculating route qualities via this neighbour. Normally once aneighbour has zero node routes going via it, it will be deleted. Locking aneighbour 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

AUTHOR

Jonathan Naylor G4KLX <jsnAATTcs.nott.ac.uk>

This document was created byman2html,using the manual pages.