7-Zip - documentation.help · icon of 7-Zip File Manager, and then click Run as administrator. Then...

7-Zip

Welcometo7-Zip18.00beta

7-Zipisafilearchiverwithahighcompressionratio.

Thedocumentationfor7-Zipincludes:

Generalinformationabout7-Zip

User'sGuidefor7-ZipFileManager

User'sGuideforcommandlineversion

SeeAlso

FrequentlyAskedQuestions(FAQ)

Copyright(c)1999-2018IgorPavlov

Website:www.7-zip.org

Support:www.7-zip.org/support.html

http://www.7-zip.org

http://www.7-zip.org/support.html

GeneralInformation

Themainfeaturesof7-Zip

Powerfulfilemanager

Highcompressionratioandhighspeed

Bignumberofsupportedarchiveformats

Additionalcommandlineversion

SeeAlso

Licenseforuseanddistribution

Supportedformats

Format Creation FilenameExtensions7z X 7z

BZIP2 X bz2bzip2tbz2tbzGZIP X gzgziptgzTAR X tarWIM X wimswmesdXZ X xztxzZIP X zipzipxjarxpiodtodsdocxxlsxepubAPM apmAR aradeblibARJ arjCAB cabCHM chmchwchichq

COMPOUND msimspdocxlspptCPIO cpio

CramFS cramfsDMG dmgExt extext2ext3ext4imgFAT fatimgHFS hfshfsxHXS hxshxihxrhxqhxwlitiHEX ihexISO isoimgLZH lzhlhaLZMA lzmaMBR mbrMsLZ mslzMub mubNSIS nsisNTFS ntfsimg

MBR mbrRAR rarr00RPM rpmPPMD ppmdQCOW2 qcowqcow2qcow2cSPLIT 001002...

SquashFS squashfsUDF udfisoimgUEFIc scapUEFIs uefifVDI vdiVHD vhdVMDK vmdkXAR xarpkgZ ztaz

ZIP7-ZipcreatesZIPcompatiblearchives.7-ZipsupportsthefollowingZIPcompressionmethods:

0-Store

1-Shrink(decompressiononly)

6-Implode(decompressiononly)

8-Deflate

9-Deflate64

12-BZip2

14-LZMA

95-xz(decompressiononly)

98-PPMd

99-WinZipAES

FilescompressedwithotherZIPcompressionmethodscan'tbeextractedbythecurrentversionofthe7-Zip.Butthesesupportedmethodsarethemostpopulartoday,andtherefore7-ZipcandecompressmostZIParchives.Toextractfilescompressedwithnon-supportedmethodsyoumustusesomeotherZIPutility.

7-ZipsupportstheZip64extensionofZIPformat.

LZH7-ZipsupportsLZHarchivesonlyforlisting,browsinganddecompressing.7-Zipsupports-lh0-,-lh4-,-lh5-,-lh6-and-lh7-methods.

7zFormat

7zisanewarchiveformat,providingahighcompressionratio.

Themainfeaturesofthe7zformat:

Openarchitecture

Highcompressionratio

StrongAES-256encryption

Abilitytouseanycompression,conversionorencryptionmethod

Supportsfileswithsizesupto16000000000GB

Unicodefilenames

Solidcompression

Archiveheaderscompression

7zhasanopenarchitecture,soitcansupportanynewcompressionmethods.

Thefollowingmethodscurrentlyareintegratedinto7z:

Method DescriptionLZMA ImprovedandoptimizedversionofLZ77algorithm

LZMA2 LZMA-basedcompressionmethod.ItprovidesbettermultithreadingsupportthanLZMA

PPMD DmitryShkarin'sPPMdHwithsmallchangesBCJ Converterfor32-bitx86executablesBCJ2 Converterfor32-bitx86executablesBZip2 StandardBWTalgorithmDeflate StandardLZ77-basedalgorithm

LZMAisthedefaultandgeneralcompressionmethodof7zformat.ThemainfeaturesoftheLZMAmethod:

Highcompressionratio

Variabledictionarysize(upto4GB)

Compressionspeed:about1MB/son2GHzCPU

Decompressionspeed:about10-20MB/son2GHzCPU

Smallmemoryrequirementfordecompression(dependsfromdictionarysize)

Smallcodesizefordecompression:about5KB

Supportsmulti-threadingandP4'shyper-threading

TheLZMAcompressionalgorithmisverysuitableforembeddedapplications.IfyouwanttouseLZMAcode,youcanaskforconsultation,customcodeprogramming,andrequireddeveloperlicensesat

www.7-zip.org/support.html

http://www.7-zip.org/support.html

AESencryption7-ZipsupportsencryptionwiththeAES-256algorithm.Thisalgorithmusesacipherkeywithlengthof256bits.Tocreatethekey,7-ZipusesaderivationfunctionbasedonanSHA-256hashalgorithm.Akeyderivationfunctionproducesaderivedkeyfromatextpassworddefinedbytheuser.Toincreasethecostofanexhaustivesearchforpasswords,7-Zipusesabignumberofiterationstoproducethecipherkeyfromthetextpassword.

TipsforselectingpasswordlengthHereisanestimateofthetimerequiredforanexhaustivepasswordsearchattack,whenthepasswordisarandomsequenceoflowercaseLatinletters.

ThemostcomplextaskforpasswordsearchattackisSHA-256calculation.SpecialSHA-256hardwareorGPUcanbeusedtoacceleratepasswordsearchattack.NowmodernGPUcanprovideabout10timesmoreperformanceforSHA-256calculationthanmodernCPU.AndspecialSHA-256hardwarecanprovideabout20timesmoreperformancethanGPU.

Wesupposethatoneuserwithabudgetofabout$2000(forGPUs)cancheck10000passwordspersecondandanorganizationwithabudgetofabout10^9USD(onethousandmillionUSdollars)cancheck3*10^12passwordspersecond.Wealsosupposethattheprocessorinusedoublesitsperformanceeverytwoyears;so,eachadditionalLatinletterofalongpasswordaddsabout9yearstoanexhaustivekeysearchattack.

Theresultisthisestimateofthetimetosucceedinanattack:

PasswordLength SingleUserAttack OrganizationAttack1 1s 1s2 1s 1s3 2s 1s4 1min 1s5 30min 1s6 12hours 1s7 14days 1s8 1year 1s9 10years 2s10 19years 1min11 28years 30min12 37years 12hours13 46years 14days

14 55years 1year15 64years 10years16 73years 19years17 82years 28years18 91years 37years19 100years 46years

Performance

Wecompared7-ZipwithWinRAR5.20.

FILESETS:MozillaFirefox34.0.5forWindowsandGoogleEarth6.2.2.6613forWindows.

Archiver

MozillaFirefox GoogleEarth65files

85280391bytes483files

110700519bytesCompressed

size Ratio Compressedsize Ratio

7-Zip9.35-mx 39357375 100% 15964369 100%

WinRAR5.20-m5-s-ma5-md128m

41789543 106% 17035432 107%

Compressionratioresultsareverydependentuponthedatausedforthetests.Usually,7-Zipcompressesto7zformat30-70%betterthantozipformat.And7-Zipcompressestozipformat2-10%betterthanmostofotherzipcompatibleprograms.

FrequentlyAskedQuestions(FAQ)

CanIuse7-Zipinacommercialorganization?

Yes,7-Zipisfreesoftware.Youcanuseitonanycomputer.Youdon'tneedtoregisterorpayfor7-Zip.

HowcanIsetfileassociationsto7-ZipinWindows7andWindowsVista?

Youmustrun7-ZipFileManagerinadministratormode.Right-clicktheiconof7-ZipFileManager,andthenclickRunasadministrator.Thenyoucanchangefileassociationsandsomeotheroptions.

Why7zarchivescreatedbynewversionof7-Zipcanbelargerthanarchivescreatedbyoldversionof7-Zip?

Newversionsof7-Zip(startingfromversion15.06)useanotherfilesortingorderbydefaultforsolid7zarchives.

Oldversionof7-Zip(beforeversion15.06)usedfilesorting"bytype"("byextension").

Newversionof7-Zipsupportstwosortingorders:

sortingbyname-defaultorder.

sortingbytype,if'qs'isspecifiedinParametersfieldin"Addtoarchive"window,(or-mqsswitchforcommandlineversion).

Youcangetbigdifferenceincompressionratiofordifferentsortingmethods,ifdictionarysizeissmallerthantotalsizeoffiles.Iftherearesimilarfilesindifferentfolders,thesorting"bytype"canprovidebettercompressionratioinsomecases.

Notethatsorting"bytype"hassomedrawbacks.Forexample,NTFSvolumesusesortingorder"byname",soifanarchiveusesanothersorting,thenthespeedofsomeoperationsforfileswithunusualordercanfallonHDDdevices(HDDshavelowspeedfor"seek"operations).

Youcanincreasecompressionratiowiththefollowingmethods:

Increasedictionarysize.Itcanhelpwhen'qs'isnotused.

Specify'qs'inParametersfield(oruse-mqsswitchforcommandlineversion).

Ifyouthinkthatunusualfileorderisnotproblemforyou,andifbettercompressionratiowithsmalldictionaryismoreimportantforyou,use'qs'mode.

Whycan't7-ZipopensomeZIParchives?

In99%ofthesecasesitmeansthatthearchivecontainsincorrectheaders.OtherZIPprogramscanopensomearchiveswithincorrectheaders,sincetheseprogramsjustignoreerrors.

Ifyouhavesucharchive,pleasedon'tcallthe7-Zipdevelopersaboutit.InsteadtrytofindtheprogramthatwasusedtocreatethearchiveandinformthedevelopersofthatprogramthattheirsoftwareisnotZIP-compatible.

TherearealsosomeZIParchivesthatwereencodedwithmethodsunsupportedby7-Zip,forexample,WAVPack(WinZip).

Whydoesdrag-and-droparchiveextractionfrom7-ZiptoExplorerusetempfiles?

7-Zipdoesn'tknowfolderpathofdroptarget.OnlyWindowsExplorerknowsexactdroptarget.AndWindowsExplorerneedsfiles(dragsource)asdecompressedfilesondisk.So7-Zipextractsfilesfromarchivetotempfolderandthen7-ZipnotifiesWindowsExploreraboutpathsofthesetempfiles.ThenWindowsExplorercopiesthesefilestodroptargetfolder.

Toavoidtempfileusage,youcanuseExtractcommandof7-Zipordrag-and-dropfrom7-Zipto7-Zip.

Whydoesn'tthecommandlineversionaddfileswithoutextensionstoanarchive?

You'reprobablyusinga*.*wildcard.7-Zipdoesn'tusetheoperatingsystem'swildcardmaskparser,andconsequentlytreats*.*asanyfilethathasanextension.Toprocessallfilesyoumustusethe*wildcard

insteadoromitthewildcardaltogether.

Whydoesn't-rswitchworkasexpected?

Inmostcasesyoudon'tneed-rswitch.7-Zipcancompresssubfoldersevenwithout-rswitch.

Example1:

7z.exeac:\a.7z"C:\ProgramFiles"

compresses"C:\ProgramFiles"completely,includingallsubfolders.

Example2:

7z.exea-rc:\a.7z"C:\ProgramFiles"

searchesandcompresses"ProgramFiles"inallsubfoldersofC:\(forexample,in"C:\WINDOWS").

Ifyouneedtocompressonlyfileswithsomeextension,youcanuse-rswitch:

7za-rc:\a.zipc:\dir\*.txt

compressesall*.txtfilesfromfolderc:\dir\andallit'ssubfolders.

Whycan't7-Zipusebigdictionaryin32-bitWindows?

32-bitWindowsallocatesonly2GBofvirtualspaceperoneapplication.Alsothatblockof2GBcanbefragmented(forexample,bysomeDLLfile),so7-Zipcan'tallocateonebigcontiguousblockofvirtualspace.Therearenosuchlimitationsin64-bitWindows.SoyoucanuseanydictionaryinWindowsx64,ifyouhaverequiredamountofphysicalRAM.

HowcanIinstall7-Zipinsilentmode?

Forexeinstaller:Usethe"/S"parametertodoasilentinstallationandthe"/D=dir"parametertospecifythe"outputdirectory".Theseoptionsarecase-sensitive.

Formsiinstaller:Usethe/qINSTALLDIR="C:\ProgramFiles\7-Zip"parameters.

HowcanIrecovercorrupted7zarchive?

Therearesomepossiblecaseswhenarchiveiscorrupted:

Youcanopenarchiveandyoucanseethelistoffiles,butwhenyoupressExtractorTestcommand,therearesomeerrors:DataErrororCRCError.

Whenyouopenarchive,yougetmessage"Cannotopenfile'a.7z'asarchive"

It'spossibletorecoversomedata.Readaboutrecoveringprocedure:

Recovercorrupted7zarchive

http://www.7-zip.org/recover.html

License

7-ZipCopyright(C)1999-2018IgorPavlov.

Licensesforfilesare:

7z.dll:GNULGPL+unRARrestriction

Allotherfiles:GNULGPL

TheGNULGPL+unRARrestrictionmeansthatyoumustfollowbothGNULGPLrulesandunRARrestrictionrules.

Note:Youcanuse7-Ziponanycomputer,includingacomputerinacommercialorganization.Youdon'tneedtoregisterorpayfor7-Zip.

ReadfileLicense.txtforfullinformationaboutlicense.

Thanks

Iwouldliketothank:

myspacefromsf.net-forportingtoUnix/Linux(p7zip),testing,bugfixingandmore.

ARJSoftware-forARJ.

EricBiggers-forLZMSdescription(wimlib).

WeiDai-forSHA-256codeandCrypto++Library.

JeffGilchrist-forcompressingtests.

SzymonGrabowski-forsomeideas.

MicrosoftCorporation-forCAB/WIMformatsdescriptions,andWiX(WindowsInstallerXML).

Nullsoft,Inc.andNSISteam-forNSIS(NullsoftScriptableInstallSystem).

RobertMartinez-7-ZipLogo.

AlexanderRatushnyak-forcompressingtests.

EugeneRoshal-forRAR.

MatthewRussotto-forCHM/CABformatdescription.

JulianSeward-forBZip2.

EugeneShelwien-forsomeideasandalgorithms.

DmitryShkarin-forPPMdalgorithm.

YoshiokaTsuneo-forTAR32program.

VadimYoockin-forcompressingtests.

BulatZiganshin-forsomeideas.

JohnMichaelWilliams-forhelpfilecorrections.

AppleInc.-forHFS.

vu1tur(DMG2IMG)-for.DMGhints.

YutakaSawada-forhintstoZIPStrongEncryptionformat.

NTFS-3Gteam-forhintstoNTFS.

PhillipLougher-forSquashFS.

HaruyasuYoshizaki-forLHA/LZH.

7-ZipFileManager

The7-ZipFileManagerisaprogramformanipulatingfilesandfolders.

The7-ZipFileManagercanworkwithtwopanels.YoucanswitchbetweenpanelsbypressingtheTabbutton.Mostoftheoperationscanbeexecutedusingkeyboardshortcutsorbyright-clickingonitemsandselectingtheappropriatecommandfrommenu.

InThisSection

MenuItemsandShortcutKeysDescribesthemenuitemsandkeyboardshortcut.

OptionsDialogBoxDescribeswhatsettingsyoucanchangethataffectthe7-ZipFileManager.

BenchmarkDescribesa7-ZipBenchmarkformeasuringCPUperformance.

AboutDialogBoxProvidesinformationabout7-Zip.

PluginsDescribespluginsforthe7-ZipFileManager.

Youhaveaccesstothefollowingitemsfromrootfolderin7-ZipFileManager:

Computer:computer'sdisks

Documents:MyDocumentsfolderofcurrentuser

Network

\\.:thefolderforlow-levelaccesstodisks.Youmusthaveadministrator'srightstousethatfolder.Youcan

copy.isoimagesfromCD/DVDtofile.

viewNTFS/FATpartitionsvia7-Zipparser.Itprovidesread-onlyaccesstofiles.

OptionsDialogBox

Youcanchangemanyofthesettingsthataffectthe7-ZipFileManagerintheOptionsdialogbox.ToaccessthisdialogboxselectOptionsfromtheToolsmenu.

Theoptionsdialogboxcontainsthefollowingpages:

SystemPage

7-Zip

FoldersPage

EditorPage

SettingsPage

LanguagePage

SystemPageAllowsyoutospecifythebehaviorof7-Zipinthefilingsystem.

Associate7-ZipwithAllowstoassociate7-Zipwithfilenameextensions.Therearetwolistofassociations:for"CurrentUser"andfor"AllUsers".Tosetassociationsfor"AllUsers"youmustrun7-ZipFileManagerwithadministratorrights.Eachassociationcanhaveupto4states:

noassociation.

AppName-theextensionisassociatedwithanotherprogram(not7-Zip).

[7-Zip]-theextensionisassociatedwithanothercopy(edition)of7-Zip.

7-Zip-theextensionisassociatedwiththiscopyof7-Zip.

Youcanswitchbetweenthesestatesbyclickingoncell.Oryoucanchangestatesforallextensionbyclickingon"+"button.

7-ZipPageAllowsyoutospecifybehaviorof7-ZipinWindowsShell.

Integrate7-ZiptoshellcontextmenuSelectthischeckboxtoadd7-ZipcommandstoShellContextMenu.Therearetwocheckboxesin64-bitsystem.Soit'spossibletoenable7-Zipcontextmenufor32-bitand64-bitapplications.

CascadedcontextmenuSelectthischeckboxtogroup7-Zipcontextmenuitemstoone7-Zipsubmenu.

IconsincontextmenuSelectthischeckboxtoshow7-Zipiconincontextmenuitems.

EliminateduplicationofrootfolderThatoptionallowstoeliminateduplicationofrootfolderfor"Extractto"operations,ifallfilesinarchiveareplacedinfolderwithnamethatisidenticaltonameofoutputfolder.

ContextmenuitemsListstheoptionalcontextmenuitems.Ifanitemischecked,7-Zipwilladdthisitemtothecontextmenu.

FoldersPageAllowsyoutosetthefolderswhich7-Zipwilluseforinternalpurposes.

WorkingfolderTheworkingfoldersectionallowsyoutospecifyafolderwhichwillbeusedfortemporaryarchivefiles:

Systemtempfolder7-ZipwillusetheWindowstempfolder.

Current7-Zipwillusethefoldercontainingthetargetarchive.

Specified7-Zipwillusethefolderspecifiedinthefollowingeditcontrol.

UseforremovabledrivesonlySpecifieswhether7-Zipshouldusethespecifiedfoldersettingsonlyforremovabledrives;forotherdrives,7-Zipwillcreatetemporaryarchivesinthefoldercontainingthetargetarchive.Ifyouclearthischeckbox,7-Zipalwayswillusethespecifiedfoldersettingsmodealways.

7-Zipusestemporaryarchivefilesforallupdateoperations.So,forspeedreasons,itisrecommendedthatyouselecttheSystemtempfolderoptionandselectUseforremovabledrivesonlycheckbox.

EditorPageAllowsyoutospecifysettingsfortheeditor.

ViewSpecifiesthepathtotheviewerthatwillbeusedfor"View"command(F3).

EditorSpecifiesthepathtotheeditorthatwillbeusedfor"Edit"command(F4).

DiffSpecifiesthepathtoafilecomparisonutilitythatshowsthedifferencesbetweentwofiles.

SettingsPageAllowsyoutospecifysomesettings.

Show..itemShows..iteminfilelist.

ShowrealfileiconsShowsrealfileiconsinfilelist.Ifthisoptionisenabled,listingupdatescanbeslower.

FullrowselectWhenanitemisselected,theitemandallitssubitemsarehighlighted.

ShowgridlinesDisplaysgridlinesarounditemsandsubitems.

Single-clicktoopenanitemIfenabled,FileManageropensfilesandfoldersbysingle-clickingthem.

AlternativeselectionmodeIfenabled,FileManagerkeepsselectionmarkwhenyoumovecursor.

ShowsystemmenuShowsasystemcontextsub-menuintheFilemenu.

UselargememorypagesIfenabled,7-Zipwilltrytouselargepages.Thisfeatureallowsanincreaseinspeedofcompression.Thismaycause7-Ziptopausewhenstartingcompression,becauseofallocationofthelargepages.Also,theWindowsTaskManagerdoesn'tshowtherealmemoryusageoftheprogram,if7-Zipuseslargepages.ThisfeatureworksonlyonWindows2003/XPx64.Alsoyoumusthaveadministrator's

rightsforyoursystem.RecommendedsizeofRAM:1GBormore.Toinstallthisfeatureyoumustrun7-ZipFileManageratleastonce,closeitandrebootthesystem.

LanguagePageAllowsyoutochangethedefaultlanguage.

LanguageListstheavailablelanguages.

Benchmark

Thisformallowsyoutomeasuretheperformanceofyourcomputer.

Therearetwotests:

1. CompressionwithLZMAmethod

2. DecompressionwithLZMAmethod

ThebenchmarkshowsaratinginMIPS(millioninstructionspersecond).Theratingvalueiscalculatedfromthemeasuredspeed,anditisnormalizedwithresultsofIntelCore2CPUwithmulti-threadingoptionswitchedoff.SoifyouhavemodernCPUfromIntelorAMD,ratingvaluesinsingle-threadmodemustbeclosetorealCPUfrequency.

Youcanchangethedictionarysizetoincreasememoryusage.Alsoyoucanchangethenumberofthreads.

TheCPUUsagecolumnshowsthepercentageoftimetheprocessorisworking.It'snormalizedforaone-threadload.Forexample,180%CPUUsagefor2threadscanmeanthataverageCPUusageisabout90%foreachthread.

TheRating/Usagecolumnshowsratingnormalizedfor100%ofCPUusage.ThatcolumnshowsperformanceoftheoneCPUthread.ItmustbeclosetorealCPUfrequency,ifyouhavemodernCPU.

TheTotalratingshowsaveragesofthecompressinganddecompressionratings.

Compressionspeedandratingstronglydependfrommemory(RAM)latency.

DecompressionspeedandratingstronglydependonCPUintegeroperations.Forexample,anIntelPentium4hasbigbranchmispredictionpenalty(whichiseffectoflongpipeline)andprettyslowmultiplyandshiftoperations.So,thePentium4hasprettylowdecompressingratings.

Alsotheprogramcheckspossibleerrors.Iftheprogramshowssomeerrormessage,inmostcasesitmeansthatyourRAMisdefective.Ifso,don'tuse7-Zipforcompressingdata,sincesucherrorscanleadtodata

losses.

AboutDialogBox

TheAboutdialogboxprovidesinformationabout7-Zip.ThisdialogboxisavailablefromtheHelpmenu.

Presswww.7-zip.orgbuttonforopening7-ZipHomePage.

Plugins

The7-ZipFileManagercanuseinternalandexternalplugins.

Currently7-Zipusesthefollowingplugins:

7-ZipPluginformanipulatingarchives.

7-ZipPlugin

7-Zipisapluginformanipulatingarchives.ItmakesallarchivefileslooklikeusualfoldersinFileManager.

Mostoftheoperationswithcompressedfilescanbeinitiatedbyright-clickingonfilesintheFileManager(orinWindowsExplorer)andselectingtheappropriatecommandfromamenu.

Using7-Zip

Openingarchive

Therearetwowaystoopenanarchivefile:

Ifyouhavethefiletypeassociatedwith7-Zip,thenyoucanopenthefilewith7-Zipbydouble-clickingthefileorbyright-clickingandselectingtheOpencommand.

Youcanright-clickthearchivefile,pointto7-Zip,andthenclicktheOpencommanditem.

Extractingarchive

Therearetwowaystoextractfilesfromanarchive:

Toextractallfilesfromanarchiveright-clickthearchivefile,pointto7-Zip,andthenclicktheExtractfiles...commanditem.

Toextractspecificfilesfromanarchive,openitbyOpenarchivewith7-Zip,selecttheitemstoextract,andruntheCopyTo...command.

ExtractDialogwillappear.

Testingarchive

Totestanarchive,right-clickthearchivefile,pointto7-Zip,andthenclicktheTestarchivecommanditem.

Creatingandupdatingfilesinanarchive

Forcreatingorupdatinganarchivefile,right-clickthefile(s)orfolder(s)youwanttocompress,pointto7-Zip,andthenclicktheAddtoarchive...commanditem.AddtoArchiveDialogwillappear.

AddtoArchiveDialogBox

Allowsyoutospecifyoptionsforcreatingorupdatinganarchive.

Howtocallthisdialogbox

1. InWindowsExplorerorin7-Zip,right-clickthefile(s)orfolder(s)youwanttocompress.

2. Pointto7-Zip,andthenclicktheAddtoarchive...commanditem.

Parameters

ArchiveProvidesaspaceforyoutospecifyadestinationarchivename.Youcanclick"..."buttontodisplay"Open"dialogboxthatyoucanusetolocatearchive.

ArchiveformatSpecifiesaformatofcreatedarchive.Someformats(gzipandbzip2)donotsupportcompressingmoretheonefileperarchive.

Compressionlevel

Specifiescompressionlevel.Thereare6levelsofcompression:

Value MeaningStore Fileswillbecopiedtoarchivewithoutcompression.Fastest Fastestcompression.Fast Fastcompression.Normal Compressionwithbalancedsettings.

Maximum CangiveahighercompressionratiothanNormallevel.Butitcanbeslower,anditcanrequiremorememory.

Ultra CangiveahighercompressionratiothanMaximumlevel.Butitcanbeslower,anditcanrequiremorememory.

Compressionmethod

Specifiescompressionmethod.Eacharchiveformatcanhaveitsowncompressionmethods:

Method Description

LZMA

It'sbasecompressionmethodfor7zformat.Evenoldversionsof7-ZipcandecompressarchivescreatedwithLZMAmethod.Itprovideshighcompressionratioandveryfastdecompression.

LZMA2

Defaultcompressionmethodof7zformat.LZMA2isLZMA-basedcompressionmethod.ItprovidesbettermultithreadingsupportthanLZMA.Butcompressionratiocanbeworseinsomecases.ForbestcompressionratiowithLZMA2use1or2CPUthreads.IfyouuseLZMA2withmorethan2threads,7-zipsplitsdatatochunksandcompressesthesechunksindependently(2threadspereachchunk).

PPMdDmitryShkarin'sPPMdHalgorithmwithsmallchanges.Usuallyitprovideshighcompressionratioandhighspeedfortextfiles.

BZip2StandardcompressionmethodbasedonBWTalgorithm.Usuallyitprovideshighspeedandprettygoodcompressionratiofortextfiles.

Deflate

StandardcompressionmethodofZIPandGZipformats.Compressionratioisnottoohigh.Butitprovidesprettyfastcompressinganddecompressing.Deflatemethodsupportsonly32KBdictionary.

Deflate64 ModifiedversionofDeflatealgorithmwithbiggerdictionary(64KB).

Estimated7-Zipperformanceandmemoryrequirementsfor2GHzdualcoreCPU:

Method Level DictionarySize

CompressingSpeed

DecompressingSpeed

MemoryforCompressing

LZMA

fastest 64KB 4.5MB/s

15MB/s

3MBfast 1MB 3MB/s 10MBnormal 16MB 2MB/s 186MBmaximum 32MB 1.8MB/s 376MB

ultra 64MB 1.6MB/s 709MB

PPMD

fast 4MB 1.4MB/s 6MBnormal 24MB 1.2MB/s 26MBmaximum 64MB 1.0MB/s 66MBultra 192MB 0.9MB/s 194MB

Deflate

fast

32KB

15MB/s

40MB/s3MB

normal 3.5MB/smaximum 1.5MB/s

4MBultra 0.4MB/s

BZip2normal

900KB3MB/s

16MB/s 20MBmaximum 1.2MB/sultra 0.4MB/s

Dictionarysize

SpecifiesDictionarysizeforcompressionmethod.

Usually,ahigherDictionarysizegivesahighercompressionratio.Butcompressingcanbesloweranditcanrequiremorememory.

Memory(RAM)usageforLZMAcompressingisabout11timesmorethandictionarysize.MemoryusageforLZMAdecompressingisclosetovalueofdictionarysize.MemoryusageforPPMdcompressinganddecompressingisalmostequaltodictionarysize.

Wordsize

Specifiesthelengthofwords,whichwillbeusedtofindidenticalsequencesofbytesforcompression.

UsuallyforLZMAandDeflate,bigWordsizegivesalittlebitbettercompressionratioandslowercompressionprocess.AbigWordsizeparametercansignificantlyincreasecompressionratioforfileswhichcontainlongidenticalsequencesofbytes.ForPPMd,theWordsizestronglyaffectsbothcompressionratioandcompression/decompressionspeed.

SolidBlocksize

Specifiesthesizeofasolidblock.Youcanalsodisablesolidmode.

Insolidmodeallfileswillbecompressedascontinuousdatablocks.Usuallycompressingtoasolidarchiveimprovesthecompressionratio.Youcanusethisoptiononlyfor7zarchives.Theupdatingofsolid.7zarchivescanbeslow,sinceitcanrequiresomerecompression.

.

NumberofCPUthreads

Specifiesthenumberofthreadsforcompressing.AbignumberofthreadscanspeedupcompressionspeedonMulti-Processorsystems.Sometimesitcanincreasespeedevenonsingle-coreCPU.

Splittovolumes{Size}[b|k|m|g]

SpecifiesvolumesizesinBytes,Kilobytes(1Kilobyte=1024bytes),Megabytes(1Megabyte=1024Kilobytes)orGigabytes(1Gigabyte=1024Megabytes).Ifyouspecifyonly{Size},7-zipwilltreatitasbytes.It'spossibletospecifyseveralvalues.Example:

10k15k2m

Thefirstvolumewillbe10KB,thesecondwillbe15KB,andallotherswillbe2MB.

Parameters

Allowsyoutospecifyparametersforcompression.Seethe-m(Method)switchdescriptionformoredetails.Omitthe-mprefix(asin-mswitch)whenusingthisdialogbox.

Examplesf=delta:4

usesDelta:4filter(ifyouwanttocompressWAVfiles).

f=bcj2

usesBCJ2filter(forx86executables).

Updatemode

Specifiesupdatemode:

Value MeaningAddandreplacefiles Addallspecifiedfilestothearchive.

Updateandaddfiles

Updateolderfilesinthearchiveandaddfilesthatarenewtothearchive.

Freshenexistingfiles

Updatespecifiedfilesinthearchivethatareolderthantheselecteddiskfiles.

Synchronizefiles

Replacespecifiedfilesonlyifaddedfilesarenewer.Alwaysaddthosefiles,whicharenotpresentinthearchive.Deletefromarchivethosefiles,whicharenotpresentonthedisk.

Pathmode

Specifieshowpathnameswillbestoredinarchive:

Value MeaningRelativepathnames Storefilepathsrelativetocurrentfolder.

Fullpathnames Storefilepathsrelativetorootofthevolume,excludingvolumenameprefix.

Absolutepathnames

Storefullyqualifiedfilepathsincludingvolumename.

Options

Specifiescompressionoptions:

Option Meaning

CreateSFXarchive

Createself-extractingarchive.Youcanusethisoptiononlyfor7zarchives.Lookto-sfx(CreateSFXarchive)switchdescriptionformoredetailsaboutSFXmodules.

Compresssharedfiles

Compressfilesopenforwritingbyanotherapplications.

DeletefilesafterDeletefilesafterincludingtoarchive.Soitworkslikemovingfilestoarchive.7-Zipdeletes

compression filesattheendofoperationandonlyifarchivewassuccessfullycreated.

Encryption

Specifiespasswordandencryptionoptions.

EnterpasswordSpecifypasswordhere

ReenterpasswordReenterpasswordhereforverification

ShowPasswordShowsPassword

EncryptionmethodSpecifiestheencryptionmethod.For7zformat,itcanbeonlyAES-256.ForZIPformatyoucanselectZipCryptoorAES-256.UseZipCrypto,ifyouwanttogetarchivecompatiblewithmostoftheZIParchivers.AES-256providesstrongerencryption,butnowAES-256issupportedonlyby7-Zip,WinZipandsomeotherZIParchivers.

EncryptfilenamesEnablesordisablesarchiveheaderencryption,includingfilenameencryption.

ExtractDialogBox

Allowsyoutospecifyoptionsforextractingfilesfromarchive.

Howtorunthisdialogbox

Therearetwowaystorunthisdialogtoextractallfilesfromanarchive:

InWindowsExplorerorin7-Zip,right-clickthearchivefile,pointto7-Zip,andthenclickExtractfiles....

Selectthearchivefilein7-ZipandpressExtractbutton.

Parameters

ExtracttoProvidesaspaceforyoutospecifyanoutputfolder.Youcanclick"..."buttontodisplay"Browseforfolder"dialogboxthatyoucanusetolocateoutputfolder.

Pathmode

Specifyextractmode:

Value MeaningFullpathnames Extractfileswithfullpathnames.

Nopathnames Extractfileswithoutfolderpaths.

Absolutepathnames

Extractfileswithabsolutepathnames.7-Zipdoesn'tusefolderspecifiedin"Extractto"fieldforfilesinarchivethathaveabsolutepathnames.Absolutepathcanincludedrivename.

EliminateduplicationofrootfolderThatoptionallowstoeliminateduplicationofrootfolder,ifallfilesinarchiveareplacedinfolderwithnamethatisidenticaltonameofoutputfolder.

Overwritemode

Specifyoverwritemodeforfilesthatalreadypresentondisk:

Value MeaningAskbeforeoverwrite Askbeforeoverwritingexistingfiles.

Overwritewithoutprompt

Overwriteexistingfileswithoutprompt.

Skipexistingfiles

Skipextractingofexistingfiles.

Autorename

Renameextractedfiles,ifafilewiththesamenamealreadyexists.Forexample,filedocument.txtwillberenamedtodocument_1.txt.

Autorenameexistingfiles

Renameexistingfiles,ifafilewiththesamenamealreadyexists.Forexample,filedocument.txtwillberenamedtodocument_1.txt.

Password

Specifiesapasswordforencryptedarchives.

ShowPasswordShowapasswordinPasswordfield.

RestorefilesecurityRestorefilesecurityinformation,ifarchivecontainsthatinformation.ThatfeaturenowisimplementedonlyforWIMarchives.

CommandLineVersionUser'sGuide

7z.exeisthecommandlineversionof7-Zip.7z.exeuses7z.dllfromthe7-Zippackage.7z.dllisusedbythe7-ZipFileManageralso.

7za.exe(a=alone)isastandaloneversionof7-Zip.7za.exesupportsonly7z,lzma,cab,zip,gzip,bzip2,Zandtarformats.7za.exedoesn'tuseexternalmodules.

CommandLinesyntax

ExitCodes

Commands

Switches

CommandLineSyntax7z<command>[<switch>...]<base_archive_name>[<arguments>...]

<arguments>::=<switch>|<wildcard>|<filename>

<switch>::=-{switch_name}|@{listfile}

Expressionsinsquarebrackets(between'['and']')areoptional.

Expressionsincurlybraces('{'and'}')meanthatinsteadofthatExpression(includingbraces),theusermustsubstitutesomestring.

Expression

expression1|expression2|...|expressionN

meansthatany(butonlyone)fromtheseexpressionsmustbespecified.

Commandsandswitchescanbeenteredinupperorlowercase.

Commandisthefirstnon-switchargument.

The"base_archive_name"mustbethefirstfilenameonthecommandlineafterthecommand.

Theswitchesandotherfilenamescanbeinanyorder.

Wildcardsorfilenameswithspacesmustbequoted:

"Dir\Programfiles\*"

Dir\"Programfiles"\*

Switchoptionscanbecombinedtosavecommandlinelength.However,someswitchoptionstakeoptionalstringargumentsandtherefore,mustbethelastoptioninacombinedargumenttokenstringbecause7-Zipacceptstherestoftheargumenttokenastheoptionalargument.

7-ZipuseswildnamematchingsimilartoWindows95:

'*'meansasequenceofarbitrarycharacters.

'?'meansanycharacter.

7-Zipdoesn'tusethesystemwildcardparser.7-Zipdoesn'tfollowthearchaicrulebywhich*.*meansanyfile.7-Ziptreats*.*asmatchingthenameofanyfilethathasanextension.Toprocessall

files,youmustusea*wildcard.

Examples:

*.txt meansallfileswithanextensionof".txt"?a* meansallfileswithasecondcharacterof"a"*1* meansallnamesthatcontainscharacter"1"*.*.* meansallnamesthatcontaintwoatleast"."characters

Thedefaultwildcard"*"willbeusedifthereisnofilename/wildcardinthecommandline.

Slash('\')attheendofapathmeansadirectory.WithoutaSlash('\')attheendofthepath,thepathcanrefereithertoafileoradirectory.

Listfile

Youcansupplyoneormorefilenamesorwildcardsforspeciallistfiles(filescontaininglistsoffiles).Thefilenamesinsuchlistfilemustbeseparatedbynewlinesymbol(s).

Forlistfiles,7-ZipusesUTF-8encodingbydefault.Youcanchangeencodingusing-scsswitch.

Multiplelistfilesaresupported.

Forexample,ifthefile"listfile.txt"containsthefollowing:

Myprograms\*.cpp

Src\*.cpp

thenthecommand

[email protected]

addstothearchive"archive.zip"all"*.cpp"filesfromdirectories"Myprograms"and"Src".

ShortandLongFileNames7-Zipsupportsshortfilenames(likeFILENA~1.TXT)insomecases.However,it'sstronglyrecommendedtouseonlythereal(long)filenames.

ExitCodesfrom7-Zip

7-Zipreturnsthefollowingexitcodes:

Code Meaning0 Noerror

1 Warning(Nonfatalerror(s)).Forexample,oneormorefileswerelockedbysomeotherapplication,sotheywerenotcompressed.

2 Fatalerror7 Commandlineerror8 Notenoughmemoryforoperation255 Userstoppedtheprocess

CommandLineCommands

Thecommandisthefirstnon-switchargumentonthecommandline.

Commandnamesarenotcasesensitive.

SeealsoCommandLineSyntaxformoredetailsaboutusingthecommandline.

Commandsquickreference

Command Descriptiona Addb Benchmarkd Deletee Extracth Hashi Showinformationaboutsupportedformatsl Listrn Renamet Testu Updatex eXtractwithfullpaths

a(Add)command

Addsfilestoarchive.

Examples7zaarchive1.zipsubdir\

addsallfilesandsubfoldersfromfoldersubdirtoarchivearchive1.zip.Thefilenamesinarchivewillcontainsubdir\prefix.

7zaarchive2.zip.\subdir\*

addsallfilesandsubfoldersfromfoldersubdirtoarchivearchive2.zip.Thefilenamesinarchivewillnotcontainsubdir\prefix.

cd/Dc:\dir1\

7zac:\archive3.zipdir2\dir3\

Thefilenamesinarchivec:\archive3.zipwillcontaindir2\dir3\prefix,buttheywillnotcontainc:\dir1\prefix.

7zaFiles.7z*.txt-r

addsall*.txtfilesfromcurrentfolderanditssubfolderstoarchiveFiles.7z.

Notes

7-Zipdoesn'tusethesystemwildcardparser.7-Zipdoesn'tfollowthearchaicrulebywhich*.*meansanyfile.7-Ziptreats*.*asmatchingthenameofanyfilethathasanextension.Toprocessallfiles,youmustusea*wildcard.

Switchesthatcanbeusedwiththiscommand

-i(Include)-m(Method)-p(SetPassword)-r(Recurse)-sdel(Deletefilesafterincludingtoarchive)-sfx(createSFX)

-si(useStdIn)-sni(StoreNTsecurityinformation)-sns(StoreNTFSalternateStreams)-so(useStdOut)-spf(Usefullyqualifiedfilepaths)-ssw(Compresssharedfiles)-stl(Setarchivetimestampfromthemostrecentlymodifiedfile)-t(Typeofarchive)-u(Update)-v(Volumes)-w(WorkingDir)-x(Exclude)

Seealso

Commands:d(Delete),u(Update)Switches:-u(Update)

b(Benchmark)command

MeasuresspeedoftheCPU.

BenchmarkexecutionalsocanbeusedtocheckRAMforerrors.

Syntaxb[number_of_iterations][-mmt{N}][-md{N}][-mm={Method}]

TheLZMAbenchmarkisdefaultbenchmarkforbenchmarkcommand.

TherearetwotestsforLZMAbenchmark:

1. CompressingwithLZMAmethod

2. DecompressingwithLZMAmethod

TheLZMAbenchmarkshowsaratinginMIPS(millioninstructionspersecond).Theratingvalueiscalculatedfromthemeasuredspeed,anditisnormalizedwithresultsofIntelCore2CPUwithmulti-threadingoptionswitchedoff.SoifyouhavemodernCPUfromIntelorAMD,ratingvaluesinsingle-threadmodemustbeclosetorealCPUfrequency.

Youcanchangetheupperdictionarysizetoincreasememoryusageby-md{N}switch.Also,youcanchangethenumberofthreadsby-mmt{N}switch.

TheDictcolumnshowsdictionarysize.Forexample,21means2^21=2MB.

TheUsagecolumnshowsthepercentageoftimetheprocessorisworking.It'snormalizedforaone-threadload.Forexample,180%CPUUsagefor2threadscanmeanthataverageCPUusageisabout90%foreachthread.

TheR/Ucolumnshowstheratingnormalizedfor100%ofCPUusage.ThatcolumnshowstheperformanceofoneaverageCPUthread.

Avrshowsaveragesfordifferentdictionarysizes.

Totshowsaveragesofthecompressionanddecompressionratings.

Thetestdatathatisusedforcompressioninthattestisproducedwithspecialalgorithm,thatcreatesdatastreamthathassomepropertiesofrealdata,liketextorexecutioncode.NotethatthespeedofLZMAforrealdatacanbeslightlydifferent.

LZMAbenchmarkdetailsCompressionspeedstronglydependsfrommemory(RAM)latency,DataCachesize/speedandTLB.Out-of-OrderexecutionfeatureofCPUisalsoimportantforthattest.

DecompressionspeedstronglydependsonCPUintegeroperations.Themostimportantthingsforthattestare:branchmispredictionpenalty(thelengthofpipeline)andthelatenciesof32-bitinstructions("multiply","shift","add"andother).Thedecompressiontesthasveryhighnumberofunpredictablebranches.NotethatsomeCPUarchitectures(forexample,32-bitARM)supportinstructionsthatcanbeconditionallyexecuted.SosuchCPUscanworkwithoutbranches(andwithoutpipelineflushing)inmanycasesinLZMAdecompressioncode.AndsuchCPUscanhavesomespeedadvantagesoverotherarchitecturesthatdon'tsupportcomplexconditionallyexecution.Out-of-OrderexecutioncapabilityisnotsoimportantforLZMADecompression.

Thetestcodedoesn'tuseFPUandSSE.Mostofthecodeis32-bitintegercode.Onlysomeminorpartincompressioncodeusesalso64-bitintegers.RAMandCachebandwidtharenotsoimportantforthesetests.Thelatenciesaremuchmoreimportant.

TheCPU'sIPC(Instructionspercycle)rateisnotveryhighforthesetests.Theestimatedvalueoftest'sIPCis1(oneinstructionpercycle)formodernCPU.ThecompressiontesthasbignumberofrandomaccessestoRAMandDataCache.SobigpartofexecutiontimetheCPUwaitsthedatafromDataCacheorfromRAM.Thedecompressiontesthasbignumberofpipelineflushesaftermispredictedbranches.SuchlowIPCmeansthattherearesomeunloadedCPUresources.ButtheCPUwithHyper-ThreadingfeaturecanloadtheseCPUresourcesusingtwothreads.SoHyper-Threadingprovidesprettybigimprovementinthesetests.

LZMAbenchmarkinmultithreadingmodeWhenyouspecify(N*2)threadsfortest,theprogramcreatesNcopiesofLZMAencoder,andeachLZMAencoderinstancecompressesseparatedblockoftestdata.EachLZMAencoderinstancecreates3unsymmetricalexecutionthreads:twobigthreadsandonesmallthread.ThetotalCPUloadforthese3threadscanvaryfrom140%to200%.ToprovidebetterCPUloadduringcompression,youcantestthemode,wherethenumberofbenchmarkthreadsislargerthanthenumberofhardwarethreads.

EachLZMAencoderinstanceinmultithreadingmodedividesthetaskofcompressioninto3differenttasks,whereeachtaskisexecutedinseparatedthread.Eachofthesetasksissimplerthanoriginaltask,andituseslessmemory.SoeachthreadusesthedatacacheandTLBmoreeffectivelyinmultithreadingmode.AndLZMAencoderisslightlymoreeffectiveinmultithreadingmodeinvalueof"theSpeed"dividedto"CPUusage".

Notethatthereissomedatatrafficbetween3threadsofLZMAencoder.SodataexchangebandwidthviamemorybetweenCPUthreadsisalsocanbeimportant,especiallyinmulti-coresystemwithbignumberofcoresorCPUs.

AllLZMAdecoderthreadsaresymmetricalandindependent.Sothedecompressiontestusesallhardwarethreads,ifthenumberofhardwarethreadsisused.

7-ZipbenchmarkWith-mm=*switchyoucanrunacomplexbenchmarkfor7-Zipcode.Ittestshashcalculationmethods,compressionandencryptioncodecsof7-Zip.NotethatthetestsofLZMAhavebigweightin"total"results.AndtheresultsarenormalizedwithAMDK8cpuinthatcomplexbenchmark.

TheCPUrowsshowCPUfrequency.It'smeasuredforsequenceofsimpleCPUinstructions.Note:Itcanbeinaccurate,ifhyper-threadingisused.

TheEffeccolumnshowsEfficiency-theRatingnormalizedtoCPUfrequency.

TheE/UcolumnshowstheEfficiencynormalizedfor100%ofCPUusage.

Examples7zb

runsbenchmarking.

7zb-mmt1-md26

runsbenchmarkingwithonethreadand64MBdictionary.

7zb30

runsbenchmarkingfor30iterations.ItcanbeusedtocheckRAMforerrors.

7zb-mm=*

runscomplex7-Zipbenchmark.

7zb-mm=*-mmt=*

runscomplex7-Zipbenchmarkfordifferentnumberofthreads:(1,max/2,max),wheremaxisnumberofavailablehardwarethreads.Soitcantest3mainmodes:single-thread,multi-threadwithouthyper-threading,multi-threadwithhyper-threading.

d(Delete)command

Deletesfilesfromarchive.

Example7zdarchive.zip*.bak-r

deletes*.bakfilesfromarchivearchive.zip.

Notes



-i(Include)-m(Method)-p(SetPassword)-r(Recurse)-sns(StoreNTFSalternateStreams)-u(Update)-w(WorkingDir)-x(Exclude)

Seealso

Commands:a(Add),u(Update)

Switches:-spf(Usefullyqualifiedfilepaths)-stl(Setarchivetimestampfromthemostrecentlymodifiedfile)-u(Update)

e(Extract)command

Extractsfilesfromanarchivetothecurrentdirectoryortotheoutputdirectory.Theoutputdirectorycanbespecifiedby-o(SetOutputDirectory)switch.

Thiscommandcopiesallextractedfilestoonedirectory.Ifyouwantextractfileswithfullpaths,youmustusex(Extractwithfullpaths)command.

7-Zipwillprompttheuserbeforeoverwritingexistingfilesunlesstheuserspecifiesthe-y(AssumeYesonallqueries)switch.Iftheusergivesanoanswer,7-Zipwillpromptforthefiletobeextractedtoanewfilename.Thenanoanswerskipsthatfile;or,yespromptsfornewfilename.

7-Zipacceptsthefollowingresponses:

Answer Abbr. ActionYes y No n

Always a AssumeYESforALLsubsequentqueriesofthesameclass

Skip s AssumeNOforALLsubsequentqueriesofthesameclass

Quit q Quittheprogram

Abbreviatedresponsesareallowed.

Examples7zearchive.zip

extractsallfilesfromarchivearchive.ziptothecurrentdirectory.

7zearchive.zip-oc:\soft*.cpp-r

extractsall*.cppfilesfromarchivearchive.ziptoc:\softfolder.

Notes



-ai(Includearchives)-an(Disableparsingofarchive_name)-ao(Overwritemode)-ax(Excludearchives)-i(Include)-m(Method)-o(SetOutputDirectory)-p(SetPassword)-r(Recurse)-si(useStdIn)-sni(StoreNTsecurityinformation)-sns(StoreNTFSalternateStreams)-so(useStdOut)-spf(Usefullyqualifiedfilepaths)-t(Typeofarchive)-x(Exclude)-y(AssumeYesonallqueries)

Seealso

Commands:x(Extractwithfullpaths)

h(Hash)command

Calculatehashvaluesforfiles.

Syntaxh[-scrc{Method}][files]

Supportedmethods:CRC32,CRC64,SHA1,SHA256,BLAKE2sp.DefaultmethodisCRC32.

Examples7zha.txt

calculatesCRC32fora.txt.

7zh-scrcsha256a.iso

calculatesSHA256fora.iso.

7zh*

calculatesCRC32forallfilesincurrentfolderandallsubfolders.

Notes

7-Zipshowshashvaluesforeachfile,thesumofhashvaluesandthesumthatincludesallhashvaluesofdataandallhashvaluesforfilenames.

7-ZiprepresentshashvaluesforCRC32andCRC64asintegernumbersinhex.

7-ZiprepresentshashvaluesForSHA1,SHA256andBLAKE2spassequenceofbytesinhex.


-i(Include)-m(Method)-r(Recurse)

-scrc(Sethashmethod)-si(useStdIn)-sns(StoreNTFSalternateStreams)-ssw(Compresssharedfiles)-x(Exclude)

l(Listcontentsofarchive)command

Listscontentsofarchive.

Examples7zlarchive.zip

listsallfilesfromarchivearchive.zip.

Notes



-ai(Includearchives)-an(Disableparsingofarchive_name)-ax(Excludearchives)-i(Include)-slt(Showtechnicalinformation)-sns(StoreNTFSalternateStreams)-p(SetPassword)-r(Recurse)-t(Typeofarchive)-x(Exclude)

rn(Rename)command

Renamesfilesinarchive.

Syntaxrn<archive_name><src_file_1><dest_file_1>[<src_file_2><dest_file_2>...]

Example7zrna.7zold.txtnew.txt2.txtfolder\2new.txt

renamesold.txttonew.txtand2.txttofolder\2new.txt.

Notes


-i(Include)-m(Method)-p(SetPassword)-r(Recurse)-stl(Setarchivetimestampfromthemostrecentlymodifiedfile)-u(Update)-w(WorkingDir)-x(Exclude)

t(Testintegrityofarchive)command

Testsarchivefiles.

Example7ztarchive.zip*.doc-r

tests*.docfilesinarchivearchive.zip.

Notes



-ai(Includearchives)-an(Disableparsingofarchive_name)-ax(Excludearchives)-i(Include)-p(SetPassword)-r(Recurse)-sns(StoreNTFSalternateStreams)-x(Exclude)

u(Update)command

Updateolderfilesinthearchiveandaddfilesthatarenotalreadyinthearchive.

Note:theupdatingofsolid.7zarchivescanbeslow,sinceitcanrequiresomerecompression.

Example7zuarchive.zip*.doc

updates*.docfilestoarchivearchive.zip.

Notes



-i(Include)-m(Method)-p(SetPassword)-r(Recurse)-sfx(createSFX)-si(useStdIn)-so(useStdOut)-sni(StoreNTsecurityinformation)-sns(StoreNTFSalternateStreams)-ssw(Compresssharedfiles)-spf(Usefullyqualifiedfilepaths)-stl(Setarchivetimestampfromthemostrecentlymodifiedfile)-t(Typeofarchive)-u(Update)-w(WorkingDir)-x(Exclude)

Seealso

Commands:a(Add),d(Delete),

Switches:-u(Update)

x(Extractwithfullpaths)command

Extractsfilesfromanarchivewiththeirfullpathsinthecurrentdirectory,orinanoutputdirectoryifspecified.

Seethee(Extract)commanddescriptionformoredetails.

Examples7zxarchive.zip

extractsallfilesfromthearchivearchive.ziptothecurrentdirectory.

7zxarchive.zip-oc:\soft*.cpp-r

extractsall*.cppfilesfromthearchivearchive.ziptoc:\softfolder.

Notes



-ai(Includearchives)-an(Disableparsingofarchive_name)-ao(Overwritemode)-ax(Excludearchives)-i(Include)-m(Method)-o(SetOutputDirectory)-p(SetPassword)-r(Recurse)-si(useStdIn)-sni(StoreNTsecurityinformation)-sns(StoreNTFSalternateStreams)-so(useStdOut)-spf(Usefullyqualifiedfilepaths)-t(Typeofarchive)

-x(Exclude)-y(AssumeYesonallqueries)

Seealso

Commands:e(Extract)

CommandLineSwitches

Syntax<switch;>::=-<switch_characters>[<option>]

Onthecommandline,aswitchconsistsofaswitchspecifier,eitheradash(-)oraforwardslash(/),followedbythenameoftheswitch.Switchnamescannotbeabbreviated.

Someswitchestakeanargumentaftertheswitchname.Nospacesortabsareallowedwithinaswitchspecification.Switchnamesarenotcasesensitive,butargumentscanbecasesensitive.

Switchcanbeusedinanyplaceincommandline.

SeealsoCommandLineSyntaxformoredetailsaboutusingthecommandline.

Switchquickreference

Switch Description-- Stopswitchesparsing-ad ShowdialogboxinGUIversion(7zg)-ai Includearchivefilenames-an Disableparsingofarchive_name-ao Overwritemode-ax Excludearchivefilenames-bb[0-3] Setoutputloglevel-bd Disableprogressindicator-bs{o|e|p}{0|1|2} Setoutputstreamforoutput/error/progress

-bt Showexecutiontimestatistics-i Includefilenames-m SetCompressionMethod-o SetOutputdirectory-p SetPassword-r Recursesubdirectories-sa SetArchivenamemode-scc Setcharsetforforconsoleinput/output-scrc Sethashfunction-scs Setcharsetforlistfiles-sdel Deletefilesafterincludingtoarchive-seml Sendarchivebyemail-sfx CreateSFXarchive-si ReaddatafromStdIn-slp SetLargePagesmode-slt Showtechnicalinformation-sni StoreNTsecurityinformation

-sns StoreNTFSalternateStreams

-snt[-] ReplacetraildotsandspacesinfilenamesforExtractoperation

-snc Extractfileasalternatestream,ifthereis':'characterinname

-snr Replace':'characterto'_'characterinpathsofalternatestreams

-snh Storehardlinksaslinks(WIMandTARformatsonly)

-snl Storesymboliclinksaslinks(WIMandTARformatsonly)

-so WritedatatoStdOut-spd Disablewildcardmatchingforfilenames

-spe Eliminateduplicationofrootfolderforextractarchivecommand

-spf Usefullyqualifiedfilepaths-ssc SetSensitiveCasemode-sse Stoparchivecreating,if7-Zipcan'topensomeinputfile-ssw Compressfilesopenforwriting

-stl Setarchivetimestampfromthemostrecentlymodifiedfile

-stm{HexMask} SetCPUthreadaffinitymask(hexadecimalnumber).

-stx{Type} Excludearchivetype-t Typeofarchive-u Updateoptions-v CreateVolumes-w SetWorkingdirectory-x Excludefilenames-y AssumeYesonallqueries

--(Stopswitchesparsing)switch

Disablesswitchparsingafter"--"onthecommandline.Thisistoallow7-Ziptousefilenamesthatstartwith"-".

Syntax--

Examples7zt---ArchiveName.7z

tests-ArchiveName.7zarchive.

-ai(Includearchivefilenames)switch

Specifiesadditionalincludearchivefilenamesandwildcards.

Multipleincludeswitchesaresupported.

Syntax-ai[<recurse_type>]<file_ref>

<recurse_type>::=r[-|0]

<file_ref>::=@{listfile}|!{wildcard}

Parameters

<recurse_type>

Specifieshowwildcardsandfilenamesinthisswitchmustbeused.Ifthisoptionisnotgiven,recursionwillbenotused.Formoredetailsseespecificationofthe-r(Recurse)switch.


<file_ref>

Specifiesfilenamesandwildcardsorlistfilethatspecifyprocessedfiles.


Option Description{listfile} Specifiesnameoflistfile.SeeListfiledescription.{wildcard} Specifieswildcardorfilename.

Examples7zt-an-air!*.7z

tests*.7zarchivesincurrentdirectoryandallit'ssubdirectories.

Commandsthatcanbeusedwiththisswitch

e(Extract),l(List),t(Test),x(Extractwithfullpaths)

Seealso

Switches:-ax(Excludearchives)-an(Disableparsingofarchive_name)

-an(Disableparsingofarchive_name)switch

Disablesparsingofthearchive_namefieldonthecommandline.Thisswitchmustbeusedwiththe-ai(Includearchives)switch.Ifyouuseafilelistforyourarchives,youspecifyitwiththe-aiswitch,soyouneedtodisableparsingofarchive_namefieldfromcommandline.

Syntax-an

Examples7zt-an-ai!*.7z-ax!a*.7z

testsall*.7zarchives,excepta*.7zarchives.



Seealso

Switches:-ai(Includearchives)-ax(Excludearchives)

-ao(Overwritemode)switch

Specifiestheoverwritemodeduringextraction,tooverwritefilesalreadypresentondisk.

Syntax-ao[a|s|t|u]

Switch Description-aoa OverwriteAllexistingfileswithoutprompt.-aos Skipextractingofexistingfiles.

-aou aUtorenameextractingfile(forexample,name.txtwillberenamedtoname_1.txt).

-aot autorenameexistingfile(forexample,name.txtwillberenamedtoname_1.txt).

Examples7zxtest.zip-aoa

extractsallfilesfromtest.ziparchiveandoverwritesexistingfileswithoutanyprompt.


e(Extract),x(Extractwithfullpaths)

Seealso

Switches:-y(assumeYesonallqueries),

-ax(Excludearchivefilenames)switch

Specifiesarchivestobeexcludedfromtheoperation.

Multipleexcludearchiveswitchesaresupported.

Syntax-ax[<recurse_type>]<file_ref>



See-xi(Includearchivefilenames)switchdescriptionforinformationaboutoptionparameters.

Examples7zt-an-ai!*.7z-ax!a*.7z

testsall*.7zarchives,excepta*.7zarchives.



Seealso

Switches:-ai(Includearchives)-an(Disableparsingofarchive_name)

-bb(Setoutputloglevel)switch

TheswitchsetsoutputloglevelforDelete/Add/Update/Extractoperations.

Syntax-bb[0-3]

Loglevel Description

-bb0 disablelog(default).-bb1or-bb

shownamesofprocessedfilesinlog.

-bb2shownamesofadditionalfilesthatwereprocessedinternallyinsolidarchives:skippedfilesfor"Extract"operation,repackedfilesfor"Add"/"Update"operations.

-bb3 showinformationaboutadditionaloperations(Analyze,Replicate)for"Add"/"Update"operations.

Examples7zaa.7z*.txt-bb

adds*.txtfilestoa.7zarchiveandshowsallfilesthatwereprocessed.

7zua.7z*.txt-bb3

updates*.txtfilesina.7zarchiveandshowsinformationaboutadditionaloperations.


a(Add),d(Delete),e(Extract),u(Update),x(Extractwithfullpaths)

-bs(Setoutputstreamforoutput/error/progressline)switch

Syntax-bs{o|e|p}{0|1|2}

{id} StreamTypeo standardoutputmessagese errormessagesp progressinformation{N} StreamDestination0 disablestream1 redirecttostdoutstream2 redirecttostderrstream

Defaultvalues:o1,e2,p1.

Examples7zta.7z-bse1>messages.txt

testsa.7zarchiveandsendserrormessagestostdoutthatisredirectedtomessages.txt

7za-si-so-bsp2-txz-an<file.tar>file.tar.xz

compressesfile.tar(fromstdin)tofile.tar.xz(stdoutstream)andshowsprogressinformationinstderrstreamthatcanbeseenatconsolewindow.


a(Add),d(Delete),h(Hash),l(List),e(Extract),u(Update),x(Extractwithfullpaths)

-i(Includefilenames)switch

Specifiesadditionalincludefilenamesandwildcards.

Multipleincludeswitchesaresupported.

Syntax-i[<recurse_type>]<file_ref>



Parameters

<recurse_type>

Specifieshowwildcardsandfilenamesinthisswitchmustbeused.Ifthisoptionisnotgiven,thentheglobalvalue,assignedbythe-r(Recurse)switchwillbeused.Formoredetailsseespecificationofthe-r(Recurse)switch.


<file_ref>

Specifiesfilenamesandwildcards,oralistfile,forfilestobeprocessed.


Option Description{listfile} Specifiesnameoflistfile.SeeListfiledescription.{wildcard} Specifieswildcardorfilename.

Examples7za-tzipsrc.zip*.txt-ir!DIR1\*.cpp

addstosrc.ziparchiveall*.txtfilesfromcurrentdirectoryandall*.cppfilesfromdirectoryDIR1andfromallit'ssubdirectories.


a(Add),d(Delete),e(Extract),h(Hash),l(List),rn(Rename),t(Test),u(Update),x(Extractwithfullpaths)

Seealso

Switches:-r(Recurse),-x(Exclude)

-m(SetcompressionMethod)switch

Specifiesthecompressionmethod.

Syntax-m<method_parameters>

Theformatforthisswitchdependsonthearchivetype.

Zip

GZip

BZip2

7z

XZ

WIM

-mswitchalsocanspecifyhashmethodforh(Hash)command,

Notes:"Defaultvalue"inswitchesdescriptionsmeansthevaluethatwillbeusedifswitchisnotspecified.

It'sallowedtousereducedformsforbooleanswitches:sw+orswinsteadsw=on,andsw-insteadofsw=off.

Zip

Parameter Default Descriptionx=[0|1|3|5|7|9] 5 Setslevelofcompression.

m={MethodID} Deflate Setsamethod:Copy,Deflate,Deflate64,BZip2,LZMA,PPMd.

fb={NumFastBytes} 32 SetsnumberofFastBytesforDeflateencoder.

pass={NumPasses} 1 SetsnumberofPassesforDeflateencoder.

d={Size}[b|k|m] 900000 SetsDictionarysizeforBZip2mem={Size}[b|k|m] 24 SetssizeofusedmemoryforPPMd.o={Size} 8 SetsmodelorderforPPMd.mt=[off|on|{N}] on Setsmultithreadingmode.em={EncryptionMethodID} ZipCrypto

Setsaencryptionmethod:ZipCrypto,AES128,AES192,AES256

tc=[off|on] onStoresNTFStimestampsforfiles:Modificationtime,Creationtime,Lastaccesstime.

cl=[off|on] off 7-Zipalwaysuseslocalcodepageforfilenames.

cu=[off|on] off 7-ZipusesUTF-8forfilenamesthatcontainnon-ASCIIsymbols.

cp={CodePage} off Setscodepage

Bydefault(ifclandcuswitchesarenotspecified),7-ZipusesUTF-8encodingonlyforfilenamesthatcontainsymbolsunsupportedbylocalcodepage.

x=[0|1|3|5|7|9]

Setslevelofcompression.x=0meansCopymode(nocompression).

Deflate/Deflate64settings:

Level NumFastBytes NumPasses Description1 Fastest

32 13 Fast5 Normal7 64 3 Maximum9 128 10 Ultra

x=1andx=3withDeflatemethodsetfastmodeforcompression.

BZip2settings:

Level Dictionary NumPasses Description1 100000

1Fastest

3 500000 Fast5

900000Normal

7 2 Maximum9 7 Ultra

fb={NumFastBytes}

SetsthenumberoffastbytesfortheDeflate/Deflate64encoder.Itcanbeintherangefrom3to258(257forDeflate64).Usually,abignumbergivesalittlebitbettercompressionratioandaslowercompressionprocess.Alargefastbytesparametercansignificantlyincreasethecompressionratioforfileswhichcontainlongidenticalsequencesofbytes.

pass={NumPasses}

SetsnumberofpassesforDeflateencoder.Itcanbeintherangefrom1to15forDeflateandfrom1to10forBZip2.Usually,abignumbergivesalittlebitbettercompressionratioandaslowercompressionprocess.

d={Size}[b|k|m]

SetstheDictionarysizeforBZip2.Youmustspecifythesizeinbytes,kilobytes,ormegabytes.ThemaximumvaluefortheDictionarysizeis900000b.Ifyoudonotspecifyanysymbolfromset[b|k|m],dictionarysizewillbecalculatedasDictionarySize=2^Sizebytes.

mem={Size}[b|k|m]

SetsthesizeofmemoryusedforPPMd.Youmustspecifythesizein

bytes,kilobytes,ormegabytes.Themaximumvalueis256MB=2^28bytes.Thedefaultvalueis24(16MB).Ifyoudonotspecifyanysymbolfromtheset[b|k|m],thememorysizewillbecalculatedas(2^Size)bytes.PPMdusesthesameamountofmemoryforcompressionanddecompression.

o={Size}

SetsthemodelorderforPPMd.Thesizemustbeintherange[2,16].Thedefaultvalueis8.

mt=[off|on|{N}]

Setsmultithreadmode.Ifyouhaveamultiprocessorormulticoresystem,youcangetaspeedincreasewiththisswitch.Thisoptionaffectsonlycompression(withanymethod)anddecompressionofBZip2streams.Eachthreadinthemultithreadmodeuses32MBofRAMforbuffering.Ifyouspecify{N},7-ZiptriestouseNthreads.

GZipGZipusesthesameparametersasZip,butGZipcompressesonlywithDeflatemethod.SoGZipsupportsonlythefollowingparameters:x,fb,pass.

BZip2

Parameter Default Descriptionx=[1|3|5|7|9] 5 Setslevelofcompression.pass={NumPasses} 1 SetsnumberofPassesforBzip2encoder.d={Size}[b|k|m] 900000 SetsDictionarysizeforBZip2mt=[off|on|{N}] on Setsmultithreadingmode.

x=[1|3|5|7|9]

Setslevelofcompression

Level Dictionary NumPasses Description1 100000

1Fastest

3 500000 Fast5

900000Normal

7 2 Maximum9 7 Ultra

d={Size}[b|k|m]

SetstheDictionarysizeforBZip2.Youmustspecifythesizeinbytes,kilobytes,ormegabytes.ThemaximumvaluefortheDictionarysizeis900000b.Ifyoudonotspecifyanysymbolfromset[b|k|m],dictionarysizewillbecalculatedasDictionarySize=2^Sizebytes.

pass={NumPasses}

Setsthenumberofpasses.Itcanbeintherangefrom1to10.Thedefaultvalueis1fornormalmode,2formaximummodeand7forultramode.Abiggernumbercangivealittlebitbettercompressionratioandaslowercompressionprocess.

mt=[off|on|{N}]

Setsmultithreadmode.Ifyouhaveamultiprocessorormulticoresystem,youcangetaspeedincreasewiththisswitch.Ifyouspecify{N},forexamplemt=4,7-Ziptriestouse4threads.

Parameter Default Descriptionx=[0|1|3|5|7|9] 5 Setslevelofcompression.yx=[0|1|3|5|7|9] 5 Setsleveloffileanalysis.s=[off|on|[e][{N}f][{N}b|{N}k|{N}m|{N}g|{N}t]

on Setssolidmode.

qs=[off|on] off Sortfilesbytypeinsolidarchives.

f=[off|on|FilterID] onEnablesordisablesfilters.FilterID:Delta:{N},BCJ,BCJ2,ARM,ARMT,IA64,PPC,SPARC.

hc=[off|on] on Enablesordisablesarchiveheadercompressing.

he=[off|on] off Enablesordisablesarchiveheaderencryption.

b{C1}[s{S1}]:{C2}[s{S2}] Setsbindingbetweencoders.

{N}={MethodID}[:param1][:param2][..] LZMA2

Setsamethod:LZMA,LZMA2,PPMd,BZip2,Deflate,Delta,BCJ,BCJ2,Copy.

mt=[off|on|{N}] on Setsmultithreadingmode.mtf=[off|on] on Setmultithreadingmodeforfilters.

tm=[off|on] on StoreslastModifiedtimestampsforfiles.

tc=[off|on] off StoresCreationtimestampsforfiles.ta=[off|on] off StoreslastAccesstimestampsforfiles.tr=[off|on] on Storesfileattributes.

x=[0|1|3|5|7|9]

Setslevelofcompression

Level Method Dictionary FastBytes MatchFinder Filter Description

0 Copy Nocompression.

1 LZMA2 64KB 32 HC4 BCJ Fastestcompressing

3 LZMA2 1MB 32 HC4 BCJ Fastcompressing

5 LZMA2 16MB 32 BT4 BCJ Normalcompressing

7 LZMA2 32MB 64 BT4 BCJ Maximumcompressing

9 LZMA2 64MB 64 BT4 BCJ2 Ultracompressing

Note:"x"worksas"x=9".

yx=[0|1|3|5|7|9]

Setsleveloffileanalysis

Level Description0 Noanalysis.

1ormoreWAVfileanalysis(forDeltafilter).7ormore EXEfileanalysis(forExecutablefilters).9ormore analysisofallfiles(Deltaandexecutablefilters).

Defaultlevelis5:"yx=5".

"yx"worksas"yx=9".

Ifthelevelofanalysisissmallerthan9,7-Zipanalysesonlyfilesthathavesomefilenameextensions:EXE,DLL,WAV.7-Zipreadssmalldatablockatthebeginningoffileandtriestoparsetheheader.Itsupportsonlysomeformats:WAV,PE,ELF,Mach-O.Thenitcanselectfilterthatcanincreasecompressionratioforthatfile.

Bydefault7-Zipusesx86filters(BCJorBCJ2)forPEfiles(EXE,DLL).7-Zipdoesn'tuseanalysisindefault(yx=5)mode.If(yx=7),thenanalysisisusedforPEfiles,anditcanincreasecompressionratioforfilesfornon-x86platformslikeARM.

s=[off|on|[e][{N}f][{N}b|{N}k|{N}m|{N}g|{N}t)]

Enablesordisablessolidmode.Thedefaultmodeiss=on.Insolid

mode,filesaregroupedtogether.Usually,compressinginsolidmodeimprovesthecompressionratio.

e Useaseparatesolidblockforeachnewfileextension.Youneedtouseqsoptionalso.

{N}f Setthelimitfornumberoffilesinonesolidblock{N}b|{N}k|{N}m|{N}g|{N}t

Setalimitforthetotalsizeofasolidblockinbytes/KiB/MiB/GiB/TiB.

Thesearethedefaultlimitsforthesolidblocksize:

CompressionLevel Solidblocksize

Store 0BFastest 16MBFast 128MBNormal 2GBMaximum 4GBUltra 4GB

Limitationofthesolidblocksizeusuallydecreasescompressionratiobutgivesthefollowingadvantages:

Decreaseslossesincaseoffuturearchivedamage.

Decreasesextractiontimeofagroupoffiles(orjustonefile),solongasthegroupdoesn'tcontaintheentirearchive.

Theupdatingofsolid.7zarchivescanbeslow,sinceitcanrequiresomerecompression.

Example:

s=100f10m

setsolidmodewith100files&10MBlimitsperonesolidblock.

qs=[off|on]

Enablesordisablessortingfilesbytypeinsolidarchives.Thedefaultmodeisqs=off.

Oldversionsof7-Zip(beforeversion15.06)usedfilesorting"bytype"("byextension").

Newversionsof7-Zip(startingfromversion15.06)supporttwosortingorders:

qs-:sortingbyname:it'sdefaultorder.

qs:sortingbytype(byfileextension).

Youcangetbigdifferenceincompressionratiofordifferentsortingmethods,ifdictionarysizeissmallerthantotalsizeoffiles.Iftherearesimilarfilesindifferentfolders,thesorting"bytype"canprovidebettercompressionratioinsomecases.

Notethatsorting"bytype"hassomedrawbacks.Forexample,NTFSvolumesusesortingorder"byname",soifanarchiveusesanothersorting,thenthespeedofsomeoperationsforfileswithunusualordercanfallonHDDdevices(HDDshavelowspeedfor"seek"operations).

If"qs"modeprovidesmuchbettercompressionratiothandefault"qs-"mode,youstillcanincreasecompressionratiofor"qs-"modebyincreasingofdictionarysize.

Ifyouthinkthatunusualfileorderisnotproblemforyou,andifbettercompressionratiowithsmalldictionaryismoreimportantforyou,use"qs"mode.

Note:Therearesomefiles(forexample,executablefiles),thatarecompressedwithadditionalfilter.7-Zipcan'tusedifferentcompressionmethodsinonesolidblock,so7-zipcancreateseveralgroupsoffilesthatdon'tfollow"byname"orderin"qs-"mode,butfilesinsideeachgrouparestillsortedbynamein"qs-"mode.

f=[off|on|FilterID]

Enablesordisablescompressionfilters.Thedefaultmodeisf=on,when7-zipusesfilteronlyforexecutablefiles:dll,exe,ocx,sfx,sys.ItusesBCJ2filterinUltramodeandBCJfilterinothermodes.Iff=FilterIDifspecified,7-zipusesspecifiedfilterforallfiles.FilterIDcanbe:Delta:{N},BCJ,BCJ2,ARM,ARMT,IA64,PPC,SPARC.

hc=[off|on]

Enablesordisablesarchiveheadercompressing.Thedefaultmodeishc=on.Ifarchiveheadercompressingisenabled,thearchiveheaderwillbecompressedwithLZMAmethod.

he=[off|on]

Enablesordisablesarchiveheaderencryption.Thedefaultmodeishe=off.

b{C1}[s{S1}]:{C2}[s{S2}]

BindsoutputstreamS1incoderC1withinputstreamS2incoderC2.Ifstreamnumberisnotspecified,streamwithnumber0willbeused.

Usallycoderhasoneinputstreamandoneoutputstream.In7zsomecoderscanhavemultipleinputandoutputstreams.

Forexample,BCJ2encoderhasoneinputstreamandfouroutputstreams.

mt=[off|on|{N}]

Setsmultithreadmode.Ifyouhaveamultiprocessorormulticoresystem,youcangetaincreasewiththisswitch.7-ZipsupportsmultithreadmodeonlyforLZMA/LZMA2compressionandBZip2compression/decompression.Ifyouspecify{N},forexamplemt=4,7-Ziptriestouse4threads.LZMAcompressionusesonly2threads.

{N}={MethodID}[:param1][:param2]...[:paramN]

Setscompressionmethod.Youcanuseanynumberofmethods.ThedefaultmethodisLZMA2.

{N}setstheindexnumberofmethodinmethodschain.Numbersmustbeginfrom0.Methodsthathavesmallernumberswillbeusedbeforeothers.

Parametersmustbeinoneofthefollowingforms:

{ParamName}={ParamValue}.

{ParamName}{ParamValue},if{ParamValue}isnumberand{ParamName}doesn'tcontainnumbers.

Supportedmethods:

MethodID DescriptionLZMA LZ-basedalgorithmLZMA2 LZMA-basedalgorithmPPMd DmitryShkarin'sPPMdHwithsmallchangesBZip2 BWTalgorithmDeflate LZ+HuffmanCopy Nocompression

Supportedfilters:

MethodID DescriptionDelta DeltafilterBCJ converterforx86executablesBCJ2 converterforx86executables(version2)ARM converterforARM(littleendian)executablesARMT converterforARMThumb(littleendian)executablesIA64 converterforIA-64executablesPPC converterforPowerPC(bigendian)executablesSPARC converterforSPARCexecutables

Filtersincreasethecompressionratioforsometypesoffiles.Filtersmustbeusedwithoneofthecompressionmethod(forexample,BCJ+LZMA).

LZMA

LZMAisanalgorithmbasedonLempel-Zivalgorithm.Itprovidesveryfastdecompression(about10-20timesfasterthancompression).Memoryrequirementsforcompressionanddecompressionalsoaredifferent(seed={Size}[b|k|m|g]switchfordetails).

Parameter Default Descriptiona=[0|1] 1 Setscompressingmoded={Size}[b|k|m|g] 24 SetsDictionarysizemf={MF_ID} bt4 SetsMatchFinder

fb={N} 32 SetsnumberofFastBytesmc={N} 32 SetsNumberofCyclesforMatchFinderlc={N} 3 SetsnumberofLiteralContextbits-[0,8]lp={N} 0 SetsnumberofLiteralPosbits-[0,4]pb={N} 2 SetnumberofPosBits-[0,4]

a=[0|1]

Setscompressionmode:0=fast,1=normal.Defaultvalueis1.

d={Size}[b|k|m|g]

SetsDictionarysizeforLZMA.Youmustspecifythesizeinbytes,kilobytes,ormegabytes.Themaximumvaluefordictionarysizeis1536MB,but32-bitversionof7-Zipallowstospecifyupto128MBdictionary.DefaultvaluesforLZMAare24(16MB)innormalmode,25(32MB)inmaximummode(-mx=7)and26(64MB)inultramode(-mx=9).Ifyoudonotspecifyanysymbolfromtheset[b|k|m|g],thedictionarysizewillbecalculatedasDictionarySize=2^Sizebytes.FordecompressingafilecompressedbyLZMAmethodwithdictionarysizeN,youneedaboutNbytesofmemory(RAM)available.

mf={MF_ID}

SetsMatchFinderforLZMA.Defaultmethodisbt4.Algorithmsfromhc*groupdon'tprovideagoodcompressionratio,buttheyoftenworkprettyfastincombinationwithfastmode(a=0).Memoryrequirementsdependondictionarysize(parameter"d"intablebelow).

MF_ID Dictionary MemoryUsage Description

bt2 9.5*d

+4MB

BinaryTree

2byteshashing

bt3 11.5*d 3byteshashing

bt464KB...48MB 11.5*d

4bytes64MB...1024MB

10.5*d

hashinghc4

64KB...48MB 7.5*dHashChain64MB...1024

MB 6.5*d

Note:Youroperationsystemalsoneedssomeamountofphysicalmemoryforinternalpurposes.Sokeepatleast32MBofphysicalmemoryunused.

fb={N}

SetsnumberoffastbytesforLZMA.Itcanbeintherangefrom5to273.Thedefaultvalueis32fornormalmodeand64formaximumandultramodes.Usually,abignumbergivesalittlebitbettercompressionratioandslowercompressionprocess.

mc={N}

Setsnumberofcycles(passes)formatchfinder.Itcanbeinrangefrom0to1000000000.Defaultvalueis(16+number_of_fast_bytes/2)forBT*matchfindersand(8+number_of_fast_bytes/4)forHC4matchfinder.Ifyouspecifymc=0,LZMAwillusedefaultvalue.Usually,abignumbergivesalittlebitbettercompressionratioandslowercompressionprocess.Forexample,mf=HC4andmc=10000canprovidealmostthesamecompressionratioasmf=BT4.

lc={N}

Setsthenumberofliteralcontextbits(highbitsofpreviousliteral).Itcanbeinrangefrom0to8.Defaultvalueis3.Sometimeslc=4givesgainforbigfiles.

lp={N}

Setsthenumberofliteralposbits(lowbitsofcurrentpositionforliterals).Itcanbeintherangefrom0to4.Thedefaultvalueis0.Thelpswitchisintendedforperiodicaldatawhentheperiodisequalto2^value(wherelp=value).Forexample,for32-bit(4bytes)periodicaldatayoucanuselp=2.Oftenit'sbettertosetlc=0,ifyouchangelpswitch.

pb={N}

Setsthenumberofposbits(lowbitsofcurrentposition).Itcanbein

therangefrom0to4.Thedefaultvalueis2.Thepbswitchisintendedforperiodicaldatawhentheperiodisequal2^value(wherelp=value).

LZMA2

LZMA2ismodifiedversionofLZMA.itprovidesthefollowingadvantagesoverLZMA:

Bettercompressionratiofordatathancan'tbecompressed.LZMA2canstoresuchblocksofdatainuncompressedform.Alsoitdecompressessuchdatafaster.

Bettermultithreadingsupport.Ifyoucompressbigfile,LZMA2cansplitthatfiletochunksandcompressthesechunksinmultiplethreads.

Parameter Default Descriptionc={Size}[b|k|m|g] dictSize*4 SetsChunksize

Ifyoudon'tspecifyChunkSize,LZMA2setsittomax(DictionarySize,min(256M,max(1M,DictionarySize*4))).

LZMA2alsosupportsallLZMAparameters,butlp+lccannotbelargerthan4.

LZMA2uses:1threadforeachchunkinx1andx3modes;and2threadsforeachchunkinx5,x7andx9modes.IfLZMA2issettouseonlysuchnumberofthreadsrequiredforonechunk,itdoesn'tsplitstreamtochunks.Soyoucangetdifferentcompressionratiofordifferentnumberofthreads.Youcangetthebestcompressionratio,whenyouuse1or2threads.

PPMd

PPMdisaPPM-basedalgorithm.ThisalgorithmismostlybasedonDmitryShkarin'sPPMdHsourcecode.PPMdprovidesverygoodcompressionratioforplaintextfiles.Thereisnodifferencebetweencompressionspeedanddecompressionspeed.Memoryrequirementsforcompressionanddecompressionalsoarethesame.

Parameter Default Description

mem={Size}[b|k|m|g] 24 SetssizeofusedmemoryforPPMd.o={Size} 6 SetsmodelorderforPPMd.

mem={Size}[b|k|m|g]

SetsthesizeofmemoryusedforPPMd.Youmustspecifythesizeinbytes,kilobytes,ormegabytes.Themaximumvalueis2GB=2^31bytes.Thedefaultvalueis24(16MB).Ifyoudonotspecifyanysymbolfromtheset[b|k|m|g],thememorysizewillbecalculatedas(2^Size)bytes.PPMdusesthesameamountofmemoryforcompressionanddecompression.

o={Size}

SetsthemodelorderforPPMd.Thesizemustbeintherange[2,32].Thedefaultvalueis6.

BCJ2

BCJ2isaBranchconverterfor32-bitx86executables(version2).Itconvertssomebranchinstructionsforincreasingfurthercompression.

ABCJ2encoderhasoneinputstreamandfouroutputstreams:

s0:mainstream.Itrequiresfurthercompression.

s1:streamforconvertedCALLvalues.Itrequiresfurthercompression.

s2:streamforconvertedJUMPvalues.Itrequiresfurthercompression.

s3:servicestream.Itisalreadycompressed.

IfLZMAisused,thesizeofthedictionaryforstreamss1ands2canbemuchsmaller(512KBisenoughformostcases)thanthedictionarysizeforstreams0.

Parameters:

d={Size}[b|k|m|g]

SetssectionsizeforBCJ2filter.Defaultsectionsizeis64MB.Ifyoudonotspecifyanysymbolfromtheset[b|k|m|g],thesectionsizewill

becalculatedasSectionSize=2^Sizebytes.Thisparameterdoesn'taffectmemoryconsumption.Compressionratioisbetter,ifthesectionsizeisequalorslightlylargerthansizeoflargestexecutionsectioninfile.Example:f=BCJ2:d9M,iflargestexecutablesectioninfilesissmallerthan9MB.

Delta

It'spossibletosetdeltaoffsetinbytes.Forexample,tocompress16-bitstereoWAVfiles,youcanset"0=Delta:4".Defaultdeltaoffsetis1.

XZXZsupportsonlyLZMA2codecnow.Theswitchesaresimilartoswitchesfor7zformat.

Parameter Default Descriptionx=[1|3|5|7|9] 5 Setslevelofcompression

f=FilterID Setscompressionfilter.FilterID:Delta:{N},BCJ,ARM,ARMT,IA64,PPC,SPARC

{N}={MethodID}[:param1][:param2][..]

LZMA2 Setscompressionmethod:LZMA2:[param1]:[param2]:[...]

mt=[off|on|{N}] on Setsmultithreadingmodes=[off|on|[{N}b|{N}k|{N}m|{N}g] off Setssolidmode.

s=[off|on|[{N}b|{N}k|{N}m|{N}g)]

Enablesordisablessolidmode.Thedefaultmodeiss=off.Insolidmode,thereisonlyoneblockperfileorstream.

{N}b|{N}k|{N}m|{N}g

Setalimitforthetotalsizeofasolidblockinbytes

Ifsizeofsolidblockisnotspecified,defaultvalueofsolidblocksizewillbecalculated,thatdependsfrom"compressionlevel"and"dictionarysize":

dictionary_size Defaultsolidblocksizesmallerthan256KB 1MB256KB-64MB dictionary_size*464MB-256MB 256MBlargerthan256MB dictionary_size

blocksizemustbeequalorlargethandictionarysize.

Ifyouusemultipleblocks:

thecompressionratiowithsmallblocksusuallyisworse.

blocksareindependent.Solossesincaseofdatadamageislimitedonlytodamagedblocks.

it'spossibletoextractsomeparticularblockofdatafaster.

thereisindexrecordattheendofxzstreamthatcontainsinformationaboutpositionandsizeofeachblock.

Note:xzuses:1threadforeachblockinx1andx3modes;and2threadsforeachblockinx5,x7andx9modes.Ifxzissettouseonlysuchnumberofthreadsrequiredforoneblock,itdoesn'tsplitstreamtoblocks.Soyoucangetdifferentcompressionratiofordifferentnumberofthreads.Youcangetthebestcompressionratio,whenyouuse1thread(forx1andx3modes)or2threads(forx5,x7andx9modes).

Note:eachxzblockcontainsLZMA2streamofdata.AndLZMA2alsocanbedividedtoindependentblocks(chunks).ThedifferencebetweenxzblocksandLZMA2blocks,thateachxzblockcontainsalsochecksum(crcorsha),andthereisindexrecordattheendofxzstreamthatpointstoeachxzblock.7-Zipbydefaultusesxzblocks.Butit'spossibletospecifythemodewhenitwilluseonexzblock,andmultipleLZMA2blocksinstead.

Examples:

s=16m

use16MBblocks.

s

useonesolidxzblockperfile.

s0c16m

useonesolidxzblockperfileand16MiBLZMA2blocks.

WIM

Parameter Default Descriptionim={ImageNumber} Setsimagenumber.is=[off|on] off Showimagenumberinpaths.

Ifimagenumberisspecified,7-ZipworksonlywiththatimageinsideWIMarchive.Otherimageswillbenotchanged.Bydefault7-Zipdoesn'tshowimagenumber,ifthereisonlyoneimageinWIMarchive,orifimagenumberisspecified.Butiftheswitch"is"specified,7-Zipshowsimagenumber.

Examples7zaarchive.zip*.jpg-mx0

adds*.jpgfilestoarchive.ziparchivewithoutcompression.

7zaarchive.7z*.exe*.dll-m0=BCJ-m1=LZMA:d=21

adds*.exeand*.dllfilestosolidarchivearchive.7zusingLZMAmethodwith2MBdictionaryandBCJfilter.

7zaarchive.7za.tar-mf=BCJ2-mx

addsa.tarfilestoarchivearchive.7zusingBCJ2filter.

7zaarchive.7z*.wav-mf=Delta:4

adds*.wavfilestoarchivearchive.7zusingDelta:4filter.

7zaa.7z*.exe*.dll-m0=BCJ2-m1=LZMA:d25-m2=LZMA:d19-m3=LZMA:d19-mb0:1-mb0s1:2-mb0s2:3

adds*.exeand*.dllfilestoarchivea.7zusingBCJ2filter,LZMAwith32MBdictionaryformainoutputstream(s0),andLZMAwith512KBdictionaryfors1ands2outputstreamsofBCJ2.

7zaarchive.7z*.txt-m0=PPMd

adds*.txtfilestoarchivearchive.7zusingPPMdmethod.

7zaa.tar.xza.tar-mf=bcj-mx

addsa.tarfilestoarchivea.tar.xzusingBCJfilter.


a(Add),h(Hash),d(Delete),rn(Rename),u(Update)

Seealso

Switches:-t(setTypeofarchive),

-o(setOutputdirectory)switch

Specifiesadestinationdirectorywherefilesaretobeextracted.

Thisswitchcanbeusedonlywithextractioncommands.

Syntax-o{dir_path}

{dir_path}Thisisthedestinationdirectorypath.It'snotrequiredtoendwithabackslash.Ifyouspecify*in{dir_path},7-Zipsubstitutesthat*charactertoarchivename.

Example7zxarchive.zip-oc:\Doc

extractsallfilesfromthearchive.ziparchivetothec:\Docdirectory.

7zx*.zip-o*

extractsall*.ziparchivestosubfolderswithnamesofthesearchives.



-p(setPassword)switch

Specifiespassword.

Syntax-p{password}

{password}Specifiespassword.

Examples7zaarchive.7z-psecret-mhe*.txt

compresses*.txtfilestoarchive.7zusingpassword"secret".Alsoitencryptsarchiveheaders(-mheswitch),sofilenameswillbeencrypted.

7zxarchive.zip-psecret

extractsallfilesfromarchive.zipusingpassword"secret".


a(Add),d(Delete),e(Extract),rn(Rename),t(Test),u(Update),x(Extractwithfullpaths)

-r(Recursesubdirectories)switch

Specifiesthemethodoftreatingwildcardsandfilenamesonthecommandline.

Syntax-r[-|0]

Switch Description-r Enablerecursesubdirectories.

-r- Disablerecursesubdirectories.Thisoptionisdefaultforallcommands.

-r0 Enablerecursesubdirectoriesonlyforwildcardnames.

Examples7zlarchive.zip*.doc-r-

listsall*.docfilesthatbelongtothearchivedrootdirectoryinthearchive.ziparchive.

7za-tziparchive.zip-rsrc\*.cppsrc\*.h

addsall*.cppand*.hfilesfromdirectorysrcandallit'ssubdirectoriestothearchive.ziparchive.

7zaarchive.7zfolder1\

addsallfilesfromdirectoryfolder1andallit'ssubdirectoriestothearchive.7zarchive.

7zaarchive.7z-rfolder2\

searchesallfolder2directoriesinallsubdirectories,andaddsthem(includingallsubdirectories)tothearchive.7zarchive.


a(Add),d(Delete),e(Extract),h(Hash),l(List),rn(Rename),t(Test),u

(Update),x(Extractwithfullpaths)

Seealso

Switches:-i(Include),-x(Exclude)

-sa(setArchivenamemode)switch

SpecifiesArchivenamemode.

Syntax-sa[a|e|s]

Switch Description-saa Alwaysaddarchivetypeextension.-sae Useexactnamespecifiedincommand.

-sas Addextensiononlyifspecifiednamehasnoextension.It'sdefaultoption.

Examples7zaarc1.txt

createsarc.7z

7zaarc.spec1.txt

createsarc.spec

7zaarc1.txt-sae

createsarc

7zafile.pdffile.pdf-saa-tzip

createsfile.pdf.zip


a(Add),

-scc(Setcharsetforconsoleinput/output)switch

Setscharsetforforconsoleinput/output.

Syntax-scc{UTF-8|WIN|DOS}

DefaultcharsetisDOS.

UTF-8UnicodeUTF-8characterset.

WINDefaultcharactersetofWindows.

DOSDOS(OEM)charactersetofWindows.

Example7zlarchive.7z-sccUTF-8

listsfilesfromarchive.7zinUTF-8encoding.

-scs(Setcharsetforlistfiles)switch

Setscharsetforlistfiles.

Syntax-scs{UTF-8|UTF-16LE|UTF-16BE|WIN|DOS|{id}}

DefaultcharsetisUTF-8.

Value DescriptionUTF-8 UnicodeUTF-8characterset.UTF-16LE UnicodeUTF-16little-endiancharacterset.UTF-16BE UnicodeUTF-16big-endiancharacterset.WIN DefaultcharactersetofWindows.DOS DefaultDOS(OEM)charactersetofWindows.{id} Thecodepagenumber(asspecifiedinMicrosoftWindows).

Notes:ThelistfileinUnicodecharsetcanstartwiththeBOM(byteordermark)character(U+FEFF).Inthatcase7-ZipchecksthatencodingofBOMcorrespondstoencodingspecifiedwiththisswitch(forUTF-16LEandUTF-16BE).

[email protected]

compressesfilesfromlistfile.txtlist,thatcontainslistoffilesindefaultcharactersetofWindows.

[email protected]

compressesfilesfromlistfile.txtlist,thatcontainslistoffilesin1251(CyrillicWindows)codepage.


a(Add),u(Update)

-scrc(Sethashfunction)switch

Setshashfunctionfor"extract"and"hash"commands.

Syntax[-scrc{Method}]

Supportedmethods:CRC32,CRC64,SHA1,SHA256,BLAKE2sp,*.DefaultmethodisCRC32.

Examples7zt-scrcSHA256archive.gz

testsarchivearchive.gzandcalculatedSHA-256fordecompresseddata.

7zh-scrcsha1*.iso

calculatesSHA-1for*.isofiles.

7zh-scrc*file.iso

calculateshashvaluesforfile.isofile.


h(Hash),e(Extract),x(Extractwithfullpaths)

-sdel(Deletefilesaftercompression)switch

Syntax-sdel

If-sdelswitchisspecified,7-Zipdeletesfilesafterincludingtoarchive.Soitworkslikemovingfilestoarchive.

7-Zipdeletesfilesattheendofoperationandonlyifarchivewassuccessfullycreated.

Examples7zaa.7z*.txt-sdel

movestxtfilesfromdisk'sdirectorytoa.7zarchive.


a(Add)

-seml(Sendarchivebyemail)switch

Sendsanarchivebye-mail.

Syntax-seml[.]

[.]Causesthearchivetobedeletedafterattachingacopyofittotheemailmessage.

Example7zaarchive.7z-semla.txt

compressesthea.txtfileandsendsitinarchive.7zbyemail.


a(Add),u(Update)

-sfx(CreateSFXarchive)switch

Createsselfextractingarchive.

Syntax-sfx[{SFX_Module}]

{SFX_Module}

SpecifiestheSFXmodulethatwillbecombinedwiththearchive.Thismodulemustbeplacedinthesamedirectoryasthe7z.exe.If{SFX_Module}isnotassigned,7-ZipwillusestandardconsoleSFXmodule7zCon.sfx.

SFX_Module Description7z.sfx Windowsversion.7zCon.sfx Consoleversion.7zS.sfx Windowsversionforinstallers.7zSD.sfx Windowsversionforinstallers(usesMSVCRT.dll).

SFXmodulecanunpack7zarchiveor7zmultivolumearchive.Forexample,ifyouhavename.7zorname.7z.001archive,justrenamesfxmulduletoname.exeandplacetosamefolderwitharchive.

SFXmodulesforinstallers

SFXmodulesforinstallersareincludedinanexternalpackage(7z_extra).Youcandownloadthesemodulesfromwww.7-zip.org.SFXmodulesforinstallers(7zS.sfxand7zSD.sfx)allowyoutocreateyourowninstallationprogram.Suchamoduleextractsthearchivetotheuser'stempfolder,andrunsaspecifiedprogram,andremovesthetempfilesaftertheprogramfinishes.Aself-extractingarchiveforinstallersmustbecreatedasjoiningthefollowingfiles:SFX_Module,Installer_Config(optional),7z_Archive.Youcanusethefollowingcommandtocreateaninstallerself-extractingarchive:

copy/b7zS.sfx+config.txt+archive.7zarchive.exe

Anoptimallysmallinstallationpackagesizecanbeachieved,iftheinstallationfilesareuncompressedbeforeincludingtheminthe7zarchive.

-yswitchforinstallermodulespecifiesquietmodeextraction.

InstallerConfigfileformat

ThisconfigfilecontainscommandsfortheInstaller.Thefilebeginswiththestring;!@Install@!UTF-8!andendswith;!@InstallEnd@!.ThefilemustbewritteninUTF-8encoding.Thefilecontainsanyorallthesestringpairs:

ID_String="Value"

ID_String DescriptionTitle TitleformessagesBeginPrompt BeginPromptmessageProgress Valuecanbe"yes"or"no".Defaultvalueis"yes".

RunProgramCommandforexecuting.Defaultvalueis"setup.exe".Substring%%Twillbereplacedwithpathtotemporaryfolder,wherefileswereextracted

Directory Directoryprefixfor"RunProgram".Defaultvalueis".\\"

ExecuteFile NameoffileforexecutingExecuteParameters Parametersfor"ExecuteFile"

Youmayomitanypair.

Therearetwowaystorunainstallationprogram:RunProgramandExecuteFile.UseRunProgram,ifyouwanttorunaprogramfromthe.7zarchive.UseExecuteFile,ifyouwanttoopenadocumentfromthe.7zarchive,orifyouwanttoexecuteacommandfromWindows.

IfyouuseRunProgram,andifyouspecifyemptydirectoryprefix:Directory="",thesystemsearchesfortheexecutablefileinthefollowingsequence:

1. Thedirectoryfromwhichtheapplication(installer)loaded.

2. Thetemporaryfolder,wherefileswereextracted.

3. TheWindowssystemdirectory.

ConfigfileExamples;!@Install@!UTF-8!

Title="7-Zip4.00"

BeginPrompt="Doyouwanttoinstallthe7-Zip4.00?"

RunProgram="setup.exe"

;!@InstallEnd@!

;!@Install@!UTF-8!

Title="7-Zip4.00"

BeginPrompt="Doyouwanttoinstallthe7-Zip4.00?"

ExecuteFile="7zip.msi"

;!@InstallEnd@!

;!@Install@!UTF-8!

Title="7-Zip4.01Update"

BeginPrompt="Doyouwanttoinstallthe7-Zip4.01Update?"

ExecuteFile="msiexec.exe"

ExecuteParameters="/i7zip.msiREINSTALL=ALLREINSTALLMODE=vomus"

;!@InstallEnd@!

Examples7za-sfxa.exe*.txt

adds*.txtfilestoselfextractingarchivea.exeusingthedefaultconsoleSFXmodule.

7za-sfx7z.sfxa.exe*

addsallfilestoselfextractingarchivea.exewithmodule7z.sfxusingwindowsversionofSFXmudule.


a(Add),d(Delete),u(Update),

-si(readdatafromstdin)switch

Causes7-Ziptoreaddatafromstdin(standardinput)insteadoffromdiscfiles.

Syntax-si{file_name}

{file_name}Specifiesanamethatwillbestoredinthearchiveforthecompresseddata.Iffile_nameisnotspecified,datawillbestoredwithoutaname.

Note:Thecurrentversionof7-Zipsupportreadingofarchivesfromstdinonlyforxz,lzma,tar,gzipandbzip2archives.

Examples7zaarchive.gz-tgzip-siDoc2.txt<Doc.txt

compressesinputstreamfromfileDoc.txttoarchive.gzarchiveusingDoc2.txtfilename.

7zx7z905.tar.gz-so|7zx-si-ttar

decompressestar.gzarchive.


a(Add),e(Extract),h(Hash),u(Update),x(Extractwithfullpaths)

-so(writedatatostdout)switch

Causes7-Ziptowriteoutputdatatostdout(standardoutputstream).

Syntax-so

Ifthe-soswitchisusedwiththecommandthatcreatesarchive,itworksonlywithsomearchiveformats:xz,gzip,bzip2andtar.

Examples7zxarchive.gz-so>Doc.txt

decompressesarchive.gzarchivetooutputstreamandthenredirectsthatstreamtoDoc.txtfile.

7zadummy-tgzip-soDoc.txt>archive.gz

compressestheDoc.txtfiletothe7-Zipstandardoutputstreamandwritesthatstreamtoarchive.gzfile.


a(Add),e(Extract),u(Update),x(Extractwithfullpaths)

-slp(SetLargePagesmode)switch

SetsLargePagesmode.

Syntax-slp[-]

Switch Description-slp EnablesLargePagesmode.

-slp- DisablesLargePagesmode.Thisoptionisdefaultforallcommands.

LargePagesmodeincreasesthespeedofcompression.However,thereisapauseatthestartofcompressionwhile7-Zipallocatesthelargepagesinmemory.If7-Zipcan'tallocatelargepages,itallocatesusualsmallpages.Also,theWindowsTaskManagerdoesn'tshowtherealmemoryusageoftheprogram,if7-Zipuseslargepages.Thisfeaturedoesn'tworkonWindows2000/32-bitWindowsXP.Also,itrequiresadministrator'srightsforyoursystem.TherecommendedsizeofRAMforthisfeatureis3GBormore.Toinstallthisfeature,youmustrunthe7-ZipFileManagerwithadministrator'srightsatleastonce,closeit,andthenrebootthesystem.

Notes:ifyouuse-slpmode,yourWindowssystemcanhangforseveralsecondswhen7-zipallocatesmemoryblocks.WhenWindowstriestoallocatelargepagesfromRAMfor7-Zip,Windowscanhangothertasksforthattime.Itcanlooklikefullsystemhang,butthenitresumes,andifallocationissuccessful,7-Zipworksfaster.Don'tuse-slpmode,ifyoudon'twantothertasksbehangedforseveralseconds.Alsoit'ssenselesstouse-slpmodetocompresssmalldatasets(lessthan100MB).Butifyoucompressbigdatasets(300MBormore)withLZMAmethodwithlargedictionary,youcanget5%-10%speedimprovementwith-slpmode.

Example7zaarchive.7z-slpa.iso

compressesa.isofilewithLargePagesmodeswitchedon.

-slt(Showtechnicalinformation)switch

Setstechnicalmodeforl(List)command.

Syntax-slt

Example7zl-sltarchive.7z

showsdetailedtechnicalinformationforthefilesinarchive.7z.


l(List)

-sni(StoreNTsecurityinformation)switch

Syntax-sni

UsethisswitchtostoreandrestoreNT(NTFS)securityinformationforfilesanddirectories.NotethatonlyNTFSfilesystemsupportsthatfeature.

Currentversionof7-ZipcanstoreNTsecurityinformationonlytoWIMarchives.

Examples7zaa.wim-sni*.txt

storestxtfileswithNTsecurityinformation.

7zxa.wim-sni

unpacksa.wimandrestoresNTsecurityinformation.


a(Add),e(Extract),u(Update),x(Extractwithfullpaths)

Seealso

Switches:-sns

-sns(StoreNTFSalternateStreams)switch

Syntax-sns[-]

Switch Description

-sns Enable"StoreNTFSalternatestreams"mode.It'sdefaultoption,ifyouextractarchive.

-sns- Disable"StoreNTFSalternatestreams"mode.It'sdefaultoption,ifyoucreatearchiveorcall"list"command.

If-snsmodeisenabled,7-ZipprocessesNTFSAlternateDataStreamsforfilesandfolders.

Currentversionof7-ZipcanstoreNTFSalternatestreamsonlytoWIMarchives.

Note:7-Zipcan'tincludealternatestreamstoarchiveson32-bitWindowsXPandoldersystems.

Examples7zaa.wim-sns*.txt

storestxtfilesincludingalternatedatastreams.

7zxa.wim

unpacksa.wimincludingalternatedatastreams.

7zxa.wim-sns-

unpacksa.wimwithoutalternatedatastreams.

7zla.wim-sns

listsfilesina.wimincludingalternatedatastreams.


a(Add),d(Delete),e(Extract),h(Hash),l(List),t(Test),u(Update),x

(Extractwithfullpaths)

Seealso

Switches:-sni

-spf(Usefullyqualifiedfilepaths)switch

Switch Description-spf Useabsolutepathsincludingdriveletter.-spf2 Usefullpathswithoutdriveletter.

Enablesthemodethatallowstousefullyqualifiedfilepathsinarchives.If-spfswitchisnotspecified,7-Zipreducesfilepathstorelativepathswhenitaddsfilestoarchive,and7-Zipconvertspathstorelativepathswhenyouextractarchive.If-spfswitchisspecified,7-Zipdoesn'ttrytoprocessorconvertpaths.

Fullyqualifiedfilepathsbeginwithoneofthefollowing:

AUNCname,whichstartswithtwobackslashcharacters,forexample,"\\Server1\".

Adiskdesignatorwithabackslash,forexample"C:\".

Asinglebackslash,forexample,"\Folder".

If-spfswitchisspecified,butthepathisnotfullyqualified,7-Zipwillusespecifiedpath,itwillnotconvertthepathtofullyqualifiedpath.

Pleasebecareful,ifyouuse-spfswitchwith"extract"command.Checkthatfilenamesinarchivearecorrect.Notethatwith-spfswitch7-Zipcantrytorewriteanyfilewithpathspecifiedinarchive.

Syntax-spf

Examples7zaa.7z-spfc:\Files\test.txtd:\test.txt

storesbothtxtfileswithfullpaths.

7zxa.7z-spf

extractsfilesfroma.7zarchivewithexactfilepathsspecifiedinarchive.


a(Add),d(Delete),e(Extract),u(Update),x(Extractwithfullpaths)

Seealso

Switches:

-ssc(SetSensitiveCasemode)switch

Setssensitivecasemodeforfilenames.

Syntax-scs[-]

Switch Description-ssc Setcase-sensitivemode.It'sdefaultforPosix/Linuxsystems.-ssc- Setcase-insensitivemode.It'sdefaultforWindowssystems.

Example7zaarchive.7zA*.txt-ssc-r

compressesallA*.txtfilesfromcurrentdirectoryandallit'ssubdirectories.Thatcommanddoesn'tcompressa*.txtfiles.


a(Add),d(Delete),e(Extract),l(List),t(Test),u(Update),x(Extractwithfullpaths)

-ssw(Compressfilesopenforwriting)switch

Compressesfilesopenforwritingbyanotherapplications.Ifthisswitchisnotset,7-zipdoesn'tincludesuchfilestoarchive.

Syntax-ssw

Example7zaarchive.7z-ssw*.txt

compressesall*.txtfilesincurrentfolderincludingfilesopenforwritingbyanotherapplications.


a(Add),h(Hash),u(Update)

-stl(Setarchivetimestampfromthemostrecentlymodifiedfile)switch

Syntax-stl

If-stlswitchisspecified,7-Zipsetstimestampforarchivefileastimestampfromthemostrecentlymodifiedfileinthatarchive.

Examples7zua.7z-stl*.txt


a(Add),d(Delete),rn(Rename),u(Update)

-stx(Excludearchivetype)switch

Theswitchdisablesthecoderelatedtospecifiedarchivetypeandanarchivecannotbeopenwithspecifiedarchivetype.

Multiple-stxswitchesaresupported.

Syntax-stx{archive_type}

{archive_type}Specifiesthetypeofarchive.Itcanbe:7z,xz,split,zip,gzip,bzip2,tar,....

Example7zx-stxpearchive.exe

extractsfilesfromarchive.exearchiveanddoesn'tusePEformathandler.


a(Add),d(Delete),e(Extract),l(List),t(Test),u(Update),x(Extractwithfullpaths)

-t(setTypeofarchive)switch

Specifiesthetypeofarchive.

Syntax-t{archive_type}[:s{Size}][:r][:e][:a]

{archive_type}Specifiesthetypeofarchive.Itcanbe:*,#,7z,xz,split,zip,gzip,bzip2,tar,....

*:rDefaultmode.7-Zipopensarchiveandsubfile,ifit'ssupportedbyformat.

*Opensonlyonetoplevelarchive.

*:s{Size}[b|k|m|g]Setsupperlimitforstartofarchiveposition.Defaultscansizeis8MBytes"*:s8m".Example:"*:s0"meansthatitwillopenonlyfilethathasnoanystubbeforearchive.

#OpensfileinParsermode,andignoresfullarchives.

#:aSameas*,butitopensfileswithunknownextensionsthatcontainarchivesinParserMode.

#:eOpensfileinParsermodeandchecksallbytepositionsasstartofarchive.

If-t{archive_type}switchisnotspecified,7-Zipusesextensionofarchivefilenametodetectthetypeofarchive.Ifyoucreatenewarchive,-

t{archive_type}switchisnotspecifiedandthereisnoextensionofarchive,7-Zipwillcreate.7zarchive.

If-t{archive_type}switchisnotspecifiedandarchivenamecontainsincorrectextension,theprogramwillshowthewarning.

It'spossibletousethecombinedtype(forexample,mbr.vhd)for"Extract"and"List"commandsforsomearchives.

Whenyouextractarchiveofsometypesthatcontainsanotherarchivewithoutcompression(forexample,MBRinVHD),7-Zipcanopenbothlevelsinonestep.Ifyouwanttoopen/extractjusttoplevelarchive,use-t*switch.

Note:xz,gzipandbzip2formatssupportonlyonefileperarchive.Ifyouwanttocompressmorethanonefiletotheseformats,createatararchiveatfirst,andthencompressitwithyourselectedformat.

Example7za-tziparchive.zip*.txt

addsall*.txtfilesfromcurrentdirectorytoziparchivearchive.zip.

7zt-t7z.splitarchive.7z.001

testsallfilesinarchive.7z.001.Italsochecksthatarchiveismultivolume.7zarchive.

7zx-t#sfxarchive.exe

extractssfxarchive.exeinparsermode.

7zx-tisoarchive.iso

extractsfilesfromarchive.isoopenasISOarchive.

7zx-tudfarchive.iso

extractsfilesfromarchive.isoopenasUDFarchive.


a(Add),d(Delete),e(Extract),l(List),t(Test),u(Update),x(Extractwith

fullpaths)

-u(Updateoptions)switch

Specifieshowtoupdatefilesinanarchiveand(or)howtocreatenewarchives.

Syntax-u[-]<action_set>[!{new_archive_name}]

<action_set>::=<state_action>...

<state_action>::=<state><action>

<state>::=p|q|r|x|y|z|w

<action>::=0|1|2|3

Parameters

dash(-)

Disablesanyupdatesinthebasearchive.

Thetermbasearchivemeansthearchiveassignedby"base_archive_name"onthecommandline.SeeCommandlinesyntaxformoredetails.

{new_archive_name}

Specifiesthepathnameofthenewarchivetobecreated.Alloptionsinthisswitchwillrefertothisnewarchive.

Ifnotassigned,thenalloptionsinthisswitchwillrefertothebasearchiveofthecommand.

<state>

Specifiesthestateofaparticularfiletobeprocessed.

<state>::=p|q|r|x|y|z|w

Foreachuniquefilenamethereare6variantsofstate:

<state> Statecondition FileonDisk FileinArchive

p Fileexistsinarchive,butisnotmatchedwithwildcard. Exists,butis

notmatched

q Fileexistsinarchive,butdoesn'texistondisk. Doesn'texist Exists

r Filedoesn'texistinarchive,butexistsondisk. Exists Doesn'texist

x Fileinarchiveisnewerthanthefileondisk. Older Newer

y Fileinarchiveisolderthanthefileondisk. Newer Older

z Fileinarchiveissameasthefileondisk Same Same

wCannotbedetectedwhatfileisnewer(timesarethesame,sizesaredifferent)

? ?

<action>

Specifiestheactionforagiven<state>.

<action>::=0|1|2|3

Foreachstateyoucanspecifyoneofthethreevariantsofactions:

<action> Description0 Ignorefile(don'tcreateiteminnewarchiveforthisfile)1 Copyfile(copyfromoldarchivetonew)2 Compress(compressfilefromdisktonewarchive)

3CreateAnti-item(itemthatwilldeletefileordirectoryduringextracting).Thisfeatureissupportedonlyin7zformat.

Remarks

Anyupdatecommand(suchasa(Add),d(Delete),u(Update))canbeassignedintheseterms.

Thefollowingtableshowsactionsetsforupdatecommands.

command\<state> p q r x y z wd(Delete) 1 0 0 0 0 0 0a(Add) 1 1 2 2 2 2 2

u(Update) 1 1 2 1 2 1 2Freshen 1 1 0 1 2 1 2

Synchronize 1 0 2 1 2 1 2

Ifyoudon'tspecifya!{new_archive_name}option,thenalloptionswillrefertothemainarchive(thearchiveassignedonthecommandlineafterthe7zcommand).Ifyouspecify!{new_archive_name}option,then7-Zipalsowillcreateanewarchivewiththespecifiednameandalloptionswillrefertothatnewarchive.

Multipleupdateswitchesaresupported.7-Zipcancreateanynumberofnewarchivesduringoneoperation.

Bydefault,theactionsetforeachnewarchiveisassignedastheactionsetofthemaincommand.Thereare3differentactionsetsforcommands:a(Add),d(Delete),u(Update).Youcanoverloadany<state_action>pair.

Timezonenotes

Ifyouchangetimezone(whenyoumoveyourcomputertoanothertimezoneorifthereareclockchangesfordaylightsavinginyourzone),youcanhavesomeproblemswithupdatecommandsthatdependfromfile'smodificationtime.It'sstronglyrecommendedtouseonlyfilesystemthatusesCoordinatedUniversalTime(UTC)andarchiveformatthatalsousesUTC.Inthatcaseyouwillhavenoproblemswithtimezonechanges.Alsoit'srecommendedtouseonlyUTCformatsinothercases,forexample,ifyousendfilestosomeoneinanothertimezone.

Alsoinsomecasestherearenoproblems,ifbothfilesystemandarchiveformatuselocaltime,forexample,FATfilesystemandZIPformat.

UTCfilesystems:NTFS

UTCarchiveformats:.zipwith-mtcswitch,7z,tar,gzip2,iso,wim

Localtimefilesystems:FAT,FAT32

Localtimearchiveformats:rar,zip,cab

Examples7zuc:\1\exist.7z-u--up0q3x2z0!c:\1\update.7z*

createsanewarchiveupdate.7zandwritestothisarchiveallfilesfromcurrentdirectorywhichdifferfromfilesinexist.7zarchive.exist.7zarchivewillnotbechanged.

7zuc:\1\exist.7z-up0q3x2z0!c:\1\update.7z*-ms=off

createsanewarchiveupdate.7zandwritestothisarchiveallfilesfromthecurrentdirectorywhichdifferfromfilesinexist.7zarchive.

Note:theupdatingofsolid.7zarchivescanbeslow,sinceitcanrequiresomerecompression.


a(Add),d(Delete),rn(Rename),u(Update),

-v(CreateVolumes)switch

Specifiesvolumesizes.

Syntax-v{Size}[b|k|m|g]

{Size}[b|k|m|g]SpecifiesvolumesizeinBytes,Kilobytes(1Kilobyte=1024bytes),Megabytes(1Megabyte=1024Kilobytes)orGigabytes(1Gigabyte=1024Megabytes).ifyouspecifyonly{Size},7-zipwilltreatitasbytes.

It'spossibletospecifyseveral-vswitches.

NOTE:Pleasedon'tusevolumes(anddon'tcopyvolumes)beforefinishingarchiving.7-Zipcanchangeanyvolume(includingfirstvolume)attheendofarchivingoperation.

Examples7zaa.7z*.txt-v10k-v15k-v2m

createsmultivolumea.7zarchive.Firstvolumewillbe10KB,secondwillbe15KB,andallotherswillbe2MB.


a(Add),

-w(setWorkingdirectory)switch

Setstheworkingdirectoryforthetemporarybasearchive.Bydefault,7-Zipbuildsanewbasearchivefileinthesamedirectoryastheoldbasearchivefile.Byspecifyingthisswitch,youcansettheworkingdirectorywherethetemporarybasearchivefilewillbebuilt.Afterthetemporarybasearchivefileisbuilt,itiscopiedovertheoriginalarchive;then,thetemporaryfileisdeleted.

Syntax-w[{dir_path}]

{dir_path}

Specifiesthedestinationdirectorypath.It'snotrequiredthatapathendwithabackslash.

If<dir_path>isnotassigned,then7-ZipwillusetheWindowstemporarydirectory.

Example7za-tziparchive.zip*.cpp-wc:\temp

adds*.cppfilestothearchive.ziparchive,creatingatemporaryarchiveinc:\tempfolder.


a(Add),d(Delete),rn(Rename),u(Update),

-x(Excludefilenames)switch

Specifieswhichfilenamesorwildcardednamesmustbeexcludedfromtheoperation.

Multipleexcludeswitchesaresupported.

Syntax-x[<recurse_type>]<file_ref>



See-i(Include)switchdescriptionforinformationaboutoptionparameters.

Examples7za-tziparchive.zip*.txt-x!temp.*

addstothearchive.zipall*.txtfiles,excepttemp.*files.

7zaarchive.7zFolder1\-xr!*.png

addstothearchive.7zallfilesfromFolder1anditssubfolders,except*.pngfiles.


a(Add),d(Delete),h(Hash),e(Extract),l(List),t(Test),rn(Rename),u(Update),x(Extractwithfullpaths)

Seealso

Switches:-r(Recurse),-i(Include)

-y(assumeYesonallqueries)switch

Disablesmostofthenormaluserqueriesduring7-Zipexecution.Youcanusethisswitchtosuppressoverwritequeriesinthee(Extract)andx(Extractwithfullpaths)commands.

Syntax-y

Examples7zxsrc.zip-y

extractsallfilesfromsrc.ziparchive.Alloverwritequerieswillbesuppressedandfilesondiskwithsamefilenamesasinarchivewillbeoverwritten.



Seealso

Switches:-ao(Overwritemode),

MenuItemsNote:'Grey'referstothenumerickeypad.

File

Menuitem Shortcut Description

System Submenuwithmenucommandsfromsystemshell.ItcanbeenabledinOptions.

Open Enter OpencurrentitemOpenInside Ctrl+PgDn Opencurrentitemasfolderinside7-Zip

OpenInside* Openonlyonetoplevelarchivecontainer

OpenInside# Openfileinparsermode

OpenOutside Shift+Enter Opencurrentiteminnewwindow

View F3 OpenselecteditemwithviewerEdit F4 OpenselecteditemwitheditorRename F2 RenameselecteditemCopyTo... F5 CopyselecteditemsMoveTo... F6 MoveselecteditemsDelete Delete DeleteselecteditemsSplitfile... SplitfiletopartsCombinefiles... Combinefilestoonefile

Properties Alt+Enter ShowPropertiesoffileComment Ctrl+Z SetcommentforfileCalculatechecksum CalculatesCRCchecksumforfiles

Diff Showthedifferencesbetweentwofiles.Itcanbeenabled,ifthediffprogramissetinOptions

Create F7 Createnewfolder

FolderCreateFile Shift+F4 CreatesnewfileLink... CreatesymboliclinkorhardlinkAlternateStreams ShowalternatefilestreamsatNTFS.

Exit Alt+F4 Closestheprogram.

Edit

MenuItem Shortcut Description

SelectAll Shift+[Grey+] Selectallitems

DeselectAll Shift+[Grey-] Selectallitems

InvertSelection [Grey*] Select/Deselectallitems

Select... [Grey+] SelectspecifieditemsDeselect... [Grey-] DeselectspecifieditemsSelectbyType

Alt+[Grey+]

Selectallitemswiththesameextensionascurrentitem

DeselectbyType

Alt+[Grey-]

Deselectallitemswiththesameextensionascurrentitem

View

MenuItem Shortcut Description

LargeIcons Ctrl+1 Displaysitemsbyusinglargeicons

SmallIcons Ctrl+2 Displaysitemsbyusingsmallicons

List Ctrl+3 Displaysitemsinalist

Details Ctrl+4 Displaysitemsinalistwithdetailedinformationabouteachitem

Name Ctrl+F3 SortitemsbyName

Type Ctrl+F4 SortitemsbyTypeDate Ctrl+F5 SortitemsbyDateSize Ctrl+F6 SortitemsbySizeUnsorted Ctrl+F7 DonotsortitemsFlatView SwitchFlatviewmodeforlistoffiles2Panels F9 SwitchOn/OffsecondpanelToolbars MenuitemsfortoolbarshandlingOpenRootFolder

\ Openrootcomputerfolder

UpOneLevel Backspace Openthefolderonelevelup

FoldersHistory... Alt+F12 Openfoldershistory

Refresh Ctrl+R RefreshitemslistAutoRefresh

If"AutoRefresh"isenabled,7-Zipreloadslistoffiles,iftherearechangesinfilesondrive.

Favorites

MenuItem Shortcut DescriptionAddfoldertoFavoritesas Addsfoldertofavorities

Tools

MenuItem Shortcut DescriptionOptions... OpenOptionsdialogbox

Benchmark Measuretheperformanceofyourcomputerwith7-ZipLZMAbenchmark

Help

MenuItem Shortcut DescriptionContents... F1 Opens7-ZipHelp

About7-Zip... OpensAboutdialogbox

Miscellaneouscommands

Shortcut DescriptionTab SwitchbetweenpanelsInsert Select/DeselectcurrentitemShift+F10 DisplaytheshortcutmenufortheselecteditemsRightCtrl+0Alt+0...RightCtrl+9Alt+9

Openfolderbookmark

Shift+RightCtrl+0Shift+Alt+0...Shift+RightCtrl+9Shift+Alt+9

Createsfolderbookmark

Alt+F1 EdittheFolderAddressonleftpanelAlt+F2 EdittheFolderAddressonrightpanelAlt+Up OpensamefolderinotherpanelAlt+Left,Alt+Right Opencurrentfolderinotherpanel

Ctrl+[Grey+] AdjustoptimalcolumnwidthforitemsCtrl+C Copythenameofselectedfiletoclipboard

KeyboardShortcuts

Key Normal Ctrl Alt Shift

Tab Switchpanel

F1 Help LeftPathF2 Rename RightPathF3 View SortbyNameF4 Edit SortbyType Exit CreateFileF5 Copy SortbyDateF6 Move SortbySize

F7 CreateFolder Unsorted

F9 1/2Panels

F10 Menu ShortcutMenu

F12 FoldersHistory

0-9 R:FolderBookmark

FolderBookmark

A SelectAll

C Copytoclipboard

N CreateFileR RefreshZ Comment

BackspaceUpOneLevel

Enter Open Properties Openoutside

Insert SelectItemDelete DeleteItemPageDown OpenInside

PageUp UpOneLevel

Up Opensamefolder

Left Opencurrentfolder

Right Opencurrentfolder

\ OpenrootGrey/ OpenrootGrey* SelectAllGrey+ Select Adjustcolumns SelectbyType SelectAll

Grey- Deselect DeselectbyType DeselectAll

7-Zip - documentation.help · icon of 7-Zip File Manager, and then click Run as administrator. Then...

Documents

Transcript of 7-Zip - documentation.help · icon of 7-Zip File Manager, and then click Run as administrator. Then...