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 设为 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