1 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
---|
2 | <HTML>
|
---|
3 | <HEAD>
|
---|
4 | <META http-equiv="Content-Type" content="text/html; charset=Windows-1252">
|
---|
5 | <TITLE>Command Line Syntax</TITLE>
|
---|
6 | <LINK href="style.css" rel="stylesheet" type="text/css">
|
---|
7 | </HEAD>
|
---|
8 |
|
---|
9 | <BODY>
|
---|
10 |
|
---|
11 | <H1>Command Line Syntax</H1>
|
---|
12 |
|
---|
13 | <PRE class = "syntax">
|
---|
14 | 7z <A href = "commands/index.htm"><command></A> [<A href = "switches/index.htm"><switch></A>...] <base_archive_name> [<arguments>...]
|
---|
15 | </PRE>
|
---|
16 | <PRE class = "syntax">
|
---|
17 | <arguments> ::= <A href = "switches/index.htm"><switch></A> | <wildcard> | <filename> | <list_file>
|
---|
18 | <A href = "switches/index.htm"><switch></A>::= <switch_symbol><switch_characters>[<option>]
|
---|
19 | <switch_symbol> ::= '/' | '-'
|
---|
20 | <list_file> ::= @{filename}
|
---|
21 | </PRE>
|
---|
22 |
|
---|
23 |
|
---|
24 | <P>Expressions in square brackets (between '[' and ']') are optional.</P>
|
---|
25 |
|
---|
26 | <P>Expressions in curly braces ('{' and '}') mean that instead of that
|
---|
27 | Expression (including braces), the user must substitute some string.</P>
|
---|
28 |
|
---|
29 | <P>Expression</P>
|
---|
30 |
|
---|
31 | <PRE class = "syntax">
|
---|
32 | expression1 | expression2 | ... | expressionN</DT>
|
---|
33 | </PRE>
|
---|
34 |
|
---|
35 | <P>
|
---|
36 | means that any (but only one) from these expressions must be specified.
|
---|
37 |
|
---|
38 | <P><A href = "commands/index.htm">Commands</A> and
|
---|
39 | <A href = "switches/index.htm">switches</A> can be entered in upper or lower case.</P>
|
---|
40 |
|
---|
41 | <P>Command is the first non-switch argument.</P>
|
---|
42 |
|
---|
43 | <P>The "base_archive_name" must be the first filename on the command line
|
---|
44 | after the command.</P>
|
---|
45 |
|
---|
46 | <P>The switches and other filenames can be in any order.</P>
|
---|
47 |
|
---|
48 | <P>Wildcards or filenames with spaces must be quoted:</P>
|
---|
49 |
|
---|
50 | <PRE>
|
---|
51 | "Dir\Program files\*"
|
---|
52 | Dir\"Program files"\*
|
---|
53 | </PRE>
|
---|
54 |
|
---|
55 | <P>Switch options can be combined to save command line length. However, some
|
---|
56 | switch options take optional string arguments and therefore, must be the
|
---|
57 | last option in a combined argument token string because 7-Zip accepts the
|
---|
58 | rest of the argument token as the optional argument.</P>
|
---|
59 |
|
---|
60 | <P>7-Zip uses wild name matching similar to Windows 95:</P>
|
---|
61 | <UL>
|
---|
62 | <LI><B>'*'</B> means a sequence of arbitrary characters.</LI>
|
---|
63 | <LI><B>'?'</B> means any character.</LI>
|
---|
64 | </UL>
|
---|
65 |
|
---|
66 | <P><B>
|
---|
67 | 7-Zip doesn't uses the system wildcard parser. 7-Zip doesn't
|
---|
68 | follow the archaic rule by which *.* means any file. 7-Zip treats
|
---|
69 | *.* as matching the name of any file that has an extension. To process all files, you must
|
---|
70 | use a * wildcard.</B></P>
|
---|
71 |
|
---|
72 | <P>Examples:</P>
|
---|
73 | <TABLE border = "0">
|
---|
74 | <TR><TD>*.txt</TD><TD>means all files with an extension of ".txt"</TD></TR>
|
---|
75 | <TR><TD>?a*</TD><TD>means all files with a second character of "a"</TD></TR>
|
---|
76 | <TR><TD>*1*</TD><TD>means all names that contains character "1"</TD></TR>
|
---|
77 | <TR><TD>*.*.*</TD><TD>means all names that contain two at least "." characters</TD></TR>
|
---|
78 | </TABLE>
|
---|
79 |
|
---|
80 |
|
---|
81 | <P>The default wildcard "*" will be used if there is no filename/wildcard in the
|
---|
82 | command line.</P>
|
---|
83 |
|
---|
84 | <P>Slash ('\') at the end of a path means a directory. Without a Slash ('\') at
|
---|
85 | the end of the path, the path can refer either to a file or a directory.
|
---|
86 |
|
---|
87 |
|
---|
88 | <H2><A name = "ListFile"></A>List file</H2>
|
---|
89 |
|
---|
90 | <P>You can supply one or more filenames or wildcards for special list files
|
---|
91 | (files containing lists of files). The filenames in such list file must be
|
---|
92 | separated by new line symbol(s).</P>
|
---|
93 |
|
---|
94 | <P>For list files, 7-Zip uses UTF-8 encoding by default. You can change encoding
|
---|
95 | using <A href = "switches/charset.htm">-scs</A> switch.</P>
|
---|
96 |
|
---|
97 | <P>Multiple list files are supported.</P>
|
---|
98 |
|
---|
99 | <P>For example, if the file "listfile.txt" contains the following:</P>
|
---|
100 |
|
---|
101 | <PRE>
|
---|
102 | My programs\*.cpp
|
---|
103 | Src\*.cpp
|
---|
104 | </PRE>
|
---|
105 | <P>then the command</P>
|
---|
106 |
|
---|
107 | <PRE>
|
---|
108 | 7z a -tzip archive.zip @listfile.txt
|
---|
109 | </PRE>
|
---|
110 |
|
---|
111 | <P>adds to the archive "archive.zip" all "*.cpp" files from directories "My
|
---|
112 | programs" and "Src".</P>
|
---|
113 |
|
---|
114 | <H2><A name = "ListFile"></A>Short and Long File Names</H2>
|
---|
115 |
|
---|
116 | <P>7-Zip supports short file names (like FILENA~1.TXT) in some cases.
|
---|
117 | However, it's strongly recommended to use only the real (long) file names.</P>
|
---|
118 |
|
---|
119 | </BODY>
|
---|
120 | </HTML>
|
---|