mirror.html

站点映像程序

<TD ALIGN=LEFT VALIGN=TOP>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.</TD>
</TR>

<TR>
<TD>&nbsp;</TD>
</TR>

<TR VALIGN=TOP>
<TD COLSPAN="3"><A NAME="File Compression"></A><B><U><FONT SIZE=+1>File
Compression&nbsp;</FONT></U></B></TD>
</TR>

<TR VALIGN=TOP>
<TD ALIGN=LEFT VALIGN=TOP><B><I><U>keyword</U></I></B></TD>

<TD ALIGN=LEFT VALIGN=TOP><I><U>default</U></I></TD>

<TD ALIGN=LEFT VALIGN=TOP><U>Description</U></TD>
</TR>

<TR VALIGN=TOP>
<TD ALIGN=LEFT VALIGN=TOP><A NAME="compress_patt"></A><B><I>compress_patt</I></B></TD>

<TD ALIGN=LEFT VALIGN=TOP><I>none</I></TD>

<TD ALIGN=LEFT VALIGN=TOP><A HREF="#Regular Expressions">Regexp</A> of
files to compress before storing locally. See <B><I><A HREF="#get_size_change">get_size_change</A></I></B>.</TD>
</TR>

<TR VALIGN=TOP>
<TD ALIGN=LEFT VALIGN=TOP><B><I>compress_excl</I></B></TD>

<TD ALIGN=LEFT VALIGN=TOP><I>\.(z|gz)$</I></TD>

<TD ALIGN=LEFT VALIGN=TOP><A HREF="#Regular Expressions">Regexp</A> of
files not to compress (case insensitive).</TD>
</TR>

<TR VALIGN=TOP>
<TD ALIGN=LEFT VALIGN=TOP><A NAME="compress_prog"></A><B><I>compress_prog</I></B></TD>

<TD ALIGN=LEFT VALIGN=TOP><I>compress</I></TD>

<TD ALIGN=LEFT VALIGN=TOP>Program to compress files. If set to the word
<B>compress</B> or <B>gzip</B>, the full pathname for the program and correct
<B><I>compress_suffix</I></B> will automatically be set. When using <B>gzip</B>,
level -9 is used. Note that <B><I><A HREF="#compress_suffix">compress_suffix</A>
</I></B>can be reset to a non-standard value by setting it after <B><I>compress_prog</I></B>.</TD>
</TR>

<TR VALIGN=TOP>
<TD ALIGN=LEFT VALIGN=TOP><A NAME="compress_suffix"></A><B><I>compress_suffix</I></B></TD>

<TD ALIGN=LEFT VALIGN=TOP><I>none</I></TD>

<TD ALIGN=LEFT VALIGN=TOP>Character(s) the compress program appends to
files. If <B><I><A HREF="#compress_prog">compress_prog</A></I></B> is <B>compress</B>,
this defaults to .Z. If <B><I><A HREF="#compress_prog">compress_prog</A></I></B>
is <B>gzip</B>, this defaults to .gz.</TD>
</TR>

<TR VALIGN=TOP>
<TD ALIGN=LEFT VALIGN=TOP><B><I>compress_conv_patt</I></B></TD>

<TD ALIGN=LEFT VALIGN=TOP><I>(\.Z|\.taz)$</I></TD>

<TD ALIGN=LEFT VALIGN=TOP>If <B><I><A HREF="#compress_prog">compress_prog
</A></I></B>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.</TD>
</TR>

<TR VALIGN=TOP>
<TD ALIGN=LEFT VALIGN=TOP><B><I>compress_conv_expr</I></B></TD>

<TD ALIGN=LEFT VALIGN=TOP><I>s/\.Z$/\.gz/;</I>&nbsp;
<BR><I>s/\.taz$/\.tgz/</I></TD>

<TD ALIGN=LEFT VALIGN=TOP><B>Perl</B> expression to convert suffix from
compress to gzip style. Change .Z to .gz and .taz to .tgz.</TD>
</TR>

<TR VALIGN=TOP>
<TD ALIGN=LEFT VALIGN=TOP><B><I>compress_size_floor</I></B></TD>

<TD ALIGN=LEFT VALIGN=TOP><I>0</I></TD>

<TD ALIGN=LEFT VALIGN=TOP>Do not compress files smaller than this size,
in bytes.</TD>
</TR>

<TR>
<TD>&nbsp;</TD>
</TR>

<TR VALIGN=TOP>
<TD COLSPAN="3"><A NAME="File Splitting"></A><B><U><FONT SIZE=+1>File Splitting&nbsp;</FONT></U></B></TD>
</TR>

<TR VALIGN=TOP>
<TD ALIGN=LEFT VALIGN=TOP><B><I><U>keyword</U></I></B></TD>

<TD ALIGN=LEFT VALIGN=TOP><I><U>default</U></I></TD>

<TD ALIGN=LEFT VALIGN=TOP><U>Description</U></TD>
</TR>

<TR VALIGN=TOP>
<TD ALIGN=LEFT VALIGN=TOP><B><I>split_max</I></B></TD>

<TD ALIGN=LEFT VALIGN=TOP><I>0</I></TD>

<TD ALIGN=LEFT VALIGN=TOP>If >0 and the size of the file is greater than
this many bytes, the file is split up to be stored locally (filename must
also match <B><I>split_patt</I></B>).&nbsp; The name of the file being
split up is used as the directory name and each part is stored in a file
called part1, part2... in that directory.</TD>
</TR>

<TR VALIGN=TOP>
<TD ALIGN=LEFT VALIGN=TOP><B><I>split_patt</I></B></TD>

<TD ALIGN=LEFT VALIGN=TOP><I>none</I></TD>

<TD ALIGN=LEFT VALIGN=TOP><A HREF="#Regular Expressions">Regexp</A> of
remote pathnames to split up before storing locally.</TD>
</TR>

<TR VALIGN=TOP>
<TD ALIGN=LEFT VALIGN=TOP><B><I>split_chunk</I></B></TD>

<TD ALIGN=LEFT VALIGN=TOP><I>102400</I></TD>

<TD ALIGN=LEFT VALIGN=TOP>Size, in bytes, of chunks to split files into.</TD>
</TR>

<TR>
<TD>&nbsp;</TD>
</TR>

<TR VALIGN=TOP>
<TD COLSPAN="3"><A NAME="Directory Listings"></A><B><U><FONT SIZE=+1>Directory
Listings</FONT></U></B>&nbsp;</TD>
</TR>

<TR VALIGN=TOP>
<TD ALIGN=LEFT VALIGN=TOP><B><I><U>keyword</U></I></B></TD>

<TD ALIGN=LEFT VALIGN=TOP><I><U>default</U></I></TD>

<TD ALIGN=LEFT VALIGN=TOP><U>Description</U></TD>
</TR>

<TR VALIGN=TOP>
<TD ALIGN=LEFT VALIGN=TOP><A NAME="remote_fs"></A><B><I>remote_fs</I></B></TD>

<TD ALIGN=LEFT VALIGN=TOP><I>unix</I></TD>

<TD ALIGN=LEFT VALIGN=TOP>File store type. Currently can be one of <B><A HREF="#remote_fs=unix">unix</A></B>,
<B><A HREF="#remote_fs=dls">dls</A></B>, <B><A HREF="#remote_fs=netware">netware</A></B>,
<B><A HREF="#remote_fs=vms">vms</A></B>, <B><A HREF="#remote_fs=dosftp">dosftp</A></B>,
<B><A HREF="#remote_fs=macos">macos</A></B>, <B><A HREF="#remote_fs=lsparse">lsparse</A></B>
and <B><A HREF="#remote_fs=infomac">infomac</A></B>. See the <A HREF="#Filestores">Filestores</A>
section for more details.</TD>
</TR>

<TR VALIGN=TOP>
<TD ALIGN=LEFT VALIGN=TOP><A NAME="ls_lR_file"></A><B><I>ls_lR_file</I></B></TD>

<TD ALIGN=LEFT VALIGN=TOP><I>none</I></TD>

<TD ALIGN=LEFT VALIGN=TOP>Remote file containing ls-lR (result of running
ls -lR on that machine), otherwise run remote <B>ls</B> command.</TD>
</TR>

<TR VALIGN=TOP>
<TD ALIGN=LEFT VALIGN=TOP><A NAME="local_ls_lR_file"></A><B><I>local_ls_lR_file</I></B></TD>

<TD ALIGN=LEFT VALIGN=TOP><I>none</I></TD>

<TD ALIGN=LEFT VALIGN=TOP>Local file containing ls-lR, otherwise use remote
<I><A HREF="#ls_lR_file">ls_lR_file</A></I>. This is useful when first
mirroring a large package.</TD>
</TR>

<TR VALIGN=TOP>
<TD ALIGN=LEFT VALIGN=TOP><A NAME="recursive"></A><B><I>recursive</I></B></TD>

<TD ALIGN=LEFT VALIGN=TOP><I>true</I></TD>

<TD ALIGN=LEFT VALIGN=TOP>Mirror both the contents of <B><I><A HREF="#local_dir">local_dir</A></I></B>
and sub directories of <B><I><A HREF="#local_dir">local_dir</A></I></B>.</TD>
</TR>

<TR VALIGN=TOP>
<TD ALIGN=LEFT VALIGN=TOP><A NAME="recurse_hard"></A><B><I>recurse_hard</I></B></TD>

<TD ALIGN=LEFT VALIGN=TOP><I>false</I></TD>

<TD ALIGN=LEFT VALIGN=TOP>Generate remote ls by doing CWD and ls for each
sub directory. In this case <B><I><A HREF="#remote_dir">remote_dir </A></I></B>must
be absolute (begin with a /) not relative. Use the CWD command in FTP to
find the path for the start of the remote archive area. (Not available
if <B><I><A HREF="#remote_fs">remote_fs</A></I></B> is VMS.)</TD>
</TR>

<TR VALIGN=TOP>
<TD ALIGN=LEFT VALIGN=TOP><A NAME="flags_recursive"></A><B><I>flags_recursive</I></B></TD>

<TD ALIGN=LEFT VALIGN=TOP><I>-lRat</I></TD>

<TD ALIGN=LEFT VALIGN=TOP>Flags to send to remote ls to do a recursive
listing.</TD>
</TR>

<TR VALIGN=TOP>
<TD ALIGN=LEFT VALIGN=TOP><A NAME="flags_nonrecursive"></A><B><I>flags_nonrecursive</I></B></TD>

<TD ALIGN=LEFT VALIGN=TOP><I>-lat</I></TD>

<TD ALIGN=LEFT VALIGN=TOP>Flags to send to remote ls to do a non-recursive
listing.</TD>
</TR>

<TR>
<TD><B><I>ls_fix_mappings</I></B></TD>

<TD><I>none</I></TD>

<TD>Edit pathnames in remote directory listings (a <B>Perl</B> substitute
command, e.g. s:/usr/spool/pub:/:).</TD>
</TR>

<TR>
<TD>&nbsp;</TD>
</TR>

<TR VALIGN=TOP>
<TD COLSPAN="3"><A NAME="Logging"></A><B><U><FONT SIZE=+1>Logging&nbsp;</FONT></U></B></TD>
</TR>

<TR VALIGN=TOP>
<TD ALIGN=LEFT VALIGN=TOP><B><I><U>keyword</U></I></B></TD>

<TD ALIGN=LEFT VALIGN=TOP><I><U>default</U></I></TD>

<TD ALIGN=LEFT VALIGN=TOP><U>Description</U></TD>
</TR>

<TR VALIGN=TOP>
<TD ALIGN=LEFT VALIGN=TOP><B><I>update_log</I></B></TD>

<TD ALIGN=LEFT VALIGN=TOP><I>none</I></TD>

<TD ALIGN=LEFT VALIGN=TOP>Filename, relative to <B><I><A HREF="#remote_dir">local_dir</A></I></B>,
where <B>mirror</B> will write a report of all it does to maintain a package.</TD>
</TR>

<TR VALIGN=TOP>
<TD ALIGN=LEFT VALIGN=TOP><A NAME="mail_to"></A><B><I>mail_to</I></B></TD>

<TD ALIGN=LEFT VALIGN=TOP><I>none</I></TD>

<TD ALIGN=LEFT VALIGN=TOP>Mail a log of the work done to this comma separated
list of addresses (currently only supported on Un*x).</TD>
</TR>

<TR VALIGN=TOP>
<TD ALIGN=LEFT VALIGN=TOP><A NAME="mail_prog"></A><B><I>mail_prog</I></B></TD>

<TD ALIGN=LEFT VALIGN=TOP><I>none</I></TD>

<TD ALIGN=LEFT VALIGN=TOP>Program called to send to the <B><I><A HREF="#mail_to">mail_to</A>
</I></B>list. May be passed the argument <B><I><A HREF="#mail_subject">mail_subject</A></I></B>.
Defaults to <B>mailx</B>, <B>Mail</B>, or <B>mail</B>. (Not supported under
Wind*ws)</TD>
</TR>

<TR VALIGN=TOP>
<TD ALIGN=LEFT VALIGN=TOP><A NAME="mail_subject"></A><B><I>mail_subject</I></B></TD>

<TD ALIGN=LEFT VALIGN=TOP><I>-s "mirror update"</I></TD>

<TD ALIGN=LEFT VALIGN=TOP>This can contain <B><I>$keyword</I></B>.&nbsp;
These will be replaced by the current value for that keyword (e.g.: -s
"mirror update: $package")</TD>
</TR>

<TR>
<TD>&nbsp;</TD>
</TR>

<TR VALIGN=TOP>
<TD COLSPAN="3"><A NAME="Special"></A><B><U><FONT SIZE=+1>Special</FONT></U></B>&nbsp;</TD>
</TR>

<TR VALIGN=TOP>
<TD ALIGN=LEFT VALIGN=TOP><B><I><U>keyword</U></I></B></TD>

<TD ALIGN=LEFT VALIGN=TOP><I><U>default</U></I></TD>

<TD ALIGN=LEFT VALIGN=TOP><U>Description</U></TD>
</TR>

<TR VALIGN=TOP>
<TD ALIGN=LEFT VALIGN=TOP><A NAME="hostname"></A><B><I>hostname</I></B></TD>

<TD ALIGN=LEFT VALIGN=TOP><I>none</I></TD>

<TD ALIGN=LEFT VALIGN=TOP><B>Mirror</B> automatically skips packages whose
<B><I><A HREF="#site">site</A></I></B> variable matches this host. Defaults
to the local hostname.&nbsp; This is normally only ever set in the <B><I><A HREF="#Setting Defaults">defaults</A></I></B>
package.&nbsp; Useful if you are sharing <B>mirror</B> <A HREF="#Package Files">package
files</A> with others.</TD>
</TR>

<TR VALIGN=TOP>
<TD ALIGN=LEFT VALIGN=TOP><B><I>comment</I></B></TD>

<TD ALIGN=LEFT VALIGN=TOP><I>none</I></TD>

<TD ALIGN=LEFT VALIGN=TOP>Used in reports.</TD>
</TR>

<TR VALIGN=TOP>
<TD ALIGN=LEFT VALIGN=TOP><B><I>use_files</I></B></TD>

<TD ALIGN=LEFT VALIGN=TOP><I>false</I></TD>

<TD ALIGN=LEFT VALIGN=TOP>Put the associative arrays that <B>mirror</B>
uses into temporary files (currently only support on Un*x).&nbsp; The files
are created in /var/tmp with names: local_map and remote_map.&nbsp; The
suffixes will depend on which DBM library was set as default when <B>Perl</B>
was installed on your machine.</TD>
</TR>

<TR VALIGN=TOP>
<TD ALIGN=LEFT VALIGN=TOP><B><I>interactive</I></B></TD>

<TD ALIGN=LEFT VALIGN=TOP><I>false</I></TD>