Home » Recent acquisitions » Acorn ADFS disks » adfs_AcornUser_199508.adf » !Internet » StarterPak/!Newsbase/Docs/Transports
StarterPak/!Newsbase/Docs/Transports
This website contains an archive of files for the Acorn Electron, BBC Micro, Acorn Archimedes, Commodore 16 and Commodore 64 computers, which Dominic Ford has rescued from his private collection of floppy disks and cassettes.
Some of these files were originally commercial releases in the 1980s and 1990s, but they are now widely available online. I assume that copyright over them is no longer being asserted. If you own the copyright and would like files to be removed, please contact me.
| Tape/disk: | Home » Recent acquisitions » Acorn ADFS disks » adfs_AcornUser_199508.adf » !Internet |
| Filename: | StarterPak/!Newsbase/Docs/Transports |
| Read OK: | ✔ |
| File size: | 2A68 bytes |
| Load address: | 0000 |
| Exec address: | 0000 |
File contents
This file explains how network transports interface to the main Newsbase application. note: some large changes took place during development of Newsbase 0.52, and much of the following applies more specifically to 0.51. However, the general behaviour is the same. The definitive example is the transport supplied for ka9q. Unfortunately this is poorly documented and rather messy in places! Transports are held in a directory !NewsBase,transports.<transport-name>. This should contain all the programs and other files which Newsbase expects to call or otherwise use. Support files may optionally be kept in the directory !Newsbase.support.<transport-name>. Configuration information may be kept within !NewsDir, in <NewsBase$Config>.<transport-name>. The !Newsbase application itself should be treated as read-only, and not used to store status or config data. Transport programs return results to Newsbase using two system variables, the numeric <NewsBase$ReturnCode>, which should be zero for success, and <NewsBase$ReturnInfo>, which can contain an informative message detailing success or reason for failure. Startup ------- When Newsbase itself starts up, it attempts to execute the transport program "detect", for each transport it finds. This should return zero if the given transport application is present on the system. For example, ka9q 'detect' returns 0 if <TCPIP$Dir> is defined. When Newsbase starts a transport up, it executes "startup". Again, this can return success or failure. For ka9q, this function updates the Newsbase active groups file by calling "mkgroups" (see later). Transport setup --------------- Newsbase attempts to find information about the transport setup automatically. The local hostname is deduced by executing "sethost". The hostname should be returned in <NewsBase$ReturnInfo>. Similarly, a remote hostname is obtained from "setremote". ka9q obtains these values from the !TCPIP startup files. The use of a remote hostname varies from transport to transport - ka9q obtains the name of the smtp gateway, if defined. The transport control panel in Newsbase has a button "Setup". If clicked, a program called "setup" is run. This can be used to perform any setup operations on the transport itself. Newsgroups ---------- Newsbase requires a list of active groups. This list defines which groups are wanted in the news database, so that newsbase can debatch only to those, and discard others. The list should be held in the file <Newsbase$Config>.transport-name.groups (for example, "<Newsbase$Config>.ka9q.groups"). Previous versions of Newsbase held this file in <Newsbase$Data>.groups, and if no file is found in the transport-specific config directory, Newsbase will look here. However, the new location permits each transport to keep its own private list without interference (for example, when switching between transports), so is to be preferred. The file consists of a single group per line. The last character can be a "*" to act as a wildcard, and the first can be a "!" to negate a group pattern. Newsbase forces an update of this file by executing "mkgroups". For ka9q, this performs the following actions: First, it compares the timestamps of the groups file with the !TCPIP xxxGroup (eg DemGroup) files, to see if an update is necessary. If so, it then reads the contents of all xxxGroup files, and writes one group per line to <Newsbase$Config>.ka9q.groups. Newsbase adds groups to the newsfeed by executing "addgroup". What this actually does depends on the transport, ka9q adds the group to the largest xxxGroup file it finds in <NNTP$Dir>. Groups are deleted similarly by calling "delgroup". After adding or deleting a group, newsbase calls "mkgroup" to update the active list "groups" file. [this following paragraph applied to the old storage location for the "groups" file - I'm not sure if it still applies now that each transport has its own place to store the file] Transports such as uucp, which are not able to locally modify their newsfeed, should maintain a "dummy" file equivalent to the ka9q xxxGroup file. "mkgroups" should then update the active list "groups" file from this dummy file. The ka9q addgroup/delgroup programs can easily be modified to suit this purpose (store the dummy file in <NewsBase$Config> somewhere). The reason for maintaining a dummy list is that the user may switch transports, either by intent or by mistake. This action would alter any data kept in the "groups" file. The dummy file allows "groups" to be recovered to its original state upon return to the uucp (or other) transport. Users ----- When usernames are added and deleted, Newsbase executes either "adduser" or "deluser". For ka9q, this does nothing. The number provided is the "group number" defined in the User setup window. Another program is called: "moduser", when a user is altered within Newsbase. Posting news, sending mail -------------------------- Newsbase calls either "sendnews" or "sendmail". These should return either success or failure, and delete their temporary input file if sending is successful. The username parameter, if specified, will generally be derived from the "From:" header line - if a transport knows better than this, it is free to ignore this information. If not enough memory is available to run "sendmail" or "sendnews", the outgoing mail or news is queued within !NewsDir and sent when memory becomes available. In this situation, a report of failure to send may not be returned to the sending application, as an unknown amount of time may have passed (the sending application may not even still be running). Debatching ---------- Newsbase examines the files specified in "infiles" for debatch candidates. See the ka9q "infiles" for an example of patterns which may be specified. If "infiles" is empty, Newsbase will instead attempt to execute "getfiles", which can provide a more flexible transport-specific method of obtaining newly-arrived files. Files to be debatched should be placed by "getfiles" in the newsbase work directory, <NewsBase$Data>.Work. When a debatch candidate file is found, Newsbase attempts to execute "prefetch". This is not used by ka9q, but can permit preprocessing of a file before Newsbase tries to debatch it. This might be useful, for example, to preprocess uqwk batch files for use by newsbase. After a debatch completes, Newsbase calls "postfetch". This is intended to provide a means for clean-up. For ka9q, this command trims old entries from the nntp history files, and transfers newgroup information to the Newsbase newgroups file. New groups ---------- No specific command is called for this; the ka9q transport performs this during the "postfetch" command. Newly-created groups are appended to the file <NewsBase$Data>.newgroups. Each line should consist of a groupname, or a time marker. A time marker line is of the form "# YYMMDD HHMMSS". ka9q obtains the list of new groups from the !TCPIP xxxNG files. Transport status ---------------- Newsbase may call the command "status" to determine transport status. This returns zero if the transport is inactive. The ka9q transport returns 1 to inhibit news expiry while !TCPIP is online. Batch files ----------- Newsbase follows these rules when debatching files. Firstly, the batch type is determined from the first line. A valid batch separator should be found, one of: #! rnews <bytes> -> news batch From (with trailing space) -> mail ^A (control-A) -> mail #! rmail <bytes> -> mail If a valid separator is not found, newsbase will continue through the file until it can determine whether it is news or mail, complain about the batch being nonstandard, "rewind" to the start, and debatch it. News batches are debatched to the groups specified in each article's Newsgroups header line, subject to the restrictions of the Active list. For mail batches, the filename is assumed to be the username. This is due to the impossibility of extracting reliable information from a "To:" header. If your transport does not provide files following this convention, a "prefetch" preprocessing step will be required. Summary of transport-specific files ----------------------------------- In Newsbase 0.52, all transport functions are defined in a single file, "params", which contains a list of tags and values as follows: in <filespec> equiv. of 'infiles' out <filespec> equiv. of 'outfiles' dir <directoryname> dir to be created for transport at startup info <description> information line defmem <memory> default memorysize for transport programs (Kb) The transport programs are also defined in this file. These definitions take the form: <command-name> <memory> <program+parameters> For example, sendmail 64 sendmail -f %f -u %u means, to send mail, call the command "sendmail -f <file> -u <user>", requiring at least 64k of memory. The default commands are: sendmail 0 sendmail -f %f -u %u sendnews 0 sendnews -f %f -u %u showqueue 0 showqueue prefetch 0 prefetch -f %f postfetch 0 postfetch adduser 0 adduser -u %u -g %n deluser 0 deluser -u %u moduser 0 moduser -u %u -g %n addgroup 0 addgroup -g %g delgroup 0 delgroup -g %g gethost 0 sethost getremote 0 setremote getinfiles 0 getinfiles mkgroups 0 mkgroups status 0 status startup 0 startup setup 0 setup detect 0 detect Normally, commands are executed from the directory !Newsbase.transports.<transport-name>, as in 0.51 and earlier. However, if the first character of the command is "*", is is simply passed to the CLI (well... Wimp_StartTask, really) so may be an OS or library command. A memorysize of 0 means, use the default value (32k if not specified earlier in file). and available parameter substitutions are: %h hostname %m mailname %r remote hostname %f filename (with sendmail, sendnews, prefetch) %u username (with sendmail, sendnews, adduser, deluser, moduser) %n user groupnumber (with adduser, moduser) %g groupname (with addgroup, delgroup) %% % For normal commands, Newsbase attempts to run all programs from the directory within newsbase (!Newsbase.transports.<transportname>"). If the command name is prefixed with a "*", the command will be run using no predefined search path, so can consist of an OS command or library program. For all the non-trivial transport programs, on exit, <NewsBase$ReturnCode> should be zero for success. <NewsBase$ReturnInfo> can contain an informative message detailing success or reason for failure. Transport deletion. ------------------- The transports control panel within Newsbase permits unwanted transports to be deleted from the application. This simply wipes the transport and support directories for that transport.
00000000 54 68 69 73 20 66 69 6c 65 20 65 78 70 6c 61 69 |This file explai| 00000010 6e 73 20 68 6f 77 20 6e 65 74 77 6f 72 6b 20 74 |ns how network t| 00000020 72 61 6e 73 70 6f 72 74 73 20 69 6e 74 65 72 66 |ransports interf| 00000030 61 63 65 20 74 6f 20 74 68 65 20 6d 61 69 6e 20 |ace to the main | 00000040 4e 65 77 73 62 61 73 65 0a 61 70 70 6c 69 63 61 |Newsbase.applica| 00000050 74 69 6f 6e 2e 0a 0a 6e 6f 74 65 3a 20 73 6f 6d |tion...note: som| 00000060 65 20 6c 61 72 67 65 20 63 68 61 6e 67 65 73 20 |e large changes | 00000070 74 6f 6f 6b 20 70 6c 61 63 65 20 64 75 72 69 6e |took place durin| 00000080 67 20 64 65 76 65 6c 6f 70 6d 65 6e 74 20 6f 66 |g development of| 00000090 20 4e 65 77 73 62 61 73 65 20 30 2e 35 32 2c 20 | Newsbase 0.52, | 000000a0 61 6e 64 0a 6d 75 63 68 20 6f 66 20 74 68 65 20 |and.much of the | 000000b0 66 6f 6c 6c 6f 77 69 6e 67 20 61 70 70 6c 69 65 |following applie| 000000c0 73 20 6d 6f 72 65 20 73 70 65 63 69 66 69 63 61 |s more specifica| 000000d0 6c 6c 79 20 74 6f 20 30 2e 35 31 2e 20 48 6f 77 |lly to 0.51. How| 000000e0 65 76 65 72 2c 20 74 68 65 0a 67 65 6e 65 72 61 |ever, the.genera| 000000f0 6c 20 62 65 68 61 76 69 6f 75 72 20 69 73 20 74 |l behaviour is t| 00000100 68 65 20 73 61 6d 65 2e 0a 0a 54 68 65 20 64 65 |he same...The de| 00000110 66 69 6e 69 74 69 76 65 20 65 78 61 6d 70 6c 65 |finitive example| 00000120 20 69 73 20 74 68 65 20 74 72 61 6e 73 70 6f 72 | is the transpor| 00000130 74 20 73 75 70 70 6c 69 65 64 20 66 6f 72 20 6b |t supplied for k| 00000140 61 39 71 2e 20 55 6e 66 6f 72 74 75 6e 61 74 65 |a9q. Unfortunate| 00000150 6c 79 0a 74 68 69 73 20 69 73 20 70 6f 6f 72 6c |ly.this is poorl| 00000160 79 20 64 6f 63 75 6d 65 6e 74 65 64 20 61 6e 64 |y documented and| 00000170 20 72 61 74 68 65 72 20 6d 65 73 73 79 20 69 6e | rather messy in| 00000180 20 70 6c 61 63 65 73 21 0a 0a 54 72 61 6e 73 70 | places!..Transp| 00000190 6f 72 74 73 20 61 72 65 20 68 65 6c 64 20 69 6e |orts are held in| 000001a0 20 61 20 64 69 72 65 63 74 6f 72 79 20 21 4e 65 | a directory !Ne| 000001b0 77 73 42 61 73 65 2c 74 72 61 6e 73 70 6f 72 74 |wsBase,transport| 000001c0 73 2e 3c 74 72 61 6e 73 70 6f 72 74 2d 6e 61 6d |s.<transport-nam| 000001d0 65 3e 2e 0a 54 68 69 73 20 73 68 6f 75 6c 64 20 |e>..This should | 000001e0 63 6f 6e 74 61 69 6e 20 61 6c 6c 20 74 68 65 20 |contain all the | 000001f0 70 72 6f 67 72 61 6d 73 20 61 6e 64 20 6f 74 68 |programs and oth| 00000200 65 72 20 66 69 6c 65 73 20 77 68 69 63 68 20 4e |er files which N| 00000210 65 77 73 62 61 73 65 0a 65 78 70 65 63 74 73 20 |ewsbase.expects | 00000220 74 6f 20 63 61 6c 6c 20 6f 72 20 6f 74 68 65 72 |to call or other| 00000230 77 69 73 65 20 75 73 65 2e 0a 0a 53 75 70 70 6f |wise use...Suppo| 00000240 72 74 20 66 69 6c 65 73 20 6d 61 79 20 6f 70 74 |rt files may opt| 00000250 69 6f 6e 61 6c 6c 79 20 62 65 20 6b 65 70 74 20 |ionally be kept | 00000260 69 6e 20 74 68 65 20 64 69 72 65 63 74 6f 72 79 |in the directory| 00000270 0a 21 4e 65 77 73 62 61 73 65 2e 73 75 70 70 6f |.!Newsbase.suppo| 00000280 72 74 2e 3c 74 72 61 6e 73 70 6f 72 74 2d 6e 61 |rt.<transport-na| 00000290 6d 65 3e 2e 20 43 6f 6e 66 69 67 75 72 61 74 69 |me>. Configurati| 000002a0 6f 6e 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 6d |on information m| 000002b0 61 79 20 62 65 20 6b 65 70 74 0a 77 69 74 68 69 |ay be kept.withi| 000002c0 6e 20 21 4e 65 77 73 44 69 72 2c 20 69 6e 20 3c |n !NewsDir, in <| 000002d0 4e 65 77 73 42 61 73 65 24 43 6f 6e 66 69 67 3e |NewsBase$Config>| 000002e0 2e 3c 74 72 61 6e 73 70 6f 72 74 2d 6e 61 6d 65 |.<transport-name| 000002f0 3e 2e 20 54 68 65 20 21 4e 65 77 73 62 61 73 65 |>. The !Newsbase| 00000300 0a 61 70 70 6c 69 63 61 74 69 6f 6e 20 69 74 73 |.application its| 00000310 65 6c 66 20 73 68 6f 75 6c 64 20 62 65 20 74 72 |elf should be tr| 00000320 65 61 74 65 64 20 61 73 20 72 65 61 64 2d 6f 6e |eated as read-on| 00000330 6c 79 2c 20 61 6e 64 20 6e 6f 74 20 75 73 65 64 |ly, and not used| 00000340 20 74 6f 20 73 74 6f 72 65 0a 73 74 61 74 75 73 | to store.status| 00000350 20 6f 72 20 63 6f 6e 66 69 67 20 64 61 74 61 2e | or config data.| 00000360 0a 0a 54 72 61 6e 73 70 6f 72 74 20 70 72 6f 67 |..Transport prog| 00000370 72 61 6d 73 20 72 65 74 75 72 6e 20 72 65 73 75 |rams return resu| 00000380 6c 74 73 20 74 6f 20 4e 65 77 73 62 61 73 65 20 |lts to Newsbase | 00000390 75 73 69 6e 67 20 74 77 6f 20 73 79 73 74 65 6d |using two system| 000003a0 20 76 61 72 69 61 62 6c 65 73 2c 0a 74 68 65 20 | variables,.the | 000003b0 6e 75 6d 65 72 69 63 20 3c 4e 65 77 73 42 61 73 |numeric <NewsBas| 000003c0 65 24 52 65 74 75 72 6e 43 6f 64 65 3e 2c 20 77 |e$ReturnCode>, w| 000003d0 68 69 63 68 20 73 68 6f 75 6c 64 20 62 65 20 7a |hich should be z| 000003e0 65 72 6f 20 66 6f 72 20 73 75 63 63 65 73 73 2c |ero for success,| 000003f0 20 61 6e 64 0a 3c 4e 65 77 73 42 61 73 65 24 52 | and.<NewsBase$R| 00000400 65 74 75 72 6e 49 6e 66 6f 3e 2c 20 77 68 69 63 |eturnInfo>, whic| 00000410 68 20 63 61 6e 20 63 6f 6e 74 61 69 6e 20 61 6e |h can contain an| 00000420 20 69 6e 66 6f 72 6d 61 74 69 76 65 20 6d 65 73 | informative mes| 00000430 73 61 67 65 20 64 65 74 61 69 6c 69 6e 67 0a 73 |sage detailing.s| 00000440 75 63 63 65 73 73 20 6f 72 20 72 65 61 73 6f 6e |uccess or reason| 00000450 20 66 6f 72 20 66 61 69 6c 75 72 65 2e 0a 0a 53 | for failure...S| 00000460 74 61 72 74 75 70 0a 2d 2d 2d 2d 2d 2d 2d 0a 0a |tartup.-------..| 00000470 57 68 65 6e 20 4e 65 77 73 62 61 73 65 20 69 74 |When Newsbase it| 00000480 73 65 6c 66 20 73 74 61 72 74 73 20 75 70 2c 20 |self starts up, | 00000490 69 74 20 61 74 74 65 6d 70 74 73 20 74 6f 20 65 |it attempts to e| 000004a0 78 65 63 75 74 65 20 74 68 65 20 74 72 61 6e 73 |xecute the trans| 000004b0 70 6f 72 74 20 70 72 6f 67 72 61 6d 0a 22 64 65 |port program."de| 000004c0 74 65 63 74 22 2c 20 66 6f 72 20 65 61 63 68 20 |tect", for each | 000004d0 74 72 61 6e 73 70 6f 72 74 20 69 74 20 66 69 6e |transport it fin| 000004e0 64 73 2e 20 54 68 69 73 20 73 68 6f 75 6c 64 20 |ds. This should | 000004f0 72 65 74 75 72 6e 20 7a 65 72 6f 20 69 66 20 74 |return zero if t| 00000500 68 65 20 67 69 76 65 6e 0a 74 72 61 6e 73 70 6f |he given.transpo| 00000510 72 74 20 61 70 70 6c 69 63 61 74 69 6f 6e 20 69 |rt application i| 00000520 73 20 70 72 65 73 65 6e 74 20 6f 6e 20 74 68 65 |s present on the| 00000530 20 73 79 73 74 65 6d 2e 20 46 6f 72 20 65 78 61 | system. For exa| 00000540 6d 70 6c 65 2c 20 6b 61 39 71 20 27 64 65 74 65 |mple, ka9q 'dete| 00000550 63 74 27 0a 72 65 74 75 72 6e 73 20 30 20 69 66 |ct'.returns 0 if| 00000560 20 3c 54 43 50 49 50 24 44 69 72 3e 20 69 73 20 | <TCPIP$Dir> is | 00000570 64 65 66 69 6e 65 64 2e 0a 0a 57 68 65 6e 20 4e |defined...When N| 00000580 65 77 73 62 61 73 65 20 73 74 61 72 74 73 20 61 |ewsbase starts a| 00000590 20 74 72 61 6e 73 70 6f 72 74 20 75 70 2c 20 69 | transport up, i| 000005a0 74 20 65 78 65 63 75 74 65 73 20 22 73 74 61 72 |t executes "star| 000005b0 74 75 70 22 2e 20 41 67 61 69 6e 2c 20 74 68 69 |tup". Again, thi| 000005c0 73 0a 63 61 6e 20 72 65 74 75 72 6e 20 73 75 63 |s.can return suc| 000005d0 63 65 73 73 20 6f 72 20 66 61 69 6c 75 72 65 2e |cess or failure.| 000005e0 20 46 6f 72 20 6b 61 39 71 2c 20 74 68 69 73 20 | For ka9q, this | 000005f0 66 75 6e 63 74 69 6f 6e 20 75 70 64 61 74 65 73 |function updates| 00000600 20 74 68 65 0a 4e 65 77 73 62 61 73 65 20 61 63 | the.Newsbase ac| 00000610 74 69 76 65 20 67 72 6f 75 70 73 20 66 69 6c 65 |tive groups file| 00000620 20 62 79 20 63 61 6c 6c 69 6e 67 20 22 6d 6b 67 | by calling "mkg| 00000630 72 6f 75 70 73 22 20 28 73 65 65 20 6c 61 74 65 |roups" (see late| 00000640 72 29 2e 0a 0a 54 72 61 6e 73 70 6f 72 74 20 73 |r)...Transport s| 00000650 65 74 75 70 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |etup.-----------| 00000660 2d 2d 2d 2d 0a 0a 4e 65 77 73 62 61 73 65 20 61 |----..Newsbase a| 00000670 74 74 65 6d 70 74 73 20 74 6f 20 66 69 6e 64 20 |ttempts to find | 00000680 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f 75 |information abou| 00000690 74 20 74 68 65 20 74 72 61 6e 73 70 6f 72 74 20 |t the transport | 000006a0 73 65 74 75 70 0a 61 75 74 6f 6d 61 74 69 63 61 |setup.automatica| 000006b0 6c 6c 79 2e 20 54 68 65 20 6c 6f 63 61 6c 20 68 |lly. The local h| 000006c0 6f 73 74 6e 61 6d 65 20 69 73 20 64 65 64 75 63 |ostname is deduc| 000006d0 65 64 20 62 79 20 65 78 65 63 75 74 69 6e 67 20 |ed by executing | 000006e0 22 73 65 74 68 6f 73 74 22 2e 20 54 68 65 0a 68 |"sethost". The.h| 000006f0 6f 73 74 6e 61 6d 65 20 73 68 6f 75 6c 64 20 62 |ostname should b| 00000700 65 20 72 65 74 75 72 6e 65 64 20 69 6e 20 3c 4e |e returned in <N| 00000710 65 77 73 42 61 73 65 24 52 65 74 75 72 6e 49 6e |ewsBase$ReturnIn| 00000720 66 6f 3e 2e 20 53 69 6d 69 6c 61 72 6c 79 2c 20 |fo>. Similarly, | 00000730 61 20 72 65 6d 6f 74 65 0a 68 6f 73 74 6e 61 6d |a remote.hostnam| 00000740 65 20 69 73 20 6f 62 74 61 69 6e 65 64 20 66 72 |e is obtained fr| 00000750 6f 6d 20 22 73 65 74 72 65 6d 6f 74 65 22 2e 0a |om "setremote"..| 00000760 0a 6b 61 39 71 20 6f 62 74 61 69 6e 73 20 74 68 |.ka9q obtains th| 00000770 65 73 65 20 76 61 6c 75 65 73 20 66 72 6f 6d 20 |ese values from | 00000780 74 68 65 20 21 54 43 50 49 50 20 73 74 61 72 74 |the !TCPIP start| 00000790 75 70 20 66 69 6c 65 73 2e 20 54 68 65 20 75 73 |up files. The us| 000007a0 65 20 6f 66 20 61 0a 72 65 6d 6f 74 65 20 68 6f |e of a.remote ho| 000007b0 73 74 6e 61 6d 65 20 76 61 72 69 65 73 20 66 72 |stname varies fr| 000007c0 6f 6d 20 74 72 61 6e 73 70 6f 72 74 20 74 6f 20 |om transport to | 000007d0 74 72 61 6e 73 70 6f 72 74 20 2d 20 6b 61 39 71 |transport - ka9q| 000007e0 20 6f 62 74 61 69 6e 73 20 74 68 65 20 6e 61 6d | obtains the nam| 000007f0 65 0a 6f 66 20 74 68 65 20 73 6d 74 70 20 67 61 |e.of the smtp ga| 00000800 74 65 77 61 79 2c 20 69 66 20 64 65 66 69 6e 65 |teway, if define| 00000810 64 2e 0a 0a 54 68 65 20 74 72 61 6e 73 70 6f 72 |d...The transpor| 00000820 74 20 63 6f 6e 74 72 6f 6c 20 70 61 6e 65 6c 20 |t control panel | 00000830 69 6e 20 4e 65 77 73 62 61 73 65 20 68 61 73 20 |in Newsbase has | 00000840 61 20 62 75 74 74 6f 6e 20 22 53 65 74 75 70 22 |a button "Setup"| 00000850 2e 20 49 66 20 63 6c 69 63 6b 65 64 2c 0a 61 20 |. If clicked,.a | 00000860 70 72 6f 67 72 61 6d 20 63 61 6c 6c 65 64 20 22 |program called "| 00000870 73 65 74 75 70 22 20 69 73 20 72 75 6e 2e 20 54 |setup" is run. T| 00000880 68 69 73 20 63 61 6e 20 62 65 20 75 73 65 64 20 |his can be used | 00000890 74 6f 20 70 65 72 66 6f 72 6d 20 61 6e 79 20 73 |to perform any s| 000008a0 65 74 75 70 0a 6f 70 65 72 61 74 69 6f 6e 73 20 |etup.operations | 000008b0 6f 6e 20 74 68 65 20 74 72 61 6e 73 70 6f 72 74 |on the transport| 000008c0 20 69 74 73 65 6c 66 2e 0a 0a 4e 65 77 73 67 72 | itself...Newsgr| 000008d0 6f 75 70 73 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a |oups.----------.| 000008e0 0a 4e 65 77 73 62 61 73 65 20 72 65 71 75 69 72 |.Newsbase requir| 000008f0 65 73 20 61 20 6c 69 73 74 20 6f 66 20 61 63 74 |es a list of act| 00000900 69 76 65 20 67 72 6f 75 70 73 2e 20 54 68 69 73 |ive groups. This| 00000910 20 6c 69 73 74 20 64 65 66 69 6e 65 73 20 77 68 | list defines wh| 00000920 69 63 68 20 67 72 6f 75 70 73 0a 61 72 65 20 77 |ich groups.are w| 00000930 61 6e 74 65 64 20 69 6e 20 74 68 65 20 6e 65 77 |anted in the new| 00000940 73 20 64 61 74 61 62 61 73 65 2c 20 73 6f 20 74 |s database, so t| 00000950 68 61 74 20 6e 65 77 73 62 61 73 65 20 63 61 6e |hat newsbase can| 00000960 20 64 65 62 61 74 63 68 20 6f 6e 6c 79 20 74 6f | debatch only to| 00000970 20 74 68 6f 73 65 2c 0a 61 6e 64 20 64 69 73 63 | those,.and disc| 00000980 61 72 64 20 6f 74 68 65 72 73 2e 20 54 68 65 20 |ard others. The | 00000990 6c 69 73 74 20 73 68 6f 75 6c 64 20 62 65 20 68 |list should be h| 000009a0 65 6c 64 20 69 6e 20 74 68 65 20 66 69 6c 65 0a |eld in the file.| 000009b0 3c 4e 65 77 73 62 61 73 65 24 43 6f 6e 66 69 67 |<Newsbase$Config| 000009c0 3e 2e 74 72 61 6e 73 70 6f 72 74 2d 6e 61 6d 65 |>.transport-name| 000009d0 2e 67 72 6f 75 70 73 20 28 66 6f 72 20 65 78 61 |.groups (for exa| 000009e0 6d 70 6c 65 2c 0a 22 3c 4e 65 77 73 62 61 73 65 |mple,."<Newsbase| 000009f0 24 43 6f 6e 66 69 67 3e 2e 6b 61 39 71 2e 67 72 |$Config>.ka9q.gr| 00000a00 6f 75 70 73 22 29 2e 20 50 72 65 76 69 6f 75 73 |oups"). Previous| 00000a10 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 4e 65 77 | versions of New| 00000a20 73 62 61 73 65 20 68 65 6c 64 20 74 68 69 73 0a |sbase held this.| 00000a30 66 69 6c 65 20 69 6e 20 3c 4e 65 77 73 62 61 73 |file in <Newsbas| 00000a40 65 24 44 61 74 61 3e 2e 67 72 6f 75 70 73 2c 20 |e$Data>.groups, | 00000a50 61 6e 64 20 69 66 20 6e 6f 20 66 69 6c 65 20 69 |and if no file i| 00000a60 73 20 66 6f 75 6e 64 20 69 6e 20 74 68 65 0a 74 |s found in the.t| 00000a70 72 61 6e 73 70 6f 72 74 2d 73 70 65 63 69 66 69 |ransport-specifi| 00000a80 63 20 63 6f 6e 66 69 67 20 64 69 72 65 63 74 6f |c config directo| 00000a90 72 79 2c 20 4e 65 77 73 62 61 73 65 20 77 69 6c |ry, Newsbase wil| 00000aa0 6c 20 6c 6f 6f 6b 20 68 65 72 65 2e 20 48 6f 77 |l look here. How| 00000ab0 65 76 65 72 2c 20 74 68 65 0a 6e 65 77 20 6c 6f |ever, the.new lo| 00000ac0 63 61 74 69 6f 6e 20 70 65 72 6d 69 74 73 20 65 |cation permits e| 00000ad0 61 63 68 20 74 72 61 6e 73 70 6f 72 74 20 74 6f |ach transport to| 00000ae0 20 6b 65 65 70 20 69 74 73 20 6f 77 6e 20 70 72 | keep its own pr| 00000af0 69 76 61 74 65 20 6c 69 73 74 20 77 69 74 68 6f |ivate list witho| 00000b00 75 74 0a 69 6e 74 65 72 66 65 72 65 6e 63 65 20 |ut.interference | 00000b10 28 66 6f 72 20 65 78 61 6d 70 6c 65 2c 20 77 68 |(for example, wh| 00000b20 65 6e 20 73 77 69 74 63 68 69 6e 67 20 62 65 74 |en switching bet| 00000b30 77 65 65 6e 20 74 72 61 6e 73 70 6f 72 74 73 29 |ween transports)| 00000b40 2c 20 73 6f 20 69 73 20 74 6f 20 62 65 0a 70 72 |, so is to be.pr| 00000b50 65 66 65 72 72 65 64 2e 20 54 68 65 20 66 69 6c |eferred. The fil| 00000b60 65 20 63 6f 6e 73 69 73 74 73 20 6f 66 20 61 20 |e consists of a | 00000b70 73 69 6e 67 6c 65 20 67 72 6f 75 70 20 70 65 72 |single group per| 00000b80 20 6c 69 6e 65 2e 20 54 68 65 20 6c 61 73 74 20 | line. The last | 00000b90 63 68 61 72 61 63 74 65 72 0a 63 61 6e 20 62 65 |character.can be| 00000ba0 20 61 20 22 2a 22 20 74 6f 20 61 63 74 20 61 73 | a "*" to act as| 00000bb0 20 61 20 77 69 6c 64 63 61 72 64 2c 20 61 6e 64 | a wildcard, and| 00000bc0 20 74 68 65 20 66 69 72 73 74 20 63 61 6e 20 62 | the first can b| 00000bd0 65 20 61 20 22 21 22 20 74 6f 20 6e 65 67 61 74 |e a "!" to negat| 00000be0 65 20 61 0a 67 72 6f 75 70 20 70 61 74 74 65 72 |e a.group patter| 00000bf0 6e 2e 0a 0a 4e 65 77 73 62 61 73 65 20 66 6f 72 |n...Newsbase for| 00000c00 63 65 73 20 61 6e 20 75 70 64 61 74 65 20 6f 66 |ces an update of| 00000c10 20 74 68 69 73 20 66 69 6c 65 20 62 79 20 65 78 | this file by ex| 00000c20 65 63 75 74 69 6e 67 20 22 6d 6b 67 72 6f 75 70 |ecuting "mkgroup| 00000c30 73 22 2e 20 46 6f 72 20 6b 61 39 71 2c 0a 74 68 |s". For ka9q,.th| 00000c40 69 73 20 70 65 72 66 6f 72 6d 73 20 74 68 65 20 |is performs the | 00000c50 66 6f 6c 6c 6f 77 69 6e 67 20 61 63 74 69 6f 6e |following action| 00000c60 73 3a 20 46 69 72 73 74 2c 20 69 74 20 63 6f 6d |s: First, it com| 00000c70 70 61 72 65 73 20 74 68 65 20 74 69 6d 65 73 74 |pares the timest| 00000c80 61 6d 70 73 20 6f 66 0a 74 68 65 20 67 72 6f 75 |amps of.the grou| 00000c90 70 73 20 66 69 6c 65 20 77 69 74 68 20 74 68 65 |ps file with the| 00000ca0 20 21 54 43 50 49 50 20 78 78 78 47 72 6f 75 70 | !TCPIP xxxGroup| 00000cb0 20 28 65 67 20 44 65 6d 47 72 6f 75 70 29 20 66 | (eg DemGroup) f| 00000cc0 69 6c 65 73 2c 20 74 6f 20 73 65 65 20 69 66 20 |iles, to see if | 00000cd0 61 6e 0a 75 70 64 61 74 65 20 69 73 20 6e 65 63 |an.update is nec| 00000ce0 65 73 73 61 72 79 2e 20 49 66 20 73 6f 2c 20 69 |essary. If so, i| 00000cf0 74 20 74 68 65 6e 20 72 65 61 64 73 20 74 68 65 |t then reads the| 00000d00 20 63 6f 6e 74 65 6e 74 73 20 6f 66 20 61 6c 6c | contents of all| 00000d10 20 78 78 78 47 72 6f 75 70 0a 66 69 6c 65 73 2c | xxxGroup.files,| 00000d20 20 61 6e 64 20 77 72 69 74 65 73 20 6f 6e 65 20 | and writes one | 00000d30 67 72 6f 75 70 20 70 65 72 20 6c 69 6e 65 20 74 |group per line t| 00000d40 6f 20 3c 4e 65 77 73 62 61 73 65 24 43 6f 6e 66 |o <Newsbase$Conf| 00000d50 69 67 3e 2e 6b 61 39 71 2e 67 72 6f 75 70 73 2e |ig>.ka9q.groups.| 00000d60 0a 0a 4e 65 77 73 62 61 73 65 20 61 64 64 73 20 |..Newsbase adds | 00000d70 67 72 6f 75 70 73 20 74 6f 20 74 68 65 20 6e 65 |groups to the ne| 00000d80 77 73 66 65 65 64 20 62 79 20 65 78 65 63 75 74 |wsfeed by execut| 00000d90 69 6e 67 20 22 61 64 64 67 72 6f 75 70 22 2e 20 |ing "addgroup". | 00000da0 57 68 61 74 20 74 68 69 73 0a 61 63 74 75 61 6c |What this.actual| 00000db0 6c 79 20 64 6f 65 73 20 64 65 70 65 6e 64 73 20 |ly does depends | 00000dc0 6f 6e 20 74 68 65 20 74 72 61 6e 73 70 6f 72 74 |on the transport| 00000dd0 2c 20 6b 61 39 71 20 61 64 64 73 20 74 68 65 20 |, ka9q adds the | 00000de0 67 72 6f 75 70 20 74 6f 20 74 68 65 20 6c 61 72 |group to the lar| 00000df0 67 65 73 74 0a 78 78 78 47 72 6f 75 70 20 66 69 |gest.xxxGroup fi| 00000e00 6c 65 20 69 74 20 66 69 6e 64 73 20 69 6e 20 3c |le it finds in <| 00000e10 4e 4e 54 50 24 44 69 72 3e 2e 0a 0a 47 72 6f 75 |NNTP$Dir>...Grou| 00000e20 70 73 20 61 72 65 20 64 65 6c 65 74 65 64 20 73 |ps are deleted s| 00000e30 69 6d 69 6c 61 72 6c 79 20 62 79 20 63 61 6c 6c |imilarly by call| 00000e40 69 6e 67 20 22 64 65 6c 67 72 6f 75 70 22 2e 0a |ing "delgroup"..| 00000e50 0a 41 66 74 65 72 20 61 64 64 69 6e 67 20 6f 72 |.After adding or| 00000e60 20 64 65 6c 65 74 69 6e 67 20 61 20 67 72 6f 75 | deleting a grou| 00000e70 70 2c 20 6e 65 77 73 62 61 73 65 20 63 61 6c 6c |p, newsbase call| 00000e80 73 20 22 6d 6b 67 72 6f 75 70 22 20 74 6f 20 75 |s "mkgroup" to u| 00000e90 70 64 61 74 65 20 74 68 65 0a 61 63 74 69 76 65 |pdate the.active| 00000ea0 20 6c 69 73 74 20 22 67 72 6f 75 70 73 22 20 66 | list "groups" f| 00000eb0 69 6c 65 2e 0a 0a 5b 74 68 69 73 20 66 6f 6c 6c |ile...[this foll| 00000ec0 6f 77 69 6e 67 20 70 61 72 61 67 72 61 70 68 20 |owing paragraph | 00000ed0 61 70 70 6c 69 65 64 20 74 6f 20 74 68 65 20 6f |applied to the o| 00000ee0 6c 64 20 73 74 6f 72 61 67 65 20 6c 6f 63 61 74 |ld storage locat| 00000ef0 69 6f 6e 20 66 6f 72 20 74 68 65 0a 22 67 72 6f |ion for the."gro| 00000f00 75 70 73 22 20 66 69 6c 65 20 2d 20 49 27 6d 20 |ups" file - I'm | 00000f10 6e 6f 74 20 73 75 72 65 20 69 66 20 69 74 20 73 |not sure if it s| 00000f20 74 69 6c 6c 20 61 70 70 6c 69 65 73 20 6e 6f 77 |till applies now| 00000f30 20 74 68 61 74 20 65 61 63 68 20 74 72 61 6e 73 | that each trans| 00000f40 70 6f 72 74 20 68 61 73 0a 69 74 73 20 6f 77 6e |port has.its own| 00000f50 20 70 6c 61 63 65 20 74 6f 20 73 74 6f 72 65 20 | place to store | 00000f60 74 68 65 20 66 69 6c 65 5d 20 54 72 61 6e 73 70 |the file] Transp| 00000f70 6f 72 74 73 20 73 75 63 68 20 61 73 20 75 75 63 |orts such as uuc| 00000f80 70 2c 20 77 68 69 63 68 20 61 72 65 20 6e 6f 74 |p, which are not| 00000f90 20 61 62 6c 65 0a 74 6f 20 6c 6f 63 61 6c 6c 79 | able.to locally| 00000fa0 20 6d 6f 64 69 66 79 20 74 68 65 69 72 20 6e 65 | modify their ne| 00000fb0 77 73 66 65 65 64 2c 20 73 68 6f 75 6c 64 20 6d |wsfeed, should m| 00000fc0 61 69 6e 74 61 69 6e 20 61 20 22 64 75 6d 6d 79 |aintain a "dummy| 00000fd0 22 20 66 69 6c 65 20 65 71 75 69 76 61 6c 65 6e |" file equivalen| 00000fe0 74 0a 74 6f 20 74 68 65 20 6b 61 39 71 20 78 78 |t.to the ka9q xx| 00000ff0 78 47 72 6f 75 70 20 66 69 6c 65 2e 20 22 6d 6b |xGroup file. "mk| 00001000 67 72 6f 75 70 73 22 20 73 68 6f 75 6c 64 20 74 |groups" should t| 00001010 68 65 6e 20 75 70 64 61 74 65 20 74 68 65 20 61 |hen update the a| 00001020 63 74 69 76 65 20 6c 69 73 74 0a 22 67 72 6f 75 |ctive list."grou| 00001030 70 73 22 20 66 69 6c 65 20 66 72 6f 6d 20 74 68 |ps" file from th| 00001040 69 73 20 64 75 6d 6d 79 20 66 69 6c 65 2e 20 54 |is dummy file. T| 00001050 68 65 20 6b 61 39 71 20 61 64 64 67 72 6f 75 70 |he ka9q addgroup| 00001060 2f 64 65 6c 67 72 6f 75 70 20 70 72 6f 67 72 61 |/delgroup progra| 00001070 6d 73 20 63 61 6e 0a 65 61 73 69 6c 79 20 62 65 |ms can.easily be| 00001080 20 6d 6f 64 69 66 69 65 64 20 74 6f 20 73 75 69 | modified to sui| 00001090 74 20 74 68 69 73 20 70 75 72 70 6f 73 65 20 28 |t this purpose (| 000010a0 73 74 6f 72 65 20 74 68 65 20 64 75 6d 6d 79 20 |store the dummy | 000010b0 66 69 6c 65 20 69 6e 0a 3c 4e 65 77 73 42 61 73 |file in.<NewsBas| 000010c0 65 24 43 6f 6e 66 69 67 3e 20 73 6f 6d 65 77 68 |e$Config> somewh| 000010d0 65 72 65 29 2e 20 54 68 65 20 72 65 61 73 6f 6e |ere). The reason| 000010e0 20 66 6f 72 20 6d 61 69 6e 74 61 69 6e 69 6e 67 | for maintaining| 000010f0 20 61 20 64 75 6d 6d 79 20 6c 69 73 74 20 69 73 | a dummy list is| 00001100 0a 74 68 61 74 20 74 68 65 20 75 73 65 72 20 6d |.that the user m| 00001110 61 79 20 73 77 69 74 63 68 20 74 72 61 6e 73 70 |ay switch transp| 00001120 6f 72 74 73 2c 20 65 69 74 68 65 72 20 62 79 20 |orts, either by | 00001130 69 6e 74 65 6e 74 20 6f 72 20 62 79 20 6d 69 73 |intent or by mis| 00001140 74 61 6b 65 2e 20 54 68 69 73 0a 61 63 74 69 6f |take. This.actio| 00001150 6e 20 77 6f 75 6c 64 20 61 6c 74 65 72 20 61 6e |n would alter an| 00001160 79 20 64 61 74 61 20 6b 65 70 74 20 69 6e 20 74 |y data kept in t| 00001170 68 65 20 22 67 72 6f 75 70 73 22 20 66 69 6c 65 |he "groups" file| 00001180 2e 20 54 68 65 20 64 75 6d 6d 79 20 66 69 6c 65 |. The dummy file| 00001190 20 61 6c 6c 6f 77 73 0a 22 67 72 6f 75 70 73 22 | allows."groups"| 000011a0 20 74 6f 20 62 65 20 72 65 63 6f 76 65 72 65 64 | to be recovered| 000011b0 20 74 6f 20 69 74 73 20 6f 72 69 67 69 6e 61 6c | to its original| 000011c0 20 73 74 61 74 65 20 75 70 6f 6e 20 72 65 74 75 | state upon retu| 000011d0 72 6e 20 74 6f 20 74 68 65 20 75 75 63 70 20 28 |rn to the uucp (| 000011e0 6f 72 0a 6f 74 68 65 72 29 20 74 72 61 6e 73 70 |or.other) transp| 000011f0 6f 72 74 2e 0a 0a 55 73 65 72 73 0a 2d 2d 2d 2d |ort...Users.----| 00001200 2d 0a 0a 57 68 65 6e 20 75 73 65 72 6e 61 6d 65 |-..When username| 00001210 73 20 61 72 65 20 61 64 64 65 64 20 61 6e 64 20 |s are added and | 00001220 64 65 6c 65 74 65 64 2c 20 4e 65 77 73 62 61 73 |deleted, Newsbas| 00001230 65 20 65 78 65 63 75 74 65 73 20 65 69 74 68 65 |e executes eithe| 00001240 72 20 22 61 64 64 75 73 65 72 22 20 6f 72 0a 22 |r "adduser" or."| 00001250 64 65 6c 75 73 65 72 22 2e 20 46 6f 72 20 6b 61 |deluser". For ka| 00001260 39 71 2c 20 74 68 69 73 20 64 6f 65 73 20 6e 6f |9q, this does no| 00001270 74 68 69 6e 67 2e 20 54 68 65 20 6e 75 6d 62 65 |thing. The numbe| 00001280 72 20 70 72 6f 76 69 64 65 64 20 69 73 20 74 68 |r provided is th| 00001290 65 20 22 67 72 6f 75 70 0a 6e 75 6d 62 65 72 22 |e "group.number"| 000012a0 20 64 65 66 69 6e 65 64 20 69 6e 20 74 68 65 20 | defined in the | 000012b0 55 73 65 72 20 73 65 74 75 70 20 77 69 6e 64 6f |User setup windo| 000012c0 77 2e 0a 0a 41 6e 6f 74 68 65 72 20 70 72 6f 67 |w...Another prog| 000012d0 72 61 6d 20 69 73 20 63 61 6c 6c 65 64 3a 20 22 |ram is called: "| 000012e0 6d 6f 64 75 73 65 72 22 2c 20 77 68 65 6e 20 61 |moduser", when a| 000012f0 20 75 73 65 72 20 69 73 20 61 6c 74 65 72 65 64 | user is altered| 00001300 20 77 69 74 68 69 6e 0a 4e 65 77 73 62 61 73 65 | within.Newsbase| 00001310 2e 0a 0a 50 6f 73 74 69 6e 67 20 6e 65 77 73 2c |...Posting news,| 00001320 20 73 65 6e 64 69 6e 67 20 6d 61 69 6c 0a 2d 2d | sending mail.--| 00001330 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| 00001340 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 4e 65 77 73 62 61 |--------..Newsba| 00001350 73 65 20 63 61 6c 6c 73 20 65 69 74 68 65 72 20 |se calls either | 00001360 22 73 65 6e 64 6e 65 77 73 22 20 6f 72 20 22 73 |"sendnews" or "s| 00001370 65 6e 64 6d 61 69 6c 22 2e 20 54 68 65 73 65 20 |endmail". These | 00001380 73 68 6f 75 6c 64 20 72 65 74 75 72 6e 20 65 69 |should return ei| 00001390 74 68 65 72 0a 73 75 63 63 65 73 73 20 6f 72 20 |ther.success or | 000013a0 66 61 69 6c 75 72 65 2c 20 61 6e 64 20 64 65 6c |failure, and del| 000013b0 65 74 65 20 74 68 65 69 72 20 74 65 6d 70 6f 72 |ete their tempor| 000013c0 61 72 79 20 69 6e 70 75 74 20 66 69 6c 65 20 69 |ary input file i| 000013d0 66 20 73 65 6e 64 69 6e 67 20 69 73 0a 73 75 63 |f sending is.suc| 000013e0 63 65 73 73 66 75 6c 2e 0a 0a 54 68 65 20 75 73 |cessful...The us| 000013f0 65 72 6e 61 6d 65 20 70 61 72 61 6d 65 74 65 72 |ername parameter| 00001400 2c 20 69 66 20 73 70 65 63 69 66 69 65 64 2c 20 |, if specified, | 00001410 77 69 6c 6c 20 67 65 6e 65 72 61 6c 6c 79 20 62 |will generally b| 00001420 65 20 64 65 72 69 76 65 64 20 66 72 6f 6d 20 74 |e derived from t| 00001430 68 65 0a 22 46 72 6f 6d 3a 22 20 68 65 61 64 65 |he."From:" heade| 00001440 72 20 6c 69 6e 65 20 2d 20 69 66 20 61 20 74 72 |r line - if a tr| 00001450 61 6e 73 70 6f 72 74 20 6b 6e 6f 77 73 20 62 65 |ansport knows be| 00001460 74 74 65 72 20 74 68 61 6e 20 74 68 69 73 2c 20 |tter than this, | 00001470 69 74 20 69 73 20 66 72 65 65 20 74 6f 0a 69 67 |it is free to.ig| 00001480 6e 6f 72 65 20 74 68 69 73 20 69 6e 66 6f 72 6d |nore this inform| 00001490 61 74 69 6f 6e 2e 0a 0a 49 66 20 6e 6f 74 20 65 |ation...If not e| 000014a0 6e 6f 75 67 68 20 6d 65 6d 6f 72 79 20 69 73 20 |nough memory is | 000014b0 61 76 61 69 6c 61 62 6c 65 20 74 6f 20 72 75 6e |available to run| 000014c0 20 22 73 65 6e 64 6d 61 69 6c 22 20 6f 72 20 22 | "sendmail" or "| 000014d0 73 65 6e 64 6e 65 77 73 22 2c 20 74 68 65 0a 6f |sendnews", the.o| 000014e0 75 74 67 6f 69 6e 67 20 6d 61 69 6c 20 6f 72 20 |utgoing mail or | 000014f0 6e 65 77 73 20 69 73 20 71 75 65 75 65 64 20 77 |news is queued w| 00001500 69 74 68 69 6e 20 21 4e 65 77 73 44 69 72 20 61 |ithin !NewsDir a| 00001510 6e 64 20 73 65 6e 74 20 77 68 65 6e 20 6d 65 6d |nd sent when mem| 00001520 6f 72 79 20 62 65 63 6f 6d 65 73 0a 61 76 61 69 |ory becomes.avai| 00001530 6c 61 62 6c 65 2e 20 49 6e 20 74 68 69 73 20 73 |lable. In this s| 00001540 69 74 75 61 74 69 6f 6e 2c 20 61 20 72 65 70 6f |ituation, a repo| 00001550 72 74 20 6f 66 20 66 61 69 6c 75 72 65 20 74 6f |rt of failure to| 00001560 20 73 65 6e 64 20 6d 61 79 20 6e 6f 74 20 62 65 | send may not be| 00001570 0a 72 65 74 75 72 6e 65 64 20 74 6f 20 74 68 65 |.returned to the| 00001580 20 73 65 6e 64 69 6e 67 20 61 70 70 6c 69 63 61 | sending applica| 00001590 74 69 6f 6e 2c 20 61 73 20 61 6e 20 75 6e 6b 6e |tion, as an unkn| 000015a0 6f 77 6e 20 61 6d 6f 75 6e 74 20 6f 66 20 74 69 |own amount of ti| 000015b0 6d 65 20 6d 61 79 20 68 61 76 65 0a 70 61 73 73 |me may have.pass| 000015c0 65 64 20 28 74 68 65 20 73 65 6e 64 69 6e 67 20 |ed (the sending | 000015d0 61 70 70 6c 69 63 61 74 69 6f 6e 20 6d 61 79 20 |application may | 000015e0 6e 6f 74 20 65 76 65 6e 20 73 74 69 6c 6c 20 62 |not even still b| 000015f0 65 20 72 75 6e 6e 69 6e 67 29 2e 0a 0a 44 65 62 |e running)...Deb| 00001600 61 74 63 68 69 6e 67 0a 2d 2d 2d 2d 2d 2d 2d 2d |atching.--------| 00001610 2d 2d 0a 0a 4e 65 77 73 62 61 73 65 20 65 78 61 |--..Newsbase exa| 00001620 6d 69 6e 65 73 20 74 68 65 20 66 69 6c 65 73 20 |mines the files | 00001630 73 70 65 63 69 66 69 65 64 20 69 6e 20 22 69 6e |specified in "in| 00001640 66 69 6c 65 73 22 20 66 6f 72 20 64 65 62 61 74 |files" for debat| 00001650 63 68 20 63 61 6e 64 69 64 61 74 65 73 2e 0a 53 |ch candidates..S| 00001660 65 65 20 74 68 65 20 6b 61 39 71 20 22 69 6e 66 |ee the ka9q "inf| 00001670 69 6c 65 73 22 20 66 6f 72 20 61 6e 20 65 78 61 |iles" for an exa| 00001680 6d 70 6c 65 20 6f 66 20 70 61 74 74 65 72 6e 73 |mple of patterns| 00001690 20 77 68 69 63 68 20 6d 61 79 20 62 65 20 73 70 | which may be sp| 000016a0 65 63 69 66 69 65 64 2e 20 0a 49 66 20 22 69 6e |ecified. .If "in| 000016b0 66 69 6c 65 73 22 20 69 73 20 65 6d 70 74 79 2c |files" is empty,| 000016c0 20 4e 65 77 73 62 61 73 65 20 77 69 6c 6c 20 69 | Newsbase will i| 000016d0 6e 73 74 65 61 64 20 61 74 74 65 6d 70 74 20 74 |nstead attempt t| 000016e0 6f 20 65 78 65 63 75 74 65 0a 22 67 65 74 66 69 |o execute."getfi| 000016f0 6c 65 73 22 2c 20 77 68 69 63 68 20 63 61 6e 20 |les", which can | 00001700 70 72 6f 76 69 64 65 20 61 20 6d 6f 72 65 20 66 |provide a more f| 00001710 6c 65 78 69 62 6c 65 20 74 72 61 6e 73 70 6f 72 |lexible transpor| 00001720 74 2d 73 70 65 63 69 66 69 63 20 6d 65 74 68 6f |t-specific metho| 00001730 64 20 6f 66 0a 6f 62 74 61 69 6e 69 6e 67 20 6e |d of.obtaining n| 00001740 65 77 6c 79 2d 61 72 72 69 76 65 64 20 66 69 6c |ewly-arrived fil| 00001750 65 73 2e 20 46 69 6c 65 73 20 74 6f 20 62 65 20 |es. Files to be | 00001760 64 65 62 61 74 63 68 65 64 20 73 68 6f 75 6c 64 |debatched should| 00001770 20 62 65 20 70 6c 61 63 65 64 20 62 79 0a 22 67 | be placed by."g| 00001780 65 74 66 69 6c 65 73 22 20 69 6e 20 74 68 65 20 |etfiles" in the | 00001790 6e 65 77 73 62 61 73 65 20 77 6f 72 6b 20 64 69 |newsbase work di| 000017a0 72 65 63 74 6f 72 79 2c 20 3c 4e 65 77 73 42 61 |rectory, <NewsBa| 000017b0 73 65 24 44 61 74 61 3e 2e 57 6f 72 6b 2e 0a 0a |se$Data>.Work...| 000017c0 57 68 65 6e 20 61 20 64 65 62 61 74 63 68 20 63 |When a debatch c| 000017d0 61 6e 64 69 64 61 74 65 20 66 69 6c 65 20 69 73 |andidate file is| 000017e0 20 66 6f 75 6e 64 2c 20 4e 65 77 73 62 61 73 65 | found, Newsbase| 000017f0 20 61 74 74 65 6d 70 74 73 20 74 6f 20 65 78 65 | attempts to exe| 00001800 63 75 74 65 0a 22 70 72 65 66 65 74 63 68 22 2e |cute."prefetch".| 00001810 20 54 68 69 73 20 69 73 20 6e 6f 74 20 75 73 65 | This is not use| 00001820 64 20 62 79 20 6b 61 39 71 2c 20 62 75 74 20 63 |d by ka9q, but c| 00001830 61 6e 20 70 65 72 6d 69 74 20 70 72 65 70 72 6f |an permit prepro| 00001840 63 65 73 73 69 6e 67 20 6f 66 20 61 20 66 69 6c |cessing of a fil| 00001850 65 0a 62 65 66 6f 72 65 20 4e 65 77 73 62 61 73 |e.before Newsbas| 00001860 65 20 74 72 69 65 73 20 74 6f 20 64 65 62 61 74 |e tries to debat| 00001870 63 68 20 69 74 2e 20 54 68 69 73 20 6d 69 67 68 |ch it. This migh| 00001880 74 20 62 65 20 75 73 65 66 75 6c 2c 20 66 6f 72 |t be useful, for| 00001890 20 65 78 61 6d 70 6c 65 2c 20 74 6f 0a 70 72 65 | example, to.pre| 000018a0 70 72 6f 63 65 73 73 20 75 71 77 6b 20 62 61 74 |process uqwk bat| 000018b0 63 68 20 66 69 6c 65 73 20 66 6f 72 20 75 73 65 |ch files for use| 000018c0 20 62 79 20 6e 65 77 73 62 61 73 65 2e 0a 0a 41 | by newsbase...A| 000018d0 66 74 65 72 20 61 20 64 65 62 61 74 63 68 20 63 |fter a debatch c| 000018e0 6f 6d 70 6c 65 74 65 73 2c 20 4e 65 77 73 62 61 |ompletes, Newsba| 000018f0 73 65 20 63 61 6c 6c 73 20 22 70 6f 73 74 66 65 |se calls "postfe| 00001900 74 63 68 22 2e 20 54 68 69 73 20 69 73 20 69 6e |tch". This is in| 00001910 74 65 6e 64 65 64 20 74 6f 0a 70 72 6f 76 69 64 |tended to.provid| 00001920 65 20 61 20 6d 65 61 6e 73 20 66 6f 72 20 63 6c |e a means for cl| 00001930 65 61 6e 2d 75 70 2e 20 46 6f 72 20 6b 61 39 71 |ean-up. For ka9q| 00001940 2c 20 74 68 69 73 20 63 6f 6d 6d 61 6e 64 20 74 |, this command t| 00001950 72 69 6d 73 20 6f 6c 64 20 65 6e 74 72 69 65 73 |rims old entries| 00001960 20 66 72 6f 6d 0a 74 68 65 20 6e 6e 74 70 20 68 | from.the nntp h| 00001970 69 73 74 6f 72 79 20 66 69 6c 65 73 2c 20 61 6e |istory files, an| 00001980 64 20 74 72 61 6e 73 66 65 72 73 20 6e 65 77 67 |d transfers newg| 00001990 72 6f 75 70 20 69 6e 66 6f 72 6d 61 74 69 6f 6e |roup information| 000019a0 20 74 6f 20 74 68 65 20 4e 65 77 73 62 61 73 65 | to the Newsbase| 000019b0 0a 6e 65 77 67 72 6f 75 70 73 20 66 69 6c 65 2e |.newgroups file.| 000019c0 0a 0a 4e 65 77 20 67 72 6f 75 70 73 0a 2d 2d 2d |..New groups.---| 000019d0 2d 2d 2d 2d 2d 2d 2d 0a 0a 4e 6f 20 73 70 65 63 |-------..No spec| 000019e0 69 66 69 63 20 63 6f 6d 6d 61 6e 64 20 69 73 20 |ific command is | 000019f0 63 61 6c 6c 65 64 20 66 6f 72 20 74 68 69 73 3b |called for this;| 00001a00 20 74 68 65 20 6b 61 39 71 20 74 72 61 6e 73 70 | the ka9q transp| 00001a10 6f 72 74 20 70 65 72 66 6f 72 6d 73 20 74 68 69 |ort performs thi| 00001a20 73 0a 64 75 72 69 6e 67 20 74 68 65 20 22 70 6f |s.during the "po| 00001a30 73 74 66 65 74 63 68 22 20 63 6f 6d 6d 61 6e 64 |stfetch" command| 00001a40 2e 0a 0a 4e 65 77 6c 79 2d 63 72 65 61 74 65 64 |...Newly-created| 00001a50 20 67 72 6f 75 70 73 20 61 72 65 20 61 70 70 65 | groups are appe| 00001a60 6e 64 65 64 20 74 6f 20 74 68 65 20 66 69 6c 65 |nded to the file| 00001a70 20 3c 4e 65 77 73 42 61 73 65 24 44 61 74 61 3e | <NewsBase$Data>| 00001a80 2e 6e 65 77 67 72 6f 75 70 73 2e 0a 45 61 63 68 |.newgroups..Each| 00001a90 20 6c 69 6e 65 20 73 68 6f 75 6c 64 20 63 6f 6e | line should con| 00001aa0 73 69 73 74 20 6f 66 20 61 20 67 72 6f 75 70 6e |sist of a groupn| 00001ab0 61 6d 65 2c 20 6f 72 20 61 20 74 69 6d 65 20 6d |ame, or a time m| 00001ac0 61 72 6b 65 72 2e 20 41 20 74 69 6d 65 20 6d 61 |arker. A time ma| 00001ad0 72 6b 65 72 0a 6c 69 6e 65 20 69 73 20 6f 66 20 |rker.line is of | 00001ae0 74 68 65 20 66 6f 72 6d 20 22 23 20 59 59 4d 4d |the form "# YYMM| 00001af0 44 44 20 48 48 4d 4d 53 53 22 2e 0a 6b 61 39 71 |DD HHMMSS"..ka9q| 00001b00 20 6f 62 74 61 69 6e 73 20 74 68 65 20 6c 69 73 | obtains the lis| 00001b10 74 20 6f 66 20 6e 65 77 20 67 72 6f 75 70 73 20 |t of new groups | 00001b20 66 72 6f 6d 20 74 68 65 20 21 54 43 50 49 50 20 |from the !TCPIP | 00001b30 78 78 78 4e 47 20 66 69 6c 65 73 2e 0a 0a 54 72 |xxxNG files...Tr| 00001b40 61 6e 73 70 6f 72 74 20 73 74 61 74 75 73 0a 2d |ansport status.-| 00001b50 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a |---------------.| 00001b60 0a 4e 65 77 73 62 61 73 65 20 6d 61 79 20 63 61 |.Newsbase may ca| 00001b70 6c 6c 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 22 |ll the command "| 00001b80 73 74 61 74 75 73 22 20 74 6f 20 64 65 74 65 72 |status" to deter| 00001b90 6d 69 6e 65 20 74 72 61 6e 73 70 6f 72 74 20 73 |mine transport s| 00001ba0 74 61 74 75 73 2e 20 54 68 69 73 0a 72 65 74 75 |tatus. This.retu| 00001bb0 72 6e 73 20 7a 65 72 6f 20 69 66 20 74 68 65 20 |rns zero if the | 00001bc0 74 72 61 6e 73 70 6f 72 74 20 69 73 20 69 6e 61 |transport is ina| 00001bd0 63 74 69 76 65 2e 20 54 68 65 20 6b 61 39 71 20 |ctive. The ka9q | 00001be0 74 72 61 6e 73 70 6f 72 74 20 72 65 74 75 72 6e |transport return| 00001bf0 73 20 31 20 74 6f 0a 69 6e 68 69 62 69 74 20 6e |s 1 to.inhibit n| 00001c00 65 77 73 20 65 78 70 69 72 79 20 77 68 69 6c 65 |ews expiry while| 00001c10 20 21 54 43 50 49 50 20 69 73 20 6f 6e 6c 69 6e | !TCPIP is onlin| 00001c20 65 2e 0a 0a 42 61 74 63 68 20 66 69 6c 65 73 0a |e...Batch files.| 00001c30 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 4e 65 77 |-----------..New| 00001c40 73 62 61 73 65 20 66 6f 6c 6c 6f 77 73 20 74 68 |sbase follows th| 00001c50 65 73 65 20 72 75 6c 65 73 20 77 68 65 6e 20 64 |ese rules when d| 00001c60 65 62 61 74 63 68 69 6e 67 20 66 69 6c 65 73 2e |ebatching files.| 00001c70 0a 0a 46 69 72 73 74 6c 79 2c 20 74 68 65 20 62 |..Firstly, the b| 00001c80 61 74 63 68 20 74 79 70 65 20 69 73 20 64 65 74 |atch type is det| 00001c90 65 72 6d 69 6e 65 64 20 66 72 6f 6d 20 74 68 65 |ermined from the| 00001ca0 20 66 69 72 73 74 20 6c 69 6e 65 2e 20 41 20 76 | first line. A v| 00001cb0 61 6c 69 64 20 62 61 74 63 68 0a 73 65 70 61 72 |alid batch.separ| 00001cc0 61 74 6f 72 20 73 68 6f 75 6c 64 20 62 65 20 66 |ator should be f| 00001cd0 6f 75 6e 64 2c 20 6f 6e 65 20 6f 66 3a 0a 0a 23 |ound, one of:..#| 00001ce0 21 20 72 6e 65 77 73 20 3c 62 79 74 65 73 3e 20 |! rnews <bytes> | 00001cf0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2d | -| 00001d00 3e 20 6e 65 77 73 20 62 61 74 63 68 0a 0a 46 72 |> news batch..Fr| 00001d10 6f 6d 20 20 20 20 20 20 20 20 20 20 20 20 20 20 |om | 00001d20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 77 | (w| 00001d30 69 74 68 20 74 72 61 69 6c 69 6e 67 20 73 70 61 |ith trailing spa| 00001d40 63 65 29 20 2d 3e 20 6d 61 69 6c 0a 5e 41 20 20 |ce) -> mail.^A | 00001d50 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 | | 00001d60 20 20 20 20 20 20 20 20 20 20 20 20 28 63 6f 6e | (con| 00001d70 74 72 6f 6c 2d 41 29 20 20 20 20 20 20 20 20 20 |trol-A) | 00001d80 20 20 2d 3e 20 6d 61 69 6c 0a 23 21 20 72 6d 61 | -> mail.#! rma| 00001d90 69 6c 20 3c 62 79 74 65 73 3e 20 20 20 20 20 20 |il <bytes> | 00001da0 20 20 20 20 20 20 20 20 20 20 2d 3e 20 6d 61 69 | -> mai| 00001db0 6c 0a 0a 49 66 20 61 20 76 61 6c 69 64 20 73 65 |l..If a valid se| 00001dc0 70 61 72 61 74 6f 72 20 69 73 20 6e 6f 74 20 66 |parator is not f| 00001dd0 6f 75 6e 64 2c 20 6e 65 77 73 62 61 73 65 20 77 |ound, newsbase w| 00001de0 69 6c 6c 20 63 6f 6e 74 69 6e 75 65 20 74 68 72 |ill continue thr| 00001df0 6f 75 67 68 20 74 68 65 20 66 69 6c 65 0a 75 6e |ough the file.un| 00001e00 74 69 6c 20 69 74 20 63 61 6e 20 64 65 74 65 72 |til it can deter| 00001e10 6d 69 6e 65 20 77 68 65 74 68 65 72 20 69 74 20 |mine whether it | 00001e20 69 73 20 6e 65 77 73 20 6f 72 20 6d 61 69 6c 2c |is news or mail,| 00001e30 20 63 6f 6d 70 6c 61 69 6e 20 61 62 6f 75 74 20 | complain about | 00001e40 74 68 65 0a 62 61 74 63 68 20 62 65 69 6e 67 20 |the.batch being | 00001e50 6e 6f 6e 73 74 61 6e 64 61 72 64 2c 20 22 72 65 |nonstandard, "re| 00001e60 77 69 6e 64 22 20 74 6f 20 74 68 65 20 73 74 61 |wind" to the sta| 00001e70 72 74 2c 20 61 6e 64 20 64 65 62 61 74 63 68 20 |rt, and debatch | 00001e80 69 74 2e 0a 0a 4e 65 77 73 20 62 61 74 63 68 65 |it...News batche| 00001e90 73 20 61 72 65 20 64 65 62 61 74 63 68 65 64 20 |s are debatched | 00001ea0 74 6f 20 74 68 65 20 67 72 6f 75 70 73 20 73 70 |to the groups sp| 00001eb0 65 63 69 66 69 65 64 20 69 6e 20 65 61 63 68 20 |ecified in each | 00001ec0 61 72 74 69 63 6c 65 27 73 0a 4e 65 77 73 67 72 |article's.Newsgr| 00001ed0 6f 75 70 73 20 68 65 61 64 65 72 20 6c 69 6e 65 |oups header line| 00001ee0 2c 20 73 75 62 6a 65 63 74 20 74 6f 20 74 68 65 |, subject to the| 00001ef0 20 72 65 73 74 72 69 63 74 69 6f 6e 73 20 6f 66 | restrictions of| 00001f00 20 74 68 65 20 41 63 74 69 76 65 20 6c 69 73 74 | the Active list| 00001f10 2e 0a 0a 46 6f 72 20 6d 61 69 6c 20 62 61 74 63 |...For mail batc| 00001f20 68 65 73 2c 20 74 68 65 20 66 69 6c 65 6e 61 6d |hes, the filenam| 00001f30 65 20 69 73 20 61 73 73 75 6d 65 64 20 74 6f 20 |e is assumed to | 00001f40 62 65 20 74 68 65 20 75 73 65 72 6e 61 6d 65 2e |be the username.| 00001f50 20 54 68 69 73 20 69 73 20 64 75 65 0a 74 6f 20 | This is due.to | 00001f60 74 68 65 20 69 6d 70 6f 73 73 69 62 69 6c 69 74 |the impossibilit| 00001f70 79 20 6f 66 20 65 78 74 72 61 63 74 69 6e 67 20 |y of extracting | 00001f80 72 65 6c 69 61 62 6c 65 20 69 6e 66 6f 72 6d 61 |reliable informa| 00001f90 74 69 6f 6e 20 66 72 6f 6d 20 61 20 22 54 6f 3a |tion from a "To:| 00001fa0 22 0a 68 65 61 64 65 72 2e 20 49 66 20 79 6f 75 |".header. If you| 00001fb0 72 20 74 72 61 6e 73 70 6f 72 74 20 64 6f 65 73 |r transport does| 00001fc0 20 6e 6f 74 20 70 72 6f 76 69 64 65 20 66 69 6c | not provide fil| 00001fd0 65 73 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 68 69 |es following thi| 00001fe0 73 0a 63 6f 6e 76 65 6e 74 69 6f 6e 2c 20 61 20 |s.convention, a | 00001ff0 22 70 72 65 66 65 74 63 68 22 20 70 72 65 70 72 |"prefetch" prepr| 00002000 6f 63 65 73 73 69 6e 67 20 73 74 65 70 20 77 69 |ocessing step wi| 00002010 6c 6c 20 62 65 20 72 65 71 75 69 72 65 64 2e 0a |ll be required..| 00002020 0a 53 75 6d 6d 61 72 79 20 6f 66 20 74 72 61 6e |.Summary of tran| 00002030 73 70 6f 72 74 2d 73 70 65 63 69 66 69 63 20 66 |sport-specific f| 00002040 69 6c 65 73 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |iles.-----------| 00002050 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| 00002060 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 49 6e 20 4e 65 77 |--------..In New| 00002070 73 62 61 73 65 20 30 2e 35 32 2c 20 61 6c 6c 20 |sbase 0.52, all | 00002080 74 72 61 6e 73 70 6f 72 74 20 66 75 6e 63 74 69 |transport functi| 00002090 6f 6e 73 20 61 72 65 20 64 65 66 69 6e 65 64 20 |ons are defined | 000020a0 69 6e 20 61 20 73 69 6e 67 6c 65 20 66 69 6c 65 |in a single file| 000020b0 2c 0a 22 70 61 72 61 6d 73 22 2c 20 77 68 69 63 |,."params", whic| 000020c0 68 20 63 6f 6e 74 61 69 6e 73 20 61 20 6c 69 73 |h contains a lis| 000020d0 74 20 6f 66 20 74 61 67 73 20 61 6e 64 20 76 61 |t of tags and va| 000020e0 6c 75 65 73 20 61 73 20 66 6f 6c 6c 6f 77 73 3a |lues as follows:| 000020f0 0a 0a 69 6e 20 3c 66 69 6c 65 73 70 65 63 3e 20 |..in <filespec> | 00002100 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 | | 00002110 20 20 65 71 75 69 76 2e 20 6f 66 20 27 69 6e 66 | equiv. of 'inf| 00002120 69 6c 65 73 27 0a 6f 75 74 20 3c 66 69 6c 65 73 |iles'.out <files| 00002130 70 65 63 3e 20 20 20 20 20 20 20 20 20 20 20 20 |pec> | 00002140 20 20 20 20 20 20 65 71 75 69 76 2e 20 6f 66 20 | equiv. of | 00002150 27 6f 75 74 66 69 6c 65 73 27 0a 64 69 72 20 3c |'outfiles'.dir <| 00002160 64 69 72 65 63 74 6f 72 79 6e 61 6d 65 3e 20 20 |directoryname> | 00002170 20 20 20 20 20 20 20 20 20 20 20 64 69 72 20 74 | dir t| 00002180 6f 20 62 65 20 63 72 65 61 74 65 64 20 66 6f 72 |o be created for| 00002190 20 74 72 61 6e 73 70 6f 72 74 20 61 74 20 73 74 | transport at st| 000021a0 61 72 74 75 70 0a 69 6e 66 6f 20 3c 64 65 73 63 |artup.info <desc| 000021b0 72 69 70 74 69 6f 6e 3e 20 20 20 20 20 20 20 20 |ription> | 000021c0 20 20 20 20 20 20 69 6e 66 6f 72 6d 61 74 69 6f | informatio| 000021d0 6e 20 6c 69 6e 65 0a 64 65 66 6d 65 6d 20 3c 6d |n line.defmem <m| 000021e0 65 6d 6f 72 79 3e 20 20 20 20 20 20 20 20 20 20 |emory> | 000021f0 20 20 20 20 20 20 20 64 65 66 61 75 6c 74 20 6d | default m| 00002200 65 6d 6f 72 79 73 69 7a 65 20 66 6f 72 20 74 72 |emorysize for tr| 00002210 61 6e 73 70 6f 72 74 20 70 72 6f 67 72 61 6d 73 |ansport programs| 00002220 20 28 4b 62 29 0a 0a 54 68 65 20 74 72 61 6e 73 | (Kb)..The trans| 00002230 70 6f 72 74 20 70 72 6f 67 72 61 6d 73 20 61 72 |port programs ar| 00002240 65 20 61 6c 73 6f 20 64 65 66 69 6e 65 64 20 69 |e also defined i| 00002250 6e 20 74 68 69 73 20 66 69 6c 65 2e 20 54 68 65 |n this file. The| 00002260 73 65 20 64 65 66 69 6e 69 74 69 6f 6e 73 20 74 |se definitions t| 00002270 61 6b 65 0a 74 68 65 20 66 6f 72 6d 3a 0a 0a 3c |ake.the form:..<| 00002280 63 6f 6d 6d 61 6e 64 2d 6e 61 6d 65 3e 20 3c 6d |command-name> <m| 00002290 65 6d 6f 72 79 3e 20 3c 70 72 6f 67 72 61 6d 2b |emory> <program+| 000022a0 70 61 72 61 6d 65 74 65 72 73 3e 0a 0a 46 6f 72 |parameters>..For| 000022b0 20 65 78 61 6d 70 6c 65 2c 0a 0a 73 65 6e 64 6d | example,..sendm| 000022c0 61 69 6c 20 36 34 20 73 65 6e 64 6d 61 69 6c 20 |ail 64 sendmail | 000022d0 2d 66 20 25 66 20 2d 75 20 25 75 0a 0a 6d 65 61 |-f %f -u %u..mea| 000022e0 6e 73 2c 20 74 6f 20 73 65 6e 64 20 6d 61 69 6c |ns, to send mail| 000022f0 2c 20 63 61 6c 6c 20 74 68 65 20 63 6f 6d 6d 61 |, call the comma| 00002300 6e 64 20 22 73 65 6e 64 6d 61 69 6c 20 2d 66 20 |nd "sendmail -f | 00002310 3c 66 69 6c 65 3e 20 2d 75 20 3c 75 73 65 72 3e |<file> -u <user>| 00002320 22 2c 0a 72 65 71 75 69 72 69 6e 67 20 61 74 20 |",.requiring at | 00002330 6c 65 61 73 74 20 36 34 6b 20 6f 66 20 6d 65 6d |least 64k of mem| 00002340 6f 72 79 2e 0a 0a 54 68 65 20 64 65 66 61 75 6c |ory...The defaul| 00002350 74 20 63 6f 6d 6d 61 6e 64 73 20 61 72 65 3a 0a |t commands are:.| 00002360 0a 73 65 6e 64 6d 61 69 6c 20 30 20 73 65 6e 64 |.sendmail 0 send| 00002370 6d 61 69 6c 20 2d 66 20 25 66 20 2d 75 20 25 75 |mail -f %f -u %u| 00002380 0a 73 65 6e 64 6e 65 77 73 20 30 20 73 65 6e 64 |.sendnews 0 send| 00002390 6e 65 77 73 20 2d 66 20 25 66 20 2d 75 20 25 75 |news -f %f -u %u| 000023a0 0a 73 68 6f 77 71 75 65 75 65 20 30 20 73 68 6f |.showqueue 0 sho| 000023b0 77 71 75 65 75 65 0a 70 72 65 66 65 74 63 68 20 |wqueue.prefetch | 000023c0 30 20 70 72 65 66 65 74 63 68 20 2d 66 20 25 66 |0 prefetch -f %f| 000023d0 0a 70 6f 73 74 66 65 74 63 68 20 30 20 70 6f 73 |.postfetch 0 pos| 000023e0 74 66 65 74 63 68 0a 61 64 64 75 73 65 72 20 30 |tfetch.adduser 0| 000023f0 20 61 64 64 75 73 65 72 20 2d 75 20 25 75 20 2d | adduser -u %u -| 00002400 67 20 25 6e 0a 64 65 6c 75 73 65 72 20 30 20 64 |g %n.deluser 0 d| 00002410 65 6c 75 73 65 72 20 2d 75 20 25 75 0a 6d 6f 64 |eluser -u %u.mod| 00002420 75 73 65 72 20 30 20 6d 6f 64 75 73 65 72 20 2d |user 0 moduser -| 00002430 75 20 25 75 20 2d 67 20 25 6e 0a 61 64 64 67 72 |u %u -g %n.addgr| 00002440 6f 75 70 20 30 20 61 64 64 67 72 6f 75 70 20 2d |oup 0 addgroup -| 00002450 67 20 25 67 0a 64 65 6c 67 72 6f 75 70 20 30 20 |g %g.delgroup 0 | 00002460 64 65 6c 67 72 6f 75 70 20 2d 67 20 25 67 0a 67 |delgroup -g %g.g| 00002470 65 74 68 6f 73 74 20 30 20 73 65 74 68 6f 73 74 |ethost 0 sethost| 00002480 0a 67 65 74 72 65 6d 6f 74 65 20 30 20 73 65 74 |.getremote 0 set| 00002490 72 65 6d 6f 74 65 0a 67 65 74 69 6e 66 69 6c 65 |remote.getinfile| 000024a0 73 20 30 20 67 65 74 69 6e 66 69 6c 65 73 0a 6d |s 0 getinfiles.m| 000024b0 6b 67 72 6f 75 70 73 20 30 20 6d 6b 67 72 6f 75 |kgroups 0 mkgrou| 000024c0 70 73 0a 73 74 61 74 75 73 20 30 20 73 74 61 74 |ps.status 0 stat| 000024d0 75 73 0a 73 74 61 72 74 75 70 20 30 20 73 74 61 |us.startup 0 sta| 000024e0 72 74 75 70 0a 73 65 74 75 70 20 30 20 73 65 74 |rtup.setup 0 set| 000024f0 75 70 0a 64 65 74 65 63 74 20 30 20 64 65 74 65 |up.detect 0 dete| 00002500 63 74 0a 0a 4e 6f 72 6d 61 6c 6c 79 2c 20 63 6f |ct..Normally, co| 00002510 6d 6d 61 6e 64 73 20 61 72 65 20 65 78 65 63 75 |mmands are execu| 00002520 74 65 64 20 66 72 6f 6d 20 74 68 65 20 64 69 72 |ted from the dir| 00002530 65 63 74 6f 72 79 0a 21 4e 65 77 73 62 61 73 65 |ectory.!Newsbase| 00002540 2e 74 72 61 6e 73 70 6f 72 74 73 2e 3c 74 72 61 |.transports.<tra| 00002550 6e 73 70 6f 72 74 2d 6e 61 6d 65 3e 2c 20 61 73 |nsport-name>, as| 00002560 20 69 6e 20 30 2e 35 31 20 61 6e 64 20 65 61 72 | in 0.51 and ear| 00002570 6c 69 65 72 2e 20 48 6f 77 65 76 65 72 2c 20 69 |lier. However, i| 00002580 66 0a 74 68 65 20 66 69 72 73 74 20 63 68 61 72 |f.the first char| 00002590 61 63 74 65 72 20 6f 66 20 74 68 65 20 63 6f 6d |acter of the com| 000025a0 6d 61 6e 64 20 69 73 20 22 2a 22 2c 20 69 73 20 |mand is "*", is | 000025b0 69 73 20 73 69 6d 70 6c 79 20 70 61 73 73 65 64 |is simply passed| 000025c0 20 74 6f 20 74 68 65 20 43 4c 49 0a 28 77 65 6c | to the CLI.(wel| 000025d0 6c 2e 2e 2e 20 57 69 6d 70 5f 53 74 61 72 74 54 |l... Wimp_StartT| 000025e0 61 73 6b 2c 20 72 65 61 6c 6c 79 29 20 73 6f 20 |ask, really) so | 000025f0 6d 61 79 20 62 65 20 61 6e 20 4f 53 20 6f 72 20 |may be an OS or | 00002600 6c 69 62 72 61 72 79 20 63 6f 6d 6d 61 6e 64 2e |library command.| 00002610 0a 0a 41 20 6d 65 6d 6f 72 79 73 69 7a 65 20 6f |..A memorysize o| 00002620 66 20 30 20 6d 65 61 6e 73 2c 20 75 73 65 20 74 |f 0 means, use t| 00002630 68 65 20 64 65 66 61 75 6c 74 20 76 61 6c 75 65 |he default value| 00002640 20 28 33 32 6b 20 69 66 20 6e 6f 74 20 73 70 65 | (32k if not spe| 00002650 63 69 66 69 65 64 20 65 61 72 6c 69 65 72 0a 69 |cified earlier.i| 00002660 6e 20 66 69 6c 65 29 2e 0a 0a 61 6e 64 20 61 76 |n file)...and av| 00002670 61 69 6c 61 62 6c 65 20 70 61 72 61 6d 65 74 65 |ailable paramete| 00002680 72 20 73 75 62 73 74 69 74 75 74 69 6f 6e 73 20 |r substitutions | 00002690 61 72 65 3a 0a 0a 20 20 25 68 20 68 6f 73 74 6e |are:.. %h hostn| 000026a0 61 6d 65 0a 20 20 25 6d 20 6d 61 69 6c 6e 61 6d |ame. %m mailnam| 000026b0 65 0a 20 20 25 72 20 72 65 6d 6f 74 65 20 68 6f |e. %r remote ho| 000026c0 73 74 6e 61 6d 65 0a 20 20 25 66 20 66 69 6c 65 |stname. %f file| 000026d0 6e 61 6d 65 20 28 77 69 74 68 20 73 65 6e 64 6d |name (with sendm| 000026e0 61 69 6c 2c 20 73 65 6e 64 6e 65 77 73 2c 20 70 |ail, sendnews, p| 000026f0 72 65 66 65 74 63 68 29 0a 20 20 25 75 20 75 73 |refetch). %u us| 00002700 65 72 6e 61 6d 65 20 28 77 69 74 68 20 73 65 6e |ername (with sen| 00002710 64 6d 61 69 6c 2c 20 73 65 6e 64 6e 65 77 73 2c |dmail, sendnews,| 00002720 20 61 64 64 75 73 65 72 2c 20 64 65 6c 75 73 65 | adduser, deluse| 00002730 72 2c 20 6d 6f 64 75 73 65 72 29 0a 20 20 25 6e |r, moduser). %n| 00002740 20 75 73 65 72 20 67 72 6f 75 70 6e 75 6d 62 65 | user groupnumbe| 00002750 72 20 28 77 69 74 68 20 61 64 64 75 73 65 72 2c |r (with adduser,| 00002760 20 6d 6f 64 75 73 65 72 29 0a 20 20 25 67 20 67 | moduser). %g g| 00002770 72 6f 75 70 6e 61 6d 65 20 28 77 69 74 68 20 61 |roupname (with a| 00002780 64 64 67 72 6f 75 70 2c 20 64 65 6c 67 72 6f 75 |ddgroup, delgrou| 00002790 70 29 0a 20 20 25 25 20 25 0a 0a 46 6f 72 20 6e |p). %% %..For n| 000027a0 6f 72 6d 61 6c 20 63 6f 6d 6d 61 6e 64 73 2c 20 |ormal commands, | 000027b0 4e 65 77 73 62 61 73 65 20 61 74 74 65 6d 70 74 |Newsbase attempt| 000027c0 73 0a 74 6f 20 72 75 6e 20 61 6c 6c 20 70 72 6f |s.to run all pro| 000027d0 67 72 61 6d 73 20 66 72 6f 6d 20 74 68 65 20 64 |grams from the d| 000027e0 69 72 65 63 74 6f 72 79 20 77 69 74 68 69 6e 20 |irectory within | 000027f0 6e 65 77 73 62 61 73 65 0a 28 21 4e 65 77 73 62 |newsbase.(!Newsb| 00002800 61 73 65 2e 74 72 61 6e 73 70 6f 72 74 73 2e 3c |ase.transports.<| 00002810 74 72 61 6e 73 70 6f 72 74 6e 61 6d 65 3e 22 29 |transportname>")| 00002820 2e 20 49 66 20 74 68 65 20 63 6f 6d 6d 61 6e 64 |. If the command| 00002830 20 6e 61 6d 65 20 69 73 20 70 72 65 66 69 78 65 | name is prefixe| 00002840 64 0a 77 69 74 68 20 61 20 22 2a 22 2c 20 74 68 |d.with a "*", th| 00002850 65 20 63 6f 6d 6d 61 6e 64 20 77 69 6c 6c 20 62 |e command will b| 00002860 65 20 72 75 6e 20 75 73 69 6e 67 20 6e 6f 20 70 |e run using no p| 00002870 72 65 64 65 66 69 6e 65 64 20 73 65 61 72 63 68 |redefined search| 00002880 20 70 61 74 68 2c 20 73 6f 20 63 61 6e 0a 63 6f | path, so can.co| 00002890 6e 73 69 73 74 20 6f 66 20 61 6e 20 4f 53 20 63 |nsist of an OS c| 000028a0 6f 6d 6d 61 6e 64 20 6f 72 20 6c 69 62 72 61 72 |ommand or librar| 000028b0 79 20 70 72 6f 67 72 61 6d 2e 0a 0a 46 6f 72 20 |y program...For | 000028c0 61 6c 6c 20 74 68 65 20 6e 6f 6e 2d 74 72 69 76 |all the non-triv| 000028d0 69 61 6c 20 74 72 61 6e 73 70 6f 72 74 20 70 72 |ial transport pr| 000028e0 6f 67 72 61 6d 73 2c 20 6f 6e 20 65 78 69 74 2c |ograms, on exit,| 000028f0 20 3c 4e 65 77 73 42 61 73 65 24 52 65 74 75 72 | <NewsBase$Retur| 00002900 6e 43 6f 64 65 3e 0a 73 68 6f 75 6c 64 20 62 65 |nCode>.should be| 00002910 20 7a 65 72 6f 20 66 6f 72 20 73 75 63 63 65 73 | zero for succes| 00002920 73 2e 20 3c 4e 65 77 73 42 61 73 65 24 52 65 74 |s. <NewsBase$Ret| 00002930 75 72 6e 49 6e 66 6f 3e 20 63 61 6e 20 63 6f 6e |urnInfo> can con| 00002940 74 61 69 6e 20 61 6e 20 69 6e 66 6f 72 6d 61 74 |tain an informat| 00002950 69 76 65 0a 6d 65 73 73 61 67 65 20 64 65 74 61 |ive.message deta| 00002960 69 6c 69 6e 67 20 73 75 63 63 65 73 73 20 6f 72 |iling success or| 00002970 20 72 65 61 73 6f 6e 20 66 6f 72 20 66 61 69 6c | reason for fail| 00002980 75 72 65 2e 0a 0a 54 72 61 6e 73 70 6f 72 74 20 |ure...Transport | 00002990 64 65 6c 65 74 69 6f 6e 2e 0a 2d 2d 2d 2d 2d 2d |deletion..------| 000029a0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 54 |-------------..T| 000029b0 68 65 20 74 72 61 6e 73 70 6f 72 74 73 20 63 6f |he transports co| 000029c0 6e 74 72 6f 6c 20 70 61 6e 65 6c 20 77 69 74 68 |ntrol panel with| 000029d0 69 6e 20 4e 65 77 73 62 61 73 65 20 70 65 72 6d |in Newsbase perm| 000029e0 69 74 73 20 75 6e 77 61 6e 74 65 64 20 74 72 61 |its unwanted tra| 000029f0 6e 73 70 6f 72 74 73 0a 74 6f 20 62 65 20 64 65 |nsports.to be de| 00002a00 6c 65 74 65 64 20 66 72 6f 6d 20 74 68 65 20 61 |leted from the a| 00002a10 70 70 6c 69 63 61 74 69 6f 6e 2e 20 54 68 69 73 |pplication. This| 00002a20 20 73 69 6d 70 6c 79 20 77 69 70 65 73 20 74 68 | simply wipes th| 00002a30 65 20 74 72 61 6e 73 70 6f 72 74 20 61 6e 64 0a |e transport and.| 00002a40 73 75 70 70 6f 72 74 20 64 69 72 65 63 74 6f 72 |support director| 00002a50 69 65 73 20 66 6f 72 20 74 68 61 74 20 74 72 61 |ies for that tra| 00002a60 6e 73 70 6f 72 74 2e 0a |nsport..| 00002a68
.