JNOS Commands Manual - The N Commands
Jump Table/Index
The N Command Set
netrom <subcommands> These commands influence netrom behavior. netrom acktime [<milliseconds>] Displays or sets the ack delay timer, similarly to ax25 t2. Default is 8000ms (i.e. 8 seconds). netrom alias <aliascall> This sets the netrom alias call for this station. Other stations can connect to the ax25 callsign and to the NetRom alias (when set). The alias is broadcast with a NetRom broadcast. If netrom is not activated, you can use the 'ax25 alias' command to set the alias callsign, such that users can still connect to the alias, even though netrom activities are not allowed. netrom bcnodes <iface> Initiates an immediate broadcast of nodelist on <iface>. Verbose behavior is controlled by the 'netrom interface' command. netrom bcpoll <iface> Initiates a poll sent to the named interface. This poll will request a netrom routes broadcast from other nodes, so that the routing table can be updated. This is automatically done any time an interface is activated (or changed) for netrom. This should speed up route discovery at startup. netrom call <call> Displays or sets the call to be used by the netrom interface. Note: this is a shortcut for the 'ifconfig netrom linkaddress' command. It defaults to the 'ax25 mycall' value. netrom choke [<milliseconds>] Display or set the time breaking a send choke. Choke is the term netrom uses for flow control conditions. Default is 180000 ms (180 seconds.) netrom connect <node> Starts a new JNOS session and attempts to establish a netrom transport connection with <node>, which must be a known node call or alias. netrom derate [ON|off] Display or set automatic derating of netrom routes on link failure. Default is on. netrom g8bpq {on | OFF] Display or set the G8BPQ-emulation behaviour. If set, transport layer conreq frames carry two extra bytes to indicate round-trip time, and conack frames have one extra byte to contain TTL (hopcount). netrom hidden [on|OFF] Display or set the hidden node flag. Nodes with aliases starting with the '#' character are displayed using the command 'N *'. Default is OFF. netrom interface [<iface> <quality> [n]] Activate <iface> as a netrom interface. <quality> can be between 1 and 255. Interfaces are activated using verbose routes broadcasting by default, meaning that they broadcast all known routes. This can be changed by adding the optional 'n' parameter to the command. Then only the system itself will be announced in a broadcast, not the known routes. If the paclen of the interface is smaller then the netrom mtu + 20, then the netrom mtu will be set to paclen-20 . This is to avoid fragmentation, causing incompatibilities with non-JNOS based NetRom nodes. See the 'ifconfig <iface> paclen' command for more. If <iface> has already been activated as a netrom interface, re- issuing the command will set <quality> and [n] to the new values. 'netrom interface' will show the currently active netrom interface. Each time an interface is activated or changed, a broadcast poll will be sent out on the interface. This minimizes the route discovery time at startup, and will update routes when the interface quality has changed. netrom irtt [<milliseconds>] Display or set the initial round trip time. Default is 45000ms, i.e. 45 seconds. netrom kick <nrcb> Give the control block a kick to get activity going again. netrom load Retrieves the last set of netrom destination data saved with the 'netrom save' command. netrom maxclients [<count>] Displays or sets the maximum number of simultaneous outgoing netrom sessions that will be allowed. The default is 10. Reduce <count> if network congestion is a problem. netrom minquality [<minqual>] Display or set the minimum quality for recognizing a node entry. Entry's below this value are not considered valuable for usage. Default is 50. You are strongly urged to set this value much higher, so as to minimize the space needed to store the nodes list. A consequence of too many nodes listed is memory depletion, leading to lockups or reboots. netrom neighbor Display all known netrom neighbors. netrom nodefilter <subcommands> Manipulate node filtering. netrom nodefilter add <neighbor> <iface> Add <neighbor> on port <iface> to the filter table. See the 'netrom nodefilter mode' command to determine the manner to handle node updates from <neighbor>. netrom nodefilter mode [none|accept|reject] Display or set the initial node filter scheme. 'none' accepts all netrom routes and is the default. 'accept' accepts routes only from nodes defined with the 'netrom nodefilter add' command. 'reject' does not accept routes from any nodes defined with 'netrom nodefilter add' netrom nodefilter drop <neighbor> <iface> Delete the node <neighbor> on interface <iface> from the filter table. netrom nodetimer [<seconds>] Display or set the interval to transmit the nodes list. If you want to use other than the default, you must first attach the netrom interface with 'attach netrom' and then set the new nodetimer value. Default is 1800 seconds (half an hour). netrom obsotimer [<seconds>] Display or set the time a node obsolescence count gets decremented. If you want to use other than the default, you must first attach the netrom interface with 'attach netrom' and then set the new obsotimer value. Default is 1800 seconds. netrom promiscuous [OFF|on] Enables nodes with a path quality greater than defined with minquality. If on, all nodes are received regardless of nodefilter mode. Default is off. netrom qlimit [<nnnn>] Display or set the maximum queue limit for choke to occur. Similar to ax25 window. Default is 512 bytes. netrom reset <nrcb> Remove the control block. You can find the control block with the 'netrom status' or 'socket' commands. netrom retries [<nn>] Display or set the maximum number of retries on connect, disconnect or data. Default is 3. netrom route <subcommands> NetRom routing commands. Routes can be marked as 3 types in the various route displays: 'P' - a permanent route set with the 'netrom route add' command 'B' - a route received through a nodes broadcast from a neighbor node 'R' - a recorded route from an incoming packet from a not previously known netrom node netrom route add <alias> <call> <iface> <quality> <neighbor> Add a permanent netrom route. The new route is to netrom system <alias> with call <call>, and the route is on interface <iface> with quality <quality> via the neighbor <neighbor>. netrom route add salem af7s-1 port1 178 k7uyx-1 A route to a direct neighbor looks like: netrom route add crv k7uyx-1 port1 192 k7uyx-1 netrom route drop <destination> <neighbor> <iface> Delete the netrom route to call <destination> via neighbor <neighbor> on <iface>. netrom route info [<destination>] Display the route a packet would take to get to <destination>. If <destination> is not given, information about all known netrom nodes is displayed. 'netrom route info' and 'netrom route info *' are equivalent commands. netrom save Saves (i.e., writes) the netrom node table to Netromrile (default is /netrom.sav) for later use by the 'netrom load' command. netrom split <node> Same as a 'netrom connect <node>', except a split-screen is used so that keyboard input appears in its own window. netrom status Display all netrom connections. netrom tdisc [secs] Display or set the NetRom Link "redundancy" timer. Value is in seconds. When no data exchange has happened during this time the link is reset and closed. Default is 900 seconds (15 minutes). netrom timertype [exponential|LINEAR] Displays or sets the type of backoff used on netrom retries. Default is linear. netrom ttl [<hops>] Display or set the maximum number of hops a frame might take before being discarded. Default is 10. netrom user <usercall> Display or set the user call to be used by 'netrom connect'. The The default call is the ax25 mycall. netrom window [<frames>] Display or set the size of the sliding window. This is the largest send and receive window we might negotiate. Default is 2. nntp The 'nntp' commands control the operation of the Network News Transfer Protocol (NNTP). The nntp features are defined at compile-time. Two NNTP modules are available, "NNTP" which is an NNTP client only, that stores news in a mailbox-compatible form, and another, "NNTPS" which is both an NNTP client and server, that stores news articles in a form inaccessible to mailbox users. We first describe the "NNTP" nntp client features: nntp addserver <nntpserver_host> <interval> [<range>] [<groups>] Add an NNTP news server to query every <interval> seconds for new articles in the specified <groups>. <range> specifies the time-of-day limits when the queries will be made, in the form hh:mm-hh:mm where start time precedes end time. Multiple 'nntp addserver' commands may be used to concatenate groups (up to a maximum of 512 bytes). Example: nntp add w5ddl.ampr.org 3600 18:00-06:00 nntp directory [ <News_spool_dir> [News_control_dir> ] Display or set the spool directory for spooling news articles. Default is /spool/mail. Optionally set a new control directory. The default control dir is /spool/news. nntp directory old=new Establish a newsgroup name mapping, so that a newsgroup name beginning with <old> is changed to one beginning with <new>, which may be a null string. To delete a mapping, use <old>==. The mapping scan continues until the list is exhausted, in the same order the nntp dir commands were specified. Example: nntp dir rec.radio.= nntp dir amateur.= nntp dir shortwave=swl nntp dir equipment=eq will map rec.radio.amateur.policy to policy, rec.radio.swap to swap, rec.radio.shortwave to swl, and rec.radio.amateur.equipment to eq. nntp dropserver <nntpserver_host> Drop the specified NNTP server from the list of servers to contact. nntp firstpoll [<#days>] Default: 5 Sets or shows the number of days of old news that is requested in the initial poll to a new server. nntp groups <group> [<group> ...] Default: All groups Display or set the currently set USEnet newsgroup(s). The group names are separated by spaces or commas. The '*' and '!' metacharacters (meaning 'all' and 'not' respectively) are supported. nntp kick <nntpserver_host> Kick the local NNTP client to get in touch with the named server. nntp listservers List the currently defined servers. nntp lzw <ON | off> Turn on or off attempts to request LZW compression be used by the server when sending articles. nntp maxcleints [<count>] Displays or sets the maximum number of simultaneous NNTP client sessions that will be allowed. The default is 0, that is, no limit (except that imposed available memory). nntp trace <level> Default: 1 Sets or shows the current trace level for NNTP traffic. Level 0: No tracing. 1: Display serious errors only 2: Display serious and transient errors 3: Display serious and transient errors, plus session progress 4: Display serious and transient errors, session progress and actual received articles 5: Display errors. nntp quiet <yes | NO> Default: no Sets or shows the current arrival-notification setting for NNTP traffic. The notification will include a BEL character if "smtp quiet no" is in effect. We now describe the "NNTPS" client/server commands. Remember that the 'start nntp' command must be used to allow the nntp server to accept connects from other nntp clients. nntp active Displays the active file, which shows configured newsgroups. See 'nntp create'. nntp access [on | OFF] Displays or sets whether access permissions are enforced. When enabled, the file /spool/news/access is scanned to determine the access permissions for a client host. Each line of this file has fields of the form: host:permissions: where host is explicit hostname (FQDN) or starname, eg, *.aara.org and permissions are a string of chars: R => read, P => post, none=>deny access. When access is turned on, hosts not mentioned are DENIED nntp access. nntp add <nntpserver_host> <interval> [<range>] [<groups>] Add an NNTP news server to query every <interval> seconds for new articles in the specified <groups>. If no <groups> are specified, all groups found in /spool/news/active are checked. <range> specifies the time-of-day limits when the queries will be made, in the form hh:mm-hh:mm where start time precedes end time. Multiple 'nntp add' commands may be used to concatenate groups (up to a maximum of 512 bytes). Example: nntp add news.usl.edu 3600 usl.test,rec.radio.swap nntp create <news.group.name> [y|n] Updates the /spool/news/active file, which must have an entry for each news group you wish to receive. Choose y to permit posting to this group, or n to deny posting. y is assumed if nothing is specified. The /spool/news/pointer file is also updated with the path to the directory which will contain the articles. Articles will be stored as separate files, named by an integer corresponding to their arrival order. nntp drop <nntpserver_host> Drop the specified NNTP server from the list of servers to contact. nntp dump <newsgroup> [<areaname>] Dump all the news articles in <newsgroup> to the JNOS area called <areaname>. This would allow mailbox users to read news, but no provisions are made to dump just new articles. If <areaname> is omitted, then <newsgroup> is used as the area name. Note: this command is unavailable if JNOS was compiled with NEWS_TO_MAIL #define'd (see note 4 below). nntp firstpoll [<#days>] Default: 5 Sets or shows the number of days of old news that is requested in the initial poll to a new server. nntp ihave [<val>] Default: 0 Set or display the IHAVE nntp-protocol behavior. 0 => IHAVE disabled (default) 1 => IHAVE reports only for newsgroups associated with serverhost 2 => IHAVE reports for all newsgroups The IHAVE protocol tells the server the message-ids of articles stored here; it is used to forward articles off this system. nntp kick <nntpserver_host> Kick the local NNTP client to get in touch with the named server. nntp list List the currently defined servers. nntp lzw <ON | off> Turn on or off attempts to request LZW compression be used by the server when sending articles. nntp post Posts to a local newsgroup. A session is created, and the console user is queried for UserName (unless established by a prior 'nntp profile' command), Newsgroup, Subject, and message body. While entering the msg, a line consisting of ".u" or ".r" will then prompt for a file name, which is inserted into the article being built. "/EX", "***END" or "." will end the article when found alone on a line. When the message body is terminated, the prompt [Send, Abort, Exit, List] is displayed. Enter the first letter of the desired choice. Note that Exit quits the post subcommand, while Abort (or Send) allows you to post another article. nntp profile {fullname|host|organization|reply|sig|user} string_value Profile establishes values for the header fields of posts originating here. Options include: sig path_to_signature_file host FQDN Defaults to our 'hostname' fullname "First Mi. Lastname" organ "organization name desired" user "user name" reply reply-to-address nntp read <newsgroup> [<article_number>] Reads the local <newsgroup>, beginning with the first unread article unless <article_number> is also provided. A session is created for displaying the articles. After each article, a prompt "Read next/previous? (n/p/q) " allows the console user to easily progress through the articles. nntp quiet [<val>] Default: 0 Dispays or sets the value if the quiet behavior flag. Nntp will display a message and/or beep when a new article arrives: 0 => beep only (default) 1 => beep and display msg 2 => no msg or beep NOTES: 1. See the 'expire' command for information on removing old articles. 2. The TO: addresses, when present, are stripped from article headers by the NNTP client. This was done to prevent loops should the area be forwarded to another JNOS system, since the TO: address would cause the msg to be routed back to the mail-to-news daemon. If you want to forward an area, give the TO: address on the line in forward.bbs that lists the area. Example: rec.radio.swl all@swl 3. The NNTPS software includes a mail-to-news feature, such that email with a To: address that begins with "!" is passed to the NNTPS module. The remainder of the To: address is interpreted as a newsgroup name, with the name truncated at the first occurrence of one of "%@.,/", and with "!" translated to "." and "+" to ",". An alias is usually used to provide this special name. For example, to route all ALLUS bulletins to both the allus area, and the ampr.allus newsgroup, use the alias: allus allus !ampr!allus To do the above task, and also post to local.allus, use: allus allus !ampr!allus+local!allus 4. The NNTPS software includes a news-to-mail feature, such that news articles can be emailed to local or remote destinations after they are processed by nntp. This would allow, for example, emailing to a public area, so that BBS users too could read news articles. JNOS must be compiled with NNTPS and NEWS_TO_MAIL #define'd and a file /spool/news/gateway must exist to define the mapping from a newsgroup to an SMTP To: address. Each non-comment line in the gateway file must begin with a newsgroup name (starnames OK), followed by spaces or tabs, followed by the email To: address. Examples: # comment line rec.radio.swapsale rec.radio.shortwaveswl rec.radio.amateur.* ham nrstat Displays the netrom serial interface statistics. This is only valid if the serial port was attached in NRS mode. See the 'attach' command for more.
(Courtesy KBNorton Computer Services)