URONODE(8)

πŸ’– URONode πŸ’–

okay bestie, gather round, because this is URONODE(8) β€” the man page for URONode, sitting pretty in section 8 of the Linux System Managers Manual. no cap, it's a whole vibe. let's get into it πŸ¦‹


🌸 NAME 🌸

URONode β€” 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. it's giving "classic node energy, but make it yours". ✨


πŸ’… COMMANDS πŸ’…

The following commands are supported for users of URONode:

  • ? β€” gives you a short list of all the available commands. that's it, that's the whole job, and honestly? iconic. πŸŽ€
  • Announce β€” reads the file uronode.announce. think of it like a local announcement wall, a cork board with posted announcements where your locals who connect into your node get to see what's going on in the area. 🫢
  • Bye β€” disconnects the user from the node. sayonara, bestie. πŸ‘‹
  • Connect β€” kicks off an AX25, NET/ROM, ROSE or Flexnet connection to a remote host. the exact shape of the command depends on what you're connecting to:
    • 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

If more than two parameters are entered and the second parameter is ten charachers in length, then it's 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 by searching for the callsign in NET/ROM nodes, then in AX25 Fixed links, then in FlexNet destinations, and last in the Mheard database β€” in that order. order matters, bestie, don't skip steps.

For a ROSE connection the <address> part must be exactly six or ten digits. if you only supply six digits, the DNIC (the first four digits) defaults to the local DNIC. the local DNIC is assumed to be that of the first configured Rose port in /etc/ax25/rsports. πŸ“Œ

You may optionally supply, as the last argument, a single character that modifies the default behaviour on disconnection of the connection:

  • a single s as the last argument β†’ when the remote host disconnects, you get returned to this node. 🏠
  • a single d as the last argument β†’ you get disconnected from this node too. πŸ’€
  • neither s nor d β†’ that's the default behaviour, and it's configured in the node configuration file, depending on the sysop's preference.
  • CAllbook <call>[@<server>] β€” retrieves 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. you can override that default setting by specifying a host name. 🌐
  • Escape [<escape string>] β€” overrides the sysop-configured default escape character setting. if you run Escape with no argument at all, the current escape character setting is returned to you. the escape string can 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>] β€” retrieves information about users of a system. if the user name is omitted, it shows the users currently logged on the host. if the hostname is omitted, it defaults to the local host. πŸ•΅οΈ
  • Help [<command>] β€” gives help for the specified command, or this text if no command is specified. heads up: commands can not be abbreviated. use the ? command to retrieve a list of available commands. πŸŽ€
  • HOst <hostname> | <ip address> β€” gives you the Domain Name Service host name information about <hostname> or <ip address>. πŸ”
  • Info β€” displays 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. go off, main character. πŸ‘‘
  • INTerfaces β€” displays the node's interface schema. most folks just 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 shows the AX25 nodes directly linked.
    • the optional parameter n shows the AX25 nodes linked connecting another node and passing a string like C XX0XX.
    • the optional parameter v shows the AX25 links via digipeaters.

you can also specify a destination callsign to get the verbose information for a single destination. πŸ”—

  • Nodes [* | <node>] β€” shows 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, the 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 β€” and in that case a which field is also shown, telling you what route the kernel will use to reach the node. πŸ‘‘βœ¨

  • Ping <host> [<size>] β€” checks 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 comes back, 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. the 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] β€” initiates a telnet session to a remote host using TCP/IP. by default, the telnet command connects to 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'll be returned to this node. if a single d is entered as the last parameter, you'll be disconnected from this node too. the default behaviour (neither s nor d entered) depends on the sysop configuration. 🫢

  • MSG <user> <message> β€” sends 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 β€” shows a list of users currently connected to the local node, where those users are coming from, and what they're 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>

and that's the whole page, bestie πŸ’– this one shipped from Linux and it's dated 28 April 1998 β€” shoutout to the elders who wrote it, we stan forever. now go configure something iconic. 🌈✨