AAAARRRRCCCCHHHHIIIIEEEE((((1111)))) AAAArrrrcccchhhhiiiieeee ((((PPPPrrrroooossssppppeeeerrrroooo)))) ((((9999 JJJJaaaannnnuuuuaaaarrrryyyy 1111999999992222)))) AAAARRRRCCCCHHHHIIIIEEEE((((1111)))) NNNNAAAAMMMMEEEE archie - query the Archie anonymous FTP databases using Prospero SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS aaaarrrrcccchhhhiiiieeee [[[[ -cccceeeerrrrssss ] [ -llll ] [ -tttt ] [ -mmmm#### ] [ -NNNN#### ] [ -hhhh _h_o_s_t_n_a_m_e ] [ ----LLLL ] _s_t_r_i_n_g DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN aaaarrrrcccchhhhiiiieeee queries an archie anonymous FTP database looking for the specified _s_t_r_i_n_g using the PPPPrrrroooossssppppeeeerrrroooo protocol. This client is based on PPPPrrrroooossssppppeeeerrrroooo version Beta.4.2 and is provided to encourage non-interactive use of the Archie servers (and subsequently better performance on both sides). This man page describes version 1.3 of the client. The general method of use is of the form % aaaarrrrcccchhhhiiiieeee ssssttttrrrriiiinnnngggg This will go to the archie server and ask it to look for all known systems that have a file named `string' in their FTP area. aaaarrrrcccchhhhiiiieeee will wait, and print out any matches. For example, % aaaarrrrcccchhhhiiiieeee eeeemmmmaaaaccccssss will find all anonymous FTP sites in the archie database that have files named eeeemmmmaaaaccccssss somewhere in their FTP area. (This particular query would probably return a lot of directories.) If you want a list of every filename that contains eeeemmmmaaaaccccssss _a_n_y_w_h_e_r_e in it, you'd use % aaaarrrrcccchhhhiiiieeee ----cccc eeeemmmmaaaaccccssss Regular expressions, such as % aaaarrrrcccchhhhiiiieeee ----rrrr ''''[[[[xxxxXXXX]]]][[[[llllLLLL]]]]iiiisssspppp'''' may also be used for searches. (See the manual of a reasonably good editor, like GNU Emacs or vi, for more information on using regular expressions.) OOOOPPPPTTTTIIIIOOOONNNNSSSS The options currently available to this aaaarrrrcccchhhhiiiieeee client are: -cccc Search substrings paying attention to upper & lower case. -eeee Exact string match. (This is the default.) -rrrr Search using a regular expression. Page 1 (printed 11/2/92) AAAARRRRCCCCHHHHIIIIEEEE((((1111)))) AAAArrrrcccchhhhiiiieeee ((((PPPPrrrroooossssppppeeeerrrroooo)))) ((((9999 JJJJaaaannnnuuuuaaaarrrryyyy 1111999999992222)))) AAAARRRRCCCCHHHHIIIIEEEE((((1111)))) -ssss Search substrings ignoring the case of the letters. -llll Output results in a form suitable for parsing by programs. -tttt Sort the results inverted by date. -mmmm#### Specifies the maximum number of hits (matches) to return (default of 99995555). -NNNN#### Sets the _n_i_c_e_n_e_s_s of a query; by default, it's set to 0. Without an argument, ``-N'' defaults to 33335555777766665555. If you use ----NNNN with an argument between 0 and 35765, it'll adjust itself accordingly. (NNNNooootttteeee: VMS users will have to put quotes around this argument, and ----LLLL, like "----NNNN44445555"; VMS will otherwise convert it to lowercase.) -hhhh _h_o_s_t_n_a_m_e Tells the client to query the Archie server _h_o_s_t_n_a_m_e. -LLLL Lists the Archie servers known to the program when it was compiled, as well as the name of the default Archie server. For an up-to-date list, write to ``archie@archie.mcgill.ca'' (or any Archie server) with the single command of _s_e_r_v_e_r_s. The three search-modifying arguments (``-c'', ``-r'', and ``-s'') are all mutually exclusive; only the last one counts. If you specify ----eeee with any of ``-c'', ``-r'', or ``-s'', the server will first check for an exact match, then fall back to the case-sensitive, case-insensitive, or regular expression search. This is so if there are matches that are particularly obvious, it will take a minimal amount of time to satisfy your request. If you list a single `-' by itself, any further arguments will be taken as part of the search string. This is intended to enable searching for strings that begin with a `-'; for example: % aaaarrrrcccchhhhiiiieeee -ssss - -oooolllldddd will search for all filenames that contain the string `-old' in them. RRRREEEESSSSPPPPOOOONNNNSSSSEEEE Archie servers are set up to respond to a number of requests in a queued fashion. That is, smaller requests get served much more quickly than do large requests. As a result, the more often you query the Archie server, or the larger your requests, the longer the queue will become, resulting in a longer waiting period for everyone's requests. Please be frugal when possible, for your benefit as well as for the other users. Page 2 (printed 11/2/92) AAAARRRRCCCCHHHHIIIIEEEE((((1111)))) AAAArrrrcccchhhhiiiieeee ((((PPPPrrrroooossssppppeeeerrrroooo)))) ((((9999 JJJJaaaannnnuuuuaaaarrrryyyy 1111999999992222)))) AAAARRRRCCCCHHHHIIIIEEEE((((1111)))) QQQQUUUUEEEERRRRYYYY PPPPRRRRIIIIOOOORRRRIIIITTTTYYYY Please use the ``-N'' option whenever you don't demand immediacy, or when you're requesting things that could generate large responses. Even when using the nice option, you should still try to avoid big jobs during busy periods. Here is a list of what we consider to be nice values that accurately reflect the priority of a job to the server. NNNNoooorrrrmmmmaaaallll 0 NNNNiiiicccceeee 500 NNNNiiiicccceeeerrrr 1000 VVVVeeeerrrryyyy NNNNiiiicccceeee 5000 EEEExxxxttttrrrreeeemmmmeeeellllyyyy NNNNiiiicccceeee 10000 NNNNiiiicccceeeesssstttt 32765 The last priority, NNNNiiiicccceeeesssstttt, would be used when a job should wait until the queue is essentially empty before running. You should pick one of these values to use, possibly modifying it slightly depending on where you think your priority should land. For example, 32760 would mean wait until the queue is empty, but jump ahead of other jobs that have selected NNNNiiiicccceeeesssstttt. There are certain types of things that we suggest using NNNNiiiicccceeeesssstttt for, irregardless. In particular, any searches for which you would have a hard time justifying the use of anything but extra resources. (We all know what those searches would be for.) EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT ARCHIE_HOST This will change the host _a_r_c_h_i_e will consult when making queries. (The default value is what's been compiled in.) The ``-h'' option will override this. If you're running VMS, create a symbol called ARCHIE_HOST. SSSSEEEEEEEE AAAALLLLSSSSOOOO For more information on regular expressions, see the manual pages on: rrrreeeeggggeeeexxxx(3),,,, eeeedddd(1) Also read the file aaaarrrrcccchhhhiiiieeee////ddddoooocccc////wwwwhhhhaaaattttiiiissss....aaaarrrrcccchhhhiiiieeee on aaaarrrrcccchhhhiiiieeee....mmmmccccggggiiiillllllll....ccccaaaa for a detailed paper on Archie as a whole. AAAAUUUUTTTTHHHHOOOORRRRSSSS The aaaarrrrcccchhhhiiiieeee service was conceived and implemented by Alan Emtage (bbbbaaaajjjjaaaannnn@@@@ccccssss....mmmmccccggggiiiillllllll....ccccaaaa), Peter Deutsch (ppppeeeetttteeeerrrrdddd@@@@ccccssss....mmmmccccggggiiiillllllll....ccccaaaa), and Bill Heelan (wwwwhhhheeeeeeeellllaaaannnn@@@@ccccssss....mmmmccccggggiiiillllllll....ccccaaaa). The entire Internet is in their debt. Page 3 (printed 11/2/92) AAAARRRRCCCCHHHHIIIIEEEE((((1111)))) AAAArrrrcccchhhhiiiieeee ((((PPPPrrrroooossssppppeeeerrrroooo)))) ((((9999 JJJJaaaannnnuuuuaaaarrrryyyy 1111999999992222)))) AAAARRRRCCCCHHHHIIIIEEEE((((1111)))) The PPPPrrrroooossssppppeeeerrrroooo system was created by Clifford Neuman (bbbbccccnnnn@@@@iiiissssiiii....eeeedddduuuu); write to iiiinnnnffffoooo----pppprrrroooossssppppeeeerrrroooo@@@@iiiissssiiii....eeeedddduuuu for more information on the protocol and its use. This stripped client was put together by Brendan Kehoe (bbbbrrrreeeennnnddddaaaannnn@@@@ccccssss....wwwwiiiiddddeeeennnneeeerrrr....eeeedddduuuu), with modifications by Clifford Neuman and George Ferguson (ffffeeeerrrrgggguuuussssoooonnnn@@@@ccccssss....rrrroooocccchhhheeeesssstttteeeerrrr....eeeedddduuuu). BBBBUUUUGGGGSSSS There are none; only a few unexpected features. Page 4 (printed 11/2/92)