121 lines
4.0 KiB
HTML
121 lines
4.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>Command Line Syntax</TITLE>
|
|
<LINK href="style.css" rel="stylesheet" type="text/css">
|
|
</HEAD>
|
|
|
|
<BODY>
|
|
|
|
<H1>Command Line Syntax</H1>
|
|
|
|
<PRE class = "syntax">
|
|
7z <A href = "commands/index.htm"><command></A> [<A href = "switches/index.htm"><switch></A>...] <base_archive_name> [<arguments>...]
|
|
</PRE>
|
|
<PRE class = "syntax">
|
|
<arguments> ::= <A href = "switches/index.htm"><switch></A> | <wildcard> | <filename> | <list_file>
|
|
<A href = "switches/index.htm"><switch></A>::= <switch_symbol><switch_characters>[<option>]
|
|
<switch_symbol> ::= '/' | '-'
|
|
<list_file> ::= @{filename}
|
|
</PRE>
|
|
|
|
|
|
<P>Expressions in square brackets (between '[' and ']') are optional.</P>
|
|
|
|
<P>Expressions in curly braces ('{' and '}') mean that instead of that
|
|
Expression (including braces), the user must substitute some string.</P>
|
|
|
|
<P>Expression</P>
|
|
|
|
<PRE class = "syntax">
|
|
expression1 | expression2 | ... | expressionN</DT>
|
|
</PRE>
|
|
|
|
<P>
|
|
means that any (but only one) from these expressions must be specified.
|
|
|
|
<P><A href = "commands/index.htm">Commands</A> and
|
|
<A href = "switches/index.htm">switches</A> can be entered in upper or lower case.</P>
|
|
|
|
<P>Command is the first non-switch argument.</P>
|
|
|
|
<P>The "base_archive_name" must be the first filename on the command line
|
|
after the command.</P>
|
|
|
|
<P>The switches and other filenames can be in any order.</P>
|
|
|
|
<P>Wildcards or filenames with spaces must be quoted:</P>
|
|
|
|
<PRE>
|
|
"Dir\Program files\*"
|
|
Dir\"Program files"\*
|
|
</PRE>
|
|
|
|
<P>Switch options can be combined to save command line length. However, some
|
|
switch options take optional string arguments and therefore, must be the
|
|
last option in a combined argument token string because 7-Zip accepts the
|
|
rest of the argument token as the optional argument.</P>
|
|
|
|
<P>7-Zip uses wild name matching similar to Windows 95:</P>
|
|
<UL>
|
|
<LI><B>'*'</B> means a sequence of arbitrary characters.</LI>
|
|
<LI><B>'?'</B> means any character.</LI>
|
|
</UL>
|
|
|
|
<P><B>
|
|
7-Zip doesn't use the system wildcard parser. 7-Zip doesn't
|
|
follow the archaic rule by which *.* means any file. 7-Zip treats
|
|
*.* as matching the name of any file that has an extension. To process all files, you must
|
|
use a * wildcard.</B></P>
|
|
|
|
<P>Examples:</P>
|
|
<TABLE border = "0">
|
|
<TR><TD>*.txt</TD><TD>means all files with an extension of ".txt"</TD></TR>
|
|
<TR><TD>?a*</TD><TD>means all files with a second character of "a"</TD></TR>
|
|
<TR><TD>*1*</TD><TD>means all names that contains character "1"</TD></TR>
|
|
<TR><TD>*.*.*</TD><TD>means all names that contain two at least "." characters</TD></TR>
|
|
</TABLE>
|
|
|
|
|
|
<P>The default wildcard "*" will be used if there is no filename/wildcard in the
|
|
command line.</P>
|
|
|
|
<P>Slash ('\') at the end of a path means a directory. Without a Slash ('\') at
|
|
the end of the path, the path can refer either to a file or a directory.
|
|
|
|
|
|
<H2><A name = "ListFile"></A>List file</H2>
|
|
|
|
<P>You can supply one or more filenames or wildcards for special list files
|
|
(files containing lists of files). The filenames in such list file must be
|
|
separated by new line symbol(s).</P>
|
|
|
|
<P>For list files, 7-Zip uses UTF-8 encoding by default. You can change encoding
|
|
using <A href = "switches/charset.htm">-scs</A> switch.</P>
|
|
|
|
<P>Multiple list files are supported.</P>
|
|
|
|
<P>For example, if the file "listfile.txt" contains the following:</P>
|
|
|
|
<PRE>
|
|
My programs\*.cpp
|
|
Src\*.cpp
|
|
</PRE>
|
|
<P>then the command</P>
|
|
|
|
<PRE>
|
|
7z a -tzip archive.zip @listfile.txt
|
|
</PRE>
|
|
|
|
<P>adds to the archive "archive.zip" all "*.cpp" files from directories "My
|
|
programs" and "Src".</P>
|
|
|
|
<H2><A name = "ListFile"></A>Short and Long File Names</H2>
|
|
|
|
<P>7-Zip supports short file names (like FILENA~1.TXT) in some cases.
|
|
However, it's strongly recommended to use only the real (long) file names.</P>
|
|
|
|
</BODY>
|
|
</HTML>
|