Provided by: manpages-zh_1.6.3.3-1_all bug

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  设为  false。recurse_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)