JNOS USER
COMMANDS MANUAL
JNOS-2.0fB
by
Kevin Roberts W1NGL / GW1NGL
Last Modified on 11/24/2007 01:36 AM
A derivative of the JNOS Robert Fahnestock WH6IO and James P. Dugal N5KNX
A derivative of the JNOS Commands Manual by Johan K. Reinalda and Douglas E. Thompson
(based in part on the NOS Reference Manual, by Phil Karn, KA9Q and Gerard van der Grinten, PA0GRI)
DISCLAIMER
-----------------
The authors make no guarantees, explicit or implied, about the functionality or any other aspect of this product.
Refer to the manuals provided by the manufacturer of your equipment for installation procedures.
JNOS MAILBOX USER COMMANDS;
The following commands are available to the users connected to the mailbox. This file is available separately as mboxcmds.txt.
The Area command lists the mail areas that contain messages you may read.
A gives a short listing, whereas
AF gives a full listing with descriptions (if available)
AN shows areas that have new mail since you last logged off.
To read messages in one of the areas, type 'A <areaname>'. You will then be told how many new, not previously listed messages there are in this area.
You can send mail to any of the listed areas as 'S <areaname>'
The Bye command is used to exit from the JNOS MBOX. This will close your mailbox file and remove any messages that you have deleted with the K[ill] command.
The Connect command has the following modes:
C[onnect] [port] [callsign] [<digipeater> . . .] connects to station
'callsign' on interface 'port', possibly via digipeaters
'digipeater...' (note the use of 'via' is optional!)
C[onnect] [node] connects over netrom to a remote node with 'node' as either node-call or node-alias
(if available) puts you in converse mode. This is a roundtable discussion feature. 'channel' allows specifying the conference channel you wish to join. Channel default = 0.
D[ownload] [/][<path_name>/]filename sends a plain ASCII text file.
DM download the motd which is otherwise unavailable once you get into the mbox.
DU [/][<path_name>/]filename downloads binary files converted to UUENCODED ASCII.
You will need the "uudecode" utility to convert this ASCII file back to binary. Source code, in various languages, for uudecode can be downloaded from this system. Look for uudecode.bas, uudecode.pas, and uudecode.c.
The optional pathname may be included along with the filename if the desired file is not in the current directory (you can determine this using the W[hat] command). Please note that the character used to separate the path and filename is a "/"
(forward slash).
E[scape] [<char> | <integer> | off|on] The escape command, when entered by itself, will display the character that is current set as the escape character, and whether escape processing is enabled. This character is what will be used if you want to exit from the current session . For instance, if you have started a "chat" session, and you don't get a response from the operator after waiting a few minutes, you can enter the escape character, followed by a <RETURN> or <ENTER>, and the session will be terminated. You will then be to the MBOX prompt.
The escape character may be changed to one of your preference by entering "escape" followed by a <SPACE> and the character that will become the new escape character. This must be a single typed character (the <CTRL> key may be used in addition). Alternatively, an <integer> corresponding to the decimal code for the escape character may be specified. Escape processing can be enabled or disabled by specifying "on" or "off" as the only argument..
EXAMPLES
escape ^Z (the ASCII character <CTRL>Z)
escape X (the character "x" is the new escape)
escape 120 (the character "x" is the new escape)
escape off (suspend escape character processing)
escape on (resume escape character processing)
The finger command retrieves personal information about users of a system.
F[inger] displays a list of known users on the current system.
F[inger] [<user_name>] display information about if and when the user last logged in, as well as any information which may be set in the user's finger-file.
F[inger] [<user_name>][@<host>] Perform the same functions detailed above on another TCP/IP host connected to the network.
To get a list of the users on a remote system, enter "finger" followed by a <SPACE> and an "@", then the host name. To get information about a remote user, insert the user name before the "@".
EXAMPLES
finger (list the known users on this system)
f sysop (list info about the local user "sysop")
f @wg7j (list the known users at host "wg7j")
f johan@wg7j (display info about "johan" at host "wg7j")
f help[@jnoshost] (shows which pseudo-user names are available for obtaining JNOS system info via finger command).
Get on-line assistance for user commands? displays a list of the commands that have help descriptions available for them:
area bye connect download escape finger
help info jheard kill list mboxuser
nodes nroutes operator ports read send
telnet upload verbose xpert what zap
H <command> Displays help for a specific command.
Example: Display the help text for the command 'connect'. 'h connect'
The IHeard command shows the tcp/ip systems recently heard.
I[heard] Show tcp/ip activity for all ports.
+
-------
-I[heard] [<port>] Show tcp/ip activity for <port>.
For ax.25 interfaces (ports), show all tcp/ip activity heard, even when this system was not involved in it. For other interfaces, show those systems that we actively routed packets for (i.e.. systems that talked to us.)
Sysop-supplied site information.
IP[route] shows the available TCP/IP routes the system has configured. It shows the interfaces and gateways involved in the routes, and also the expiration timer (if applicable).
This could be a LONG list if the system has a lot of ip routes.
Please ask the sysop for more about the information given in the display.
The jheard command will display a list of all the station callsigns that have been received as sending packet traffic on the channel, the time since the station was heard last, and the total number of packets received.
J[heard] displays the "heard" list for all interfaces.
J[heard] [<port>] displays a list of the stations heard on a particular channel. See the Ports command for determining which channel is heard on which port.
Warning: if this system has been on the air for very long, and the channels are very active, the "heard" list could be extremely long.
K[ill] <message_number_or_range> [<message_number_or_range> . . .]
The kill command allows you to delete messages from the current mailbox (if you have been given that permission by the operator).
At least one message number must be supplied. The message numbers you can select from can be displayed with the "L[ist]" command. The second parameter on each line of the list is the <message_number>.
You may specify a range of message numbers by placing a "-" between the first and last message numbers of the range. No intervening spaces are allowed. For example, 4-7 is equivalent to 4 5 6 7.
KM will delete all messages in the area.
KU will un-kill a message that was previously marked for killing.
KA will delete all messages in the area.
The kill command allows you to delete messages from the current mailbox (if you have been given that permission by the operator).
At least one message number must be supplied. The message numbers you can select from can be displayed with the "L[ist]" command. The second parameter on each line of the list is the <message_number>.
The kill command only applies to messages in the current mail "area". The current mail area can be checked and modified with the "A[rea]" command.
L[ist] [<starting_msg_number> [<ending_msg_number>] ] prints a list of the messages from the current mailbox (or "area"). For each message, the list contains the subject header line, the time and date it was created, who it is from, how many bytes long it is, and whethez or not it has been read.
You may include an optional "starting_msg_number" from which to begin displaying the list. If you specify a starting msg number, then you may also specify an ending number as well.
This will limit the display for you in case there are a large number of messages in a particular "area" mailbox.
L by itself will display the headers for all unread messages, if any.
LA list all messages, read or unread
LL display the last <number> of message headers.
LM is the same as 'L'
LB list all bulletins
LS [subject] list messages in the current 'area' with [subject] in the subject line.
LT list all traffic
L> xxx list all messages that have the string 'xxx' in the To: address including numeric strings.
L< xxx list all messages that have the string 'xxx' in the From: address including numeric strings.
M will display a list of all the current users, how they connected, and their current activity.
MC <path, area> (sysop) copies the current message to the path or area indicated. This command accepts a range of messages, e.g., mc 5-26 junk will copy messages 5 through 26 to area 'junk'.
ML will list all past users of the system, when they were last on and how many times they've connected.
ML n will show the last n users of the system
ML call will list when 'call' last logged in
MM <path, area> (sysop) moves the current message to the path or area desired. This command accepts a range of messages, e.g., mm 5-26 junk will move messages 5 through 26 to area 'junk'.
MS will give some info on the number of messages handled since the system has been up
N prints a list of NetRom nodes that are known to this system and for which the nodeids do not begin with '#'.
N * will give info on all known nodes including "hidden" nodes (those with IDs beginning with '#').
N <nodename> displays information about routes (paths) available to <nodename>
NR[oute] command will list all known NetRom neighbor stations, with a listing of the path quality to them, number of destinations the neighbor knows and the obsolescence count.
'>' in front indicates that the route has been used in the past 60 seconds
O[perator] allows you to "talk" keyboard-to-keyboard with the operator of this NOS system if the system is attended.
When you wish to terminate the chat session, type the escape character on your keyboard, and then press <ENTER> or <RETURN>. The default escape character is "CTRL-X", which means to hold down the <CTRL> key and press the <X> key simultaneously. This escape character may be changed to whatever you prefer by using the "E[scape]" command.
Check of <host> is alive. Returns RTT.
P[orts] prints a list of AX.25 interfaces (ports) that are installed in this system. A description of the port is also given if one has been setup for that port. These ports can be used to make outgoing AX.25 connections with the "C[onnect]" command.
Q <call> [<call> . . .] If available, this queries the BuckMaster CDRom callbook server for info about the calls given. More then one call per query is allowed.
Read a message (or messages) from the current mail area.
# or,
R[ead] # or,
R[ead] <msg_number_or_range> [<msg_number-or_range> . . .] To read a specific message, you may either type "read #" or just the number by itself. If there is a specific list of messages you are interested in (determined by the use of the L[ist] command, for instance), you can enter the list of message numbers (separated by spaces) on the "read" command-line. You can also simply advance sequentially through the messages by just pressing the <ENTER> or <CR> key. This will display the next message in order. The "read" command displays only an abbreviated portion of the mail headers. If you want to display all the header lines, use the V[erbose] command instead.
RM display without interruption all unread messages.
EXAMPLES:
read 3 5 (Display only messages 3 and 5)
4 (Display message 4)
<CR> (Display next message)
The send command allows you to enter a message and send it to a user at either this system, or some other system on the network. The "from_addr" and "bulletin_id" fields are for special use and won't be covered here.
The "S" command may also be followed by "P", "B", or any other message type you use (e.g. SP wb7xxx @ n7xxx). The "SR" command allows you to "reply" to either the current message or the message number specified.
The "ST" command allows you to send "traffic" to <user> specified.
The subject will be copied and the reply will be sent to the address it was sent from. The "SF" command will forward a copy of the current message to the user specified.
SC allows you to send a message to more then one user. The system will prompt with "Cc: ", which allows you to add more users to be send Carbon copies of the message. Separate users on the Cc line with commas
S[end] <user>[ @ <host>] [< <from_addr>] [$<bulletin_id>]
SR [msg_number]
SF <user>[ @ <host>] [< <from_addr>] [$<bulletin_id>]
SC
SB <user>[@<host>] (Send Bulletin) As above, but ANY <user> may read the message from the mailbox. <User> is usually a category rather than an individual stationid when sending bulletins.
SP <user>[ @ <host>] (Send Personal) As above, but only the addressee (<user>) may read the message from the mailbox.
SR [msg_number] "reply" to either the current message or the message number specified. The subject will be copied and the reply will be sent to the address it was sent from.
SF <user>[ @ <host>] [< <from_addr>] [$<bulletin_id>] Forward a copy of the current message to the user specified.
SC <user>[ @ <host>] [< <from_addr>] [$<bulletin_id>] Send a message to more than one user. The system will prompt with "Cc: ", which allows you to add more users to be sent 'carbon copies' of the message.
Separate users on the Cc: line with commas.
EXAMPLES
send kf7xx (Send a message to the local user, kf7xx)
s kf7xx @ wb7xxx (Send a message to kf7xx at the wb7xxx host)
sr 3 (Reply to message number 3)
sf n7aaa%n7bbb@w7ccc (Forward current msg to n7aaa at n7bbb via w7ccc)
sc wg7j (Send with Carbon copy to others)
Cc: ka7ehk, n7dva@n7dva
T[elnet] <hostname> [<port_number>]
The telnet command allows you to initiate a TCP connection from the NOS mailbox out across the network to another host. This allows an AX.25 user with nothing more than a terminal and TNC to gain access to the TCP/IP network.
By including the optional port_number, you can connect to any TCP server at the given host. The default is to be connected to the "telnet" server, which in the case of JNOS software, is the MBOX.
To quit the session at any time, enter the escape character (<CTRL>X by default, can be changed with the E[scape] command).
U[pload] [/][<path_name>/]<filename> Transfer an ASCII file from your system onto disk at this host. You may also specify a full path_name containing a specific directory in which to deposit the new "upload". All uploads can only go into the directory that you logged into, or into another directory under the current one.
The transfer proceeds line-by-line until the file is sent and you enter either a "<CTRL>Z" or "/ex" as the first item on a blank line.
EXAMPLES
upload kepler.txt
u /public/satelite/oscar13.txt
This command allows you to read a message (or messages) from the current mail area, and it includes all the header lines for display. The R[ead] command operates the same way, but with abbreviated header lines.
V[erbose] <msg_number_or_range> [<msg_number_or_range> . . .]
View a specific message or a list of messages with all headers.
VH, 'verbose held' is verbose-read-held mesages (sysop only).
VM, 'verbose mine' Display, without interruption, all unread messages in the area.
W[hat] [/][<path_name>] Generate a sorted directory listing of the current directory or the one specified by the optional path_name. The listing includes the filename (or subdirectory name if there is a "/" appended), the file size in bytes, creation time, and date.
EXAMPLES
what (Displays a directory listing of the "current" dir)
w /nos/pub (Display a list of files contained in the "/nos/pub" dir)
The Xpert command toggles the prompts that the system gives
X - toggles the prompt between using long and short prompts.
XA - toggles the 'current area' indication on or off.
XG - effective with 1.11a, addr/#bits - establishes an encapped route for addr, if permitted.
XN - toggles the 'netrom id' prompt on or off
XM - shows the number of lines before -more- prompting occurs in lists
XM n - sets the number of lines ...
XP - toggles LINEMODE-style prompting for input (telnet/tip users).
XR - shows if 'Reply-to' line is added when sending mail. You need to have set an email address when you registered.
The states of the above are remembered at logout and used at next login.
The XG command, when allows by the 0x2000000 permission bit in ftpusers, lets the sender register as a gateway for the indicated host or subnet, for a period of time. This could be used by systems connecting with a dynamic IP address, to facilitate tcp forwarding of bulletins.
Z[ap] [/][<path_name>/]<filename> The zap command allows you to delete a file in the current directory of one you specify with the optional path_name. Use of the optional path_name. Use of this command requires that permission be granted by the operator of this system.
EXAMPLES
zap myfile.txt (Deletes myfile.txt in the current dir)
z /nos/mydir/myfile.txt (Deletes myfile.txt in /nos/mydir)
End of Appendix A: JNOS User Commands