home *** CD-ROM | disk | FTP | other *** search
ARCHIE(1) User Commands ARCHIE(1) N_N_N_NA_A_A_AM_M_M_ME_E_E_E archie - query the Archie anonymous FTP databases using Prospero S_S_S_SY_Y_Y_YN_N_N_NO_O_O_OP_P_P_PS_S_S_SI_I_I_IS_S_S_S a_a_a_ar_r_r_rc_c_c_ch_h_h_hi_i_i_ie_e_e_e [_[_[_[ -_-_-_-c_c_c_ce_e_e_er_r_r_rs_s_s_s ] [ -_-_-_-a_a_a_a ] [ -_-_-_-l_l_l_l ] [ -_-_-_-t_t_t_t ] [ -_-_-_-m_m_m_m hits ] [ -_-_-_-N_N_N_N [_[_[_[ level ] ] [ -_-_-_-h_h_h_h hostname ] [ -_-_-_-o_o_o_o filename ] [ -_-_-_-L_L_L_L ] [ -_-_-_-V_V_V_V ] [ -_-_-_-v_v_v_v ] string D_D_D_DE_E_E_ES_S_S_SC_C_C_CR_R_R_RI_I_I_IP_P_P_PT_T_T_TI_I_I_IO_O_O_ON_N_N_N a_a_a_ar_r_r_rc_c_c_ch_h_h_hi_i_i_ie_e_e_e queries an archie anonymous FTP database looking for the specified string using the P_P_P_Pr_r_r_ro_o_o_os_s_s_sp_p_p_pe_e_e_er_r_r_ro_o_o_o protocol. This client is based on P_P_P_Pr_r_r_ro_o_o_os_s_s_sp_p_p_pe_e_e_er_r_r_ro_o_o_o 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 % a_a_a_ar_r_r_rc_c_c_ch_h_h_hi_i_i_ie_e_e_e s_s_s_st_t_t_tr_r_r_ri_i_i_in_n_n_ng_g_g_g 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. a_a_a_ar_r_r_rc_c_c_ch_h_h_hi_i_i_ie_e_e_e will wait, and print out any matches. For example, % a_a_a_ar_r_r_rc_c_c_ch_h_h_hi_i_i_ie_e_e_e e_e_e_em_m_m_ma_a_a_ac_c_c_cs_s_s_s will find all anonymous FTP sites in the archie database that have files named e_e_e_em_m_m_ma_a_a_ac_c_c_cs_s_s_s somewhere in their FTP area. (This particular query would probably return a lot of direc- tories.) If you want a list of every filename that contains e_e_e_em_m_m_ma_a_a_ac_c_c_cs_s_s_s anywhere in it, you'd use % a_a_a_ar_r_r_rc_c_c_ch_h_h_hi_i_i_ie_e_e_e -_-_-_-c_c_c_c e_e_e_em_m_m_ma_a_a_ac_c_c_cs_s_s_s Regular expressions, such as % a_a_a_ar_r_r_rc_c_c_ch_h_h_hi_i_i_ie_e_e_e -_-_-_-r_r_r_r '_'_'_'[_[_[_[x_x_x_xX_X_X_X]_]_]_][_[_[_[l_l_l_lL_L_L_L]_]_]_]i_i_i_is_s_s_sp_p_p_p'_'_'_' may also be used for searches. (See the manual of a reason- ably good editor, like GNU Emacs or vi, for more information on using regular expressions.) O_O_O_OP_P_P_PT_T_T_TI_I_I_IO_O_O_ON_N_N_NS_S_S_S The options currently available to this a_a_a_ar_r_r_rc_c_c_ch_h_h_hi_i_i_ie_e_e_e client are: -_-_-_-c_c_c_c Search substrings paying attention to upper & lower case. -_-_-_-e_e_e_e Exact string match. (This is the default.) Archie (Prospero) Last change: 26 October 1992 1 ARCHIE(1) User Commands ARCHIE(1) -_-_-_-r_r_r_r Search using a regular expression. -_-_-_-s_s_s_s Search substrings ignoring the case of the letters. -_-_-_-o_o_o_ofilename If specified, place the results of the search in filename. -_-_-_-a_a_a_a Output results as Alex filenames. -_-_-_-l_l_l_l Output results in a form suitable for parsing by programs. -_-_-_-t_t_t_t Sort the results inverted by date. -_-_-_-m_m_m_mhits Specifies the maximum number of hits (matches) to return (default of 9_9_9_95_5_5_5). -_-_-_-N_N_N_Nlevel Sets the niceness of a query; by default, it's set to 0. Without an argument, ``-N'' defaults to 3_3_3_35_5_5_57_7_7_76_6_6_65_5_5_5. If you use -_-_-_-N_N_N_N with an argument between 0 and 35765, it'll adjust itself accord- ingly. (N_N_N_No_o_o_ot_t_t_te_e_e_e: VMS users will have to put quotes around this argument, and -_-_-_-L_L_L_L, like "-_-_-_-N_N_N_N4_4_4_45_5_5_5"; VMS will otherwise convert it to lowercase.) -_-_-_-h_h_h_h hostname Tells the client to query the Archie server hostname. -_-_-_-L_L_L_L 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 servers. -_-_-_-V_V_V_V With the verbose option, a_a_a_ar_r_r_rc_c_c_ch_h_h_hi_i_i_ie_e_e_e will make some comments along the way if a search is going to take some time, to pacify the user. The three search-modifying arguments (``-c'', ``-r'', and ``-s'') are all mutually exclusive; only the last one counts. If you specify -_-_-_-e_e_e_e 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 regu- lar 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: % a_a_a_ar_r_r_rc_c_c_ch_h_h_hi_i_i_ie_e_e_e -_-_-_-s_s_s_s -_-_-_- -_-_-_-o_o_o_ol_l_l_ld_d_d_d will search for all filenames that contain the string `-old' in them. R_R_R_RE_E_E_ES_S_S_SP_P_P_PO_O_O_ON_N_N_NS_S_S_SE_E_E_E Archie servers are set up to respond to a number of requests in a queued fashion. That is, smaller requests get served Archie (Prospero) Last change: 26 October 1992 2 ARCHIE(1) User Commands ARCHIE(1) 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. Q_Q_Q_QU_U_U_UE_E_E_ER_R_R_RY_Y_Y_Y P_P_P_PR_R_R_RI_I_I_IO_O_O_OR_R_R_RI_I_I_IT_T_T_TY_Y_Y_Y Please use the ``-N'' option whenever you don't demand immediacy, or when you're requesting things that could gen- erate 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. N_N_N_No_o_o_or_r_r_rm_m_m_ma_a_a_al_l_l_l 0 N_N_N_Ni_i_i_ic_c_c_ce_e_e_e 500 N_N_N_Ni_i_i_ic_c_c_ce_e_e_er_r_r_r 1000 V_V_V_Ve_e_e_er_r_r_ry_y_y_y N_N_N_Ni_i_i_ic_c_c_ce_e_e_e 5000 E_E_E_Ex_x_x_xt_t_t_tr_r_r_re_e_e_em_m_m_me_e_e_el_l_l_ly_y_y_y N_N_N_Ni_i_i_ic_c_c_ce_e_e_e 10000 N_N_N_Ni_i_i_ic_c_c_ce_e_e_es_s_s_st_t_t_t 32765 The last priority, N_N_N_Ni_i_i_ic_c_c_ce_e_e_es_s_s_st_t_t_t, 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 modify- ing 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 N_N_N_Ni_i_i_ic_c_c_ce_e_e_es_s_s_st_t_t_t. There are certain types of things that we suggest using N_N_N_Ni_i_i_ic_c_c_ce_e_e_es_s_s_st_t_t_t for, irregardless. In particular, any searches for which you would have a hard time justifying the use of any- thing but extra resources. (We all know what those searches would be for.) E_E_E_EN_N_N_NV_V_V_VI_I_I_IR_R_R_RO_O_O_ON_N_N_NM_M_M_ME_E_E_EN_N_N_NT_T_T_T ARCHIE_HOST This will change the host archie 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. S_S_S_SE_E_E_EE_E_E_E A_A_A_AL_L_L_LS_S_S_SO_O_O_O For more information on regular expressions, see the manual pages on: r_r_r_re_e_e_eg_g_g_ge_e_e_ex_x_x_x(3),_,_,_, e_e_e_ed_d_d_d(1) Also read the file a_a_a_ar_r_r_rc_c_c_ch_h_h_hi_i_i_ie_e_e_e/_/_/_/d_d_d_do_o_o_oc_c_c_c/_/_/_/w_w_w_wh_h_h_ha_a_a_at_t_t_ti_i_i_is_s_s_s._._._.a_a_a_ar_r_r_rc_c_c_ch_h_h_hi_i_i_ie_e_e_e on a_a_a_ar_r_r_rc_c_c_ch_h_h_hi_i_i_ie_e_e_e._._._.m_m_m_mc_c_c_cg_g_g_gi_i_i_il_l_l_ll_l_l_l._._._.c_c_c_ca_a_a_a for a detailed paper on Archie as a whole. Archie (Prospero) Last change: 26 October 1992 3 ARCHIE(1) User Commands ARCHIE(1) Read the file README.ALEX distributed with this client for more information on what Alex is and how you can take advan- tage of it. A_A_A_AU_U_U_UT_T_T_TH_H_H_HO_O_O_OR_R_R_RS_S_S_S The a_a_a_ar_r_r_rc_c_c_ch_h_h_hi_i_i_ie_e_e_e service was conceived and implemented by Alan Emtage (b_b_b_ba_a_a_aj_j_j_ja_a_a_an_n_n_n@_@_@_@c_c_c_cs_s_s_s._._._.m_m_m_mc_c_c_cg_g_g_gi_i_i_il_l_l_ll_l_l_l._._._.c_c_c_ca_a_a_a), Peter Deutsch (p_p_p_pe_e_e_et_t_t_te_e_e_er_r_r_rd_d_d_d@_@_@_@c_c_c_cs_s_s_s._._._.m_m_m_mc_c_c_cg_g_g_gi_i_i_il_l_l_ll_l_l_l._._._.c_c_c_ca_a_a_a), and Bill Heelan (w_w_w_wh_h_h_he_e_e_ee_e_e_el_l_l_la_a_a_an_n_n_n@_@_@_@c_c_c_cs_s_s_s._._._.m_m_m_mc_c_c_cg_g_g_gi_i_i_il_l_l_ll_l_l_l._._._.c_c_c_ca_a_a_a). The entire Internet is in their debt. The P_P_P_Pr_r_r_ro_o_o_os_s_s_sp_p_p_pe_e_e_er_r_r_ro_o_o_o system was created by Clifford Neuman (b_b_b_bc_c_c_cn_n_n_n@_@_@_@i_i_i_is_s_s_si_i_i_i._._._.e_e_e_ed_d_d_du_u_u_u); write to i_i_i_in_n_n_nf_f_f_fo_o_o_o-_-_-_-p_p_p_pr_r_r_ro_o_o_os_s_s_sp_p_p_pe_e_e_er_r_r_ro_o_o_o@_@_@_@i_i_i_is_s_s_si_i_i_i._._._.e_e_e_ed_d_d_du_u_u_u for more information on the protocol and its use. This stripped client was put together by Brendan Kehoe (b_b_b_br_r_r_re_e_e_en_n_n_nd_d_d_da_a_a_an_n_n_n@_@_@_@c_c_c_cy_y_y_yg_g_g_gn_n_n_nu_u_u_us_s_s_s._._._.c_c_c_co_o_o_om_m_m_m), with modifications by Clifford Neuman and George Ferguson (f_f_f_fe_e_e_er_r_r_rg_g_g_gu_u_u_us_s_s_so_o_o_on_n_n_n@_@_@_@c_c_c_cs_s_s_s._._._.r_r_r_ro_o_o_oc_c_c_ch_h_h_he_e_e_es_s_s_st_t_t_te_e_e_er_r_r_r._._._.e_e_e_ed_d_d_du_u_u_u). B_B_B_BU_U_U_UG_G_G_GS_S_S_S There are none; only a few unexpected features. Archie (Prospero) Last change: 26 October 1992 4 
