mirror.html

站点映像程序

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

<TD ALIGN=LEFT VALIGN=TOP>Get the remote file if it is more recent that
the local file.</TD>
</TR>

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

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

<TD ALIGN=LEFT VALIGN=TOP>Get the file if the size is different from local.
If the file is to be <A HREF="#File Compression">compressed</A> after being
fetched <B><I>get_size_change</I></B> is automatically set to false.</TD>
</TR>

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

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

<TD ALIGN=LEFT VALIGN=TOP>If true, symlinks will be made to invalid (non-existent)
pathnames. (In older versions of <B>mirror</B> this defaulted to true.)</TD>
</TR>

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

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

<TD ALIGN=LEFT VALIGN=TOP><A HREF="#Regular Expressions">Regexp</A> of
pathnames of local symbolic links.&nbsp; Rather than treating them as symlinks
the target files or directories they reference are used instead. This makes
local symlinks invisible to <B>mirror</B>.</TD>
</TR>

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

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

<TD ALIGN=LEFT VALIGN=TOP>Really get files. When set to false, only deletions
and symlinking will be done. Used to delete expired files older than <B><I><A HREF="#max_days">max_days</A></I></B>
without retrieving older files.</TD>
</TR>

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

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

<TD ALIGN=LEFT VALIGN=TOP>Get files.&nbsp; If set to false <B>mirror</B>
will try to put files.</TD>
</TR>

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

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

<TD ALIGN=LEFT VALIGN=TOP>If true, all files are transferred in TEXT mode.
Un*x prefers binary so that is the default.</TD>
</TR>

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

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

<TD ALIGN=LEFT VALIGN=TOP>Strip carriage returns from any file as it is
retrieved.</TD>
</TR>

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

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

<TD ALIGN=LEFT VALIGN=TOP>When mirroring VMS files, keep the version numbers.
If false, the versions are stripped off and the only the base filenames
are kept.</TD>
</TR>

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

<TD ALIGN=LEFT VALIGN=TOP>(readme|info|listing|\.c)$</TD>

<TD ALIGN=LEFT VALIGN=TOP>Pattern of VMS files to transfer in TEXT mode
(case insensitive).</TD>
</TR>

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

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

<TD ALIGN=LEFT VALIGN=TOP>Remote to local pathname mappings (a <B>Perl</B>
substitute command, e.g. s:old:new:).</TD>
</TR>

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

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

<TD ALIGN=LEFT VALIGN=TOP>Specifies a file that should contain a Perl module
called <TT><FONT SIZE=+1>extmap</FONT></TT> containing at least a function
called <TT><FONT SIZE=+1>map</FONT></TT>.&nbsp; This function is used as
the <B><I><A HREF="#name_mappings">name_mappings</A></I></B> function.</TD>
</TR>

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

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

<TD ALIGN=LEFT VALIGN=TOP>Set <B><I><A HREF="#get_patt">get_patt</A></I></B>
to be all the files and directories already present in <B><I><A HREF="#local_dir">local_dir</A></I></B>.</TD>
</TR>

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

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

<TD ALIGN=LEFT VALIGN=TOP>If >0, ignore files older than this many days.&nbsp;
Any ignored files will not be transferred or deleted.</TD>
</TR>

<TR VALIGN=TOP>
<TD><B><I>max_size</I></B></TD>

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

<TD ALIGN=LEFT VALIGN=TOP>If >0, do not transfer any files any larger than
this many bytes.</TD>
</TR>

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

<TD>true</TD>

<TD>By default try and set the file attributes (e.g. time-stamps) of the
copied file.&nbsp; If false do not set attributes.&nbsp;</TD>
</TR>

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

<TR VALIGN=TOP>
<TD COLSPAN="3"><A NAME="Local File Attributes"></A><B><U><FONT SIZE=+1>Local
File Attributes&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="user"></A><B><I>user</I></B></TD>

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

<TD ALIGN=LEFT VALIGN=TOP>User name or uid to give to local pathnames.</TD>
</TR>

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

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

<TD ALIGN=LEFT VALIGN=TOP>Group name or gid to give to local pathnames.</TD>
</TR>

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

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

<TD ALIGN=LEFT VALIGN=TOP>Flag indicating if we need to copy the file/dir
modes.&nbsp; If this is false then <B><I><A HREF="#file_mode">file_mode</A></I></B>
and <B><I><A HREF="#dir_mode">dir_mode</A></I></B> will be used instead.</TD>
</TR>

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

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

<TD ALIGN=LEFT VALIGN=TOP>Mode to give files created locally if <B><I><A HREF="#mode_copy">mode_copy</A></I></B>
is false.</TD>
</TR>

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

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

<TD ALIGN=LEFT VALIGN=TOP>Mode to give directories created locally if <B><I><A HREF="#mode_copy">mode_copy</A></I></B>
is false.</TD>
</TR>

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

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

<TD ALIGN=LEFT VALIGN=TOP>If true, all files will be transferred regardless
of the results from size or time-stamp comparisons.</TD>
</TR>

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

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

<TD ALIGN=LEFT VALIGN=TOP>Do not create setuid files by default (see the
<B>chmod(1)</B> on Un*x).</TD>
</TR>

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

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

<TD ALIGN=LEFT VALIGN=TOP>Time-stamp files to local time zone. If false,
the time zone is set to GMT (older versions of <B>mirror</B> had a bug
setting all files to GMT).</TD>
</TR>

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

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

<TD ALIGN=LEFT VALIGN=TOP>Force local times to match remote times.</TD>
</TR>

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

<TR VALIGN=TOP>
<TD COLSPAN="3"><A NAME="File Deletion"></A><B><U><FONT SIZE=+1>File Deletion&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>do_deletes</I></B></TD>

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

<TD ALIGN=LEFT VALIGN=TOP>Delete destination files if not in source tree.</TD>
</TR>

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

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

<TD ALIGN=LEFT VALIGN=TOP><A HREF="#Regular Expressions">Regexp</A> of
local pathnames to check for deletions. Names that are not matched are
not checked. The match by <B><I><A HREF="#delete_excl">delete_excl</A>
</I></B>is done to all files selected by this pattern.</TD>
</TR>

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

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

<TD ALIGN=LEFT VALIGN=TOP>Set <A HREF="#delete_patt"><B><I>delete_patt</I></B>
</A>to be <B><I><A HREF="#get_patt">get_patt</A></I></B>.</TD>
</TR>

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

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

<TD ALIGN=LEFT VALIGN=TOP><A HREF="#Regular Expressions">Regexp</A> of
local pathnames that <B>mirror</B> will not delete.</TD>
</TR>

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

<TD ALIGN=LEFT VALIGN=TOP><I>10%</I></TD>

<TD ALIGN=LEFT VALIGN=TOP>If this is set to just a number and there are
more than this many files to delete, do not delete just warn. If this is
set to <I>number%</I> and the percentage of files that would be deleted
is greater than the number, do not delete just warn.</TD>
</TR>

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

<TD ALIGN=LEFT VALIGN=TOP><I>10%</I></TD>

<TD ALIGN=LEFT VALIGN=TOP>As <B><I><A HREF="#max_delete_files">max_delete_files</A></I></B>
except applies to directories.</TD>
</TR>

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

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

<TD ALIGN=LEFT VALIGN=TOP>Instead of deleting local files move them into
<B><I><A HREF="#save_dir">save_dir</A></I></B> .&nbsp;</TD>
</TR>

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

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

<TD ALIGN=LEFT VALIGN=TOP>Where local files no longer on remote site are
moved to.&nbsp; Either begins with / or is relative to <B><I>local_dir</I></B>.&nbsp;
Only used when <B><I><A HREF="#save_deletes">save_deletes</A></I></B> is
true.</TD>
</TR>

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

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