mirror.html

站点映像程序

<H2>
<A NAME="Package Files"></A>Package Files</H2>
Each group of keywords defines how to mirror a particular package and should
begin with a unique <B><I><A HREF="#package">package</A></I></B> line.
The package name is used in report generation and by the <B><A HREF="#-p">-p</A></B>
argument, so pick something mnemonic. The minimum needed for each package
is <B><I><A HREF="#package">package</A></I></B>, <B><I><A HREF="#site">site</A></I></B>,
<B><I><A HREF="#remote_dir">remote_dir</A></I></B> and <B><I><A HREF="#local_dir">local_dir</A></I></B>
. On finding a <B><I><A HREF="#package">package</A></I></B> line, all the
default values are reset to either the values from the <B><I><A HREF="#Setting Defaults">defaults</A></I></B>
package (or built-in values if defaults has not been set).&nbsp; A package
ends at either the next <B><I><A HREF="#package">package</A></I></B> statement
or at the end of file.

<P>Package files are parsed as a series of statements. Blank lines and
lines beginning with a hash are ignored. Each statement is of the form
<UL><B><I>keyword</I>=value</B></UL>
or
<UL><B><I>keyword</I>+value</B></UL>
&nbsp;You can add whitespace before the keyword and the equals/plus. Everything
immediately following the equals/plus is the value, including any leading
or trailing whitespace. The equals version sets the keyword to this value,
while the plus version concatenates the value onto the end of the existing
value (normally set in <B><I><A HREF="#Setting Defaults">defaults</A></I></B>
package).

<P>A statement can be continued over multiple lines by ending all lines
except the last, with the character ampersand ('&amp;'). The line following
the ampersand, is appended to the current line with all leading whitespace
removed.

<P>Although there are a lot of keywords that can be set, the built-in defaults
will handle most cases. Normally only <B><I><A HREF="#package">package</A></I></B>,&nbsp;
<B><I><A HREF="#site">site</A></I></B>,&nbsp; <B><I><A HREF="#remote_dir">remote_dir</A></I></B>
and <B><I><A HREF="#local_dir">local_dir</A></I></B> need to be set.
<H3>
<A NAME="Setting Defaults"></A>Setting Defaults</H3>
If the package name is <B>defaults</B>, then no site is contacted, but
the default values given for any keywords are changed. Normally all the
defaults are in the file <B>mirror.defaults</B> which will be automatically
loaded before any <A HREF="#Package Files">package files</A> (see <A HREF="#Finding Defaults">Description</A>).
<PRE><TT># Sample mirror.defaults
package=defaults
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; # The LOCAL hostname - if not the same as `hostname` returns
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; # (I advertise the name sunsite.org.uk but the machine is
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; #&nbsp; really swallow.doc.ic.ac.uk.)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; hostname=sunsite.org.uk
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; # Keep all local_dirs relative to here
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; local_dir=/public/
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; remote_password=[e-mail]</TT></PRE>

<H3>
<A NAME="Keywords"></A>Keywords</H3>
The following is a list of all the available keywords and the default values
built into <B>mirror</B>.&nbsp; To change these defaults it is usually
best to change your <B><A HREF="#Setting Defaults">mirror.defaults </A></B>file.
<BR>&nbsp;
<BR>The keywords are grouped into the following sections:
<UL>
<LI>
<A HREF="#Required Keywords">Required Keywords</A></LI>

<LI>
<A HREF="#FTP Related">FTP Related</A></LI>

<LI>
<A HREF="#File Copying">File Copying</A></LI>

<LI>
<A HREF="#Local File Attributes">Local File Attributes</A></LI>

<LI>
<A HREF="#File Deletion">File Deletion</A></LI>

<LI>
<A HREF="#File Compression">File Compression</A></LI>

<LI>
<A HREF="#File Splitting">File Splitting</A></LI>

<LI>
<A HREF="#Directory Listings">Directory Listings</A></LI>

<LI>
<A HREF="#Logging">Logging</A></LI>

<LI>
<A HREF="#Special">Special</A></LI>
</UL>
&nbsp;
<TABLE NOSAVE >
<TR VALIGN=TOP>
<TD COLSPAN="3"><A NAME="Required Keywords"></A><B><U><FONT SIZE=+1>Required
Keywords&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="package"></A><B><I>package</I></B></TD>

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

<TD ALIGN=LEFT VALIGN=TOP>A name for the package to be mirrored.&nbsp;
Should be different from all other package names you use.</TD>
</TR>

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

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

<TD ALIGN=LEFT VALIGN=TOP>Hostname or IP address of the remote site to
mirror from.</TD>
</TR>

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

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

<TD ALIGN=LEFT VALIGN=TOP>Remote directory to mirror. See also <B><I><A HREF="#recurse_hard">recurse_hard</A></I></B>.</TD>
</TR>

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

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

<TD ALIGN=LEFT VALIGN=TOP>Local directory.</TD>
</TR>

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

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

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

<TD ALIGN=LEFT VALIGN=TOP>Username to use at remote site.</TD>
</TR>

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

<TD ALIGN=LEFT VALIGN=TOP><I>localuser@localhostname</I></TD>

<TD ALIGN=LEFT VALIGN=TOP>Password to use at remote site.&nbsp; Note: <I>localuser</I>
is will be your name and <I>localhostname</I> will be the name of the local
machine (if it can be found, see <B><I><A HREF="#hostname">hostname</A></I></B>)</TD>
</TR>

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

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

<TD ALIGN=LEFT VALIGN=TOP>Account name/password to use at remote site,
after logging in anonymously (for systems that require it).</TD>
</TR>

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

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

<TD ALIGN=LEFT VALIGN=TOP>If present set the remote 'site group'.&nbsp;</TD>
</TR>

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

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

<TD ALIGN=LEFT VALIGN=TOP>If present set the remote 'site gpass'.&nbsp;</TD>
</TR>

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

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

<TD ALIGN=LEFT VALIGN=TOP>Timeout FTP requests after this many seconds.&nbsp;</TD>
</TR>

<TR VALIGN=TOP>
<TD ALIGN=LEFT VALIGN=TOP><A NAME="failed_gets_excl"></A><B><I>failed_gets_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
error messages to skip reporting, when the FTP GET command fails.&nbsp;
(E.g. permission denied.)</TD>
</TR>

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

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

<TD ALIGN=LEFT VALIGN=TOP>Port number of remote FTP daemon.&nbsp;</TD>
</TR>

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

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

<TD ALIGN=LEFT VALIGN=TOP>Set to true to use proxy FTP service.&nbsp;</TD>
</TR>

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

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

<TD ALIGN=LEFT VALIGN=TOP>Port number of proxy-service FTP daemon. This
value should be changed depending on which proxy library you are using.&nbsp;</TD>
</TR>

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

<TD ALIGN=LEFT VALIGN=TOP><I>internet-gateway</I></TD>

<TD ALIGN=LEFT VALIGN=TOP>Name of proxy-service, may also be supplied by
the environment variable <B>INTERNET_HOST</B>.&nbsp;</TD>
</TR>

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

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

<TD ALIGN=LEFT VALIGN=TOP>Set to true if you are using a SOCKS version
of <B>Perl</B>.&nbsp;</TD>
</TR>

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

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

<TD ALIGN=LEFT VALIGN=TOP>Set to true if you want to use the PASV extension
of the FTP protocol. Especially useful with firewalls, other proxy FTP
servers, and the variable <B><I><A HREF="#using_socks">using_socks</A></I></B>.&nbsp;</TD>
</TR>

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

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

<TD ALIGN=LEFT VALIGN=BASELINE>If initial connect fails, retry ONCE after
ONE minute. This is to handle sites which reverse lookup the incoming host
but sometimes timeout on the first attempt.&nbsp;</TD>
</TR>

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

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

<TD ALIGN=LEFT VALIGN=TOP>Disconnect from remote site at end of package.&nbsp;
Normally only disconnects if the next <B><I><A HREF="#package">package</A></I></B>
specifies a different site.&nbsp; (Some sites will not let you change to
certain directories except when first connecting in.)</TD>
</TR>

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

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

<TD ALIGN=LEFT VALIGN=TOP>If set try and set the remote idle timer to this.</TD>
</TR>

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

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

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

<TD ALIGN=LEFT VALIGN=TOP><A HREF="#Regular Expressions">Regexp</A> of
remote pathnames to retrieve.</TD>
</TR>

<TR VALIGN=TOP>
<TD ALIGN=LEFT VALIGN=TOP><A NAME="exclude_patt"></A><B><I>exclude_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 ignore.</TD>
</TR>

<TR VALIGN=TOP>
<TD ALIGN=LEFT VALIGN=TOP><B><I>local_ignore</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 to ignore. Useful to skip restricted local directories.</TD>
</TR>

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