178 lines
8.0 KiB
HTML
178 lines
8.0 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
|
<HTML>
|
|
<HEAD>
|
|
<META http-equiv="Content-Type" content="text/html; charset=Windows-1252">
|
|
<TITLE>-u (Update options) switch</TITLE>
|
|
<LINK href="style.css" rel="stylesheet" type="text/css">
|
|
</HEAD>
|
|
|
|
<BODY>
|
|
|
|
<H1>-u (Update options) switch</H1>
|
|
|
|
<P>Specifies how to update files in an archive and (or) how to create new archives.</P>
|
|
|
|
<H4>Syntax</H4>
|
|
|
|
<PRE class="syntax">
|
|
-u<A class="parameter" href="#disable_base_archive">[-]</A><action_set><A class="parameter" href="#new_archive_name">[!{new_archive_name}]</A>
|
|
|
|
<action_set> ::= <state_action>...
|
|
|
|
<state_action> ::= <A class="parameter" href="#state"><state></A><A class="parameter" href="#state"><action></A>
|
|
|
|
<A class="parameter" href="#action"><state></A> ::= p | q | r | x | y | z | w
|
|
|
|
<A class="parameter" href="#action"><action></A> ::= 0 | 1 | 2 | 3
|
|
</PRE>
|
|
|
|
|
|
<H4>Parameters</H4>
|
|
|
|
<DL>
|
|
<DT><A name="disable_base_archive"></A>dash (-)</DT>
|
|
<DD><P>Disables any updates in the base archive.</P>
|
|
|
|
<P>The term <B>base archive</B> means the archive assigned by "base_archive_name"
|
|
on the command line. See <A href="../syntax.htm">Command line syntax</A>
|
|
for more details.</P>
|
|
</DD>
|
|
<DT><A name="new_archive_name"></A>{new_archive_name}</DT>
|
|
<DD><P>Specifies the path name of the new archive to be created.
|
|
All options in this switch will refer to this new archive.</P>
|
|
<P>If not assigned, then all options in this switch will
|
|
refer to the base archive of the command.</P>
|
|
</DD>
|
|
<DT><A name="state"></A><state></DT>
|
|
<DD><P>Specifies the state of a particular file to be processed.</P>
|
|
<PRE class="syntax"><state> ::= p | q | r | x | y | z | w</PRE>
|
|
<P>For each unique filename there are 6 variants of state:</P>
|
|
<TABLE>
|
|
<TR> <TH><state></TH> <TH>State condition</TH>
|
|
<TH width="20%">File on Disk</TH> <TH width="20%">File in Archive</TH> </TR>
|
|
|
|
<TR> <TD align="center">p</TD> <TD>File exists in archive, but is not matched with wildcard.</TD>
|
|
<TD> </TD> <TD>Exists, but is not matched</TD> </TR>
|
|
|
|
<TR> <TD align="center">q</TD> <TD>File exists in archive, but doesn't exist on disk.</TD>
|
|
<TD>Doesn't exist</TD> <TD>Exists</TD> </TR>
|
|
|
|
<TR> <TD align="center">r</TD> <TD>File doesn't exist in archive, but exists on disk.</TD>
|
|
<TD>Exists</TD> <TD>Doesn't exist</TD> </TR>
|
|
|
|
<TR> <TD align="center">x</TD> <TD>File in archive is newer than the file on disk.</TD>
|
|
<TD>Older</TD> <TD>Newer</TD> </TR>
|
|
|
|
<TR> <TD align="center">y</TD> <TD>File in archive is older than the file on disk.</TD>
|
|
<TD>Newer</TD> <TD>Older</TD> </TR>
|
|
|
|
<TR> <TD align="center">z</TD> <TD>File in archive is same as the file on disk</TD>
|
|
<TD>Same</TD> <TD>Same</TD> </TR>
|
|
|
|
<TR> <TD align="center">w</TD> <TD>Can not be detected what file is newer
|
|
(times are the same, sizes are different)</TD>
|
|
<TD>?</TD> <TD>?</TD> </TR>
|
|
</TABLE>
|
|
</DD>
|
|
|
|
<DT><A name="action"></A><action></DT>
|
|
<DD><P>Specifies the action for a given <A class="parameter" href="#state"><state></A>.</P>
|
|
<PRE class="syntax"><action> ::= 0 | 1 | 2 | 3</PRE>
|
|
<P>For each state you can specify one of the three variants of actions:</P>
|
|
<TABLE>
|
|
<TR> <TH><action></TH> <TH>Description</TH></TR>
|
|
<TR> <TD align="center">0</TD> <TD>Ignore file (don't create item in new archive for this file)</TD></TR>
|
|
<TR> <TD align="center">1</TD> <TD>Copy file (copy from old archive to new)</TD></TR>
|
|
<TR> <TD align="center">2</TD> <TD>Compress (compress file from disk to new archive)</TD></TR>
|
|
<TR> <TD align="center">3</TD> <TD>Create Anti-item (item that will delete file or directory during extracting). This feature is supported only in 7z format.</TD></TR>
|
|
</TABLE>
|
|
</DD>
|
|
</DL>
|
|
|
|
|
|
<H4>Remarks</H4>
|
|
|
|
<P>Any update command (such as <A href="../commands/add.htm">a (Add)</A>,
|
|
<A href="../commands/delete.htm">d (Delete)</A>,
|
|
<A href="../commands/update.htm">u (Update)</A>) can be assigned in these terms.</P>
|
|
<P>The following table shows action sets for update commands.</P>
|
|
|
|
<TABLE>
|
|
<TR> <TH>command \ <A class="parameter" href="#state"><state></A></TH>
|
|
<TH>p</TH> <TH>q</TH> <TH>r</TH> <TH>x</TH> <TH>y</TH> <TH>z</TH> <TH>w</TH></TR>
|
|
<TR> <TH><A href="../commands/delete.htm">d (Delete)</A></TH> <TD>1</TD> <TD>0</TD> <TD>0</TD> <TD>0</TD> <TD>0</TD> <TD>0</TD> <TD>0</TD></TR>
|
|
<TR> <TH><A href="../commands/add.htm">a (Add)</A></TH> <TD>1</TD> <TD>1</TD> <TD>2</TD> <TD>2</TD> <TD>2</TD> <TD>2</TD> <TD>2</TD></TR>
|
|
<TR> <TH><A href="../commands/update.htm">u (Update)</A></TH> <TD>1</TD> <TD>1</TD> <TD>2</TD> <TD>1</TD> <TD>2</TD> <TD>1</TD> <TD>2</TD></TR>
|
|
<TR> <TH>Freshen</TH> <TD>1</TD> <TD>1</TD> <TD>0</TD> <TD>1</TD> <TD>2</TD> <TD>1</TD> <TD>2</TD></TR>
|
|
<TR> <TH>Synchronize</TH> <TD>1</TD> <TD>0</TD> <TD>2</TD> <TD>1</TD> <TD>2</TD> <TD>1</TD> <TD>2</TD></TR>
|
|
</TABLE>
|
|
|
|
|
|
<P>If you don't specify a
|
|
<A class="parameter" href="#new_archive_name"><I>!{new_archive_name}</I></A> option, then
|
|
all options will refer to the main archive (the archive assigned on the command line after the 7z command).
|
|
If you specify <A class="parameter" href="#new_archive_name"><I>!{new_archive_name}</I></A>
|
|
option, then 7-Zip also will create a new archive with the specified name and all options
|
|
will refer to that new archive.</P>
|
|
|
|
<P>Multiple update switches are supported.
|
|
7-Zip can create any number of new archives during one operation.</P>
|
|
|
|
<P>By default, the action set for each new archive is assigned
|
|
as the action set of the main command. There are 3 different
|
|
action sets for commands: <A href="../commands/add.htm">a (Add)</A>,
|
|
<A href="../commands/delete.htm">d (Delete)</A>,
|
|
<A href="../commands/update.htm">u (Update)</A>.
|
|
You can overload any <state_action> pair.</P>
|
|
|
|
<H4>Time zone notes</H4>
|
|
<P>If you change time zone (when you move your computer to another time zone
|
|
or if there are clock changes for daylight saving in your zone), you can have some problems
|
|
with update commands that depend from file's modification time. It's strongly recommended to use only
|
|
file system that uses Coordinated Universal Time (UTC) and archive format that also uses UTC.
|
|
In that case you will have no problems with time zone changes.
|
|
Also it's recommended to use only UTC formats in other cases, for example, if you send files to
|
|
someone in another time zone.</P>
|
|
|
|
<P>Also in some cases there are no problems, if both file system and archive format use local time, for example, FAT file system and ZIP format.</P>
|
|
<UL>
|
|
<LI>UTC file systems: NTFS
|
|
<LI>UTC archive formats: .zip with -mtc switch, 7z, tar, gzip2, iso, wim
|
|
<LI>Local time file systems : FAT, FAT32
|
|
<LI>Local time archive formats : rar, zip, cab
|
|
</UL>
|
|
|
|
<H4>Examples</H4>
|
|
|
|
<PRE class="example">
|
|
7z u c:\1\exist.7z -u- -up0q3x2z0!c:\1\update.7z *
|
|
</PRE>
|
|
|
|
<P>creates a new archive <SPAN class="filename">update.7z</SPAN> and
|
|
writes to this archive all files from current directory which differ from
|
|
files in <SPAN class="filename">exist.7z</SPAN> archive.
|
|
<SPAN class="filename">exist.7z</SPAN> archive will not be changed.</P>
|
|
|
|
<PRE class="example">
|
|
7z u c:\1\exist.7z -up0q3x2z0!c:\1\update.7z * -ms=off
|
|
</PRE>
|
|
|
|
<P>creates a new archive <SPAN class="filename">update.7z</SPAN> and
|
|
writes to this archive all files from the current directory which differ from
|
|
files in <SPAN class="filename">exist.7z</SPAN> archive.
|
|
|
|
<P>Note: the updating of solid .7z archives can be slow, since it
|
|
can require some recompression.</P>
|
|
|
|
<H4>Commands that can be used with this switch</H4>
|
|
|
|
<P>
|
|
<A href="../commands/add.htm">a (Add)</A>,
|
|
<A href="../commands/delete.htm">d (Delete)</A>,
|
|
<A href="../commands/rename.htm">rn (Rename)</A>,
|
|
<A href="../commands/update.htm">u (Update)</A>,
|
|
</P>
|
|
|
|
</BODY>
|
|
</HTML>
|