uronode - Man Page

Node front end for AX.25, NET/ROM, Rose and TCP

Synopsis

node

Description

URONode is a simple node front end, modelled after the node shells of LinuxNode, AWZNode, and Flexnode.

Commands

The following commands are supported for users of URONode:

?

Give short list of available commands.

Announce

Reads the file uronode.announce. This is like a local announcement wall where you can give your locals connecting into your node a chance to see the local activities going on like a cork board with posted announcements.

Bye

Disconnect user from the node.

Connect <call | alias> [s|d]                  For NETROM
Connect <port> <call> [via <call1> ...] [d|s] For AX.25
Connect <call> <address> [<digi>] [d|s]       For ROSE
Connect <destination> [s|d]                   For FlexNet

Initiates an AX25, NET/ROM, ROSE or Flexnet connection to a remote host.  If more than two parameters are entered and the second parameter is ten  charachers in length then it is interpreted as a ROSE connection,  otherwise the first parameter is interpreted as a port name and AX25 is  used to make the connection via that port. If only one parameter is given  the connection is made searching for the callsign in NET/ROM nodes,  in AX25 Fixed links, in FlexNet destinations and last in Mheard database  in this order.

For a ROSE connection the <address> part must be exactly six or ten digits. If only six digits are supplied, the DNIC (first four digits) default to the local DNIC. The local DNIC is assumed to be that of the first configured Rose port in /etc/ax25/rsports.

The user may optionally supply as the last argument a single character which modifies the default behaviour on disconnection of the connection. If a single `s' is entered as the last argument, then when the remote host disconnects you will be returned to this node. If a single `d' is entered as the last argument, you will be disconnected from this node too. The Default behaviour (neither `s' nor `d' entered) is configured in the node configuration file and depends on the sysop preference.

CAllbook <call>[@<server>]

Retrieve data about a callsign from an internet-accessible callbook server. The server name can usually be omitted, since the default server configured by the operator is usually valid. The default setting can be overridden by specifying a host name.

Escape [<escape string>]

Override the sysop configured default escape character setting. If the Escape command is given without an argument then the current escape character setting is returned to the user. The escape string may be specified using any of the well known codings:

<char> to enter the escape character in its binary form.

^C to enter the escape character as a control character value.

NNN to set the escape character to a Decimal value.

0xNN to set the escape character to a HexaDecimal value.

0NNN to set the escape character to an Octal value.

off to disable the escape character.

Finger [<username>][@<hostname>]

Retrieve information about users of a system. If the user name is omitted, shows the users currently logged on the host. If the hostname is omitted, defaults to the local host.

Help [<command>]

Give help for the specified command or this text if no command is specified. Commands can not be abbreviated. Use the "?" command to retrieve a list of available commands.

HOst <hostname> | <ip address>

Give the Domain Name Service host name information about <hostname> or <ip address>.

Info

Display the version information and the contents of the /usr/local/etc/ax25/uronode.info file, which should describe any aspects of your system that you would like to brag about.

INTerfaces

Display the node's interface schema, most folks often call these "ports".

Jheard<interface>

Displays the last 20 stations heard to this node. You may use an interface name to get the last 20 stations heard to that particular interface.

JLong<interface>

Displays the full list of the heards database up to the last 100 callsigns. Add the name of an interface for the full heards listing for that specific interface.

Links [d | n | v | <call>]

Shows the AX25 link table of the local node. The destinations  on this list can be reached using the Connect command without  knowing the actual network path used (assuming the network is OK).

The optional parameter d show the AX25 nodes directly linked. The optional parameter n show the AX25 nodes linked connecting  another node and passing a string like "C XX0XX". The optional parameter v show the AX25 links via digipeaters.

You can also specify a destination callsign to get the verbose  information for a single destination.

Nodes [* | <node>]

Show the NET/ROM node table of the local host. The nodes on this list can be reached using the Connect command without knowing the actual network path used (assuming the network is OK).

The optional argument '*' toggles verbose mode, showing the Obsolescence counter, relative path quality and the port and neighbour node used to reach each node. You can also specify a node callsign to get the verbose information for a single node. In that case a "which" field that tells what route the kernel will use to reach the node is also shown.

Ping <host> [<size>]

Check if a host can be reached trough the network by sending an ICMP Echo Request packet to the host and waiting for it to reply. If a reply is received the round-trip-time (RTT) between the local and remote hosts is shown.

If an optional length is specified the data portion of the packet is filled with length number of bytes up to 128.

Routes

Shows the NET/ROM route table of the local host (eg. the nodes which the local node directly talks with). These nodes are used to reach the other nodes on the node table. Fields shown are:

Link Is there an AX25 connection active to this node.

Port Which port is this route on.

Callsign The callsign of the neighbour node.

Quality A relative quality for the path (0-255).

Destinations Number of other nodes reached via this route.

Lock Is the quality of this route locked by the operator.

QSO Number of NET/ROM session enties.

Telnet <host> [<port>] [<string>] [d|s]

Initiate a telnet session to a remote host using TCP/IP. By default, the telnet command connects to the TCP port 23 (allocated for telnet). You can specify another TCP port or a TCP port name.

If an optional third argument <string> is given, that string, followed by a CRLF is sent to the remote host right after the connection is established. This is mainly useful for command aliases.

If a single `s' is entered as the last parameter, then when the remote host disconnects you will be returned to this node. If a single `d' is entered as the last parameter, you will be disconnected from this node too. Default behaviour (neither `s' nor `d' entered) depends on sysop configuration.

MSG <user> <message>

Send a message to another user of the node. The user in question must be in idle state (ie. not connected/connecting anywhere or running a program).

If the user has an SSID other than zero, the SSID must be specified. If multiple users are logged in with the same callsign/SSID pair, those who are in idle state, get the message.

Users

Show a list of users currently connected to the local node, where the users are coming from, and what are they doing at the moment.

Files

/usr/local/etc/ax25/uronode.conf

URONode configuration file.

/usr/local/etc/ax25/uronode.perms

URONode permissions file.

/usr/local/etc/ax25/uronode.users

URONode users settings file.

/usr/local/etc/ax25/uronode.motd

URONode message of the day file.

/usr/local/etc/ax25/uronode.info

The response to the 'info' command.   This file should be edited to reflect the local configuration.

/usr/local/var/ax25/node/loggedin

Database of current users.

/usr/local/var/ax25/mheard/mheard.dat

Information about AX.25 stations heard.

/usr/local/var/ax25/node/help/*.hlp

The online help files.

See Also

uronode.conf(5), uronode.perms(5), axports(5), ax25d(8), mheardd(8).

Author

Brian Rogers N1URO <n1uro@n1uro.com>

Thanks to

Stefano Noferi IZ5AWZ <iz5awz@radio-gw.cnuce.cnr.it>
Tomi Manninen OH2BNS <tpmannin@cc.hut.fi>
Alan Cox GW4PTS <gw4pts@gw4pts.ampr.org>
Roy PE1RJA <roy@esrac.ele.tue.nl>

Referenced By

calibrate(8), flexd.conf(5), nodeusers(1), uronode.conf(5), uronode.perms(5).

28 April 1998 Linux System Managers Manual