diff options
Diffstat (limited to 'src/libs/7zip/unix/DOCS/MANUAL/switches/update.htm')
| -rw-r--r-- | src/libs/7zip/unix/DOCS/MANUAL/switches/update.htm | 176 |
1 files changed, 0 insertions, 176 deletions
diff --git a/src/libs/7zip/unix/DOCS/MANUAL/switches/update.htm b/src/libs/7zip/unix/DOCS/MANUAL/switches/update.htm deleted file mode 100644 index 3c707a784..000000000 --- a/src/libs/7zip/unix/DOCS/MANUAL/switches/update.htm +++ /dev/null @@ -1,176 +0,0 @@ -<!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/update.htm">u (Update)</A>, -</P> - -</BODY> -</HTML> |