/*???????????????????????????????????????????????????????????????????????????*/
/*??*?aquery.c?:?Programmatic?Prospero?interface?to?Archie???????????????????*/
/*??*????????????????????????????????????????????????????????????????????????*/
/*??*?Copyright?（c）?1991?by?the?University?of?Washington?????????????????????*/
/*??*????????????????????????????????????????????????????????????????????????*/
/*??*?For?copying?and?distribution?information?please?see?the?file??????????*/
/*??*?.?????????????????????????????????????????????????????????*/

#include?“pmachine.h“
#include?“pfs.h“
#include?“perrno.h“
#include?“archie.h“

static?void?translateArchieResponse（）;
inline?static?int?hostnamecmp（）;

extern?int?pwarn;
extern?char?p_warn_string[];

/*???????????????????????????????????????????????????????????????????????????*/
/*??*?archie_query?:?Sends?a?request?to?_host_?telling?it?to?search?for?????*/
/*??*?_string_?using?_query_?as?the?search?method.???????????????????????????*/
/*??*?No?more?than?_max_hits_?matches?are?to?be?returned?????????????????????*/
/*??*?skipping?over?_offset_?matches.????????????????????????????????????????*/
/*??*????????????????????????????????????????????????????????????????????????*/
/*??*?archie_query?returns?a?linked?list?of?virtual?links.???????????????????*/
/*??*?If?_flags_?does?not?include?AQ_NOTRANS?then?the?Archie????????????????*/
/*??*?responses?will?be?translated.?If?_flags_?does?not?include??????????????*/
/*??*?AQ_NOSORT?then?the?list?will?be?sorted?using?_cmp_proc_?to????????????*/
/*??*?compare?pairs?of?links.??If?_cmp_proc_?is?NULL?or?AQ_DEFCMP???????????*/
/*??*?then?the?default?comparison?procedure?defcmplink（）?is?used???????????*/
/*??*?sorting?by?host?then?filename.?If?cmp_proc?is?AQ_INVDATECMP???????????*/
/*??*?then?invdatecmplink（）?is?used?sorting?inverted?by?date.???????????????*/
/*??*?otherwise?a?user-defined?comparison?procedure?is?called.???????????????*/
/*??*????????????????????????????????????????????????????????????????????????*/
/*??*?archie_query?returns?NULL?and?sets?perrno?if?the?query?????????????????*/
/*??*?failed.?Note?that?it?can?return?NULL?with?perrno?==?PSUCCESS???????????*/
/*??*?if?the?query?didn‘t?fail?but?there?were?simply?no?matches.?????????????*/
/*??*????????????????????????????????????????????????????????????????????????*/
/*??*?query:?S?Substring?search?ignoring?case????????????????????????????????*/
/*??*?C?Substring?search?with?case?significant???????????????????????????????*/
/*??*?R?Regular?expression?search????????????????????????????????????????????*/
/*??*?=?Exact?String?Match???????????????????????????????????????????????????*/
/*??*?sce?Tries?exact?match?first?and?falls?back?to?S?C?or?R?????????????*/
/*??*?if?not?found.??????????????????????????????????????????????????????????*/
/*??*????????????????????????????????????????????????????????????????????????*/
/*??*?cmp_proc:?AQ_DEFCMP?Sort?by?host?then?filename????????????????????????*