Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

nrparms(8) [debian man page]

NRPARMS(8)						   Linux System Managers Manual 						NRPARMS(8)

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 call- signs 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 <> Linux 25 January 1997 NRPARMS(8)

Check Out this Related Man Page

NETROMD(8)						   Linux System Managers Manual 						NETROMD(8)

netromd - Send and receive NET/ROM routing messages SYNOPSIS
netromd [-c] [-d] [-i] [-l] [-p pause] [-q quality] [-t interval] [-v] DESCRIPTION
For a NET/ROM based network to operate correctly, a periodic broadcast of routing information needs to occur. Typically this occurs once every hour on every port which is expected to carry NET/ROM traffic. The purpose of netromd is to send and receive NET/ROM routing broad- casts. To operate correctly a set of parameters that corresponds to each AX.25 port needs to be passed to the program. This information is encoded in a configuration file, by default which is /etc/ax25/nrbroadcast with each line representing one port, see the manual page for nrbroadcast(5). To cut down the length of these routing broadcasts, only the information about the highest quality neighbour for a particular node is transmitted. The transmission is also limited to those node that have a certain minimum value in their obsolesence count, this value is decremented every time a routing broadcast is transmitted, and is refreshed by receiving a routing broadcast which contains that particular node. The value of the default quality is traditionally assigned a value that represents the quality of the radio links on that port. A higher number representing better radio links with 255 (the maximum) reserved for wire connections. The practise in the UK is to set the default quality to a low value, typically 10, and manually set up the trusted neighbouring nodes in the neighbour list manually. The worst quality for auto-updates value is a way to filter out low quality (ie distant) nodes. The verbose flag may be either 0 or 1, representing no and yes. By specifying no, the program will only generate a routing message contain- ing information about the node on which it is running, by specifying the yes option, all the information in the nodes routing tables will be transmitted. The quality advertised for the other node callsigns on this machine may be set using the -q option. Between each transmission netromd pauses for five seconds (default) in order to avoid flooding the channels that it must broadcast on. The value of this delay is settable with the -p option. OPTIONS
-c Forces strict compliance to Software 2000 specifications. At present this only determines how node mnemonics with lower case characters will be handled. With compliance enabled mixed case node mnemonics will be ignored. The default is to accept node mnemonics of mixed case. -d Switches on debugging messages, the default is off. Logging must be enabled for them to be output. -i Transmit a routing broadcast immediately, the default is to wait for the time interval to elapse before transmitting the first routing broadcast. -l Enables logging of errors and debug messages to the system log. The default is off. -p pause Sets the delay between transmissions of individual routing broadcast packets. The default is five seconds. -q quality Sets the quality of the subsidiary nodes relative to the main node. The default is 255. -t interval The time interval between routing broadcasts, in minutes. The default is 60 minutes. -v Display the version. FILES
/proc/net/nr_neigh /proc/net/nr_nodes /etc/ax25/axports /etc/ax25/nrbroadcast SEE ALSO
ax25(4), axports(5), nrbroadcast(5), netrom(4), nrparms(8). AUTHOR
Jonathan Naylor G4KLX <> Linux 20 August 1996 NETROMD(8)
Man Page