/usr/share/doc/p7zip-full/DOCS/MANUAL/switches/update.htm is in p7zip-full 9.20.1~dfsg.1-4.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 | <!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>
|