From cs.toronto.edu!mackay Tue Dec 10 16:31:52 1996 From: David Mackay To: mackay@cs.toronto.edu MIRROR(1L) MISC. REFERENCE MANUAL PAGES MIRROR(1L) NNNNAAAAMMMMEEEE mirror - mirror packages on remote sites SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS mmmmiiiirrrrrrrroooorrrr [[[[ffffllllaaaaggggssss]]]] ----gggg_s_i_t_e::::_p_a_t_h_n_a_m_e mmmmiiiirrrrrrrroooorrrr [[[[ffffllllaaaaggggssss]]]] [[[[ccccoooonnnnffffiiiigggg----ffffiiiilllleeeessss]]]] DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN MMMMiiiirrrrrrrroooorrrr is a package written in Perl that uses the ftp proto- col to duplicate a directory hierarchy between the machine it is run on and a remote host. It avoids copying files unnecessarily by comparing the file time-stamps and sizes before transferring. Amongst other things, it can option- ally compress, gzip, and split files. It was written for use by archive maintainers but can be used by anyone wanting to transfer a lot of files via ftp. Regardless of how it is called, mmmmiiiirrrrrrrroooorrrr always performs the same basic steps. It connects to the remote site, inter- nally builds a directory listing of the local target direc- tory, builds one for the remote directory, compares them, creates any subdirectories required, transfers the appropri- ate files (setting their time-stamps to match those on the remote site), creates any symbolic links, removes any unnecessary objects and finally drops the connection. MMMMiiiirrrrrrrroooorrrr can handle symbolic links but not ordinary links. It does not duplicate owner or group information. If you require any of these options, use rrrrddddiiiisssstttt(1) instead. MMMMiiiirrrrrrrroooorrrr is called in one of two ways shown in the synopsis above. The first method is used to retrieve a remote directory into the current directory. If you are mirroring a directory, it would be best to end the pathname in a slash ('/') so the remote recursive listing is smaller or use the ----rrrr flag to suppress recursion (see ----gggg below). The mmmmiiiirrrrrrrroooorrrr....ddddeeeeffffaaaauuuullllttttssss file is not used. In the second method given in the synopsis above, a minimal number of arguments are required and mmmmiiiirrrrrrrroooorrrr is controlled by the settings read from the configuration files (or standard input). If a file named mmmmiiiirrrrrrrroooorrrr....ddddeeeeffffaaaauuuullllttttssss can be found in either the directory the mmmmiiiirrrrrrrroooorrrr executable is in or in the PPPPEEEERRRRLLLLLLLLIIIIBBBB path, then it is loaded first. This is used to pro- vide common defaults for all config-files. MMMMiiiirrrrrrrroooorrrr was written to mirror remote Un*x archives, but has grown (like topsy). Sun Release 4.1 Last change: Mirror 2.6 1 MIRROR(1L) MISC. REFERENCE MANUAL PAGES MIRROR(1L) OOOOPPPPTTTTIIIIOOOONNNNSSSS ----dddd Enable debugging. If this argument is given more than once, the debugging level will increase. Currently the maximum useful level is four. ----pppppackage Only mirror the given package. This option may be given multiple times in which case all the given pack- ages will be mirrored. Without this option, all pack- ages will be mirrored. Package is a regexp matched against the package variable. ----RRRRpackage Similar to ----pppp but skips all packages until it reaches the given package. Useful for restarting failed mirror runs from where they left off. ----nnnn Do nothing except compare local and remote directories, no file transfers are done. Sets debug level to two, so you are shown a trace of what would be done. ----FFFF Use temporary ddddbbbbmmmm files for the information about files. This is useful if you mirror a very large directory. See the variable _u_s_e__f_i_l_e_s. ----ggggsite::::path Get all files on given site. If path matches .*/.+ then it is the name of the directory and the last part is the pattern of filenames to get. If path matches .*/ then it is the name of a directory and all its contents are retrieved. Otherwise path is the pattern to be used in '/'. If you use host:/fred, a full directory listing of / on the remote host will be done. If all you wanted was the contents of the directory /fred, specify host:/fred/. ----rrrr Equivalent to ----kkkk_r_e_c_u_r_s_i_v_e=false ----vvvv Print the version details of mirror and exit. ----TTTT Force the time stamps of any local files to be reset to be the same as the remote files. Normally only used when initialising a mirror area using existing files contents. ----UUUU[[[[filename]]]] Record all uploads into the given filename. Remember that mirror changes into _l_o_c_a_l__d_i_r to do its work, so it should be a full pathname. If no parameter is given, it defaults to `pwd`/upload_log.day.month.year. ----kkkk_k_e_y=value Sun Release 4.1 Last change: Mirror 2.6 2 MIRROR(1L) MISC. REFERENCE MANUAL PAGES MIRROR(1L) Override any default key/value. ----mmmm Equivalent to ----kkkk_m_o_d_e__c_o_p_y=true ----tttt Equivalent to ----kkkk_t_e_x_t__m_o_d_e=true ----ffff Equivalent to ----kkkk_f_o_r_c_e=true ----sssssite Equivalent to ----kkkk_s_i_t_e=site ----uuuuuser Equivalent to ----kkkk_r_e_m_o_t_e__u_s_e_r=user You are then prompted for a password, with echo turned off. The password is used to set _r_e_m_o_t_e__p_a_s_s_w_o_r_d. ----LLLL Just generate a pretty printed version of the input and exit. ----GGGG Get files from the remote machine. The local and remote directories have to be given on the command line. (This option is no longer supported.) ----PPPP Put files onto the remote machine. The local and remote directories have to be given on the command line. (This option is no longer supported.) ----CCCCfile Specify config-files. Needed to give config-files with ----PPPP and ----GGGG options. (This option is no longer sup- ported.) CCCCOOOONNNNFFFFIIIIGGGGUUUURRRRAAAATTTTIIIIOOOONNNN FFFFIIIILLLLEEEE Configuration files are parsed as a series of statements. Blank lines and lines beginning with a hash are ignored. Each statement is of the form _k_e_y_w_o_r_d====value or _k_e_y_w_o_r_d++++value You can add whitespace before the keyword and the equals/plus. Everything immediately following the equals/plus is the value, including any leading or trailing whitespace. The equals version sets the keyword to this value, while the plus version concatenates the value onto the end of the default. A statement can be continued over multiple lines by ending all lines except the last, with the character ampersand ('&'). The line following the ampersand, is appended to the current line with all leading whitespace removed. Sun Release 4.1 Last change: Mirror 2.6 3 MIRROR(1L) MISC. REFERENCE MANUAL PAGES MIRROR(1L) Here is a list of the keywords and their values with defaults given inside square brackets. Those options flagged with a star are not yet implemented. Although there are a lot of keywords that can be set, the built-in defaults will handle most cases. Normally only _p_a_c_k_a_g_e, _s_i_t_e, _r_e_m_o_t_e__d_i_r and _l_o_c_a_l__d_i_r need to be set. _p_a_c_k_a_g_e Should be a unique name for the package to be mirrored. _c_o_m_m_e_n_t Used in reports. _s_k_i_p Setting this entry causes this package to be skipped. The value is reported as the reason for skipping. (It is easier than commenting the entry out.) _s_i_t_e Site-name or IP address of the remote site. _r_e_m_o_t_e__d_i_r Remote directory to mirror. See also _r_e_c_u_r_s_e__h_a_r_d. _l_o_c_a_l__d_i_r Local directory. _r_e_m_o_t_e__u_s_e_r Username to use at remote site. [anonymous] _r_e_m_o_t_e__p_a_s_s_w_o_r_d Password to use at remote site. [user@localhostname] _r_e_m_o_t_e__a_c_c_o_u_n_t Account name/password (to use at remote site, after logging in anonymously (for systems that use it). _g_e_t__p_a_t_t Regexp of remote pathnames to retrieve. [.] _f_a_i_l_e_d__g_e_t_s__e_x_c_l Regexp of messages to ignore, when the ftp get command failed. _e_x_c_l_u_d_e__p_a_t_t Regexp of remote pathnames to ignore. _u_p_d_a_t_e__l_o_c_a_l Set _g_e_t__p_a_t_t to be _l_o_c_a_l__d_i_r/*. This is use- ful if you only want to mirror selected sub- directories of a remote archive. [false] _l_o_c_a_l__i_g_n_o_r_e Regexp of local pathnames to ignore. Useful to skip restricted local directories. _d_o__d_e_l_e_t_e_s Delete destination files if not in source tree. [false] Sun Release 4.1 Last change: Mirror 2.6 4 MIRROR(1L) MISC. REFERENCE MANUAL PAGES MIRROR(1L) _d_e_l_e_t_e__p_a_t_t Regexp of local pathnames to check for dele- tions. Names that are not matched are not checked. The match by _d_e_l_e_t_e__e_x_c_l is done to all files selected by this pattern. [.] _d_e_l_e_t_e__g_e_t__p_a_t_t Set _d_e_l_e_t_e__p_a_t_t to be _g_e_t__p_a_t_t. [false] _d_e_l_e_t_e__e_x_c_l Regexp of local pathnames to never delete. _s_a_v_e__d_e_l_e_t_e_s Save local files into _s_a_v_e__d_i_r rather than deleting. [false] _s_a_v_e__d_i_r Where local files no longer on remote site are transferred to. [Old] _m_a_x__d_e_l_e_t_e__f_i_l_e_s If there are more than this many files to delete, do not delete, just warn. If the value ends with percent character the this is the percentage of files before deletion dis- abled. [10%] _m_a_x__d_e_l_e_t_e__d_i_r_s If there are more than this many directories to delete, do not delete, just warn. If the value ends with percent character the this is the percentage of directories before deletion disabled. [10%] _m_a_x__d_a_y_s If >0, ignore files older than this many days. Any ignored files will not be transferred or deleted. [0] _s_t_o_r_e__r_e_m_o_t_e__l_i_s_t_i_n_g Local pathname where remote listings are kept. Useful if you have a slow network or want to perform several operations on the same package without retrieving the index every time. _s_p_l_i_t__m_a_x If >0 and the size of the file is greater than this, the file is split up to be stored locally (filename must also match _s_p_l_i_t__p_a_t_t). [0] _s_p_l_i_t__p_a_t_t regexp of remote pathnames to split up before storing locally. _s_p_l_i_t__c_h_u_n_k Size of chunks to split files into. [102400] _l_s__l_R__f_i_l_e Remote file containing ls-lR, otherwise run Sun Release 4.1 Last change: Mirror 2.6 5 MIRROR(1L) MISC. REFERENCE MANUAL PAGES MIRROR(1L) remote ls. _l_o_c_a_l__l_s__l_R__f_i_l_e Local file containing ls-lR, otherwise use remote _l_s__l_R__f_i_l_e. This is useful when first mirroring a large package. _r_e_c_u_r_s_i_v_e Do subdirectories as well. [true] _r_e_c_u_r_s_e__h_a_r_d Have to generate remote ls by doing cwd and ls for each subdirectory. In this case remote_dir must be absolute (begin with a /) not relative. Use the pwd command in ftp to find the path for the start of the remote archive area. (Not available if _r_e_m_o_t_e__f_s is vms.) [false] _f_l_a_g_s__r_e_c_u_r_s_i_v_e Flags to send to remote ls to do a recursive listing. _f_l_a_g_s__n_o_n_r_e_c_u_r_s_i_v_e Flags to send to remote ls to do a non- recursive listing. _r_e_m_o_t_e__f_s Remote file store type. Handles uuuunnnniiiixxxx, ddddllllssss, nnnneeeettttwwwwaaaarrrreeee, vvvvmmmmssss, ddddoooossssffffttttpppp, mmmmaaaaccccoooossss, llllssssppppaaaarrrrsssseeee and iiiinnnnffffoooommmmaaaacccc. See the FILESTORES section below for more details. [unix] _v_m_s__k_e_e_p__v_e_r_s_i_o_n_s When mirroring vms files, keep the version numbers. If false, the versions are stripped off and the only the base filenames are kept. [true] _v_m_s__x_f_e_r__t_e_x_t Pattern of vms files to transfer in TEXT mode (case insensitive). _n_a_m_e__m_a_p_p_i_n_g_s Remote to local pathname mappings (a perl ssss command, eg. s:old:new:). _e_x_t_e_r_n_a_l__m_a_p_p_i_n_g External routine to perform name mappings. _g_e_t__n_e_w_e_r Get the remote file if its date is newer than local. [true] _g_e_t__s_i_z_e__c_h_a_n_g_e Get the file if the size is different from local. If a file is compressed when fetched, the size is automatically ignored. [true] Sun Release 4.1 Last change: Mirror 2.6 6 MIRROR(1L) MISC. REFERENCE MANUAL PAGES MIRROR(1L) _c_o_m_p_r_e_s_s__p_a_t_t Regexp of files to compress before storing locally. See _g_e_t__s_i_z_e__c_h_a_n_g_e. _c_o_m_p_r_e_s_s__e_x_c_l Regexp of files not to compress (case insen- sitive). [\.(z|gz)$] _c_o_m_p_r_e_s_s__p_r_o_g Program to compress files. If set to the word compress or gzip, the full pathname and correct _c_o_m_p_r_e_s_s__s_u_f_f_i_x will automatically be set. When using gzip, level -9 is used. Note that _c_o_m_p_r_e_s_s__s_u_f_f_i_x can be reset to a non-standard value by setting it after _c_o_m_p_r_e_s_s__p_r_o_g. [compress] _c_o_m_p_r_e_s_s__s_u_f_f_i_x Character(s) the compress program appends to files. If _c_o_m_p_r_e_s_s__p_r_o_g is compress, this defaults to .Z. If _c_o_m_p_r_e_s_s__p_r_o_g is gzip, this defaults to .gz. _c_o_m_p_r_e_s_s__c_o_n_v__p_a_t_t If _c_o_m_p_r_e_s_s__p_r_o_g is gzip, files matching this pattern are uncompressed and gzip'ed before storing locally. Compression conversion is only meant to do compress to gzip conversion. [(\.Z|\.taz)$] _c_o_m_p_r_e_s_s__c_o_n_v__e_x_p_r Perl expression to convert suffix from compress to gzip style. [s/\.Z$/\.gz/;s/\.taz$/\.tgz/] _c_o_m_p_r_e_s_s__s_i_z_e__f_l_o_o_r Only compress files smaller than this size. [0] _f_o_r_c_e__t_i_m_e_s Force local times to match remote times. [yes] _r_e_t_r_y__c_a_l_l If initial connect fails, retry ONCE after ONE minute. This is to handle sites which reverse lookup the incoming host but some- times timeout on the first attempt. [yes] _u_p_d_a_t_e__l_o_g Filename, relative to _l_o_c_a_l__d_i_r, where an update report is to be kept. _m_a_i_l__t_o Mail a log of the work done to this comma separated list of people. _u_s_e_r User name or uid to give to local pathnames. Sun Release 4.1 Last change: Mirror 2.6 7 MIRROR(1L) MISC. REFERENCE MANUAL PAGES MIRROR(1L) _g_r_o_u_p Group name or gid to give to local pathnames. _f_i_l_e__m_o_d_e Mode to give files created locally. [0444] _d_i_r__m_o_d_e Mode to give directories created locally. [0755] _t_i_m_e_o_u_t Timeout ftp requests after this many seconds. [40] _f_t_p__p_o_r_t Port number of remote ftp daemon. [21] _p_r_o_x_y Set to 1 to use proxy ftp service. [0] _p_r_o_x_y__f_t_p__p_o_r_t Port number of proxy-service ftp daemon. This value should be changed depending on which proxy library you are using. [4514] _p_r_o_x_y__g_a_t_e_w_a_y Name of proxy-service, may also be supplied by the environment variable IIIINNNNTTTTEEEERRRRNNNNEEEETTTT____HHHHOOOOSSSSTTTT. [internet-gateway] _u_s_i_n_g__s_o_c_k_s Set to 1 if you are using a SOCKS version of perl. [0] _p_a_s_s_i_v_e__f_t_p Set to 1 if you want to use the PASV exten- sion of the FTP protocol. Especially useful with firewalls, other proxy FTP servers, and the variable _u_s_i_n_g__s_o_c_k_s. [0] _m_o_d_e__c_o_p_y Flag indicating if we need to copy the mode bits. [false] _i_n_t_e_r_a_c_t_i_v_e A non-batch transfer. Implied by ----gggg flag. [false] _t_e_x_t__m_o_d_e If true, files are transferred in text mode. Un*x prefers binary so that is the default. [false] _f_o_r_c_e If true, all files will be transferred regardless of size or time-stamp. [false] _g_e_t__f_i_l_e Perform get, not put by default. [true] _v_e_r_b_o_s_e Verbose messages. [false] _d_e_l_e_t_e__s_o_u_r_c_e Delete the source files and directories once transferred. (This is no longer supported.) [false] _d_i_s_c_o_n_n_e_c_t Disconnect from remote site at end of Sun Release 4.1 Last change: Mirror 2.6 8 MIRROR(1L) MISC. REFERENCE MANUAL PAGES MIRROR(1L) package. [false] _m_a_i_l__p_r_o_g Program called to send to the _m_a_i_l__t_o list. May be passed the argument _m_a_i_l__s_u_b_j_e_c_t. Defaults to mailx, Mail, mail or whatever is available on your system. _m_a_i_l__s_u_b_j_e_c_t mirror update _h_o_s_t_n_a_m_e Mirror automatically skips packages whose site variable matches this host. Defaults to the local hostname. _u_s_e__f_i_l_e_s Put the associative arrays that mirror uses into tmp files. [false] _u_m_a_s_k Do not allow setuid things across by default. [07000] _u_s_e__t_i_m_e_l_o_c_a_l Time-stamp files to local time zone. If false, the time zone is set to offset 0 (com- patible with older versions of mmmmiiiirrrrrrrroooorrrr). [true] _r_e_m_o_t_e__g_r_o_u_p If present set the remote 'site group'. _r_e_m_o_t_e__g_p_a_s_s If present set the remote 'site gpass'. _r_e_m_o_t_e__i_d_l_e If not null, try and set the remote idle timer to this. _m_a_k_e__b_a_d__s_y_m_l_i_n_k_s If true, symlinks will be made to invalid (non-existent) pathnames. Under older ver- sions this defaulted to true. [false] _f_o_l_l_o_w__l_o_c_a_l__s_y_m_l_i_n_k_s Regexp of pathnames that should be followed to the file or directory they point at. This makes local symlinks invisible to mmmmiiiirrrrrrrroooorrrr. _g_e_t__m_i_s_s_i_n_g Really get files. When set to false, only deletions and symlinking will be done. Used to delete expired files older than _m_a_x__d_a_y_s without retrieving older files. [true] Each group of keywords defines how to mirror a particular package and should begin with a unique _p_a_c_k_a_g_e line. The package name is used in report generation and by the ----pppp argument, so pick something mnemonic. The minimum needed for each package is the _p_a_c_k_a_g_e, _s_i_t_e, _r_e_m_o_t_e__d_i_r and _l_o_c_a_l__d_i_r. On finding a package line, all the default Sun Release 4.1 Last change: Mirror 2.6 9 MIRROR(1L) MISC. REFERENCE MANUAL PAGES MIRROR(1L) values are reset. If the package name is ddddeeeeffffaaaauuuullllttttssss, then no site is contacted, but the default values given for any keywords are changed. Normally all the defaults are in the file mmmmiiiirrrrrrrroooorrrr....ddddeeeeffffaaaauuuullllttttssss which will be automatically loaded before any package details. #### SSSSaaaammmmpppplllleeee mmmmiiiirrrrrrrroooorrrr....ddddeeeeffffaaaauuuullllttttssss ppppaaaacccckkkkaaaaggggeeee====ddddeeeeffffaaaauuuullllttttssss #### TTTThhhheeee LLLLOOOOCCCCAAAALLLL hhhhoooossssttttnnnnaaaammmmeeee ---- iiiiffff nnnnooootttt tttthhhheeee ssssaaaammmmeeee aaaassss ````hhhhoooossssttttnnnnaaaammmmeeee```` rrrreeeettttuuuurrrrnnnnssss #### ((((IIII aaaaddddvvvveeeerrrrttttiiiisssseeee tttthhhheeee nnnnaaaammmmeeee ssssrrrrcccc....ddddoooocccc....iiiicccc....aaaacccc....uuuukkkk bbbbuuuutttt tttthhhheeee mmmmaaaacccchhhhiiiinnnneeee iiiissss #### rrrreeeeaaaallllllllyyyy ppppuuuuffffffffiiiinnnn....ddddoooocccc....iiiicccc....aaaacccc....uuuukkkk....)))) hhhhoooossssttttnnnnaaaammmmeeee====ssssrrrrcccc....ddddoooocccc....iiiicccc....aaaacccc....uuuukkkk #### KKKKeeeeeeeepppp aaaallllllll llllooooccccaaaallll____ddddiiiirrrrssss rrrreeeellllaaaattttiiiivvvveeee ttttoooo hhhheeeerrrreeee llllooooccccaaaallll____ddddiiiirrrr====////ppppuuuubbbblllliiiicccc//// rrrreeeemmmmooootttteeee____ppppaaaasssssssswwwwoooorrrrdddd====uuuukkkkuuuuuuuugggg----ssssoooofffftttt@@@@ddddoooocccc....iiiicccc....aaaacccc....uuuukkkk If the package is not ddddeeeeffffaaaauuuullllttttssss, then mmmmiiiirrrrrrrroooorrrr will perform the following steps. Unless an internal failure is detected, any error will cause the current package to be skipped and the next one tried. If mmmmiiiirrrrrrrroooorrrr is not already connected to the site, it will disconnect from any site it is already connected to and attempt to connect to the remote site's ffffttttpppp daemon. It will then login using the given remote username and password. Once connected, mmmmiiiirrrrrrrroooorrrr turns on binary mode transfers. Next it changes to the given local directory and scans it to get the details of the local files that already exist. If necessary, the local directory will be created. Once this is completed, the remote directory is scanned in a similar fashion. MMMMiiiirrrrrrrroooorrrr does this by changing to the remote direc- tory and running the ftp LIST command, passing the _f_l_a_g_s__r_e_c_u_r_s_i_v_e options or _f_l_a_g_s__n_o_n_r_e_c_u_r_s_i_v_e depending on the value of _r_e_c_u_r_s_i_v_e. Alternatively a file containing the directory listing may be retrieved. Each remote pathname will have any specified mappings performed on it to create a local pathname. Then any checks specified by the _e_x_c_l_u_d_e__p_a_t_t, _m_a_x__d_a_y_s, _g_e_t__n_e_w_e_r and _g_e_t__s_i_z_e__c_h_a_n_g_e key- words are applied on names of files or symlinks. Only _e_x_c_l_u_d_e__p_a_t_t checking is applied to directories. The above creates a list of all required remote files and the local pathnames to store them in. Once the directory listing is completed, all required files are fetched from the remote site into their local path names. This is done by retrieving the file into a temporary file in the target directory. If required, the temporary file is compressed, gzip'ed or split (or compressed or gzip'ed and then split). The temporary file is renamed when Sun Release 4.1 Last change: Mirror 2.6 10 MIRROR(1L) MISC. REFERENCE MANUAL PAGES MIRROR(1L) the transfer is successful. FFFFIIIILLLLEEEESSSSTTTTOOOORRRREEEESSSS Mirror uses the remote directory listing to work out what files are available. Mirror was originally targetted con- nect to unix ftp daemons using a standard _l_s command. To use a unix host with a non-standard ls or a non unix host it is necessary to set the _r_e_m_o_t_e__f_s variable to match the kind of directory listing that will be returned. There is some interaction between _r_e_m_o_t_e__f_s and other variables in partic- ular _f_l_a_g_s__r_e_c_u_r_s_i_v_e, _r_e_c_u_r_s_e__h_a_r_d and _g_e_t__s_i_z_e__c_h_a_n_g_e. The following sub sections show examples of the results of run- ning the ftp _d_i_r command on the various kinds of archive and recommendations for related variables. With some unusually setups archive you may have to vary from the recommended variable setups. rrrreeeemmmmooootttteeee____ffffssss====uuuunnnniiiixxxx ttttoooottttaaaallll 66665555 ----rrrrwwww----rrrr--------rrrr-------- 1111 uuuukkkkuuuuuuuugggg uuuukkkkuuuuuuuugggg 2222222244445555 JJJJuuuunnnn 22228888 22220000::::00006666 RRRREEEEAAAADDDDMMMMEEEE ----rrrrwwww----rrrr--------rrrr-------- 1111 uuuukkkkuuuuuuuugggg uuuukkkkuuuuuuuugggg 66661111999944449999 JJJJuuuunnnn 22229999 11119999::::11113333 mmmmiiiirrrrrrrroooorrrr----2222....1111....ttttaaaarrrr....ggggzzzz This is the default and you should not normally have to reset any other variables. rrrreeeemmmmooootttteeee____ffffssss====ddddllllssss 00000000iiiinnnnddddeeeexxxx....ttttxxxxtttt 111188889999999911116666 0000rrrreeeeaaaaddddmmmmeeee 5555777799993333 1111____xxxx//// ==== OOOOSSSS////2222 1111....xxxx----ssssppppeeeecccciiiiffffiiiicccc ffffiiiilllleeeessss This is an _l_s variant used on some unix archives. It pro- vides descriptions of known items in the listing. Set _f_l_a_g_s__r_e_c_u_r_s_i_v_e to -dtR. rrrreeeemmmmooootttteeee____ffffssss====nnnneeeettttwwwwaaaarrrreeee ---- [[[[RRRR----------------FFFF--------]]]] jjjjrrrrdddd 1111666644446666 MMMMaaaayyyy 00007777 22221111::::44443333 iiiinnnnddddeeeexxxx dddd [[[[RRRR----------------FFFF--------]]]] jjjjrrrrdddd 555511112222 SSSSeeeepppp 00009999 11110000::::55552222 nnnneeeettttwwwwiiiirrrreeee dddd [[[[RRRR----------------FFFF--------]]]] jjjjrrrrdddd 555511112222 SSSSeeeepppp 00002222 00001111::::33331111 ppppkkkkttttddddrrrrvvvvrrrr dddd [[[[RRRRWWWWCCCCEEEE----FFFF--------]]]] jjjjrrrrdddd 555511112222 SSSSeeeepppp 00004444 11110000::::55555555 iiiinnnnccccoooommmmiiiinnnngggg or ----[[[[RRRR----------------FFFF--------]]]] 1111 jjjjrrrrdddd 1111666644446666 MMMMaaaayyyy 00007777 22221111::::44443333 iiiinnnnddddeeeexxxx dddd[[[[RRRR----------------FFFF--------]]]] 1111 jjjjrrrrdddd 555511112222 SSSSeeeepppp 00009999 11110000::::55552222 nnnneeeettttwwwwiiiirrrreeee dddd[[[[RRRR----------------FFFF--------]]]] 1111 jjjjrrrrdddd 555511112222 SSSSeeeepppp 00002222 00001111::::33331111 ppppkkkkttttddddrrrrvvvvrrrr This is used by Novell archives. Set _r_e_c_u_r_s_e__h_a_r_d to true and set _f_l_a_g_s__r_e_c_u_r_s_i_v_e to be nothing. See also _r_e_m_o_t_e__d_i_r. ddddoooossssffffttttpppp 00000000----iiiinnnnddddeeeexxxx....ttttxxxxtttt 6666,,,,444477771111 11113333::::55554444 7777////22220000////99993333 aaaallllaaaabbbbaaaammmmaaaa....ttttxxxxtttt 1111,,,,222244446666 22223333::::22229999 5555////00008888////99992222 aaaallllaaaasssskkkkaaaa....ttttxxxxtttt 888877773333 22223333::::22229999 5555////00008888////99992222 aaaallllbbbbeeeerrrrttttaaaa....ttttxxxxtttt 2222,,,,111166662222 22223333::::22229999 5555////00008888////99992222 Sun Release 4.1 Last change: Mirror 2.6 11 MIRROR(1L) MISC. REFERENCE MANUAL PAGES MIRROR(1L) dosftp is for an ftp daemon on dos boxes. Set _r_e_c_u_r_s_e__h_a_r_d to true and set _f_l_a_g_s__r_e_c_u_r_s_i_v_e to nothing. See also _r_e_m_o_t_e__d_i_r. rrrreeeemmmmooootttteeee____ffffssss====mmmmaaaaccccoooossss ----------------------------rrrr-------- 0000 111122227777 111122227777 AAAAuuuugggg 22227777 11113333::::55553333 !!!!GGGGoooopppphhhheeeerrrr LLLLiiiinnnnkkkkssss ddddrrrrwwwwxxxxrrrrwwwwxxxxrrrr----xxxx ffffoooollllddddeeeerrrr 33332222 SSSSeeeepppp 9999 11116666::::33330000 FFFFAAAAQQQQ ddddrrrrwwwwxxxxrrrrwwwwxxxx----wwwwxxxx ffffoooollllddddeeeerrrr 0000 SSSSeeeepppp 9999 00009999::::55559999 iiiinnnnccccoooommmmiiiinnnngggg macos is for one of Macintosh ftp daemon variants. Although the output is similar to unix it the unix _r_e_m_o_t_e__f_s type cannot cope with it because there are three file sizes for each file. Set_r_e_c_u_r_s_e__h_a_r_d to true, _f_l_a_g_s__r_e_c_u_r_s_i_v_e to nothing, _g_e_t__s_i_z_e__c_h_a_n_g_e to false and _c_o_m_p_r_e_s_s__p_a_t_t to noth- ing (this last setting is due to the unusual file names upsetting the shell used to run compress). See also _r_e_m_o_t_e__d_i_r. rrrreeeemmmmooootttteeee____ffffssss====vvvvmmmmssss UUUUSSSSEEEERRRRSSSS::::[[[[AAAANNNNOOOONNNNYYYYMMMMOOOOUUUUSSSS....PPPPUUUUBBBBLLLLIIIICCCC]]]] 1111----RRRREEEEAAAADDDDMMMMEEEE....FFFFIIIIRRRRSSSSTTTT;;;;11113333 9999 11114444----JJJJUUUUNNNN----1111999999993333 11113333::::00009999 [[[[AAAANNNNOOOONNNNYYYYMMMMOOOOUUUUSSSS]]]] ((((RRRRWWWWEEEE,,,,RRRRWWWWEEEE,,,,RRRREEEE,,,,RRRREEEE)))) PPPPAAAALLLLTTTTEEEERRRR....DDDDIIIIRRRR;;;;1111 1111 11118888----JJJJAAAANNNN----1111999999993333 11111111::::55556666 [[[[AAAANNNNOOOONNNNYYYYMMMMOOOOUUUUSSSS]]]] ((((RRRRWWWWEEEE,,,,RRRRWWWWEEEE,,,,RRRREEEE,,,,RRRREEEE)))) PPPPRRRREEEESSSSSSSS----RRRREEEELLLLEEEEAAAASSSSEEEESSSS....DDDDIIIIRRRR;;;;1111 1111 11111111----AAAAUUUUGGGG----1111999999992222 22220000::::00005555 [[[[AAAANNNNOOOONNNNYYYYMMMMOOOOUUUUSSSS]]]] ((((RRRRWWWWEEEE,,,,RRRRWWWWEEEE,,,,,,,,)))) alternatively: [[[[VVVVMMMMSSSSSSSSEEEERRRRVVVV....FFFFIIIILLLLEEEESSSS]]]]AAAALLLLAAAARRRRMMMM....DDDDIIIIRRRR;;;;1111 1111////3333 5555----MMMMAAAARRRR----1111999999993333 11118888::::00009999 [[[[VVVVMMMMSSSSSSSSEEEERRRRVVVV....FFFFIIIILLLLEEEESSSS]]]]AAAALLLLAAAARRRRMMMM....TTTTXXXXTTTT;;;;1111 1111////3333 4444----FFFFEEEEBBBB----1111999999993333 11112222::::22220000 Set _f_l_a_g_s__r_e_c_u_r_s_i_v_e to '[...]' and _g_e_t__s_i_z_e__c_h_a_n_g_e to false. _r_e_c_u_r_s_e__h_a_r_d is not available with vms. See also the _v_m_s__k_e_e_p__v_e_r_s_i_o_n_s and _v_m_s__x_f_e_r__t_e_x_t variables. rrrreeeemmmmooootttteeee____ffffssss====iiiinnnnffffoooommmmaaaacccc This is a special just meant to handle the sumex- aim.stanford.edu info-mac directory listing stored on that archive in help/all-files. _r_e_c_u_r_s_e__h_a_r_d should be set to true. rrrreeeemmmmooootttteeee____ffffssss====ddddoooossssiiiisssshhhh This is for a DOS/Windows FTP server with a faintly DOS like output 00003333----00004444----99994444 00008888::::44445555PPPPMMMM <<<>>> .... 00003333----00004444----99994444 00008888::::44445555PPPPMMMM <<<>>> ........ 00003333----00004444----99994444 00009999::::55558888AAAAMMMM 9999777711118888 CCCCoooonnnndddduuuuiiiitttt 00003333----00004444----99994444 00009999::::55559999AAAAMMMM 8888777744445555 EEEEvvvveeee Sun Release 4.1 Last change: Mirror 2.6 12 MIRROR(1L) MISC. REFERENCE MANUAL PAGES MIRROR(1L) _r_e_c_u_r_s_e__h_a_r_d should be set to true and _f_l_a_g_s__r_e_c_u_r_s_i_v_e to nothing. rrrreeeemmmmooootttteeee____ffffssss====llllssssppppaaaarrrrsssseeee Allow reparsing of the listing generated by mirror with debugging turned to a high level. Meant only for mirror wizards. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS Here is the mirror.defaults file from the archive on src.doc.ic.ac.uk: #### TTTThhhhiiiissss iiiissss tttthhhheeee ddddeeeeffffaaaauuuulllltttt mmmmiiiirrrrrrrroooorrrr sssseeeettttttttiiiinnnnggggssss uuuusssseeeedddd bbbbyyyy mmmmyyyy ssssiiiitttteeee:::: #### ssssrrrrcccc....ddddoooocccc....iiiicccc....aaaacccc....uuuukkkk ((((111144446666....111166669999....2222....1111)))) #### TTTThhhhiiiissss iiiissss hhhhoooommmmeeee ooooffff tttthhhheeee UUUUKKKKUUUUUUUUGGGG SSSSooooffffttttwwwwaaaarrrreeee DDDDiiiissssttttrrrriiiibbbbuuuuttttiiiioooonnnn SSSSeeeerrrrvvvviiiicccceeee ppppaaaacccckkkkaaaaggggeeee====ddddeeeeffffaaaauuuullllttttssss #### TTTThhhheeee LLLLOOOOCCCCAAAALLLL hhhhoooossssttttnnnnaaaammmmeeee ---- iiiiffff nnnnooootttt tttthhhheeee ssssaaaammmmeeee aaaassss ````hhhhoooossssttttnnnnaaaammmmeeee```` #### ((((IIII aaaaddddvvvveeeerrrrttttiiiisssseeee tttthhhheeee nnnnaaaammmmeeee ssssrrrrcccc....ddddoooocccc....iiiicccc....aaaacccc....uuuukkkk bbbbuuuutttt tttthhhheeee mmmmaaaacccchhhhiiiinnnneeee iiiissss #### rrrreeeeaaaallllllllyyyy ppppuuuuffffffffiiiinnnn....ddddoooocccc....iiiicccc....aaaacccc....uuuukkkk)))) hhhhoooossssttttnnnnaaaammmmeeee====ssssrrrrcccc....ddddoooocccc....iiiicccc....aaaacccc....uuuukkkk #### KKKKeeeeeeeepppp aaaallllllll llllooooccccaaaallll____ddddiiiirrrrssss rrrreeeellllaaaattttiiiivvvveeee ttttoooo hhhheeeerrrreeee llllooooccccaaaallll____ddddiiiirrrr====////ppppuuuubbbblllliiiicccc//// rrrreeeemmmmooootttteeee____ppppaaaasssssssswwwwoooorrrrdddd====uuuukkkkuuuuuuuugggg----ssssoooofffftttt@@@@ddddoooocccc....iiiicccc....aaaacccc....uuuukkkk mmmmaaaaiiiillll____ttttoooo==== #### DDDDoooonnnn''''tttt mmmmiiiirrrrrrrroooorrrr ffffiiiilllleeee mmmmooooddddeeeessss.... SSSSeeeetttt aaaallllllll ddddiiiirrrrssss////ffffiiiilllleeeessss ttttoooo tttthhhheeeesssseeee ddddiiiirrrr____mmmmooooddddeeee====0000777755555555 ffffiiiilllleeee____mmmmooooddddeeee====0000444444444444 #### BBBByyyy ddddeeeeffffaaaauuuulllltttt,,,, ffffiiiilllleeeessss aaaarrrreeee oooowwwwnnnneeeedddd bbbbyyyy rrrrooooooootttt....zzzzeeeerrrroooo uuuusssseeeerrrr====0000 ggggrrrroooouuuupppp====0000 #### #### KKKKeeeeeeeepppp aaaa lllloooogggg ffffiiiilllleeee iiiinnnn eeeeaaaacccchhhh uuuuppppddddaaaatttteeeedddd ddddiiiirrrreeeeccccttttoooorrrryyyy #### uuuuppppddddaaaatttteeee____lllloooogggg====....mmmmiiiirrrrrrrroooorrrr uuuuppppddddaaaatttteeee____lllloooogggg==== #### DDDDoooonnnn''''tttt oooovvvveeeerrrrwwwwrrrriiiitttteeee mmmmyyyy mmmmiiiirrrrrrrroooorrrr lllloooogggg wwwwiiiitttthhhh tttthhhheeee rrrreeeemmmmooootttteeee oooonnnneeee.... #### DDDDoooonnnn''''tttt rrrreeeettttrrrriiiieeeevvvveeee aaaannnnyyyy ooooffff tttthhhheeeeiiiirrrr mmmmiiiirrrrrrrroooorrrr tttteeeemmmmppppoooorrrraaaarrrryyyy ffffiiiilllleeeessss.... #### DDDDoooonnnn''''tttt ttttoooouuuucccchhhh aaaannnnyyyytttthhhhiiiinnnngggg wwwwhhhhoooosssseeee nnnnaaaammmmeeee bbbbeeeeggggiiiinnnnssss wwwwiiiitttthhhh aaaa ssssppppaaaacccceeee!!!! #### nnnnoooorrrr aaaannnnyyyy FFFFSSSSPPPP oooorrrr ggggoooopppphhhheeeerrrr ffffiiiilllleeeessss............ eeeexxxxcccclllluuuuddddeeee____ppppaaaatttttttt====((((^^^^||||////))))((((....mmmmiiiirrrrrrrroooorrrr$$$$||||....iiiinnnn........****....$$$$||||MMMMIIIIRRRRRRRROOOORRRR....LLLLOOOOGGGG||||####....****####||||....FFFFSSSSPPPP||||....ccccaaaacccchhhheeee||||....zzzziiiippppppppeeeedddd||||lllloooosssstttt++++ffffoooouuuunnnndddd////|||| )))) #### TTTTrrrryyyy ttttoooo ccccoooommmmpppprrrreeeessssssss eeeevvvveeeerrrryyyytttthhhhiiiinnnngggg ccccoooommmmpppprrrreeeessssssss____ppppaaaatttttttt====.... ccccoooommmmpppprrrreeeessssssss____pppprrrroooogggg====ccccoooommmmpppprrrreeeessssssss #### DDDDoooonnnn''''tttt ccccoooommmmpppprrrreeeessssssss iiiinnnnffffoooorrrrmmmmaaaattttiiiioooonnnn ffffiiiilllleeeessss,,,, ffffiiiilllleeeessss tttthhhhaaaatttt ddddoooonnnn''''tttt bbbbeeeennnneeeeffffiiiitttt ffffrrrroooommmm #### bbbbeeeeiiiinnnngggg ccccoooommmmpppprrrreeeesssssssseeeedddd,,,, ffffiiiilllleeeessss tttthhhhaaaatttt tttteeeellllllll ffffttttppppdddd,,,, ggggoooopppphhhheeeerrrr,,,, wwwwaaaaiiiissss............ ttttoooo ddddoooo tttthhhhiiiinnnnggggssss,,,, #### tttthhhheeee ssssoooouuuurrrrcccceeeessss ffffoooorrrr ccccoooommmmpppprrrreeeessssssssiiiioooonnnn pppprrrrooooggggrrrraaaammmmssss............ #### ((((NNNNooootttteeee tttthhhhiiiissss iiiissss tttthhhheeee oooonnnnllllyyyy rrrreeeeggggeeeexxxxpppp tttthhhhaaaatttt iiiissss ccccaaaasssseeee iiiinnnnsssseeeennnnssssiiiittttiiiivvvveeee....)))) ccccoooommmmpppprrrreeeessssssss____eeeexxxxccccllll++++||||^^^^....nnnnoooottttaaaarrrr$$$$||||----zzzz||||....ttttaaaazzzz$$$$||||....ttttaaaarrrr....ZZZZ||||....aaaarrrrcccc$$$$||||....zzzziiiipppp$$$$||||....llllzzzzhhhh$$$$||||....zzzzoooooooo$$$$||||....eeeexxxxeeee$$$$||||....llllhhhhaaaa$$$$||||....zzzzoooommmm$$$$||||....ggggiiiiffff$$$$||||....jjjjppppeeeegggg$$$$||||....jjjjppppgggg$$$$||||....mmmmppppeeeegggg$$$$||||....aaaauuuu$$$$||||rrrreeeeaaaadddd....****mmmmeeee||||iiiinnnnddddeeeexxxx||||....mmmmeeeessssssssaaaaggggeeee||||iiiinnnnffffoooo||||ffffaaaaqqqq ||||ggggzzzziiiipppp||||ccccoooommmmpppprrrreeeessssssss #### DDDDoooonnnn''''tttt ddddeeeelllleeeetttteeee oooowwwwnnnn mmmmiiiirrrrrrrroooorrrr lllloooogggg oooorrrr aaaannnnyyyy ....nnnnoooottttaaaarrrr ffffiiiilllleeeessss ((((iiiinnnnccccllll iiiinnnn ssssuuuubbbbddddiiiirrrrssss)))) ddddeeeelllleeeetttteeee____eeeexxxxccccllll====((((^^^^||||////))))....((((mmmmiiiirrrrrrrroooorrrr||||nnnnoooottttaaaarrrr))))$$$$ #### IIIIggggnnnnoooorrrreeee aaaannnnyyyy llllooooccccaaaallll rrrreeeeaaaaddddmmmmeeee ffffiiiilllleeeessss llllooooccccaaaallll____iiiiggggnnnnoooorrrreeee====RRRREEEEAAAADDDDMMMMEEEE....ddddoooocccc....iiiicccc #### AAAAuuuuttttoooommmmaaaattttiiiiccccaaaallllllllyyyy ddddeeeelllleeeetttteeee llllooooccccaaaallll ccccooooppppiiiieeeessss ooooffff ffffiiiilllleeeessss tttthhhhaaaatttt tttthhhheeee Sun Release 4.1 Last change: Mirror 2.6 13 MIRROR(1L) MISC. REFERENCE MANUAL PAGES MIRROR(1L) #### rrrreeeemmmmooootttteeee ssssiiiitttteeee hhhhaaaassss zzzzaaaappppppppeeeedddd ddddoooo____ddddeeeelllleeeetttteeeessss====ttttrrrruuuueeee Here are some sample package descriptions: ppppaaaacccckkkkaaaaggggeeee====ggggnnnnuuuu ccccoooommmmmmmmeeeennnntttt====PPPPoooowwwweeeerrrrffffuuuullll aaaannnndddd ffffrrrreeeeeeee UUUUnnnn****xxxx uuuuttttiiiilllliiiittttiiiieeeessss ssssiiiitttteeee====pppprrrreeeepppp....aaaaiiii....mmmmiiiitttt....eeeedddduuuu rrrreeeemmmmooootttteeee____ddddiiiirrrr====////ppppuuuubbbb////ggggnnnnuuuu #### LLLLooooccccaaaallll____ddddiiiirrrr++++ ccccaaaauuuusssseeeessss ggggnnnnuuuu ttttoooo bbbbeeee aaaappppppppeeeennnnddddeeeedddd ttttoooo tttthhhheeee ddddeeeeffffaaaauuuulllltttt llllooooccccaaaallll____ddddiiiirrrr #### ssssoooo mmmmaaaakkkkiiiinnnngggg ////ppppuuuubbbblllliiiicccc////ggggnnnnuuuu llllooooccccaaaallll____ddddiiiirrrr++++ggggnnnnuuuu eeeexxxxcccclllluuuuddddeeee____ppppaaaatttttttt++++||||^^^^LLLLiiiissssttttAAAArrrrcccchhhhiiiivvvveeeessss////||||^^^^lllloooosssstttt++++ffffoooouuuunnnndddd////||||^^^^sssscccchhhheeeemmmmeeee----7777....0000////||||^^^^....hhhhiiiissssttttoooorrrryyyy #### IIII tttteeeennnndddd ttttoooo oooonnnnllllyyyy kkkkeeeeeeeepppp tttthhhheeee llllaaaatttteeeesssstttt ccccoooouuuupppplllleeee ooooffff vvvveeeerrrrssssiiiioooonnnnssss ooooffff tttthhhhiiiinnnnggggssss #### tttthhhhiiiissss ssssttttooooppppssss mmmmiiiirrrrrrrroooorrrr ffffrrrroooommmm rrrreeeettttrrrriiiieeeevvvviiiinnnngggg tttthhhheeee oooollllddddeeeerrrr vvvveeeerrrrssssiiiioooonnnnssss IIII''''vvvveeee rrrreeeemmmmoooovvvveeeedddd mmmmaaaaxxxx____ddddaaaayyyyssss====33330000 ddddoooo____ddddeeeelllleeeetttteeeessss====ffffaaaallllsssseeee ppppaaaacccckkkkaaaaggggeeee====XXXX11111111RRRR5555 ccccoooommmmmmmmeeeennnntttt====XXXX WWWWiiiinnnnddddoooowwwwssss ((((wwwwiiiinnnnddddoooowwwwiiiinnnngggg ggggrrrraaaapppphhhhiiiiccccssss ssssyyyysssstttteeeemmmm ffffoooorrrr UUUUnnnn****xxxx)))) ssssiiiitttteeee====eeeexxxxppppoooorrrrtttt....llllccccssss....mmmmiiiitttt....eeeedddduuuu rrrreeeemmmmooootttteeee____ddddiiiirrrr====////ppppuuuubbbb////RRRR5555 llllooooccccaaaallll____ddddiiiirrrr++++ccccoooommmmppppuuuuttttiiiinnnngggg////ggggrrrraaaapppphhhhiiiiccccssss////ssssyyyysssstttteeeemmmmssss////XXXX11111111////ppppuuuubbbb////RRRR5555 #### TTTThhhhiiiissss iiiissss aaaa llllooooccccaaaallll ssssyyyymmmmlllliiiinnnnkkkk ttttoooo tttthhhheeee ffffrrrreeeeeeee----ffffoooorrrr----aaaallllllll ccccoooonnnnttttrrrriiiibbbb aaaarrrreeeeaaaa #### aaaannnndddd iiiissss mmmmiiiirrrrrrrroooorrrreeeedddd eeeellllsssseeeewwwwhhhheeeerrrreeee llllooooccccaaaallll____iiiiggggnnnnoooorrrreeee====^^^^ccccoooonnnnttttrrrriiiibbbb$$$$ #### DDDDoooonnnn''''tttt ccccoooommmmpppprrrreeeessssssss aaaa tttthhhhiiiinnnngggg.... IIIItttt iiiissss aaaallllrrrreeeeaaaaddddyyyy ccccoooommmmpppprrrreeeesssssssseeeedddd #### bbbbuuuutttt ddddooooeeeessssnnnn''''tttt llllooooooookkkk iiiitttt.... ccccoooommmmpppprrrreeeessssssss____ppppaaaatttttttt==== ppppaaaacccckkkkaaaaggggeeee====ccccnnnneeeewwwwssss ccccoooommmmmmmmeeeennnntttt====TTTThhhheeee CCCC NNNNeeeewwwwssss ssssyyyysssstttteeeemmmm ssssiiiitttteeee====ffffttttpppp....ccccssss....ttttoooorrrroooonnnnttttoooo....eeeedddduuuu rrrreeeemmmmooootttteeee____ddddiiiirrrr====////ppppuuuubbbb////cccc----nnnneeeewwwwssss llllooooccccaaaallll____ddddiiiirrrr++++ccccoooommmmppppuuuuttttiiiinnnngggg////uuuusssseeeennnneeeetttt////ssssooooffffttttwwwwaaaarrrreeee////ttttrrrraaaannnnssssppppoooorrrrtttt////cccc ccccoooommmmpppprrrreeeessssssss____eeeexxxxccccllll++++||||ppppaaaattttcccchhhheeeessss////PPPPAAAATTTTCCCCHHHHDDDDAAAATTTTEEEESSSS||||WWWWhhhheeeerrrreeeeFFFFrrrroooommmm #### TTTTHHHHIIIISSSS IIIISSSS JJJJUUUUSSSSTTTT AAAA TTTTEEEESSSSTTTT ppppaaaacccckkkkaaaaggggeeee====tttteeeesssstttt vvvvmmmmssss ssssiiiitttteeee ssssiiiitttteeee====vvvvmmmmssssbbbbooooxxxx....ssssoooommmmeeeewwwwhhhheeeerrrreeee....aaaacccc....uuuukkkk llllooooccccaaaallll____ddddiiiirrrr====////ttttmmmmpppp////ccccooooppppyyyy4444 rrrreeeemmmmooootttteeee____ddddiiiirrrr====vvvvmmmmsssssssseeeerrrrvvvv////ffffiiiilllleeeessss rrrreeeemmmmooootttteeee____ffffssss====vvvvmmmmssss #### MMMMuuuusssstttt ddddoooo tttthhhheeeesssseeee sssseeeettttttttiiiinnnnggggssss ffffoooorrrr VVVVMMMMSSSS ffffllllaaaaggggssss____rrrreeeeccccuuuurrrrssssiiiivvvveeee====[[[[............]]]] ggggeeeetttt____ssssiiiizzzzeeee____cccchhhhaaaannnnggggeeee====ffffaaaallllsssseeee #### aaaannnndddd oooonnnn,,,, aaaannnndddd oooonnnn ............ HHHHIIIINNNNTTTTSSSS On adding a new package, first check it out by turning on the ----nnnn option. Sun Release 4.1 Last change: Mirror 2.6 14 MIRROR(1L) MISC. REFERENCE MANUAL PAGES MIRROR(1L) If you are adding to an existing archive, then it is usually best to force the time-stamps of the existing local files so time comparisons with the remote files will work. Try and keep all packages that are being retrieved from the same site together. That way mmmmiiiirrrrrrrroooorrrr will only have to login once. Remember that all regexp's are Perl regular expressions. If the remote site contains symlinks that you want to "flat- ten out" into the corresponding files, then do this by changing the flags passed to the remote ls: _f_l_a_g_s__r_e_c_u_r_s_i_v_e++++L or _f_l_a_g_s__n_o_n_r_e_c_u_r_s_i_v_e++++L First test this by trying a llllssss ----llllRRRRaaaattttLLLL on the remote site under the ftp command to check whether the remote file-store has any symlink loops. If you are mirroring a very large site that changes infre- quently, add _m_a_x__d_a_y_s=7 to the settings after it is ini- tially mirrored. That way mirror will only have to consider recent files when updating. Then once a week, or whenever necessary, call mirror with ----kkkk_m_a_x__d_a_y_s=0 to force a full update. If you don't want to compress anything from the remote site the easiest way to do this is to set the _c_o_m_p_r_e_s_s__p_a_t_t to nothing. If you want to run a command at the end of mirroring a pack- age a useful trick is to reset the _m_a_i_l__p_r_o_g variable to be the program name and _m_a_i_l__t_o to be the arguments. For netware, dosftp, macos and VMS you should normally set remote_dir to be the home directory of the remote ftp dae- mon. Connect in manually and before changing directory use the pwd command to find where home is. If you are only mir- roring part of the tree then give the full path name includ- ing this home directory at the start. macos names can sometimes contain characters that make it hard to pass them through un*x shells. Since compressing files is done via a shell it would be best to turn off compression with compress_patt= macos files seem to always change size when transfered, in either binary or text mode. So it would be best to set get_size_change=false Sun Release 4.1 Last change: Mirror 2.6 15 MIRROR(1L) MISC. REFERENCE MANUAL PAGES MIRROR(1L) NNNNEEEETTTTIIIIQQQQUUUUEEEETTTTTTTTEEEE If you are going to mirror a remote site, please obey any restrictions that the site administrators place on access. You can generally find the restrictions on connecting to the archive using the standard ffffttttpppp command. Any restrictions are normally given as a login banner or in a (hopefully) obvious file. Here are, what I hope are, some good general rules: Only mirror a site well outside the working hours of both the local and remote sites. It is probably unfriendly to try to mirror a remote site more than once a day. Before trying to mirror a remote site, try and find the packages you want from local archives, as no one will be pleased if you soak up a lot of network bandwidth need- lessly. If you have a local archive, then tell people about it so they don't have to waste bandwidth and CPU at the remote site. Do remember to check your config-files from time to time in case the remote archive has changed their access restric- tions. Check the remote site regularly for any new restrictions. SSSSEEEEEEEE AAAALLLLSSSSOOOO perl(l), ftp(1), mm(1) BBBBUUUUGGGGSSSS Some of the netiquette guidelines should be enforced. Should be able to cope with links as well as symlinks. Suffers from _c_r_e_e_p_i_n_g _f_e_a_t_u_r_i_s_m. RRRREEEEMMMMEEEEMMMMBBBBEEEERRRR Objects in a mirror are closer than you think! AAAAUUUUTTTTHHHHOOOORRRR Written by Lee McLoughlin . It uses a heavily rewritten and extended version of the ftp.pl package originally by: Alan R. Martello which uses lchat.pl which is based on the chat2.pl package by: Randal L. Schwartz Sun Release 4.1 Last change: Mirror 2.6 16 MIRROR(1L) MISC. REFERENCE MANUAL PAGES MIRROR(1L) Special thanks to the following people for patches, comments and other suggestions that have helped to improve mirror. If I have omitted anyone, please contact me. James Revell Chris Myers Amos Shapira Paul A Vixie Jonathan Kamens Christian Andretzky Kean Stump Anita Eijs Simon E Sperro Aaron Wohl Michael Meissner Michael Graff Bradley Rhoades Edwards Reed Joachim Schrod David Woodgate Pieter Immelman Jost Krieger Erez HWank1 Zadok Sun Release 4.1 Last change: Mirror 2.6 17