@database "AmigaNOS.guide" @Node Main "AmigaNOS" AmigaNOS is a package that allows you to connect to the Internet, via a gateway. It also has several other functions to do with radio, but as I'm not too well up on them, I won't even try to document them. It supports connections via SLIP and PPP, across phone lines (using a modem :-) or via a direct connection. When connected, you can (amongst other things) download news ( @{"nntp",link AmigaNOS_Nntp} ), send and receive mail ( @{"smtp",link AmigaNOS_Smtp} ) transfer files ( @{"ftp",link AmigaNOS_Ftp} ) and connect interactively to other computers on Internet ( @{"telnet",link AmigaNOS_Telnet} ). I use @{"Demon",link AmigaNOSIntro_Demon} to provide dial up connection to the Internet. They provide a very good service, at GBP 10 per month, plus VAT. @{"Installation",link AmigaNOSIntro_Setup} @{"Commands",link AmigaNOSMain_Index} @{"MailBox",link AmigaNOSMBox_Index} @EndNode @Node AmigaNOSIntro_Setup "AmigaNOS Setup" Nos Set-up ========== Here is a brief guide to getting Amiganos set up on your machine. Consult the other files to fully customize your setup. First Step ========== Send mail to internet@demon.co.uk telling them what you want your site name to be, also tell them your using SLIP and Amiganos. (Hopefully you've already done this) If you haven't you'll have to wait at least a day until you are able to go to the next stage. (You can call @{"demon",link AmigaNOSIntro_Demon} voice to subscribe,currently 081-343 3881) @{"Log",link AmigaNOS_Log} on to @{"demon",link AmigaNOSIntro_Demon} with a normal terminal program (ncomm,jrcomm etc). Telephone : 0813434848 Your will be prompted with gate login: (type in just your site name and not the full address) New Password: (type in your desired password) It will the give you your @{"IP",link AmigaNOS_Ip} Address in the form; number.number.number.number Write this down as you will need it for the next part. Running Nos =========== (1) You must edit the following files putting in your own @{"IP",link AmigaNOS_Ip} address and site name were indicated; Domain.txt in directory amiganos/slip nos-startup in directory amiganos/slip Note: Your site name will be what you asked @{"demon",link AmigaNOSIntro_Demon} to set your system up as. I.e. My site is "evil" so I have evil.demon.co.uk. Your @{"IP",link AmigaNOS_Ip} address is what you wrote down just a minute ago. Also in Nos-startup you will need to tell it what speed your modem will be logging on to @{"demon",link AmigaNOSIntro_Demon} at; @{"attach",link AmigaNOS_Attach} asy serial.device 0 slip nos 4096 1006 38400c <-- The c is for ^ RTS/CTS | Use what you do in your terminal program. (2) Edit the ftpusers file in directory amiganos/slip (This is for when you logon to your NOS BBS.) The following is your choice; yourname : (Same as cix would be a good choice) Password : (Anything not obvious) (If you don't want any tom, dick or fis logging on get rid of the line that says anonymous *). (3) In your startup-sequence put the following; assign slip: <device>:amiganos/slip assign tcpip: <device>:amiganos/slip assign nntp: <device>:amiganos/slip/spool/articles (4) Edit the Nos-dial file and put in your own site name and password. (5) Copy files in amiganos/c to your c: directory. (6) To @{"start",link AmigaNOS_Start} simply click the icon - it will then load and dial @{"demon",link AmigaNOSIntro_Demon} to connect. (Make sure the assign's are running i.e. you've done a reset) Troubleshooting =============== Q: I only have one drive A: Commit suicide or get a hard-disk Q: It won't even open a window A: You need 1MB or more of memory Q: How do I @{"log",link AmigaNOS_Log} on to my own node? A: Type "telnet yoursite.demon.co.uk" or "bbs" at the nos prompt. Q: What are all these @{"commands",link AmigaNOSMain_Index} for? A: Type @{"help",link AmigaNOS_Help} <command> for info. CONSULT THE USENET GROUP DEMON.IP.SUPPORT.AMIGA IF YOU NEED @{"HELP",link AmigaNOS_Help} ================================================================ Information supplied by fis@evil.demon.co.uk @EndNode @Node AmigaNOSIntro_Demon "Demon" @{"Demon",link AmigaNOSIntro_Demon} (DIS) is a company providing connection to the Internet for GBP 10 + VAT per month. They can be reached on 081-343 3881, or by EMail at internet@demon.co.uk @EndNode @Node AmigaNOSMAIN_Index "AmigaNOS MAIN Index" @{" Abort ", link AmigaNOS_Abort } @{" Amiga ", link AmigaNOS_Amiga } @{" Arp ", link AmigaNOS_Arp } @{" Asystat ", link AmigaNOS_Asystat } @{" Attach ", link AmigaNOS_Attach } @{" Ax25 ", link AmigaNOS_Ax25 } @{" bak ", link AmigaNOS_bak } @{" Bbs ", link AmigaNOS_Bbs } @{" ChatNode ", link AmigaNOS_ChatNode } @{" Close ", link AmigaNOS_Close } @{" Connect ", link AmigaNOS_Connect } @{" Detach ", link AmigaNOS_Detach } @{" Digger ", link AmigaNOS_Digger } @{" Disconnect ", link AmigaNOS_Disconnect } @{" Domain ", link AmigaNOS_Domain } @{" Echo ", link AmigaNOS_Echo } @{" Eol ", link AmigaNOS_Eol } @{" Escape ", link AmigaNOS_Escape } @{" Exit ", link AmigaNOS_Exit } @{" Finger ", link AmigaNOS_Finger } @{" Ftp ", link AmigaNOS_Ftp } @{" FtpDown ", link AmigaNOS_FtpDown } @{" FtTimeout ", link AmigaNOS_FtTimeout } @{" Help ", link AmigaNOS_Help } @{" Hopcheck ", link AmigaNOS_Hopcheck } @{" Hostname ", link AmigaNOS_Hostname } @{" Icmp ", link AmigaNOS_Icmp } @{" Ifconfig ", link AmigaNOS_Ifconfig } @{" Ip ", link AmigaNOS_Ip } @{" Kick ", link AmigaNOS_Kick } @{" Less ", link AmigaNOS_Less } @{" Listserv ", link AmigaNOS_Listserv } @{" Log ", link AmigaNOS_Log } @{" Mbox ", link AmigaNOS_Mbox } @{" Mem ", link AmigaNOS_Mem } @{" Message ", link AmigaNOS_Message } @{" Mode ", link AmigaNOS_Mode } @{" Netrom ", link AmigaNOS_Netrom } @{" Nntp ", link AmigaNOS_Nntp } @{" Nrstat ", link AmigaNOS_Nrstat } @{" Param ", link AmigaNOS_Param } @{" Ping ", link AmigaNOS_Ping } @{" Pop ", link AmigaNOS_Pop } @{" Ps ", link AmigaNOS_Ps } @{" Record ", link AmigaNOS_Record } @{" Remote ", link AmigaNOS_Remote } @{" Reset ", link AmigaNOS_Reset } @{" Rip ", link AmigaNOS_Rip } @{" Route ", link AmigaNOS_Route } @{" Rspf ", link AmigaNOS_Rspf } @{" Session ", link AmigaNOS_Session } @{" Smtp ", link AmigaNOS_Smtp } @{" Socket ", link AmigaNOS_Socket } @{" Source ", link AmigaNOS_Source } @{" Start ", link AmigaNOS_Start } @{" Status ", link AmigaNOS_Status } @{" Stop ", link AmigaNOS_Stop } @{" Tcp ", link AmigaNOS_Tcp } @{" Telnet ", link AmigaNOS_Telnet } @{" Time ", link AmigaNOS_Time } @{" Trace ", link AmigaNOS_Trace } @{" TtyLink ", link AmigaNOS_TtyLink } @{" Udp ", link AmigaNOS_Udp } @{" Upload ", link AmigaNOS_Upload } @EndNode @Node AmigaNOSMBOX_Index "AmigaNOS MBOX Index" @{" Area ", link AmigaNOSMBOX_Area } @{" Bye ", link AmigaNOSMBOX_Bye } @{" ChatNode ", link AmigaNOSMBOX_ChatNode } @{" Download ", link AmigaNOSMBOX_Download } @{" Escape ", link AmigaNOSMBOX_Escape } @{" Find ", link AmigaNOSMBOX_Find } @{" Finger ", link AmigaNOSMBOX_Finger } @{" Gateway ", link AmigaNOSMBOX_Gateway } @{" Help ", link AmigaNOSMBOX_Help } @{" Info ", link AmigaNOSMBOX_Info } @{" Jheard ", link AmigaNOSMBOX_Jheard } @{" Kill ", link AmigaNOSMBOX_Kill } @{" List ", link AmigaNOSMBOX_List } @{" Message ", link AmigaNOSMBOX_Message } @{" MoveMail ", link AmigaNOSMBOX_MoveMail } @{" NConnect ", link AmigaNOSMBOX_NConnect } @{" Netrom ", link AmigaNOSMBOX_Netrom } @{" Nodes ", link AmigaNOSMBOX_Nodes } @{" OS ", link AmigaNOSMBOX_OS } @{" PageSysop ", link AmigaNOSMBOX_PageSysop } @{" Ports ", link AmigaNOSMBOX_Ports } @{" Read ", link AmigaNOSMBOX_Read } @{" Retrieve ", link AmigaNOSMBOX_Retrieve } @{" Send ", link AmigaNOSMBOX_Send } @{" SignOn ", link AmigaNOSMBOX_SignOn } @{" Telnet ", link AmigaNOSMBOX_Telnet } @{" Upload ", link AmigaNOSMBOX_Upload } @{" Verbose ", link AmigaNOSMBOX_Verbose } @{" What ", link AmigaNOSMBOX_What } @{" Zap ", link AmigaNOSMBOX_Zap } @EndNode @Node AmigaNOS_Abort abort [<session #>] Abort a @{"FTP",link AmigaNOS_Ftp} get, put or dir operation in progress. If issued without an argument, the current session is aborted. (This com- mand works only on @{"FTP",link AmigaNOS_Ftp} sessions.) When receiving a file, abort simply resets the data connection; the next incoming data packet will generate a @{"TCP",link AmigaNOS_Tcp} RST (reset) response to clear the remote server. When sending a file, abort sends a premature end-of- file. Note that in both cases abort will leave a partial copy of the file on the destination machine, which must be removed manu- ally if it is unwanted. @EndNode @Node AmigaNOS_Amiga amiga arplist [on] | [off] Is used to denote whether the internal directory routine (OFF) or an external LIST program (ON) is used for the @{"ftp",link AmigaNOS_Ftp} dir/ls and the @{"mailbox",link AmigaNOSMBox_Index} What commands. amiga command ["amigados command"] Will cause the amigados command to be issued at specified intervals. (see 'amiga interval [seconds]') amiga eightbit [on] | [off] Allows the system to run telnet/mailbox sessions in 8-bit mode. (this is needed to receive '7plus' files via the mailbox) amiga interval [seconds] Issue the @{"commands",link AmigaNOSMain_Index} in the linked-list formed by 'amiga command ["xxx"]' at regular intervals/ amiga winsize <X_min> <Y_min> <X_max> <Y_max> This is used to set the dimensions of all subsequent session windows. amiga wintype border [<on|off>] This is used to specify whether subsequent session windows are to have or have no border. amiga wintype resize [<on|off>] This is used to specify whether it is possible to resize subsequent session windows with the mouse. The default setting for these @{"commands",link AmigaNOSMain_Index} is for all session windows to be the same as the original command window. amiga sound [on] | [off] With this set to ON, the Amiga makes use of the AmigaDOS command SAY (not included!) to speak whenever a new mail message arrives. (It says 'NEW MAIL') ** AmigaNOS4GW on ** amiga guide [on] | [off] With this set to ON, the Amiga makes use of the AmigaGuide command to display help. The file AmigaNOS.guide must be accessible to AmigaGuide. @EndNode @Node AmigaNOS_Arp arp Display the Address Resolution Protocol table that maps @{"IP",link AmigaNOS_Ip} addresses to their subnet (link) addresses on subnetworks capable of broadcasting. For each @{"IP",link AmigaNOS_Ip} address entry the subnet type (eg. Ethernet, AX.25), subnet address and @{"time",link AmigaNOS_Time} to expiration is shown. If the link address is currently unknown, the number of @{"IP",link AmigaNOS_Ip} datagrams awaiting resolution is also shown. arp add <hostid> ax25|netrom <ax25|netrom_address> Add a permanent entry to the table. It will not @{"time",link AmigaNOS_Time} out as will an automatically-created entry, but must be removed with the arp drop command. arp drop <hostid> ax25|netrom Remove the specified entry from the ARP table. arp flush Drop all automatically-created entries in the ARP table; per- manent entries are not affected. arp publish <hostid> ax25|netrom <ax25|netrom_address> This command is similar to the arp add command, but system will also respond to any ARP request it sees on the network that seeks the specified address. (Use this feature with great care.) @EndNode @Node AmigaNOS_Asystat asystat Will produce a one-line display of each configured interface, showing the number of bytes transmitted and received along with the device it is attached to. @EndNode @Node AmigaNOS_Attach attach asy <dev> <unit> <mode> <name> <bufsiz> <mtu> <speed> where asy - is always 'asy' for the serial network driver; dev - is usually 'serial.device' for the normal Amiga serial device driver. If you happen to have additional serial ports on your Amiga, you should list the name of its serial.device compatible driver here. unit - the unit number to be opened on the driver. Usually '0' for the case of the internal serial port. mode - is either 'slip' for serial line @{"IP",link AmigaNOS_Ip} use; 'ax25' for KISS AX.25 use, or 'nrs' for the NET/ROM serial interface. name - is a symbolic name for the interface, something like 'sl0' or 'nos'. bufsiz - the amount of buffering that the device driver will do. The larger you specify then it lessens the chance you'll experience serial line overruns. The value of 8000 works great with 9600 baud SLIP doing FTPs to a hard disk. mtu - the Maximum Transmission Unit of the interface; packets larger than this are fragmented. speed - baud rate you'd like the interface to run at. '9600' works great. @EndNode @Node AmigaNOS_Ax25 ax25 ... These @{"commands",link AmigaNOSMain_Index} are used for AX25 interfaces. With no parameters it will display the AX.25 "heard" list. (see 'ax25 heard') ax25 bc [<interface>] This command routes BEACON broadcasts via <interface> ax25 bcinterval [<seconds>] Display or set the @{"time",link AmigaNOS_Time} interval between BEACON broadcasts. ax25 bctext [<"beacon_text">] Display or set the text to be sent for BEACON broadcasts. ax25 blimit [<count>] Display or set the AX25 retransmission backoff limit. Normally each successive AX25 retransmission is delayed by twice the value of the previous interval; this is called binary exponential back- off. When the backoff reaches the blimit setting it is held at that value, which defaults to 30. To prevent the possibility of "congestive collapse" on a loaded channel, blimit should be set at least as high as the number of stations sharing the channel. Note that this is applicable only on actual AX25 connections; UI frames will never be retransmitted by the AX25 layer. ax25 destlist Displays the destination list: i.e, the addressed-to stations. The display shows latest times of transmission TO stations, together with the times that the station replied (if the destination was out of range the replied field will be blank) ax25 digipeat [on|off] Display or set the digipeater enable flag. ax25 filter [1] | [2] | [3] Display or set the logging of heard lists of @{"source",link AmigaNOS_Source} and destination AX25 callsigns. This is a bitwise-OR function where the 01 value is for @{"source",link AmigaNOS_Source} stations and the 02 value for destination stations. When the bit is '0', logging is enabled, when '1' it is disabled. ax25 flush Clear the AX.25 "heardlist" and "destlist" (see ax25 heardlist & destlist). ax25 heardlist Display the AX.25 "heard" list. For each interface that is con- figured to use AX.25, a list of all callsigns heard through that interface is shown, along with a count of the number of packets heard from each station and the interval, in hr:min:sec format, since each station was last heard. The local station always appears first in the listing; the packet count actually reflects the number of packets transmitted. This entry is always present even if no packets have been sent. ax25 irtt [<milliseconds>] Display or set the initial value of smoothed round trip @{"time",link AmigaNOS_Time} to be used when a new AX25 connection is created. The value is in milliseconds. The actual round trip @{"time",link AmigaNOS_Time} will be learned by measurement once the connection has been established. ax25 @{"kick",link AmigaNOS_Kick} <axcb> Force a retransmission on the specified AX.25 control block. ax25 maxframe [<count>] Establish the maximum number of frames that will be allowed to remain unacknowledged at one @{"time",link AmigaNOS_Time} on new AX.25 connections. This number cannot be greater than 7. ax25 mycall [<call>] Display or set the local AX.25 address. The standard format is used (eg. KA9Q-0 or WB6RQN-5). This command must be given before any @{"attach",link AmigaNOS_Attach} @{"commands",link AmigaNOSMain_Index} using AX.25 mode are given. ax25 paclen [<size>] Limit the size of I-fields on new AX.25 connections. If @{"IP",link AmigaNOS_Ip} datagrams or fragments larger than this are transmitted, they will be transparently fragmented at the AX.25 level, sent as a series of I frames, and reassembled back into a complete @{"IP",link AmigaNOS_Ip} datagram or fragment at the other end of the link. To have any effect on @{"IP",link AmigaNOS_Ip} datagrams, this parameter should be less than or equal to the MTU of the associated interface. ax25 pthresh [<size>] Display or set the poll threshold to be used for new AX.25 Ver- sion 2 connections. The poll threshold controls retransmission behavior as follows. If the oldest unacknowledged I-frame size is less than the poll threshold, it will be sent with the poll (P) bit set if a timeout occurs. If the oldest unacked I-frame size is equal to or greater than the threshold, then a RR or RNR frame, as appropriate, with the poll bit set will be sent if a timeout occurs. The idea behind the poll threshold is that the extra @{"time",link AmigaNOS_Time} needed to send a "small" I-frame instead of a supervisory frame when polling after a timeout is small, and since there's a good chance the I-frame will have to be sent anyway (i.e., if it were lost previously) then you might as well send it as the poll. But if the I-frame is large, send a supervisory (RR/RNR) poll instead to determine first if retransmitting the oldest unacknowledged I- frame is necessary; the timeout might have been caused by a lost acknowledgement. This is obviously a tradeoff, so experiment with the poll threshold setting. The default is 128 bytes, one half the default value of paclen. ax25 reset <axcb> Delete the AX.25 connection control block at the specified address. ax25 retry [<count>] Limit the number of successive unsuccessful retransmission attempts on new AX.25 connections. If this limit is exceeded, link re-establishment is attempted. If this fails retry times, then the connection is abandoned and all queued data is deleted. ax25 @{"route",link AmigaNOS_Route} Display the AX.25 routing table that specifies the digipeaters to be used in reaching a given station, along with the transmission mode (VC - Virtual Circuit, DG - Datagram or IF - Default). ax25 @{"route",link AmigaNOS_Route} add <target> [digis ... ] Add an entry to the AX.25 routing table. An automatic ax25 @{"route",link AmigaNOS_Route} add is executed if digipeaters are specified in an AX25 connect command, or if a connection is received from a remote station via digipeaters. Such automatic routing table entries won't override locally created entries, however. ax25 @{"route",link AmigaNOS_Route} drop <target> Drop an entry from the AX.25 routing table. ax25 @{"route",link AmigaNOS_Route} mode <target> [VC] | [DG] | [IF] Change the transmission mode for a existing @{"route",link AmigaNOS_Route} entry. ax25 status [<axcb>] Without an argument, display a one-line summary of each AX.25 control block. If the address of a particular control block is specified, the contents of that control block are dumped in more detail. Note that the send queue units are frames, while the receive queue units are bytes. ax25 t3 [<milliseconds>] Display or set the AX.25 idle "keep alive" timer. Value is in milliseconds. ax25 t4 [<milliseconds>] Display or set the AX.25 "link redundancy" timer. The value is in milliseconds. ax25 timertype [<original|linear|exponential>] ax25 version [1] | [2] Display or set the version of the AX.25 protocol to attempt to use on new connections. The default is 2 (the version that uses the poll/final bits). ax25 window [<size>] Set the number of bytes that can be pending on an AX.25 receive queue beyond which I frames will be answered with RNR (Receiver Not Ready) responses. This presently applies only to suspended interactive AX.25 sessions, since incoming I-frames containing network (IP, NET/ROM) packets are always processed immediately and are not placed on the receive queue. However, when an AX.25 connection carries both interactive and network packet traffic, an RNR generated because of backlogged interactive traffic will also @{"stop",link AmigaNOS_Stop} network packet traffic from being sent. @EndNode @Node AmigaNOS_bak ftp <hostid> Open an @{"FTP",link AmigaNOS_Ftp} control channel to the specified remote host and enter converse mode on the new session. Responses from the remote server are displayed directly on the screen. @{"FTP",link AmigaNOS_Ftp} Subcommands During converse mode with an @{"FTP",link AmigaNOS_Ftp} server, everything typed on the console is first examined to see if it is a locally-known com- mand. If not, the line is passed intact to the remote server on the control channel. If it is one of the following commands, how- ever, it is executed locally. (Note that this generally involves other @{"commands",link AmigaNOSMain_Index} being sent to the remote server on the control channel.) dir [<file>|<directory> [<local file>]] Without arguments, dir requests that a full directory listing of the remote server's current directory be sent to the terminal. If one argument is given, this is passed along in the LIST com- mand; this can be a specific file or subdirectory that is mean- ingful to the remote file system. If two arguments are given, the second is taken as the local file into which the directory list- ing should be put (instead of being sent to the console). The PORT command is used before the LIST command is sent. get <remote file> [<local file>] Asks the remote server to send the file specified in the first argument. The second argument, if given, will be the name of the file on the local machine; otherwise it will have the same name as on the remote machine. The PORT and RETR @{"commands",link AmigaNOSMain_Index} are sent on the control channel. hash A synonym for the @{"verbose",link AmigaNOSMBOX_Verbose} 3 command. ls [<file>|<directory> [<local file>]] ls is identical to the dir command except that the "NLST" command is sent to the server instead of the "LIST" command. This results in an abbreviated directory listing, i.e., one showing only the file names themselves without any other information. mget <file> [<file> ...] Fetch a collection of files from the server. File names may include wild card characters; they will be interpreted and expanded into a list of files by the remote system using the NLST command. The files will have the same name on the local system that they had on the server. mkdir <remote directory> Creates a directory on the remote machine. put <local file> [<remote file>] Asks the remote server to accept data, creating the file named in the first argument. The second argument, if given, will be the name of the file on the remote machine; otherwise it will have the same name as on the local machine. The PORT and STOR com- mands are sent on the control channel. rmdir <remote directory> Deletes a directory on the remote machine. type [a|i|l <bytesize>] Tells both the local client and remote server the type of file that is to be transferred. The default is 'a', which means ASCII (i.e., a text file). Type 'i' means image, i.e., binary. In ASCII mode, files are sent as varying length lines of text in ASCII separated by cr/lf sequences; in IMAGE mode, files are sent exactly as they appear in the file system. ASCII mode should be used whenever transferring text between dissimilar systems (eg. UNIX and MS-DOS) because of their different end-of-line and/or end-of-file conventions. When exchanging text files between machines of the same type, either mode will work but IMAGE mode is usually faster. Naturally, when exchanging raw binary files (executables, compressed archives, etc) IMAGE mode must be used. Type 'l' (logical byte size) is used when exchanging binary files with remote servers having oddball word sizes (eg. DECSYSTEM-10s and 20s). Locally it works exactly like IMAGE, except that it notifies the remote system how large the byte size is. bytesize is typically 8. The type command sets the local transfer mode and generates the TYPE command on the control channel. verbose [0|1|2|3|4] Set or display the level of message output in file transfers. @{"Verbose",link AmigaNOSMBOX_Verbose} 0 gives the least output, and @{"verbose",link AmigaNOSMBOX_Verbose} 3 the most, as fol- lows: 0 - Display error messages only. 1 - Display error messages plus a one-line summary after each transfer giving the name of the file, its size, and the transfer @{"time",link AmigaNOS_Time} and rate. 2 - Display error and summary messages plus the progress messages generated by the remote @{"FTP",link AmigaNOS_Ftp} server. 3 - Display all messages. In addition, a "hash mark" (#) is displayed for every 1,000 bytes sent or received. 4 - Display all messages. In addition the number of bytes sent/received are displayed after each acknowledged packet. If a command is sent to the remote server because it is not recognized locally, the response is always displayed, regardless of the setting of verbose. This is necessary for @{"commands",link AmigaNOSMain_Index} like pwd (display working directory), which would otherwise produce no message at all if @{"verbose",link AmigaNOSMBOX_Verbose} were set to 0 or 1. @EndNode @Node AmigaNOS_Bbs bbs Will issue a @{"telnet",link AmigaNOS_Telnet} call to the local system's bbs on the loopback interface. @EndNode @Node AmigaNOS_ChatNode chatnode Will issue a @{"telnet",link AmigaNOS_Telnet} call to the local system's chatnode on the loopback interface, the the user should identify him/her self with the command /n <Name>|<Callsign> @EndNode @Node AmigaNOS_Close close [<session>] Close the specified session; without an argument, close the current session. On an AX.25 session, this command initiates a disconnect. On a @{"FTP",link AmigaNOS_Ftp} or @{"Telnet",link AmigaNOS_Telnet} session, this command sends a FIN (i.e., initiates a close) on the session's @{"TCP",link AmigaNOS_Tcp} connection. This is an alternative to asking the remote server to initiate a close (QUIT to FTP, or the logout command appropriate for the remote system in the case of Telnet). When either @{"FTP",link AmigaNOS_Ftp} or @{"Telnet",link AmigaNOS_Telnet} sees the incoming half of a @{"TCP",link AmigaNOS_Tcp} connection close, it automatically responds by closing the outgoing half of the connection. Close is more graceful than the reset command, in that it is less likely to leave the remote @{"TCP",link AmigaNOS_Tcp} in a "half-open" state. @EndNode @Node AmigaNOS_Connect connect <iface> <callsign> [<digipeater> ... ] Initiate a "vanilla" AX.25 session to the specified call sign using the specified interface. Data sent on this session goes out in conventional AX.25 packets with no upper layer protocol. The de-facto presentation standard format is used, in that each packet holds one line of text, terminated by a carriage return. A single AX.25 connection may be used for terminal-to-terminal, @{"IP",link AmigaNOS_Ip} and NET/ROM traffic. The three types of data are automati- cally separated by their AX.25 Level 3 Protocol IDs. Up to 7 optional digipeaters may be given; note that the word via is NOT needed. If digipeaters are specified, they are automati- cally added to the @{"AX25",link AmigaNOS_Ax25} routing table as though the @{"ax25",link AmigaNOS_Ax25} route add command had been given before issuing the connect command. @EndNode @Node AmigaNOS_Detach detach <iface> Detach a previously attached interface from the system. All @{"IP",link AmigaNOS_Ip} routing table entries referring to this interface are deleted, and forwarding references by any other interface to this inter- face are removed. @EndNode @Node AmigaNOS_Digger digger [on] | [off] | [kick] When (ON) it activates the Digger server, which is an @{"SMTP",link AmigaNOS_Smtp} based file server. @EndNode @Node AmigaNOS_Disconnect disconnect [<session #>] An alias for the @{"close",link AmigaNOS_Close} command (for the benefit of AX.25 users). @EndNode @Node AmigaNOS_Domain domain ... These @{"commands",link AmigaNOSMain_Index} are used for access to the Domain Name Service. domain addserver <hostid> Add one or more domain name server(s) to the list of name servers. domain dropserver <hostid> Remove one or more domain name server(s) from the list of name servers. domain listservers List the currently configured domain name servers, along with statistics on how many queries and replies have been exchanged with each one, response times, etc. domain suffix [<domain suffix>] Display or specify the default domain name suffix to be appended to a host name when it contains no periods. For example, if the suffix is set to ampr.org and the user enters @{"telnet",link AmigaNOS_Telnet} ka9q, the domain resolver will attempt to find ka9q.ampr.org. If the host name being sought contains one or more periods, however, the default suffix is NOT applied (eg. @{"telnet",link AmigaNOS_Telnet} foo.bar would NOT be turned into foo.bar.ampr.org). domain trace [on|off] Display or set the flag controlling the tracing of domain server requests and responses. Trace messages will be seen only if a domain name being sought is not found in the local cache file, domain.txt. @EndNode @Node AmigaNOS_Echo echo [accept|refuse] Display or set the flag controlling client Telnet's response to a remote WILL ECHO offer. The @{"Telnet",link AmigaNOS_Telnet} presentation protocol specifies that in the absence of a negotiated agreement to the contrary, neither end echoes data received from the other. In this mode, a @{"Telnet",link AmigaNOS_Telnet} client session echoes keyboard input locally and nothing is actually sent until a carriage return is typed. Local line editing is also performed: backspace deletes the last character typed, while control-U deletes the entire line. When communicating from keyboard to keyboard the standard local echo mode is used, so the setting of this parameter has no effect. However, many timesharing systems (eg. UNIX) prefer to do their own echoing of typed input. (This makes screen editors work right, among other things). Such systems send a @{"Telnet",link AmigaNOS_Telnet} WILL ECHO offer immediately upon receiving an incoming @{"Telnet",link AmigaNOS_Telnet} connec- tion request. If echo accept is in effect, a client @{"Telnet",link AmigaNOS_Telnet} ses- sion will automatically return a DO ECHO response. In this mode, local echoing and editing is turned off and each key stroke is sent immediately (subject to the Nagle tinygram algorithm in TCP). While this mode is just fine across an Ethernet, it is clearly inefficient and painful across slow paths like packet radio channels. Specifying echo refuse causes an incoming WILL ECHO offer to be answered with a DONT ECHO; the client @{"Telnet",link AmigaNOS_Telnet} session remains in the local echo mode. Sessions already in the remote echo mode are unaffected. (Note: Berkeley Unix has a bug in that it will still echo input even after the client has refused the WILL ECHO offer. To get around this problem, enter the stty -echo command to the shell once you have logged in.) @EndNode @Node AmigaNOS_Eol eol [unix|standard] Display or set Telnet's end-of-line behavior when in remote @{"echo",link AmigaNOS_Echo} mode. In standard mode, each key is sent as-is. In unix mode, carriage returns are translated to line feeds. This command is not necessary with all UNIX systems; use it only when you find that a particular system responds to line feeds but not carriage returns. Only SunOS release 3.2 seems to exhibit this behavior; later releases are fixed. @EndNode @Node AmigaNOS_Escape escape [<char>] Display or set the current command-mode escape character in hex. @EndNode @Node AmigaNOS_Exit exit Exit the AmigaNOS program and return to AmigaDOS. @EndNode @Node AmigaNOS_Finger finger <user@hostid> [<user@hostid> ...] Issue a network finger request for user user at host hostid. This creates a client session which may be interrupted, resumed, reset, etc, just like a @{"Telnet",link AmigaNOS_Telnet} client session. @EndNode @Node AmigaNOS_Ftp ftp <hostid> Open an FTP control channel to the specified remote host and enter converse mode on the new session. Responses from the remote server are displayed directly on the screen. Most hosts will require you to logon and quote a password. The logon process can be automated by setting up the file slip:NOS.rc. This should contain one line per host, in the form: <hostid> <logon> <password> FTP Subcommands During converse mode with an FTP server, everything typed on the console is first examined to see if it is a locally-known com- mand. If not, the line is passed intact to the remote server on the control channel. If it is one of the following commands, how- ever, it is executed locally. (Note that this generally involves other @{"commands",link AmigaNOSMain_Index} being sent to the remote server on the control channel.) dir [<file>|<directory> [<local file>]] Without arguments, dir requests that a full directory listing of the remote server's current directory be sent to the terminal. If one argument is given, this is passed along in the LIST com- mand; this can be a specific file or subdirectory that is mean- ingful to the remote file system. If two arguments are given, the second is taken as the local file into which the directory list- ing should be put (instead of being sent to the console). The PORT command is used before the LIST command is sent. get <remote file> [<local file>] Asks the remote server to send the file specified in the first argument. The second argument, if given, will be the name of the file on the local machine; otherwise it will have the same name as on the remote machine. The PORT and RETR @{"commands",link AmigaNOSMain_Index} are sent on the control channel. hash A synonym for the @{"verbose",link AmigaNOSMBOX_Verbose} 3 command. ls [<file>|<directory> [<local file>]] ls is identical to the dir command except that the "NLST" command is sent to the server instead of the "LIST" command. This results in an abbreviated directory listing, i.e., one showing only the file names themselves without any other information. mget <file> [<file> ...] Fetch a collection of files from the server. File names may include wild card characters; they will be interpreted and expanded into a list of files by the remote system using the NLST command. The files will have the same name on the local system that they had on the server. mkdir <remote directory> Creates a directory on the remote machine. put <local file> [<remote file>] Asks the remote server to accept data, creating the file named in the first argument. The second argument, if given, will be the name of the file on the remote machine; otherwise it will have the same name as on the local machine. The PORT and STOR com- mands are sent on the control channel. rmdir <remote directory> Deletes a directory on the remote machine. type [a|i|l <bytesize>] Tells both the local client and remote server the type of file that is to be transferred. The default is 'a', which means ASCII (i.e., a text file). Type 'i' means image, i.e., binary. In ASCII mode, files are sent as varying length lines of text in ASCII separated by cr/lf sequences; in IMAGE mode, files are sent exactly as they appear in the file system. ASCII mode should be used whenever transferring text between dissimilar systems (eg. UNIX and MS-DOS) because of their different end-of-line and/or end-of-file conventions. When exchanging text files between machines of the same type, either mode will work but IMAGE mode is usually faster. Naturally, when exchanging raw binary files (executables, compressed archives, etc) IMAGE mode must be used. Type 'l' (logical byte size) is used when exchanging binary files with remote servers having oddball word sizes (eg. DECSYSTEM-10s and 20s). Locally it works exactly like IMAGE, except that it notifies the remote system how large the byte size is. bytesize is typically 8. The type command sets the local transfer mode and generates the TYPE command on the control channel. verbose [0|1|2|3|4] Set or display the level of message output in file transfers. @{"Verbose",link AmigaNOSMBOX_Verbose} 0 gives the least output, and @{"verbose",link AmigaNOSMBOX_Verbose} 3 the most, as fol- lows: 0 - Display error messages only. 1 - Display error messages plus a one-line summary after each transfer giving the name of the file, its size, and the transfer @{"time",link AmigaNOS_Time} and rate. 2 - Display error and summary messages plus the progress messages generated by the remote FTP server. 3 - Display all messages. In addition, a "hash mark" (#) is displayed for every 1,000 bytes sent or received. 4 - Display all messages. In addition the number of bytes sent/received are displayed after each acknowledged packet. If a command is sent to the remote server because it is not recognized locally, the response is always displayed, regardless of the setting of verbose. This is necessary for @{"commands",link AmigaNOSMain_Index} like pwd (display working directory), which would otherwise produce no message at all if @{"verbose",link AmigaNOSMBOX_Verbose} were set to 0 or 1. @EndNode @Node AmigaNOS_FtpDown ftpdown [xxyy] This is used to restrict access to the system to a specific @{"time",link AmigaNOS_Time} window xxyy, where xx represents the first hour and yy represents the last hour. So 'ftpdown 2108' would restrict access to between 21:00 hrs and 08:59 hrs. @EndNode @Node AmigaNOS_FtTimeout fttimeout [seconds] Display or set the @{"FTP",link AmigaNOS_Ftp} inactivity timeout in seconds, after which an inactive session is closed. @EndNode @Node AmigaNOS_Help help [<command>] Will invoke the LESS program to display a help file from the Spool/Help directory for a NOS command. @EndNode @Node AmigaNOS_Hopcheck hopcheck ... These @{"commands",link AmigaNOSMain_Index} are used to test the connectivity of the network. hopcheck check <hostid> Initiate a hopcheck session to the specified host. This uses a series of @{"UDP",link AmigaNOS_Udp} "probe" packets with increasing @{"IP",link AmigaNOS_Ip} TTL fields to determine the sequence of gateways in the path to the specified destination. This function is patterned after the UNIX traceroute facility. @{"ICMP",link AmigaNOS_Icmp} message tracing should be turned off before this command is executed (see the @{"icmp",link AmigaNOS_Icmp} trace command). hopcheck maxttl [<hops>] Display or set the maximum TTL value to be used in hop check ses- sions. This effectively bounds the radius of the search. hopcheck maxwait [<seconds>] Display or set the maximum interval that a hopcheck session will wait for responses at each stage of the trace. The default is 5 seconds. hopcheck queries [<count>] Display or set the number of @{"UDP",link AmigaNOS_Udp} probes that will be sent at each stage of the trace. The default is 3. hopcheck trace [on|off] Display or set the flag that controls the display of additional information during a hop check session. @EndNode @Node AmigaNOS_Hostname hostname [<name>] Display or set the local host's name. By convention this should be the same as the host's primary @{"domain",link AmigaNOS_Domain} name. This string is used only in the greeting messages of the various network servers; note that it does NOT set the system's @{"IP",link AmigaNOS_Ip} address. If <name> is the same as an <iface> (see the @{"Attach",link AmigaNOS_Attach} commands chapter), this command will search for a CNAME @{"domain",link AmigaNOS_Domain} resource @{"record",link AmigaNOS_Record} which corresponds to the @{"IP",link AmigaNOS_Ip} address of the <iface>. @EndNode @Node AmigaNOS_Icmp icmp ... These @{"commands",link AmigaNOSMain_Index} are used for the Internet Control Message Protocol service. icmp @{"echo",link AmigaNOS_Echo} [on|off] Display or set the flag controlling the asynchronous display of ICMP @{"Echo",link AmigaNOS_Echo} Reply packets. This flag must be on for one-shot pings to work (see the @{"ping",link AmigaNOS_Ping} command.) icmp status Display statistics about the Internet Control Message Protocol (ICMP), including the number of ICMP messages of each type sent or received. icmp trace [on|off] Display or set the flag controlling the display of ICMP error messages. These informational messages are generated by Internet routers in response to routing, protocol or congestion problems. This option should be turned off before using the hop check facility because it relies on ICMP @{"Time",link AmigaNOS_Time} Exceeded messages, and the asynchronous display of these messages will be mingled with hop check command output. @EndNode @Node AmigaNOS_Ifconfig ifconfig Display a list of interfaces, with a short status for each. ifconfig <iface> Display an extended status of the interface. ifconfig <iface> broadcast <address> Set the broadcast address for the interface. The <address> takes the form of an @{"IP",link AmigaNOS_Ip} address with 1's in the host part of the address. This is related to the netmask sub-command. See also the @{"arp",link AmigaNOS_Arp} command. ifconfig <iface> description ["description"] Set the description for <iface>, to be used by the PORTS command from the Mailbox. ifconfig <iface> encapsulation <name> Not fully implemented. ifconfig <iface> forward <forward-iface> Set a forwarding interface for multiple channel interfaces. To remove the forward, set <forward-iface> to <iface>. ifconfig <iface> ipaddress <hostid> Set the @{"IP",link AmigaNOS_Ip} address for this interface. It is standard Internet practice that each interface has its own address. For hosts with only one interface, the interface address is usually the same as the host address. See also the @{"hostname",link AmigaNOS_Hostname} and @{"ip",link AmigaNOS_Ip} address commands. ifconfig <iface> linkaddress <hardware-dependant> Set the hardware dependant address for this interface. ifconfig <iface> mtu <mtu> Set the MTU for this interface. ifconfig <iface> netmask <address> Set the sub-net mask for this interface. The <address> takes the form of an @{"IP",link AmigaNOS_Ip} address with 1's in the network and subnet parts of the address, and 0's in the host part of the address. This is related to the broadcast sub-command. See also the @{"route",link AmigaNOS_Route} com- mand. ifconfig <iface> rxbuf <?> Not yet implemented. @EndNode @Node AmigaNOS_Ip ip Display Internet Protocol (IP) statistics, such as total packet counts and error counters of various types. ip address [<hostid>] Display or set the default local IP address. This command must be given before an @{"attach",link AmigaNOS_Attach} command if it is to be used as the default IP address for the interface. ip rtimer [<seconds>] Display or set the IP reassembly timeout. The default is 30 seconds. ip ttl [<hops>] Display or set the time-to-live value placed in each outgoing IP datagram. This limits the number of switch hops the datagram will be allowed to take. The idea is to bound the lifetime of the packet should it become caught in a routing loop, so make the value slightly larger than the number of hops across the network you expect to transit packets. The default is set at compilation @{"time",link AmigaNOS_Time} to the official recommended value for the Internet. @EndNode @Node AmigaNOS_Kick kick [<session>] Kick all sockets associated with a session; if no argument is given, kick the current session. Performs the same function as the @{"ax25",link AmigaNOS_Ax25} kick and @{"tcp",link AmigaNOS_Tcp} kick commands, but is easier to type. @EndNode @Node AmigaNOS_Less less <filename> Invokes the external LESS command to display the file <filename> @EndNode @Node AmigaNOS_Listserv listserv [<on|off|kick>] @EndNode @Node AmigaNOS_Log log [stop|<filename>] Display or set the filename for logging server sessions. If @{"stop",link AmigaNOS_Stop} is given as the argument, logging is terminated (the servers themselves are unaffected). If a file name is given as an argu- ment, server session log entries will be appended to it. @EndNode @Node AmigaNOS_Mbox mbox accept <to_address> mbox reject [<to_address>] The subcommand REJECT will display the reject list, that is: the list of destination addresses that the system will reject from the @{"mailbox",link AmigaNOSMBox_Index} prompt, and if supplied with a <to_address> string will add that to the reject list. The subcommand ACCEPT will remove the <to_address> from the reject list. mbox attend [on] | [off] Display or Set the @{"Mailbox",link AmigaNOSMBox_Index} attended flag. mbox @{"kick",link AmigaNOS_Kick} Forces the @{"Mailbox",link AmigaNOSMBox_Index} to run the @{"ax25",link AmigaNOS_Ax25} forwarding system, if there is anything to forward. mbox maxmsg <messages> Display or set the maximum number of messages in each @{"mailbox",link AmigaNOSMBox_Index} message file. mbox password ["sysop password string upto 80 characters"] Set the SYSOP password for access from the mailbox. mbox profile Display the MOTD, ORGANISATION, REALNAME and RHEADER strings. mbox profile motd ["message of the day"] Set the @{"Mailbox",link AmigaNOSMBox_Index} MOTD string. mbox profile organisation ["name of organisation"] Set the @{"Mailbox",link AmigaNOSMBox_Index} ORGANISATION string. mbox profile realname ["your real name"] Set the @{"Mailbox",link AmigaNOSMBox_Index} REALNAME string. mbox profile rheader ["NTS header string"] Set the @{"Mailbox",link AmigaNOSMBox_Index} RHEADER string. mbox sysop [on] | [off] Display or set the SYSOP access flag. mbox thirdparty [on] | [off] Display or set the THIRDPARTY access flag. mbox timer [seconds] Display or set the @{"Mailbox",link AmigaNOSMBox_Index} forwarding timer period in seconds. mbox trace [trace_level] Display or set the @{"Mailbox",link AmigaNOSMBox_Index} trace level. Set to 2, all user input to the @{"mailbox",link AmigaNOSMBox_Index} are shown, Set to 1, just the user @{"commands",link AmigaNOSMain_Index} are shown. @EndNode @Node AmigaNOS_Mem mem ... mem thresh [<bytes>] Display or set the memory threshold in bytes. If available memory falls below this value, no new sessions are started or accepted/ @EndNode @Node AmigaNOS_Message message <socket> <"message"> message <socket1> <... ...> <socketn> <"message"> Send a one-line message to the sockets specified. @EndNode @Node AmigaNOS_Mode mode <iface> [vc|datagram] Control the default transmission mode on the specified AX.25 interface. In datagram mode, @{"IP",link AmigaNOS_Ip} packets are encapsulated in AX.25 UI frames and transmitted without any other link level mechan- isms, such as connections or acknowledgements. In vc (virtual circuit) mode, @{"IP",link AmigaNOS_Ip} packets are encapsulated in AX.25 I frames and are acknowledged at the link level according to the AX.25 protocol. Link level connections are opened if necessary. In both modes, @{"ARP",link AmigaNOS_Arp} is used to map @{"IP",link AmigaNOS_Ip} to AX.25 addresses. The defaults can be overridden with the type-of-service (TOS) bits in the @{"IP",link AmigaNOS_Ip} header. Turning on the "reliability" bit causes I frames to be used, while turning on the "low delay" bit uses UI frames. (The effect of turning on both bits is undefined and subject to change). In both modes, IP-level fragmentation is done if the datagram is larger than the interface MTU. In virtual circuit mode, how- ever, the resulting datagram (or fragments) is further fragmented at the AX.25 layer if it (or they) are still larger than the AX.25 paclen parameter. In AX.25 fragmentation, datagrams are broken into several I frames and reassembled at the receiving end before being passed to IP. This is preferable to @{"IP",link AmigaNOS_Ip} fragmentation whenever possible because of decreased overhead (the @{"IP",link AmigaNOS_Ip} header isn't repeated in each fragment) and increased robustness (a lost fragment is immediately retransmitted by the link layer). @EndNode @Node AmigaNOS_Netrom netrom acktime [<millisecs>] Display or set the NET/ROM acknowledgement timer. netrom bcnodes <iface> Send a NET/ROM routing broadcast out on <iface> netrom connect <node_callsign> Make an ordinary NET/ROM connection to another NET/ROM node. netrom choketime [<millisecs>] Display or set the NET/ROM choke time. This is the @{"time",link AmigaNOS_Time} to wait before breaking a send choke condition. netrom interface <interface> <alias> <quality> The 'netrom interface' command specifies an <interface> to be used for NET/ROM, together with the NET/ROM node <alias> and <quality>. The <alias> is a string of up to six characters, and is the name by which the node is known to other NET/ROM stations. There are no hard and fast rules for choosing an alias name, but ideally it should contain the letters "IP" or "TCP", or @{"start",link AmigaNOS_Start} with a "#", to make it clear to other users that this is not an ordinary NET/ROM node. A suggested convention is to incorporate the last half of your @{"IP",link AmigaNOS_Ip} address, expressed in hexadecimal, into the alias. The <quality> is the default quality for incoming NET/ROM broadcasts (and is also the default quality for stations added to the node filter list). netrom irtt [<millisecs>] Display or set the NET/ROM Initial Round Trip Timer. netrom @{"kick",link AmigaNOS_Kick} <&CB> @{"Kick",link AmigaNOS_Kick} the NET/ROM session with control block address <&CB>. netrom nodefilter Display the node filter list. netrom nodefilter add <neighbour_callsign> <interface> [<quality>] Add a node to the node filter list. The default value of <quality> is the quality value assigned in the 'netrom interface' command. netrom nodefilter drop <neighbour_callsign> <interface> Remove a node from the node filter list. netrom nodefilter mode [none|accept|reject] Display or set the node filter mode. The settings are: none: No filtering. The filter is ignored. accept: Only @{"nodes",link AmigaNOSMBOX_Nodes} in the nodefilter list will be heard by the node. reject: @{"Nodes",link AmigaNOSMBOX_Nodes} in the nodefilter list will be rejected. This is used to disable a path to a neighbouring node; useful if there are several paths and you do not want to use a specific one. netrom nodetimer [<seconds>] Display or set the NET/ROM @{"route",link AmigaNOS_Route} update broadcast interval. netrom obsotimer [<seconds>] Display or set the NET/ROM obsolescence timer, which indicates how long the entries will remain alive in the NET/ROM routing table. A new or refreshed entry in the table has a time-to-live (TTL) count of 6. Each @{"time",link AmigaNOS_Time} the obsotimer expires, the TTL count is decremented by one. If node information is not refreshed, the entry will eventually disappear when the TTL count falls to zero. netrom qlimit [<bytes>] Display or set the maximum number of bytes on the NET/ROM receive queue. This is the threshhold at which the sender is choked. netrom reset <&CB> Reset the NET/ROM session with control block address <&CB>. Use the 'netrom status' command to obtain the control block address. netrom retries [<n>] Display or set the maximum number of connect and @{"disconnect",link AmigaNOS_Disconnect} retries. netrom @{"route",link AmigaNOS_Route} Display the NET/ROM routing table. Entries are of the form <alias>:<callsign>. netrom @{"route",link AmigaNOS_Route} add <alias> <target_callsign> <interface> <quality> <neighbour_callsign> Add an entry to the NET/ROM routing table. The <alias> and <target_callsign> apply to the station at the eventual destination of the route. The <neighbour_callsign> is the callsign of the local NET/ROM node to which packets will be sent first on their journey to the target. netrom @{"route",link AmigaNOS_Route} drop <target_callsign> <neighbour_callsign> <interface> Remove an entry from the NET/ROM routing table. netrom @{"route",link AmigaNOS_Route} @{"info",link AmigaNOSMBOX_Info} <target_callsign> Display NET/ROM routing information. The output includes the quality, TTL, interface and neighbouring NET/ROM node. Permanent routes which have been manually entered are indicated with a "P". netrom status [<&CB>] Display NET/ROM status. The 'netrom status' command without a control block parameter <&CB> displays the general status. When a control block address is supplied, a more detailed output is produced. netrom timertype [linear|exponential] Display or set the NET/ROM timer backoff mode. Linear backoff is recommended for amateur radio work. netrom ttl [<hops>] Display or set the NET/ROM Time-to-Live. This is the maximum number of hops a packet can take before it is thrown away. This prevents packets from circulating for ever in an endless loop. netrom user [<username>] Display or set your NET/ROM user name. netrom @{"verbose",link AmigaNOSMBOX_Verbose} [on|off] Display or set the NET/ROM "verbose" mode. When set to 'on', the node will act as a normal NET/ROM switch, broadcasting its routing table in the normal NET/ROM manner. netrom window [<frames>] Display or set the maximum NET/ROM window size. This is the largest negotiable send and receive window. @EndNode @Node AmigaNOS_Nntp 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. Multiple 'nntp addserver' @{"commands",link AmigaNOSMain_Index} may be used to concatenate groups (up to a maximum of 512 bytes). nntp directory [spool|control <directory>] Display or set the default spool directory for spooling news articles. This is in addition to the control directory (SPOOL/NEWS). nntp dropserver <nntpserver_host> Drop the specified NNTP server. nntp groups <group> [<group> ...] 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",link AmigaNOS_Kick} <nntpserver_host> @{"Kick",link AmigaNOS_Kick} the local NNTP client to get in touch with the named server. nntp @{"kill",link AmigaNOSMBOX_Kill} <message_number> @{"Kill",link AmigaNOSMBOX_Kill} the specified message number from the outbound news queue. nntp listservers List the currently defined servers. nntp messages List the Outbound message queue. nntp profile Display the current nntp profile, i.e, full_name, hostname, organisation, reply_address, signature_filename, username. nntp profile fullname ["your full name"] nntp profile host ["hostname"] nntp profile organ ["your organisation"] nntp profile reply ["address"] nntp profile sig ["pathname for signature file"] nntp profile user ["username"] Set up the nntp profile. nntp post Prepare Articles for nntp. nntp trace <level> 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. @EndNode @Node AmigaNOS_Nrstat nrstat Display statistics for the NET/ROM serial interface (nrs). @EndNode @Node AmigaNOS_Param param <iface> [<param> ...] Invoke a device-specific control routine. On a KISS TNC inter- face, this sends control packets to the TNC. Data bytes are treated as decimal. For example, param ax0 1 255 will set the keyup timer (type field = 1) on the KISS TNC configured as ax0 to 2.55 seconds (255 x .01 sec). On a SLIP interface, the param command allows the baud rate to be read (without arguments) or set. The implementation of this command for the various inter- face drivers is incomplete and subject to change. @EndNode @Node AmigaNOS_Ping ping <hostid> [<length> [<seconds> [<incflag>]]] Ping (send @{"ICMP",link AmigaNOS_Icmp} @{"Echo",link AmigaNOS_Echo} Request packets to) the specified host. By default the data field contains only a small timestamp to aid in determining round trip time; if the optional length argument is given, the appropriate number of data bytes (consisting of hex 55) are added to the ping packets. If interval is specified, pings will be repeated indefinitely at the specified number of seconds; otherwise a single, "one shot" ping is done. Responses to one-shot pings appear asynchronously on the command screen, while repeated pings create a session that may be suspended and resumed. Pinging continues until the ses- sion is manually reset. The incflag option causes a repeated ping to increment the target @{"IP",link AmigaNOS_Ip} address for each ping; it is an experimental feature for searching blocks of @{"IP",link AmigaNOS_Ip} addresses for active hosts. @EndNode @Node AmigaNOS_Pop pop @{"mailbox",link AmigaNOSMBox_Index} [<name>] Display or set the name of the local @{"mailbox",link AmigaNOSMBox_Index} that is to hold all of the mail received from the POP server. Note that this @{"mailbox",link AmigaNOSMBox_Index} <name>, like all DOS filenames, is limited to eight characters. Also, <name> does NOT include a DOS path; all mail is placed in SPOOL/MAIL, along with other mail placed there by SMTP. The POP client does not write directly to the user's mailbox. Instead it creates a file MBOX.POP in the current directory and places all of the mail it receives in that file. On completion it appends the contents of the file to the end of the @{"mailbox",link AmigaNOSMBox_Index} when all mail has been collected from the @{"mailbox",link AmigaNOSMBox_Index} server. Normally this file is deleted after its contents have been transferred to the mailbox. However, if the POP client is unable to access the @{"mailbox",link AmigaNOSMBox_Index} (for example, if it is locked by SMTP), then MBOX.POP will remain in existence. Any new mail gathered by the POP client will be appended to the end of MBOX.POP. Then eventually when the @{"mailbox",link AmigaNOSMBox_Index} becomes available the contents of MBOX.POP will be transferred to it. pop mailhost [<host>] Display or set the the POP server host. pop @{"kick",link AmigaNOS_Kick} Force the POP client to check with the remote POP server. pop quiet Display or set the POP quiet flag. This flag determines whether the bell sounds when the system announces that incoming mail has arrived. When quiet is set to 'off' you hear the bell. pop timer Display or Set the interval for POP sessions. pop userdata Display or set the user data required by the POP server to validate the client's mail request. Note that <name> and <password> are case sensitive. When only 'pop userdata' is entered to show the values, only the <name> is shown. @EndNode @Node AmigaNOS_Ps ps Display all current processes in the system. The fields are as follows: PID - Process ID (the address of the process descriptor). SP - The current value of the process stack pointer. stksize - The size of the stack allocated to the process. maxstk - The apparent peak stack utilization of this process. This is done in a somewhat heuristic fashion, so the numbers should be treated as approximate. If this number reaches or exceeds the stksize figure, the system is almost certain to crash; the AmigaNOS program should be recompiled to give the process a larger allocation when it is started. event - The event this task is waiting for, if it is not runnable. fl - Process status flags. There are three: I (Interrupts enabled), W (Waiting for event) and S (Suspended). The I flag is set whenever a task has executed a pwait() call (wait for event) without first disabling hardware interrupts. Only tasks that wait for hardware interrupt events will turn off this flag; this is done to avoid critical sections and missed interrupts. The W flag indicates that the process is waiting for an event; the event column will be non-blank. Note that although there may be several runnable processes at any @{"time",link AmigaNOS_Time} (shown in the ps listing as those without the W flag and with blank event fields) only one process is actually running at any one instant (The Refrigerator Light Effect says that the ps command is always the one running when this display is generated.) @EndNode @Node AmigaNOS_Record record [off|<filename>] Append to filename all data received on the current session. Data sent on the current session is also written into the file except for @{"Telnet",link AmigaNOS_Telnet} sessions in remote @{"echo",link AmigaNOS_Echo} mode. The command record off stops recording and closes the file. @EndNode @Node AmigaNOS_Remote remote [-p <port>] [-k <key>] [-a <kickaddr>] <hostid> exit|reset|kick Send a @{"UDP",link AmigaNOS_Udp} packet to the specified host commanding it to exit the net.exe program, reset the processor, or force a retransmission on @{"TCP",link AmigaNOS_Tcp} connections. For this command to be accepted, the remote system must be running the remote server and the port number specified in the remote command must match the port number given when the server was started on the remote system. If the port numbers do not match, or if the remote server is not running on the target system, the command packet is ignored. Even if the command is accepted there is no acknowledgement. The @{"kick",link AmigaNOS_Kick} command forces a retransmission timeout on all @{"TCP",link AmigaNOS_Tcp} con- nections that the remote node may have with the local node. If the -a option is used, connections to the specified host are kicked instead. No key is required for the @{"kick",link AmigaNOS_Kick} subcommand. The exit and reset subcommands are mainly useful for restarting the net.exe program on a remote unattended system after the con- figuration file has been updated. remote -s <key> The exit and reset subcommands of remote require a password. The password is set on a given system with the -s option, and it is specified in a command to a remote system with the -k option. If no password is set with the -s option, then the exit and reset subcommands are disabled. Note that remote is an experimental feature in NOS; it is not yet supported by any other TCP/IP implementation. @EndNode @Node AmigaNOS_Reset reset [<session>] Reset the specified session; if no argument is given, reset the current session. This command should be used with caution since it does not reliably inform the remote end that the connection no longer exists. (In @{"TCP",link AmigaNOS_Tcp} a reset (RST) message will be automati- cally generated should the remote @{"TCP",link AmigaNOS_Tcp} send anything after a local reset has been done. In AX.25 the DM message performs a similar role. Both are used to get rid of a lingering half-open connec- tion after a remote system has crashed.) @EndNode @Node AmigaNOS_Rip rip ... These @{"commands",link AmigaNOSMain_Index} are used for the RIP service. rip accept <gateway> Remove the specified @{"gateway",link AmigaNOSMBOX_Gateway} from the RIP filter table, allowing future broadcasts from that @{"gateway",link AmigaNOSMBOX_Gateway} to be accepted. rip add <hostid> <seconds> [<flags>] Add an entry to the RIP broadcast table. The @{"IP",link AmigaNOS_Ip} routing table will be sent to hostid every interval seconds. If flags is speci- fied as 1, then "split horizon" processing will be performed for this destination. That is, any @{"IP",link AmigaNOS_Ip} routing table entries pointing to the interface that will be used to send this update will be removed from the update. If split horizon processing is not specified, then all routing table entries except those marked "private" will be sent in each update. (Private entries are never sent in RIP packets). Triggered updates are always done. That is, any change in the routing table that causes a previously reachable destination to become unreachable will trigger an update that advertises the destination with metric 15, defined to mean "infinity". Note that for RIP packets to be sent properly to a broadcast address, there must exist correct @{"IP",link AmigaNOS_Ip} routing and @{"ARP",link AmigaNOS_Arp} table entries that will first steer the broadcast to the correct inter- face and then place the correct link-level broadcast address in the link-level destination field. If a standard @{"IP",link AmigaNOS_Ip} broadcast address convention is used (eg. 128.96.0.0 or 128.96.255.255) then chances are you already have the necessary @{"IP",link AmigaNOS_Ip} routing table entry, but unusual subnet or cluster-addressed networks may require special attention. However, an @{"arp",link AmigaNOS_Arp} add command will be required to translate this address to the appropriate link level broadcast address. For example, arp add 44.131.0.0 @{"ax25",link AmigaNOS_Ax25} qst-0 for an @{"AX25",link AmigaNOS_Ax25} packet radio channel. rip drop <dest> Remove an entry from the RIP broadcast table. rip merge [on|off] This flag controls an experimental feature for consolidating redundant entries in the @{"IP",link AmigaNOS_Ip} routing table. When rip merging is enabled, the table is scanned after processing each RIP update. An entry is considered redundant if the target(s) it covers would be routed identically by a less "specific" entry already in the table. That is, the target address(es) specified by the entry in question must also match the target addresses of the less specific entry and the two entries must have the same interface and @{"gateway",link AmigaNOSMBOX_Gateway} fields. For example, if the routing table contains Dest Len Interface @{"Gateway",link AmigaNOSMBOX_Gateway} Metric P Timer Use 1.2.3.4 32 ethernet0 128.96.1.2 1 0 0 0 1.2.3 24 ethernet0 128.96.1.2 1 0 0 0 then the first entry would be deleted as redundant since packets sent to 1.2.3.4 will still be routed correctly by the second entry. Note that the relative metrics of the entries are ignored. rip refuse <gateway> Refuse to accept RIP updates from the specified @{"gateway",link AmigaNOSMBOX_Gateway} by adding the @{"gateway",link AmigaNOSMBOX_Gateway} to the RIP filter table. It may be later removed with the rip accept command. rip request <gateway> Send a RIP Request packet to the specified gateway, causing it to reply with a RIP Response packet containing its routing table. rip status Display RIP status, including a count of the number of packets sent and received, the number of requests and responses, the number of unknown RIP packet types, and the number of refused RIP updates from hosts in the filter table. A list of the addresses and intervals to which periodic RIP updates are being sent is also shown, along with the contents of the filter table. rip trace [0|1|2] This variable controls the tracing of incoming and outgoing RIP packets. Setting it to 0 disables all RIP tracing. A value of 1 causes changes in the routing table to be displayed, while pack- ets that cause no changes cause no output. Setting the variable to 2 produces maximum output, including tracing of RIP packets that cause no change in the routing table. @EndNode @Node AmigaNOS_Route route With no arguments, route displays the @{"IP",link AmigaNOS_Ip} routing table. route add <dest_hostid>[/bits]|default <iface> [<gateway_hostid> [<metric>]] This command adds an entry to the routing table. It requires at least two more arguments, the hostid of the target destination and the name of the interface to which its packets should be sent. If the destination is not local, the gateway's hostid should also be specified. (If the interface is a point-to-point link, then gateway_hostid may be omitted even if the target is non-local because this field is only used to determine the gateway's link level address, if any. If the destination is directly reachable, gateway_hostid is also unnecessary since the destination address is used to determine the interface link address). The optional /bits suffix to the destination host id specifies how many leading bits in the host id are to be considered signi- ficant in the routing comparisons. If not specified, 32 bits (i.e., full significance) is assumed. With this option, a single routing table entry may refer to many hosts all sharing a common bit string prefix in their @{"IP",link AmigaNOS_Ip} addresses. For example, ARPA Class A, B and C networks would use suffixes of /8, /16 and /24 respec- tively; the command route add 44/8 sl0 44.64.0.2 causes any @{"IP",link AmigaNOS_Ip} addresses beginning with "44" in the first 8 bits to be routed to 44.64.0.2; the remaining 24 bits are "don't- cares". When an @{"IP",link AmigaNOS_Ip} address to be routed matches more than one entry in the routing table, the entry with largest bits parameter (i.e., the "best" match) is used. This allows individual hosts or blocks of hosts to be exceptions to a more general rule for a larger block of hosts. The special destination default is used to route datagrams to addresses not matched by any other entries in the routing table; it is equivalent to specifying a /bits suffix of /0 to any desti- nation hostid. Care must be taken with default entries since two @{"nodes",link AmigaNOSMBOX_Nodes} with default entries pointing at each other will route packets to unknown addresses back and forth in a loop until their time-to-live (TTL) fields expire. (Routing loops for specific addresses can also be created, but this is less likely to occur accidentally). Here are some examples of the route command: # Route datagrams to @{"IP",link AmigaNOS_Ip} address 44.0.0.3 to SLIP line #0. # No @{"gateway",link AmigaNOSMBOX_Gateway} is needed because SLIP is point-to point. route add 44.0.0.3 sl0 # Route all default traffic to the @{"gateway",link AmigaNOSMBOX_Gateway} on the local Ethernet # with @{"IP",link AmigaNOS_Ip} address 44.0.0.1 route add default ec0 44.0.0.1 # The station with @{"IP",link AmigaNOS_Ip} address 44.0.0.10 is on the local AX.25 channel route add 44.0.0.10 ax0 route addprivate <dest hostid>[/bits]|default <iface> [<gateway hostid> [<metric>]] This command is identical to route add except that it also marks the new entry as private; it will never be included in outgoing @{"RIP",link AmigaNOS_Rip} updates. route drop <dest hostid> route drop deletes an entry from the table. If a packet arrives for the deleted address and a default route is in effect, it will be used. @EndNode @Node AmigaNOS_Rspf rspf interface [<interface> <quality> <horizon>] Display or set an RSPF interface. The command 'rspf interface' without parameters displays existing interface settings. <interface> is the required interface RSPF should use. <quality> is from 1 to 127 <horizon> is from 1 to 255 hops rspf maxping [<n>] Display or set the maximum number of times to ping. rspf message ["<message_string>"] Display or set the RSPF message string. rspf mode [vc | datagram | none] Display or set the preferred mode for RSPF. rspf routes Display the RSPF routing table. rspf rrhtimer [seconds] Display or set the Router-to-Router Hello (RRH) message interval. rspf status Display the current RSPF status. rspf suspecttimer [seconds] Display or set the @{"time",link AmigaNOS_Time} limit for an idle link to be suspected to be bad. rspf timer [seconds] Display or set the interval between routing updates. @EndNode @Node AmigaNOS_Session session [<session #>] Without arguments, displays the list of current sessions, includ- ing session number, remote @{"TCP",link AmigaNOS_Tcp} or AX.25 address and the address of the @{"TCP",link AmigaNOS_Tcp} or AX.25 control block. An asterisk (*) is shown next to the current session; entering a blank line at this point puts you in converse mode with that session. Entering a session number as an argument to the session command will put you in con- verse mode with that session. If the @{"Telnet",link AmigaNOS_Telnet} server is enabled, the user is notified of an incoming request and a session number is automatically assigned. The user may then select the session normally to converse with the remote user as though the session had been locally initiated. @EndNode @Node AmigaNOS_Smtp smtp ... These @{"commands",link AmigaNOSMain_Index} are used for the Simple Message Transport Protocol service (that is, mail). smtp batch [<on|off>] Display or set the smtp batch flag. When set to 'on', messages in the outgoing mail queue are sent as a batch, whereby many of the SMTP @{"commands",link AmigaNOSMain_Index} are sent in one fell swoop before waiting for responses. (Unfortunately this breaks many brain-damaged SMTP servers, and so may not be usable in practice). smtp @{"gateway",link AmigaNOSMBOX_Gateway} [<hostid>] Displays or sets the host to be used as a "smart" mail relay. Any mail sent to a host not in the host table will instead be sent to the @{"gateway",link AmigaNOSMBOX_Gateway} for forwarding. smtp @{"kick",link AmigaNOS_Kick} Run through the outgoing mail queue and attempt to deliver any pending mail. This command allows the user to "kick" the mail system manually. Normally, this command is periodically invoked by a timer whenever net.exe is running. smtp list List the messages in the outgoing mail queue. smtp maxclients [<count>] Displays or sets the maximum number of simultaneous outgoing SMTP sessions that will be allowed. The default is 10; reduce it if network congestion is a problem. smtp mode [<route|queue>] By default, the SMTP mode is 'route', which means that incoming mail is directed to the mail queue SPOOL/MAIL. You can then read the mail there with the 'bbs' command, or by using an external mailer such as BM or ELM. If the mode is set to 'queue', incoming mail is directed instead to the special mail forwarding queue SPOOL/RQUEUE. The mail is stored in .WRK and .TXT files in the same format as the normal outgoing mail files in SPOOL/MQUEUE. A special forwarding program (not supplied with NOS) is then required to send the mail in SPOOL/RQUEUE onwards to its destination. This mechanism provides added flexibility to NOS for handling mail in different ways. smtp accept <name> smtp reject [<name>] These two subcommands allow the sysop to build up a list of systems from which mail is not wanted, in the case of reject, and to remove items from the list with accept. smtp timer [<seconds>] Displays or sets the interval between scans of the outbound mail queue. For example, smtp timer 600 will cause the system to check for outgoing mail every 10 minutes and attempt to deliver any- thing it finds, subject of course to the smtp maxclients limit. Setting a value of zero disables queue scanning altogether, note that this is the default! This value is recommended for stand alone @{"IP",link AmigaNOS_Ip} gateways that never handle mail, since it saves wear and tear on the floppy disk drive. smtp trace [<value>] Displays or sets the trace flag in the SMTP client, allowing you to watch SMTP's conversations as it delivers mail. Zero (the default) disables tracing. @EndNode @Node AmigaNOS_Socket socket [<socket #>] Without an argument, displays all active sockets, giving their index and type, the address of the associated protocol control block and the and owner process ID and name. If the index to an active socket is supplied, the status display for the appropriate protocol is called. For example, if the socket refers to a @{"TCP",link AmigaNOS_Tcp} connection, the display will be that given by the @{"tcp",link AmigaNOS_Tcp} status com- mand with the protocol control block address. @EndNode @Node AmigaNOS_Source source <filename> The 'source' command runs a set of NOS @{"commands",link AmigaNOSMain_Index} which are in <script_filename>. This is a very convenient way of executing a series of @{"commands",link AmigaNOSMain_Index} without having to enter them individually at the keyboard. @EndNode @Node AmigaNOS_Start start ax25|chat|discard|echo|ftp|netrom|remote| smtp|telnet Start the specified Internet server, allowing remote connection requests. @EndNode @Node AmigaNOS_Status status The 'status' command displays general system information. @EndNode @Node AmigaNOS_Stop stop ax25|chat|discard|echo|ftp|netrom|remote| smtp|telnet Stop the specified Internet server, rejecting any further remote connect requests. Existing connections are allowed to complete normally. @EndNode @Node AmigaNOS_Tcp tcp ... These @{"commands",link AmigaNOSMain_Index} are used for the Transmission Control Protocol service. tcp irtt [<milliseconds>] Display or set the initial round trip @{"time",link AmigaNOS_Time} estimate, in milliseconds, to be used for new TCP connections until they can measure and adapt to the actual value. The default is 5000 mil- liseconds (5 seconds). Increasing this when operating over slow channels will avoid the flurry of retransmissions that would oth- erwise occur as the smoothed estimate settles down at the correct value. Note that this command should be given before servers are started in order for it to have effect on incoming connections. TCP also keeps a cache of measured round trip times and mean deviations (MDEV) for current and recent destinations. Whenever a new TCP connection is opened, the system first looks in this cache. If the destination is found, the cached IRTT and MDEV values are used. If not, the default IRTT value mentioned above is used, along with a MDEV of 0. This feature is fully automatic, and it can improve performance greatly when a series of connections are opened and closed to a given destination (eg. a series of @{"FTP",link AmigaNOS_Ftp} file transfers or directory listings). tcp @{"kick",link AmigaNOS_Kick} <tcb_addr> If there is unacknowledged data on the send queue of the speci- fied TCB, this command forces an immediate retransmission. tcp mss [<size>] Display or set the TCP Maximum Segment Size in bytes that will be sent on all outgoing TCP connect request (SYN segments). This tells the remote end the size of the largest segment (packet) it may send. Changing MSS affects only future connections; existing connections are unaffected. tcp reset <tcb_addr> Deletes the TCP control block at the specified address. tcp rtt <tcb_addr> <milliseconds> Replaces the automatically computed round trip @{"time",link AmigaNOS_Time} in the speci- fied TCB with the rtt in milliseconds. This command is useful to speed up recovery from a series of lost packets since it provides a manual bypass around the normal backoff retransmission timing mechanisms. tcp status [<tcb_addr>] Without arguments, displays several TCP-level statistics, plus a summary of all existing TCP connections, including TCB address, send and receive queue sizes, local and remote sockets, and con- nection state. If tcb_addr is specified, a more detailed dump of the specified TCB is generated, including send and receive sequence numbers and timer information. tcp timertype [linear|exponential] The TCP timer backoff can be either linear or binary exponential. Linear backoff is recommended for amateur radio work. tcp trace [on|off] Display or set TCP trace mode. When set to 'on', task control block activity is displayed, together with numbered TCP protocol messages. tcp window [<size>] Displays or sets the default receive window size in bytes to be used by TCP when creating new connections. Existing connections are unaffected. @EndNode @Node AmigaNOS_Telnet telnet <hostid> Creates a Telnet session to the specified host and enters con- verse mode. @EndNode @Node AmigaNOS_Time ** AmigaNOS4GW on ** e server <time_server_host> Set the server to be used. e read Read the time from the time server previously specified. e set Read the Amiga real-time clock from the time server previously specified e mincorrect <value> Set a minimum threshold for time corrections to be applied; ie if time set discovers the time difference is less than this amount, no correction will be applied. e maxcorrect <value> Set a maximum threshold for time corrections to be applied; ie if time set discovers the time difference is greater than this amount, no correction will be applied. @EndNode @Node AmigaNOS_Trace trace [<iface> [off|<btio> [<tracefile>]]] Controls packet tracing by the interface drivers. Specific bits enable tracing of the various interfaces and the amount of infor- mation produced. Tracing is controlled on a per-interface basis; without arguments, trace gives a list of all defined interfaces and their tracing status. Output can be limited to a single interface by specifying it, and the control flags can be change by specifying them as well. The flags are given as a hexadecimal number which is interpreted as follows: O - Enable tracing of output packets if 1, disable if 0 I - Enable tracing of input packets if 1, disable if 0 T - Controls type of tracing: 0 - Protocol headers are decoded, but data is not displayed 1 - Protocol headers are decoded, and data (but not the headers themselves) are displayed as ASCII characters, 64 characters/line. Unprintable characters are displayed as hyphens. 2 - Protocol headers are decoded, and the entire packet (headers AND data) is also displayed in hexadecimal and ASCII, 16 characters per line. B - Broadcast filter flag. If set, only packets specifically addressed to this node will be traced; broadcast packets will not be displayed. If tracefile is not specified, tracing will be to the console. @EndNode @Node AmigaNOS_TtyLink ttylink <hostid> Creates a @{"Telnet",link AmigaNOS_Telnet} session to port 87 at the specified host and enters converse mode. @EndNode @Node AmigaNOS_Udp udp Displays the status of all UDP receive queues. @EndNode @Node AmigaNOS_Upload upload [<filename>] Opens filename and sends it on the current session as though it were typed on the terminal. @EndNode @Node AmigaNOSMBOX_Area USAGE A[rea] [<area-name>] DESCRIPTION The area command, when used by itself, will list the mail areas that contain messages you may read. The list gives the name of each area (<area-name>), followed by a description of the message area's contents. When the area command is followed by a valid "<area-name>", as shown in the area list described above, your current mail context will be switched to the new area. You may then use the R[ead] and L[ist] @{"commands",link AmigaNOSMain_Index} to review messages in the selected catagory. If you want to add your own message to one of these areas, use the S[end] command to send mail addressed to "<area-name>". EXAMPLES area public (makes "public" your current mail area) send public (puts a message in the "public" mail area) @EndNode @Node AmigaNOSMBOX_Bye USAGE B[ye] DESCRIPTION The bye command is used when you want to exit from the NOS MBOX. This will @{"close",link AmigaNOS_Close} your @{"mailbox",link AmigaNOSMBox_Index} file and remove any messages that you have deleted with the K[ill] command. EXAMPLES bye @EndNode @Node AmigaNOSMBOX_ChatNode chatnode Will issue a @{"telnet",link AmigaNOS_Telnet} call to the local system's @{"chatnode",link AmigaNOS_ChatNode} on the port number 3600 @EndNode @Node AmigaNOSMBOX_Download USAGE D[ownload] [/][<path_name>/]filename DU [/][<path_name>/]filename DESCRIPTION The download command will begin sending a file from this system to you. Use the "D" command to send a plain ASCII text file. You can also download binary files converted to UUENCODED ASCII by using the "DU" command. You will need the "uudecode" utility to convert this ASCII file back to binary. The system will check the file for non-ascii characters, and if any are found in the first 512 characters it is assumed to be a binary file and will be sent uuencoded. The optional path_name 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 "/". EXAMPLES download index.txt du nos/ibm/g1emmkit.zip @EndNode @Node AmigaNOSMBOX_Escape USAGE E[scape] [<new_escape_character>] DESCRIPTION The @{"escape",link AmigaNOS_Escape} command, when entered by itself, will display the character that is currently set as the @{"escape",link AmigaNOS_Escape} character. 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 any response from the operator after waiting a few minutes, you can enter the @{"escape",link AmigaNOS_Escape} character, followed by a <RETURN> or <ENTER>, and the session will be terminated. You will then be returned to the @{"MBOX",link AmigaNOS_Mbox} prompt. The @{"escape",link AmigaNOS_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",link AmigaNOS_Escape} character. This must be a single typed character (the <CTRL> key may be used in addition). EXAMPLES @{"escape",link AmigaNOS_Escape} ^Z (the ASCII character <CTRL>Z) @{"escape",link AmigaNOS_Escape} X (the character "x" is the new escape) @EndNode @Node AmigaNOSMBOX_Find USAGE find <string> DESCRIPTION The find command allows you to scan all the files in the cache for a given string. EXAMPLES find kantronics find g1yyh NOTE This command is unique to AmigaNOS v2.8 @EndNode @Node AmigaNOSMBOX_Finger USAGE F[inger] [<user_name>][@<host>] DESCRIPTION The @{"finger",link AmigaNOS_Finger} command retrieves personal information about users of a system. When used by itself, a list of known users on the current system will be displayed. When a user_name is added to the command, @{"finger",link AmigaNOS_Finger} will display information about that particular user. The same functions detailed above may be performed on some other TCP/IP host connected to the network. Just add the "@<host>" to the @{"finger",link AmigaNOS_Finger} command as specified in the usage line above. 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, simply insert the user name before the "@". EXAMPLES @{"finger",link AmigaNOS_Finger} (list the known users on this system) f g1yyh (list @{"info",link AmigaNOSMBOX_Info} about the local user "g1yyh") f @g1yyh (list the known users at host "g1yyh") f g1yyh@g1yyh (display @{"info",link AmigaNOSMBOX_Info} about "g1yyh" at host "g1yyh") @EndNode @Node AmigaNOSMBOX_Gateway USAGE G[ateway] <interface> <callsign> [<digipeater> . . .] DESCRIPTION The gateway command allows you to connect to another AX.25 station through this host system's radio ports. You can determine what ports are available using the "J[heard]" command. The list will be divided by headings listing the interfaces available. You can also try using the I[nfo] command. Your connection will assume the callsign of this TCP/IP station instead of your own. The station you want to connect to must be substituted for the "<callsign>" parameter above. If you need to reach this station via one or more digipeaters, enter the list following the desti- nation station's callsign. The first digipeater in the list is the one that is to be connected through first. EXAMPLES gateway nos gb7nwp (connect to gb7nwp on interface nos) g nos g1aaa g2bbb g3ccc (connect to g1aaa on the nos interface, via g2bbb and g3ccc as digipeaters) @EndNode @Node AmigaNOSMBOX_Help USAGE H[elp] [<command-name>] DESCRIPTION The @{"help",link AmigaNOS_Help} command will display @{"help",link AmigaNOS_Help} for a given command. The help command by itself, displays this particular message. To get @{"help",link AmigaNOS_Help} for a specific command, enter "help" followed by a space and then the name of the command you want described. The following @{"commands",link AmigaNOSMain_Index} have @{"help",link AmigaNOS_Help} descriptions available for them: @{"area",link AmigaNOSMBOX_Area} @{"bye",link AmigaNOSMBOX_Bye} chat download escape finger @{"gateway",link AmigaNOSMBOX_Gateway} @{"help",link AmigaNOS_Help} @{"info",link AmigaNOSMBOX_Info} jheard kill list @{"netrom",link AmigaNOS_Netrom} read @{"retrieve",link AmigaNOSMBOX_Retrieve} send telnet upload @{"verbose",link AmigaNOSMBOX_Verbose} what zap EXAMPLES @{"help",link AmigaNOS_Help} @{"area",link AmigaNOSMBOX_Area} (displays a description of the "area" command) h download (displays @{"info",link AmigaNOSMBOX_Info} about downloading files) @EndNode @Node AmigaNOSMBOX_Info Welcome to G1YYH's TCP/IP system The software running on this machine is the TCP/IP software package developed by Phil Karn, KA9Q which was ported to the Amiga by Louis Mamakos, WA3YMH and subsequently modified by me. You can of course get a copy of both the IBM-PC and AMIGA versions directly from me. It is possible to download a copy of NOS using the AX.25 @{"Mailbox",link AmigaNOSMBox_Index} by using the "DU" form of the download command (use "help download" for info). This is not encouraged, as both versions are very large files ( 400K+ ), and will tie up a local packet channel for quite a long time. The system here is composed of: Computer: Commodore AMIGA B2000, 105MB disk, 5MB memory Radio Interface: Kantronics KAM, (interface name "nos") Leave mail for the owner of this system by using the command: S g1yyh @EndNode @Node AmigaNOSMBOX_Jheard USAGE J[heard] [<interface>] DESCRIPTION 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",link AmigaNOS_Time} since the station was heard last, and the total number of packets received. When the command is used alone (no interface specified), the "heard" lists for all interfaces will be displayed. To display a list of stations heard on only a particular channel, specify the "<interface>" name along with the "jheard" command. Warning: if this system has been on the air for very long, and the channels are very active, this list could be extremely long. EXAMPLES jheard (displays all stations heard on all ports) j nos (displays stations only heard on interface nos) @EndNode @Node AmigaNOSMBOX_Kill USAGE K[ill] <message_number> [<message_number> . . .] DESCRIPTION The kill command allows you to delete messages from the current @{"mailbox",link AmigaNOSMBox_Index} (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",link AmigaNOSMBOX_Area} can be checked and modified with the "A[rea]" command. EXAMPLES kill 1 k 2 4 5 7 @EndNode @Node AmigaNOSMBOX_List USAGE L[ist] [<starting_msg_number> [<ending_msg_number>] ] DESCRIPTION The list command prints a list of the messages in the current @{"mailbox",link AmigaNOSMBox_Index} (or "area"). For each message, the list contains the subject header line, the @{"time",link AmigaNOS_Time} and date it was created, who it is from, how many bytes long it is, and whether 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. EXAMPLES list (Display a list of all messages in the current area) l 6 (Display messages headers beginning with message 6) list 6 10 (Display only message headers from 6 to 10) ll 5 (Display the last 5 messages in the current area) @EndNode @Node AmigaNOSMBOX_Message message <"your message"> Send a one-line message to the sysop @EndNode @Node AmigaNOSMBOX_MoveMail movemail <area> Move the current message to <area> movemail <msg_num> <msg_num> @{"area",link AmigaNOSMBOX_Area} Move <msg_num> ... to <area> @EndNode @Node AmigaNOSMBOX_NConnect USAGE NC[onnect] DESCRIPTION The Nconnect command will attempt a NET/ROM connection to the specified system. nc[onnect] <node> When you are finished using the @{"NetRom",link AmigaNOS_Netrom} interface, you may return to the @{"mbox",link AmigaNOS_Mbox} by entering the "escape" character, <CTRL>X (or what ever you may have changed it to using the "E[scape]" command. EXAMPLES nc orc22 (Attempts a connection to the @{"netrom",link AmigaNOS_Netrom} node "orc22") @EndNode @Node AmigaNOSMBOX_Netrom USAGE N[etrom] DESCRIPTION The @{"Netrom",link AmigaNOS_Netrom} command places you into a pseudo @{"NetRom",link AmigaNOS_Netrom} mode. The typical @{"NetRom",link AmigaNOS_Netrom} @{"commands",link AmigaNOSMain_Index} available are: c[onnect] <node> i[dent] n[odes] [<callsign>] u[sers] When you are finished using the @{"NetRom",link AmigaNOS_Netrom} interface, you may return to the @{"mbox",link AmigaNOS_Mbox} by entering the "escape" character, <CTRL>X (or what ever you may have changed it to using the "E[scape]" command. EXAMPLES @{"netrom",link AmigaNOS_Netrom} (Puts you into the @{"NetRom",link AmigaNOS_Netrom} interface) c orc22 (Attempts a connection to the @{"netrom",link AmigaNOS_Netrom} node "orc22") ident (Prints this station's callsign and @{"NetRom",link AmigaNOS_Netrom} node ID) n gb3by-2 (Prints a list of all the paths to get to gb3by-2) users (Prints a list of all the current @{"mailbox",link AmigaNOSMBox_Index} users) @EndNode @Node AmigaNOSMBOX_Nodes USAGE No[des] DESCRIPTION The Nodes command will either list the available NET/ROM nodelist or if supplied with a nodename/callsign it will show details of the node quality/routes no[des] [<callsign>] EXAMPLES n gb3by-2 (Prints a list of all the paths to get to gb3by-2) @EndNode @Node AmigaNOSMBOX_OS os The 'os' command displays general system information. @EndNode @Node AmigaNOSMBOX_PageSysop USAGE P[ageSysop] DESCRIPTION The pagesysop command allows you to "talk" keyboard-to-keyboard with the operator of this NOS system. When you select this function, a new window will be opened on the operator's console and whatever you type will be visible there. If the operator is present, and types something in return, it will be sent back to you. When you wish to terminate the session, type the @{"escape",link AmigaNOS_Escape} character on your keyboard, and then press <ENTER> or <RETURN>. The default @{"escape",link AmigaNOS_Escape} character is "CTRL-X", which means to hold down the <CTRL> key and press the <X> key simultaneously. This @{"escape",link AmigaNOS_Escape} character may be changed to whatever you prefer by using the "E[scape]" command. EXAMPLES page p pagesys @EndNode @Node AmigaNOSMBOX_Ports ports Display the available ports on the system along @EndNode @Node AmigaNOSMBOX_Read USAGE R[ead] <msg_number> [<msg_number> . . .] <msg_number> <ENTER> DESCRIPTION Each of these @{"commands",link AmigaNOSMain_Index} allows you to read a message (or messages) from the current mail area. 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> key. This will display the next message in order. The "read" command displays only an abbreviated portion of the mail headers. If you want all the header lines displayed, use the V[erbose] command instead. EXAMPLES read 3 5 (Display only messages 3 and 5) 4 (Display message 4) @EndNode @Node AmigaNOSMBOX_Retrieve USAGE retrieve <file_name> DESCRIPTION The retrieve command allows you to extract a file from within a system archive. EXAMPLES retrieve index (retrieves the INDEX of all files contained in the archive.) retrieve tcp.v90-023 (retrieves 'tcp.v90-023' from the archive.) retrieve pkt.v90-Index (retrieves 'pkt.v90-index' from the archive.) NOTE When a file is requested, the local cache directory is checked first to see if the file has been requested recently, if so it is sent from there. If the file is not in the local cache directory, an AmigaDOS command is issued to de-archive the file and place it in the local cache directory as well as sending the file out. The cache directory will be cleaned out at regular intervals as new files are added to the archive. Also, this command is unique to AmigaNOS v2.8 @EndNode @Node AmigaNOSMBOX_Send USAGE S[end] <user>[ @ <host>] [< <from_addr>] [$<bulletin_id>] SR [msg_number] SF <user>[ @ <host>] [< <from_addr>] [$<bulletin_id>] DESCRIPTION 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 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. EXAMPLES send g1yyh (Send a message to the local user, g1yyh) s g1yyh @ gb7crg (Send a message to g1yyh at the gb7crg host) sr 3 (Reply to message number 3) sf g7aaa%g7bbb@gb7ccc (Forward current msg to g7aaa at g7bbb via gb7ccc) @EndNode @Node AmigaNOSMBOX_SignOn * North West Packet User Group * * * * Annual General Meeting * * Grappenhall Community Centre * * Grappenhall, Warrington * * * * Sunday 23rd February 1992 * * 19:30 Hrs (7.30pm) * ******************************** @EndNode @Node AmigaNOSMBOX_Telnet USAGE T[elnet] <hostname> [<port_number>] DESCRIPTION The @{"telnet",link AmigaNOS_Telnet} command allows you to initiate a @{"TCP",link AmigaNOS_Tcp} connection from the NOS @{"mailbox",link AmigaNOSMBox_Index} 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",link AmigaNOS_Tcp} server at the given host. The default is to be connected to the "telnet" server, which in the case of NOS software, is the MBOX. To quit the session at any time, enter the @{"escape",link AmigaNOS_Escape} character (<CTRL>X by default, can be changed with the E[scape] command). EXAMPLES @{"telnet",link AmigaNOS_Telnet} g1yyh (Connect to g1yyh, (MBOX if NOS) ) t g1yyh 25 (Connect to the @{"SMTP",link AmigaNOS_Smtp} mail server at g1yyh) @EndNode @Node AmigaNOSMBOX_Upload USAGE U[pload] [/][<path_name>/]<filename> DESCRIPTION The @{"upload",link AmigaNOS_Upload} command allows you to 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 thing on a blank line. EXAMPLES @{"upload",link AmigaNOS_Upload} kepler.txt u /pub/satelite/oscar13.txt @EndNode @Node AmigaNOSMBOX_Verbose USAGE V[erbose] <msg_number> [<msg_number> . . .] DESCRIPTION This command allows you to read a message (or messages) from the current mail area, and it includes all the header lines for display. To view a specific message with all headers, type "verbose #", where the "#" is the number of the message to be displayed. (The R[ead] command operates the same way, but with abbreviated header lines). If there is a specific list of messages you are interested in, you can enter the list of message numbers (separated by spaces) on the "verbose" command-line. EXAMPLES verbose 3 5 (Display only messages 3 and 5 with full headers) @EndNode @Node AmigaNOSMBOX_What USAGE W[hat] [/][<path_name>] DESCRIPTION The what command generates a sorted directory listing of the current directory or the one specified by the optional path_name. Directory "TCPIP:PUBLIC" on Saturday 18-May-91 AMIGA Dir ----rwed Yesterday 20:16:11 IBM Dir ----rwed Tuesday 07:44:44 INDEX.txt 909 ----rwed Yesterday 20:16:52 ODDS-ENDS Dir ----rwed 03-May-91 11:51:23 1 files - 3 directories - 6 blocks - 909 bytes EXAMPLES what (Displays a directory listing of the "current" dir) w ibm (Display a list of files contained in the "ibm" dir) w "* quick" (Displays the filename only in the current directory) @EndNode @Node AmigaNOSMBOX_Zap USAGE Z[ap] [/][<path_name>/]<filename> DESCRIPTION The zap command allows you to delete a file in the current directory of one you specify with the optional path_name. Use of this command requires that permission be granted by the operator of this system. (Which you won't get!!) EXAMPLES zap myfile.txt (Deletes myfile.txt in the current dir) z nos/mydir/myfile.txt (Deletes myfile.txt in /nos/mydir) @EndNode .