mirror(1) General Commands Manual mirror(1) NAME mirror - SYNOPSIS mirror [flags] -gsite:pathname mirror [flags] [package-files] DESCRIPTION Mirror Perl ftp (time-stamps) (compress, gzip) (split) ftp mirror (target direction) (objects) Mirror (owner)(group) rdist(1) Mirror ('/') -r -g mirror.defaults mirror mirror PERLLIB mirror.defaults Mirror Un*x (like topsy) FLAGS -d -ppackage (package) (package) package (regexp) -R -p mirror -n -F dbm use_files -g : .*/.+ (pattern) .*/ '/' host:/fred / /fred host:/fred/ -r -krecursive=false -v mirror -T -U [] mirror local_dir (full) `pwd`/upload_log.day.month.year. -kkey=value (key/value) -m -kmode_copy=true -t -ktext_mode=true -f -kforce=true -ssite -ksite=site -uuser -kremote_user=user (echo) remote_password -L -G -P -C filename -P -G Package Files (hash) = + ampersand('&') ampersand square brackets package, site, remote_dir local_dir package [''] comment [''] skip commenting the entry out [''] site IP [''] remote_dir recursed_hard [''] local_dir [''] remote_user [anonymous] remote_password [user@localhostname] get_patt [.] exclude_patt [''] update_local get_patt local_dir/* [false] local_ignore (restricted)[''] do_deletes (destination) (source tree)[false] delete_patt delete_excl [.] delete_get_patt delete_patt get_patt[false] delete_excl [''] save_deletes save_dir [false] save_dir [Old] max_delete_files [10%] max_delete_dirs [10%] max_days >0 [0] split_max >0 split_patt [0] spilt_patt [''] split_chunk [102400] ls_lR_file ls-lR ls [''] local_ls_lR_file ls-lR ls_lR_file [''] recursive [true] recuese_hard cwd ls ls remote_dir / ftp pwd remote_fs vms [false] flags_recursive ls ['-lRat'] flags_nonrecursive ls ['-lat'] remote_fs unix, dls, netware vms, dosftp, macos, lsparse infomac FILESTORES [unix] vms_keep_version vms false [true] vms_xfer_text (TEXT mode) vms ['readme$|info$|listing$|.c$'] name_mappings perl s eg. s:old:new:[''] external_mapping [''] get_newer [true] get_size_change [true] compress_patt get_size_change [''] compress_excl [.(z|gz)$] compress_prog compress gzip compress_suffix() gzip (gzip -9) compress_prog compress_suffix [compress] compress_suffix compress_prog compress .Z compress_prog gzip .gz[''] compress_conv_patt compress_prog gzip gzip compress gzip [(.Z|.taz)$] compress_conv_expr compress gzip perl [s/.Z$/.gz/;s/.taz$/.tgz/] compress_size_floor [0] force_times [yes] retry_call (lookup)(incoming) [yes] update_log local_dir [''] mail_to [''] user [''] group [''] file_mode [0444] dir_mode [0755] timeout ftp [40] ftp_port ftp [21] proxy 1 (proxy) ftp [0] proxy_ftp_port ftp [4514] proxy_gateway INTERNET_HOST [internet-gateway] mode_copy (mode bits) [false] interactive (non-batch) -g [false] text_mode true Un*x [false] force true [false] get_file get put [true] verbose [false] delete_source [false] disconnect [false] mail_prog mail_to mail_subject mailx Mail, mail [''] mail_subject mirror update ['-s] hostname Mirror [''] use_files mirroe associative arrays [false] umask setuid [07000] remote_group 'site group' [''] remote_gpass 'site gpass' [''] remote_idle (not null) (idle timer)[''] make_bad_symlinks true true [false] follow_local_symlinks mirror [''] get_missing false max_days [true] package -p package, site, remote_dir local_dir package package defaults mirror.defaults package # Sample mirror.defaults package=defaults # The LOCAL hostname - if not the same as `hostname` returns # (I advertise the name src.doc.ic.ac.uk but the machine is # really puffin.doc.ic.ac.uk.) hostname=src.doc.ic.ac.uk # Keep all local_dirs relative to here local_dir=/public/ remote_password=ukuug-soft@doc.ic.ac.uk defaults mirror mirror ftp mirror Mirror ftp LIST recursive flags_recursive flags_nonrecursive (mapping) exclude_patt, max_days, get_newer get_size_change exclude- patt (compressed, gzip'ed) FILESTORES Mirror Mirror unix ftp ls ls unix unix remote_fs (return) (remote_fs) flags_recursive, recurse_hard get_size_change ftp dir remote_fs=unix total 65 -rw-r--r-- 1 ukuug ukuug 2245 Jun 28 20:06 README -rw-r--r-- 1 ukuug ukuug 61949 Jun 29 19:13 mirror-2.1.tar.gz remote_fs=dls 00index.txt 189916 0readme 5793 1_x/ = OS/2 1.x-specific files unix ls flags_recursive -dtR remote_fs=netware - [R----F--] jrd 1646 May 07 21:43 index d [R----F--] jrd 512 Sep 09 10:52 netwire d [R----F--] jrd 512 Sep 02 01:31 pktdrvr d [RWCE-F--] jrd 512 Sep 04 10:55 incoming Novell recurse_hard true flags_recursive (nothing) remote_dir dosftp 00-index.txt 6,471 13:54 7/20/93 alabama.txt 1,246 23:29 5/08/92 alaska.txt 873 23:29 5/08/92 alberta.txt 2,162 23:29 5/08/92 dosftp dos ftp recurse_hard true flags_recursive (nothing) remote_fs=macos -------r-- 0 127 127 Aug 27 13:53 !Gopher Links drwxrwxr-x folder 32 Sep 9 16:30 FAQ drwxrwx-wx folder 0 Sep 9 09:59 incoming macos (Macintosh) ftp unix unix remote_fs recurse_hard true, flags_ recursive (nothing)get_size_change false compress_patt shell remote_dir remote_fs=vms USERS:[ANONYMOUS.PUBLIC] 1-README.FIRST;13 9 14-JUN-1993 13:09 [ANONYMOUS] (RWE,RWE,RE,RE) PALTER.DIR;1 1 18-JAN-1993 11:56 [ANONYMOUS] (RWE,RWE,RE,RE) PRESS-RELEASES.DIR;1 1 11-AUG-1992 20:05 [ANONYMOUS] (RWE,RWE,,) alternatively: [VMSSERV.FILES]ALARM.DIR;1 1/3 5-MAR-1993 18:09 [VMSSERV.FILES]ALARM.TXT;1 1/3 4-FEB-1993 12:20 flags_recursive '[...]' get_size_change falserecurse_hard vms vms_keep_version vms_xfer_text remote_fs=infomac sumexaim.stanford.edu info-mac help/all-files recurse_hard true remote_fs=lsparse mirror mirror wizards EXAMPLES src.doc.ic.ac.uk mirror.defaults : # This is the default mirror settings used by my site: # src.doc.ic.ac.uk (146.169.2.1) # This is home of the UKUUG Software Distribution Service package=defaults # The LOCAL hostname - if not the same as `hostname` # (I advertise the name src.doc.ic.ac.uk but the machine is # really puffin.doc.ic.ac.uk) hostname=src.doc.ic.ac.uk # Keep all local_dirs relative to here local_dir=/public/ remote_password=ukuug-soft@doc.ic.ac.uk mail_to= # Don't mirror file modes. Set all dirs/files to these dir_mode=0755 file_mode=0444 # By default, files are owned by root.zero user=0 group=0 # # Keep a log file in each updated directory # update_log=.mirror update_log= # Don't overwrite my mirror log with the remote one. # Don't retrieve any of their mirror temporary files. # Don't touch anything whose name begins with a space! # nor any FSP or gopher files... exclude_patt=(^|/)(.mirror$|.in..*.$|MIRROR.LOG|#.*#|.FSP|.c ache|.zipped|lost+found/| ) # Try to compress everything compress_patt=. compress_prog=compress # Don't compress information files, files that don't benefit from # being compressed, files that tell ftpd, gopher, wais... to do things, # the sources for compression programs... # (Note this is the only regexp that is case insensitive.) compress_excl+|^.notar$|-z|.taz$|.tar.Z|.arc$|.zip$|.lzh$|.z oo$|.exe$|.lha$|.zom$|.gif$|.jpeg$|.jpg$|.mpeg$|.au$|read.*me|index|.message|in fo|faq|gzip|compress # Don't delete own mirror log or any .notar files (incl in s ubdirs) delete_excl=(^|/).(mirror|notar)$ # Ignore any local readme files local_ignore=README.doc.ic # Automatically delete local copies of files that the # remote site has zapped do_deletes=true Here are some sample package descriptions: package=gnu comment=Powerful and free Un*x utilities site=prep.ai.mit.edu remote_dir=/pub/gnu # Local_dir+ causes gnu to be appended to the default local_ dir # so making /public/gnu local_dir+gnu exclude_patt+|^ListArchives/|^lost+found/|^scheme-7.0/|^.his tory # I tend to only keep the latest couple of versions of thing s # this stops mirror from retrieving the older versions I've removed max_days=30 do_deletes=false package=X11R5 comment=X Windows (windowing graphics system for Un*x) site=export.lcs.mit.edu remote_dir=/pub/R5 local_dir+computing/graphics/systems/X11/pub/R5 # This is a local symlink to the free-for-all contrib area # and is mirrored elsewhere local_ignore=^contrib$ # Don't compress a thing. It is already compressed # but doesn't look it. compress_patt= package=cnews comment=The C News system site=ftp.cs.toronto.edu remote_dir=/pub/c-news local_dir+computing/usenet/software/transport/c compress_excl+|patches/PATCHDATES|WhereFrom # THIS IS JUST A TEST package=test vms site site=vmsbox.somewhere.ac.uk local_dir=/tmp/copy4 remote_dir=vmsserv/files remote_fs=vms # Must do these settings for VMS flags_recursive=[...] get_size_change=false # and on, and on ... -n force mirror Perl ("flatten out") ls flags_recursive+L flags_nonrecursive+L ftp ls -lRatL max_days=7 mirror -kmax_days=-0 mirror compress_patt (nothing) mail_prog mail_to netware, dosftp, macos vms remote_dir ftp home pwd home home macos un*x shells shell compress_patt= macos get_size_change=false (NETIQUETTE) ftp : CPU SEE ALSO perl(l), ftp(1), mm(1) BUGS Suffers from creeping featurism. NOTES mirror ! AUTHOR Written by Lee McLoughlin . It uses an extended version of the ftp.pl package originally by: Alan R. Martello which uses the chat2.pl pack- age by: Randal L. Schwartz Special thanks to the following people for patches, com- ments 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 Copyright (C) 1999 Best Linux. All rights reserved. Revised: 99-11-28. [] mirror-2.9.7(20031118) 1996+1999 http://sunsite.org.uk/packages/mirror/mirror.html [] 2001/01/01 Linux man : http://cmpp.linuxforum.net man man https://github.com/man-pages-zh/manpages- zh mirror(1)