287.html

著名的linux英雄站点的文档打包

                       切割以便本地储存（档案名称同时也必须要符合  <br>
                       split_patt  选项）。[0]  <br>
  <br>
       spilt_patt      要储存在本地前需先分割之远端路径名称的正规  <br>
                       表示式。['']  <br>
  <br>
       split_chunk     档案所要切割成的大小。[102400]  <br>
  <br>
       ls_lR_file      包含 ls-lR  的远端档案，否则执行远端 ls 以  <br>
                       取得目录列表。['']  <br>
  <br>
       local_ls_lR_file  <br>
                       包含 ls-lR  的本地档案，否则使用远端节点的  <br>
                       ls_lR_file  取代。这在第一次映射一个很大的  <br>
                       档案包裹时有用。['']  <br>
  <br>
       recursive       执行范围包括子目录。[true]  <br>
  <br>
       recuese_hard    必须对每一个子目录执行 cwd  以及 ls 以产生  <br>
                       远端 ls 结果。在这种情形下 remote_dir 必须  <br>
                       是绝对的（从 /  开始）而非相对的。使用 ftp  <br>
                       里的 pwd  指令以找出远端档案区域之路径开始  <br>
                       处。（如果 remote_fs 是 vms 则不可使用。）  <br>
                       [false]  <br>
  <br>
       flags_recursive 传送给远端 ls 用以执行递回列出的旗标。  <br>
                       ['-lRat']  <br>
  <br>
       flags_nonrecursive  <br>
                       传送给远端 ls 用以执行非递回列出的旗标。  <br>
                       ['-lat']  <br>
  <br>
       remote_fs       远端档案储存型态。处理 unix, dls,  netware  <br>
                       vms, dosftp, macos, lsparse 以及 infomac。  <br>
                       细节参阅下面 FILESTORES 段落。[unix]  <br>
  <br>
       vms_keep_version  <br>
                       映射 vms 档案时，保留版本编号。若为 false  <br>
                       ，会抽离版本而只保留基本的档案名称。[true]  <br>
  <br>
       vms_xfer_text   要以文字模式(TEXT mode) 传输之 vms  档案的  <br>
                       样板（忽略大小写）。  <br>
                       ['readme$|info$|listing$|.c$']  <br>
  <br>
       name_mappings   远端到本地的路径名称对映（一个 perl s 指令  <br>
                       eg. s:old:new:）。['']  <br>
  <br>
       external_mapping  <br>
                       执行名称对映的外部函式。['']  <br>
  <br>
       get_newer       如果远端档案的日期比本地的新则取回。[true]  <br>
  <br>
       get_size_change 如果档案的大小与本地的不同则取回。如果档案  <br>
                       是在撷取时压缩的，则其大小会自动地忽略掉。  <br>
                       [true]  <br>
  <br>
       compress_patt   储存在本地之前要先压缩之档案的正规表示式。  <br>
                       参阅 get_size_change  选项。['']  <br>
  <br>
       compress_excl   不压缩之档案的正规表示式（忽略大小写）。  <br>
                       [.(z|gz)$]  <br>
  <br>
       compress_prog   用来压缩档案的程式。如果设为 compress 或是  <br>
                       gzip  这两个字的话，则将会自动地设定完整的  <br>
                       路径名称以及正确的 compress_suffix(副档名)  <br>
                       。使用 gzip 的时候，会使用第九级 (gzip -9)  <br>
                       压缩。注意到可以在 compress_prog  之後设定  <br>
                       compress_suffix 将其重设为非标准值。  <br>
                       [compress]  <br>
  <br>
       compress_suffix 压缩程式附加到档案後的字元。若压缩程式选项  <br>
                       compress_prog 为 compress 的话，则此预设值  <br>
                       为 .Z 。若 compress_prog  为 gzip 的话，则  <br>
                       此预设值为 .gz。['']  <br>
  <br>
       compress_conv_patt  <br>
                       如果 compress_prog  是 gzip 的话，符合这个  <br>
                       样板的档案会被解压缩并在本地储存前以  gzip  <br>
                       重新压缩。压缩转换只对 compress 到 gzip 此  <br>
                       转换有意义。[(.Z|.taz)$]  <br>
  <br>
       compress_conv_expr  <br>
                       把副档名从 compress 转为 gzip 形式的  perl  <br>
                       表示式。[s/.Z$/.gz/;s/.taz$/.tgz/]  <br>
  <br>
       compress_size_floor  <br>
                       只压缩比此数值小的档案。[0]  <br>
  <br>
       force_times     强制要求本地时间符合远端时间。[yes]  <br>
  <br>
       retry_call      如果初始连线失败，一分钟之後重试一次。这是  <br>
                       用来处理一些反向找寻(lookup)进入(incoming)  <br>
                       主机但有时会在第一次尝试时超过时间的节点。  <br>
                       [yes]  <br>
  <br>
       update_log      档案名称，系相对於 local_dir  选项之设定值  <br>
                       ，此处会保留一份更新报告。['']  <br>
  <br>
       mail_to         将一份系统执行工作记录寄给这个以逗点隔开之  <br>
                       列表上的人。['']  <br>
  <br>
       user            给予本地路径名称之使用者名称或使用者号码。  <br>
                       ['']  <br>
  <br>
       group           给予本地路径名称之群组名称或群组号码。['']  <br>
  <br>
       file_mode       给予本地建立之档案的权限。[0444]  <br>
  <br>
       dir_mode        给予本地建立之目录的权限。[0755]  <br>
  <br>
       timeout         在此秒数後结束 ftp  要求。[40]  <br>
  <br>
       ftp_port        远端 ftp  伺服程式的埠号。[21]  <br>
  <br>
       proxy           设为 1  以使用代理转接(proxy)式的 ftp 服务  <br>
                       。[0]  <br>
  <br>
       proxy_ftp_port  代理服务之 ftp  伺服程式的埠号。[4514]  <br>
  <br>
       proxy_gateway   代理服务之名称，也可用 INTERNET_HOST  变数  <br>
                       来提供。[internet-gateway]  <br>
  <br>
       mode_copy       指出是否需要拷贝模式位元(mode bits) 的旗标  <br>
                       。[false]  <br>
  <br>
       interactive     非批次(non-batch) 传输。系以 -g 旗标实作。  <br>
                       [false]  <br>
  <br>
       text_mode       如果为 true 的话，档案以文字模式传输。Un*x  <br>
                       较喜欢以二进位传输所以这是预设值。[false]  <br>
  <br>
       force           如果为 true 的话，所有档案都将被传输而不去  <br>
                       理会档案的大小或时间。[false]  <br>
  <br>
       get_file        以执行 get  而非 put  作为预设。[true]  <br>
  <br>
       verbose         冗馀讯息。[false]  <br>
  <br>
       delete_source   一旦传输完成後删除来源档案。（此选项已不再  <br>
                       支援。）[false]  <br>
  <br>
       disconnect      档案包裹结束後从远端节点结束连线。[false]  <br>
  <br>
       mail_prog       呼叫执行以将信件寄送给 mail_to  列表的程式  <br>
                       。可以传递 mail_subject 参数。预设为 mailx  <br>
                       Mail, mail  或任何在你的系统上可用的东西。  <br>
                       ['']  <br>
  <br>
       mail_subject    mirror update ['-s]  <br>
  <br>
       hostname        Mirror  自动地跳过节点名称符合此主机的档案  <br>
                       包裹。预设为本地主机名称。['']  <br>
  <br>
       use_files       将 mirroe 所使用的 associative arrays 放到  <br>
                       暂存档里。[false]  <br>
  <br>
       umask           预设不允许任何 setuid 的东西通过。[07000]  <br>
  <br>
       remote_group    如果存在则设定远端 'site group' 。['']  <br>
  <br>
       remote_gpass    如果存在则设定远端 'site gpass' 。['']  <br>
  <br>
       remote_idle     如果非空(not null)，则尝试并将远端闲置计时  <br>
                       (idle timer)设为此值。['']  <br>
  <br>
       make_bad_symlinks  <br>
                       如果为 true 的话，将会把符号链结连到不允许  <br>
                       （不存在）的路径名称。旧版预设值为 true 。  <br>
                       [false]  <br>
  <br>
       follow_local_symlinks  <br>
                       应该要跟从档案或是目录所指向处之路径名称的  <br>
                       正规表示式。这使得 mirror 不能够见到本地的  <br>
                       符号链结。['']  <br>
  <br>
       get_missing     确实取回档案。当设为 false  的时候，只执行  <br>
                       删除以及建立符号链结。用来删除比  max_days  <br>
                       更旧的过时档案而不必撷取这些旧档案。[true]  <br>
  <br>
       每一组关键字定义如何映射一份特定的档案包裹而且应该要以一行  <br>
       唯一的 package  开始。档案包裹的名称用在产生报告及 -p 参数  <br>
       上，所以应使用较具记忆性的名称。定义每个档案包裹所需的最小  <br>
       需求是 package, site, remote_dir 以及 local_dir 。一旦找到  <br>
       一行 package  叙述，所有的预设值都会重设。  <br>
  <br>
       如果 package  的名称是 defaults 的话，则不会连线到任何节点  <br>
       去，但是所给任何关键字的预设值都会改变。一般而言所有的预设  <br>
       值都在 mirror.defaults  这个将会在任何 package  细节前自动  <br>
       载入的档案里。  <br>
  <br>
              # Sample mirror.defaults  <br>
              package=defaults  <br>
                   # The LOCAL hostname - if not the same as `hostname` returns  <br>
                   # (I advertise the name src.doc.ic.ac.uk but the machine is  <br>
                   #  really puffin.doc.ic.ac.uk.)  <br>
                   hostname=src.doc.ic.ac.uk  <br>
                   # Keep all local_dirs relative to here  <br>
                   local_dir=/public/  <br>
                   remote_password=[e-mail]  <br>
  <br>
       如果档案包裹不是 defaults 的话，则 mirror 将会执行下列步骤  <br>
       。除非侦测出一个内部错误，任何错误都将会使得目前的档案包裹  <br>
       被跳过并且尝试下一个。  <br>
  <br>
       如果 mirror 并非已经连上该节点，它将会从任何已经连上的节点  <br>
       离线并尝试连线到远端节点的 ftp  伺服程式去。它接著将会使用  <br>
       所给的远端使用者名称及密码签入。一旦连上， mirror 开启二进  <br>
       位传输模式。接下来它切换到所给的本地目录并扫描之以取得已经  <br>
       存在的本地档案的细节。如果必要，将会建立本地目录。一旦这项  <br>
       作业完成，会以类似的方式扫描远端目录。 Mirror 系切换到远端  <br>
       目录并执行 ftp LIST 指令，然後依据 recursive  选项的值传递  <br>
       flags_recursive 选项或 flags_nonrecursive 选项来完成。此外  <br>
       也可以撷取一个包含有目录列表的档案。每一个远端路径名称都将  <br>
       会执行任何指定的对映(mapping) 以建立本地路径名称。然後任何  <br>
       由 exclude_patt, max_days, get_newer 以及  get_size_change  <br>
       关键字指定的检验都会施行在档案或符号链结上。只有  exclude-  <br>
       patt 检验会施行在子目录上。  <br>