OSDN Git Service

add help file in v4.64
[sevenzip/7-Zip.git] / sevenzip.sourceforge.jp / chm / cmdline / switches / update.htm
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">\r
2 <HTML>\r
3 <HEAD>\r
4   <META http-equiv="Content-Type" content="text/html; charset=Windows-1252">\r
5   <TITLE>-u (Update options) switch</TITLE>\r
6   <LINK href="style.css" rel="stylesheet" type="text/css">\r
7 </HEAD>\r
8 \r
9 <BODY>\r
10 \r
11 <H1>-u (Update options) switch</H1>\r
12 \r
13 <P>Specifies how to update files in an archive and (or) how to create new archives.</P>\r
14 \r
15 <H4>Syntax</H4>\r
16 \r
17 <PRE class="syntax">\r
18 -u<A class="parameter" href="#disable_base_archive">[-]</A>&lt;action_set><A class="parameter" href="#new_archive_name">[!{new_archive_name}]</A>\r
19 \r
20   &lt;action_set> ::= &lt;state_action>...\r
21 \r
22     &lt;state_action> ::= <A class="parameter" href="#state">&lt;state></A><A class="parameter" href="#state">&lt;action></A>\r
23 \r
24       <A class="parameter" href="#action">&lt;state></A> ::= p | q | r | x | y | z | w\r
25 \r
26       <A class="parameter" href="#action">&lt;action></A> ::= 0 | 1 | 2 | 3\r
27 </PRE>\r
28 \r
29 \r
30 <H4>Parameters</H4>\r
31 \r
32 <DL>\r
33   <DT><A name="disable_base_archive"></A>dash (-)</DT>\r
34   <DD><P>Disables any updates in the base archive.</P>\r
35 \r
36       <P>The term <B>base archive</B> means the archive assigned by "base_archive_name"\r
37       on the command line. See <A href="../syntax.htm">Command line syntax</A>\r
38       for more details.</P>\r
39   </DD>\r
40   <DT><A name="new_archive_name"></A>{new_archive_name}</DT>\r
41   <DD><P>Specifies the path name of the new archive to be created.\r
42     All options in this switch will refer to this new archive.</P>\r
43     <P>If not assigned, then all options in this switch will\r
44                   refer to the base archive of the command.</P>\r
45   </DD>\r
46   <DT><A name="state"></A>&lt;state></DT>\r
47   <DD><P>Specifies the state of a particular file to be processed.</P>\r
48     <PRE class="syntax">&lt;state> ::= p | q | r | x | y | z | w</PRE>\r
49     <P>For each unique filename there are 6 variants of state:</P>\r
50     <TABLE>\r
51       <TR> <TH>&lt;state></TH> <TH>State condition</TH>\r
52            <TH width="20%">File on Disk</TH> <TH width="20%">File in Archive</TH> </TR>\r
53 \r
54       <TR> <TD align="center">p</TD> <TD>File exists in archive, but is not matched with wildcard.</TD>\r
55            <TD>&nbsp;</TD> <TD>Exists, but is not matched</TD> </TR>\r
56 \r
57       <TR> <TD align="center">q</TD> <TD>File exists in archive, but doesn't exist on disk.</TD>\r
58            <TD>Doesn't exist</TD> <TD>Exists</TD> </TR>\r
59 \r
60       <TR> <TD align="center">r</TD> <TD>File doesn't exist in archive, but exists  on disk.</TD>\r
61            <TD>Exists</TD> <TD>Doesn't exist</TD> </TR>\r
62 \r
63       <TR> <TD align="center">x</TD> <TD>File in archive is newer than the file on disk.</TD>\r
64            <TD>Older</TD> <TD>Newer</TD> </TR>\r
65 \r
66       <TR> <TD align="center">y</TD> <TD>File in archive is older than the file on disk.</TD>\r
67            <TD>Newer</TD> <TD>Older</TD> </TR>\r
68 \r
69       <TR> <TD align="center">z</TD> <TD>File in archive is same as the file on disk</TD>\r
70            <TD>Same</TD> <TD>Same</TD> </TR>\r
71 \r
72       <TR> <TD align="center">w</TD> <TD>Can not be detected what file is newer  \r
73               (times are the same, sizes are different)</TD>\r
74            <TD>?</TD> <TD>?</TD> </TR>\r
75     </TABLE>\r
76   </DD>\r
77 \r
78   <DT><A name="action"></A>&lt;action></DT>\r
79   <DD><P>Specifies the action for a given <A class="parameter" href="#state">&lt;state></A>.</P>\r
80     <PRE class="syntax">&lt;action> ::= 0 | 1 | 2 | 3</PRE>\r
81     <P>For each state you can specify one of the three variants of actions:</P>\r
82     <TABLE>\r
83       <TR> <TH>&lt;action></TH> <TH>Description</TH></TR>\r
84       <TR> <TD align="center">0</TD> <TD>Ignore file (don't create item in new archive for this file)</TD></TR>\r
85       <TR> <TD align="center">1</TD> <TD>Copy file (copy from old archive to new)</TD></TR>\r
86       <TR> <TD align="center">2</TD> <TD>Compress (compress file from disk to new archive)</TD></TR>\r
87       <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>\r
88     </TABLE>\r
89   </DD>\r
90 </DL>\r
91 \r
92 \r
93 <H4>Remarks</H4>\r
94 \r
95 <P>Any update command (such as <A href="../commands/add.htm">a (Add)</A>,\r
96   <A href="../commands/delete.htm">d (Delete)</A>,\r
97   <A href="../commands/update.htm">u (Update)</A>) can be assigned in these terms.</P>\r
98 <P>The following table shows action sets for update commands.</P>\r
99 \r
100 <TABLE>\r
101   <TR> <TH>command \ <A class="parameter" href="#state">&lt;state></A></TH>\r
102               <TH>p</TH> <TH>q</TH> <TH>r</TH> <TH>x</TH> <TH>y</TH> <TH>z</TH> <TH>w</TH></TR>\r
103   <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>\r
104   <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>\r
105   <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>\r
106   <TR> <TH><A href="../commands/update.htm">Synchronize</A></TH> <TD>1</TD> <TD>0</TD> <TD>2</TD> <TD>1</TD> <TD>2</TD> <TD>1</TD> <TD>2</TD></TR>\r
107 </TABLE>\r
108 \r
109 \r
110 <P>If you don't specify a\r
111 <A class="parameter" href="#new_archive_name"><I>!{new_archive_name}</I></A> option, then\r
112 all options will refer to the main archive (the archive assigned on the command line after the 7z command).\r
113 If you specify <A class="parameter" href="#new_archive_name"><I>!{new_archive_name}</I></A>\r
114 option, then 7-Zip also will create a new archive with the specified name and all options\r
115 will refer to that new archive.</P>\r
116 \r
117 <P>Multiple update switches are supported.\r
118 7-Zip can create any number of new archives during one operation.</P>\r
119 \r
120 <P>By default, the action set for each new archive is assigned\r
121 as the action set of the main command. There are 3 different\r
122 action sets for commands: <A href="../commands/add.htm">a (Add)</A>,\r
123   <A href="../commands/delete.htm">d (Delete)</A>,\r
124   <A href="../commands/update.htm">u (Update)</A>.\r
125 You can overload any &lt;state_action> pair.</P>\r
126 \r
127 <H4>Time zone notes</H4>\r
128 <P>If you change time zone (when you move your computer to another time zone \r
129 or if there are clock changes for daylight saving in your zone), you can have some problems \r
130 with update commands that depend from file's modification time. It's strongly recommended to use only \r
131 file system that uses Coordinated Universal Time (UTC) and archive format that also uses UTC. \r
132 In that case you will have no problems with time zone changes.\r
133 Also it's recommended to use only UTC formats in other cases, for example, if you send files to \r
134 someone in another time zone.</P>\r
135 \r
136 <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> \r
137 <UL>\r
138 <LI>UTC file systems: NTFS\r
139 <LI>UTC archive formats: .zip with -mtc switch, 7z, tar, gzip2, iso, wim\r
140 <LI>Local time file systems : FAT, FAT32\r
141 <LI>Local time archive formats : rar, zip, cab\r
142 </UL>\r
143 \r
144 <H4>Examples</H4>\r
145 \r
146 <PRE class="example">\r
147 7z u c:\1\exist.7z -u- -up0q3x2z0!c:\1\update.7z *\r
148 </PRE>\r
149 \r
150 <P>creates a new archive <SPAN class="filename">update.7z</SPAN> and\r
151 writes to this archive all files from current directory which differ from\r
152 files in <SPAN class="filename">exist.7z</SPAN> archive.\r
153 <SPAN class="filename">exist.7z</SPAN> archive will not be changed.</P>\r
154 \r
155 <PRE class="example">\r
156 7z u c:\1\exist.7z -up0q3x2z0!c:\1\update.7z * -ms=off\r
157 </PRE>\r
158 \r
159 <P>creates a new archive <SPAN class="filename">update.7z</SPAN> and\r
160 writes to this archive all files from the current directory which differ from\r
161 files in <SPAN class="filename">exist.7z</SPAN> archive.\r
162 \r
163 <P>Note: The current version of 7-Zip cannot change an archive created with the solid option switched on.\r
164 To update a .7z archive, you must create and update the archive in non-solid\r
165 mode (-ms=off switch).</P>\r
166 \r
167 <H4>Commands that can be used with this switch</H4>\r
168 \r
169 <P>\r
170   <A href="../commands/add.htm">a (Add)</A>,\r
171   <A href="../commands/delete.htm">d (Delete)</A>,\r
172   <A href="../commands/update.htm">u (Update)</A>,\r
173 </P>\r
174 \r
175 </BODY>\r
176 </HTML>\r