prev

next

» WIT: Wiimms ISO Tools » wwt: Wiimms WBFS Tool

Wiimms ISO Tools

Privacy Statement

Tools

wwt

wwt commands

argtest

features

filetype, ftype

wwt: Wiimms WBFS Tool

Wiimms WBFS Tool (WBFS manager) : It can create, check, repair, verify and clone WBFS files and partitions. It can list, add, extract, remove, rename and recover ISO images as part of a WBFS.

Contents

1. Syntax
2. Features of wwt
3. Commands
4. Options in alphabetic order

1. Syntax

wwt [option]... command [option|parameter|@file]...

2. Features of wwt

wwt can work with WBFS drives and partitions and with WBFS files. When creating plain WBFS files the tools try to create sparse files to reduce disk usage. Most commands accept multiple working WBFS to add, modify or extract more than one WBFS with one command.
The working WBFS are defined by the options -part, --auto and --all. The option @--auto scanns all drives for valid WBFS partitionss.
»wwt FORMAT« will format a WBFS partition or file. Together with option --recover it try to recover an already existing WBFS.
»wwt LIST« list the discs of one ore more WBFS as a text table. Options like --long, --mixed, --unique, --no-header, --sections and more control the formating.
Try the abbreviations »wwt LS«, »wwt LL«, »wwt LLL« or »wwt LM«.
»wwt ADD« will add Wii discs in any file formats to one or more working WBFS. The options --update, --newer, --sync --ignore and many more controls the operation. Cloning of WBFS is done with this command too.
»wwt ADD« can also read from extracted file system to compose a disc on the fly (like »wit COPY«). This functionality is also called »Partition builder« or »Disc builder«.
While adding a disc you can patch ID, disc title, IOS and region. Objects for patching are disc header, ticket, tmd and boot.bin. If necessary the partitions will be fake signed (trucha sign) automatically.
»wwt UPDATE« is a shortcut for »wwt ADD --update« and »wwt SYNC« for »wwt ADD --sync«.
»wwt EXTRACT« will extract Wii discs and copy them to files in any file formats. If more then one working WBFS is set, each ISO image is searched in all working WBFS until found.
»wwt REMOVE« will remove Wii discs from all working WBFS.
»wwt VERIFY« verifies all ISO images of all working WBFS to find bad dumps. This is done by calculating the SHA1 checksums and comparing them with the stored checksums.
The commands »wwt ANALYSE«, »wwt CHECK«, »wwt REPAIR« and »wwt RECOVER« can be used for analyzing, checking and repairing WBFS.
»wwt CHECK« check the WBFS for different kinds of allocation errors. This check ist very fast (less than 1 second). All commands, which will modify the WBFS, do a silent check and report, if harmless errors found, or stop execution, if harmful errors found.
»wwt DUMP« will print the data structures and information of WBFS partitionss and files. This is good for analysis.
wwt (and also wit) supports time stamps for discs in WBFS containers like other file systems.
For all commands working with Wii ISO images the options --include, --include-path, --exclude and --exclude-path setup up filters to decide which ISO images are used for the operation.
The options --quiet and --verbose control the verbosity. Both option can be set multiple times to decrease or increase the verbosity.

Read »Features« for features of the whole toolset.

3. Commands

`VERSION`		Print program name and version and exit.
`HELP`	`H`	Print help and exit. If the first non option is a valid command name, then a help for the given command is printed.
`ARGTEST`		This debug command accepts all kinds of parameters and prints one line for each parameter.
`INFO`		Print some internal information about the keywords. If the keyword ALL is set or no keyword is entered, then all informations are printed. Possible keywords are: IMAGE-FORMAT and ALL.
`TEST`		Test options: All options are allowed, some are printed.
`ERROR`	`ERR`	Translate an exit code to a message name. If no exit code is entered, print a table with all error messages.
`COMPR`		Scan compression modes and print the normalized names. See option --compression for syntax details. If no mode is given than print a table with all available compression modes and alternative mode names.
`FEATURES`		Check, if the requested features are available. All keywords are possible. If no keyword is used, all supported features are printed. The exit status is 0 for 'all features supported', 1 for 'some features supported' and 2 for 'no feature supported'.
`EXCLUDE`		Dump the internal exclude database to standard output (stdout).
`TITLES`		Dump the internal title database to standard output (stdout).
`GETTITLES`		Call the script 'load-titles.sh' in the share folder to update the title database.
`FIND`	`F`	Find WBFS partitions and optionally print some geometric values.
`SPACE`	`DF`	Print disk space of WBFS partitions.
`ANALYZE`	`ANA`	Analyze files and partitions for WBFS usage. Try to find old WBFS structures and make calculations for new WBFS.
`DUMP`	`D`	Dump the data structure of WBFS partitions.
`ID6`	`ID`	List all ID6 of all discs of WBFS partitions. If the ID list is set use it as selector.
`LIST`	`LS`	List all discs of WBFS partitions.
`LIST-L`	`LL`	List all discs of WBFS partitions with size and region. 'LIST-L' is a shortcut for »LIST --long«.
`LIST-LL`	`LLL`	List all discs of WBFS partitions with date, size and region. 'LIST-LL' is a shortcut for »LIST --long --long«.
`LIST-LLL`	`LLLL`	List all discs of WBFS partitions with date, time, size and region. 'LIST-LLL' is a shortcut for »LIST --long --long --long«.
`LIST-A`	`LA`	List all discs of all WBFS partitions. 'LIST-A' is a shortcut for »LIST --long --long --auto«.
`LIST-M`	`LM`	List all discs of WBFS partitions in mixed view. 'LIST-M' is a shortcut for »LIST --long --long --mixed«.
`LIST-U`	`LU`	List all discs of WBFS partitions in mixed view. 'LIST-U' is a shortcut for »LIST --long --long --unique«.
`LIST-F`	`LF`	List all discs of WBFS partitions and include fragmentation info. 'LIST-F' is a shortcut for »LIST --fragments«.
`FORMAT`	`INIT`	Initialize (=format) WBFS partitions and files. Combine with --recover to recover discs.
`RECOVER`		Recover deleted discs of WBFS partitions.
`CHECK`	`FSCK`	Check WBFS partitions and print error listing. To repair WBFS partitions use the option »--repair modelist«.
`REPAIR`		Check WBFS partitions and repair errors. 'REPAIR' is a shortcut for »CHECK --repair standard«.
`EDIT`		Low level edit of slot and block assignments. Dangerous! Read the documentation!
`PHANTOM`		Add NUM phantom discs with entered SIZE (default unit 'g') with a generic ID6 ('PHT###' where '###' is the smallest not already used integer). If NUM and/or SIZE are ranges use random values from this range. Phantom discs have no content and only a header is written. This makes adding discs very fast and this is good for testing. The creation process stops if the WBFS becomes full. In this case, the last added image may be shorter as planned.
`TRUNCATE`	`TR`	Truncate WBFS partitions to the really used size.
`ADD`	`A`	Add Wii and GameCube ISO discs to WBFS partitions. Images, WBFS partitions and directories are accepted as source.
`UPDATE`	`U`	Add missing Wii and GameCube ISO discs to WBFS partitions. Images, WBFS partitions and directories are accepted as source. 'UPDATE' is a shortcut for »ADD --update«.
`NEW`	`N`	Add missing and newer Wii and GameCube ISO discs to WBFS partitions. Images, WBFS partitions and directories are accepted as source. 'NEW' is a shortcut for »ADD --update --newer«.
`SYNC`		Modify primary WBFS (REMOVE and ADD) until it contains exactly the same discs as all sources together. Images, WBFS partitions and directories are accepted as source. 'SYNC' is a shortcut for »ADD --sync«.
`DUP`		Duplicate source WBFS files or partitions and create new WBFS files. If multiple sources entered, the destination must be a directory. All used WBFS blocks are copied 1:1 to the destination file and unused blocks are skipped and stored as sparse blocks.
`EXTRACT`	`X`	Extract discs from WBFS partitions and store them as Wii or GameCube images.
`SCRUB`		Scrub discs of WBFS partitions and rewrite (repair) the WBFS block map. Use '+' as ID6 to scrub all images of the WBFS partitions. Use option --psel=list to remove image partitions.
`REMOVE`	`RM`	Remove discs from WBFS partitions.
`RENAME`	`REN`	Rename the ID6 and/or the disc title of WBFS discs.
`SETTITLE`	`ST`	Set the disc title of WBFS discs.
`TOUCH`		Set time stamps of WBFS discs.
`VERIFY`	`V`	Verify all discs of WBFS (calculate and compare SHA1 checksums) to find bad dumps.
`SKELETON`	`SKEL`	Create very small skeletons of ISO images. A skeleton contains only disc and partition headers for further analysis and is not playable because all files are zeroed.
`FILETYPE`	`FTYPE`	Print a status line for each source file.

4. Options in alphabetic order

Options
Option		Param	Description
	`--align-files`		If creating a partition the file 'align-files.txt' is read. Files listed with values >=0x8000 (Wii sector size) are automatically aligned to 0x8000.
	`--align-part`	size	If creating or moving partitions the beginning of each partition is set to an offset that is a multiple of the align size. Size must be a power of 2 and at least 32 KiB (=default).
	`--align-wdf`	[align][,minhole]	Parameter align defines the aligning factor for new WDF images. It must be a power of 2 and smaller or equal than 1 GiB. The default WDF alignment is 1 for WDF v1 and 4 for WDF v2. Usual values are 1, 512, 4K and 32K. The optional parameter minhole defines the minimal hole size, before a new chunk is created. If NULL, an internal value is used to minimize the total file size. minhole can't be smaller than align.
`-A`	`--all`		Use all WBFS partitions found.
	`--allow-fst`	[=mode]	Enable the usage of extracted images.MODE is either OFF, AUTO (default) or ON. Without value, ON is used. If mode is AUTO, extracted images are usually enabled.
	`--allow-nkit`	[=mode]	Enable the detection of NKIT images.MODE is either OFF, AUTO (default) or ON. Without value, ON is used. If mode is AUTO, the NKIT detection is enabled only for a few analytic commands. Anyway, NKIT images are not supported yet, but detected to print warnings.
	`--array`		Use an array on script output if possible. If arrays are not supported, then append a '_#' suffix with an zero based index to the variable name defined by »--var name«. In this case, only one output file is created.
	`--atime`		Select 'atime' (last access time) for printing. --atime is an abbreviation of »--time a«.
`-a`	`--auto`		Search for WBFS partitions using '/proc/partitions' or searching hard disks in '/dev/'.
	`--auto-split`		Enable auto split modus: Split only if necessary and determine the split size automatically. THIS OPTION IS EXPERIMENTAL. In future versions it becomes the default.
	`--avar`	varname	Shortcut for: »--array --var name«
	`--bash`		Dump info using BASH syntax. Use »--var name« as prefix.
	`--boot-id`	id	This patching option changes the ID of boot.bin to the given parameter. 1 to 6 characters are expected. Only defined characters not equal '.' are modified. The plus sign '+' is a wildcard for multiple '.' to fill the complete entered ID to 6 characters. Option --boot-id overrides the definition of option --id.
`-b`	`--brief`		Print only a summary.
	`--case`	case	CASE is one of LOWER, AUTO (default) or UPPER.If LOWER or UPPER are set, then the lower/upper case of the variable names is adjusted accordingly.
	`--chunk-mode`	mode	Defines an operation mode for --chunk-size and --max-chunks. Allowed keywords are 'ANY' to allow any values, '32K' to force chunk sizes with a multiple of 32 KiB, 'POW2' to force chunk sizes >=32K and with a power of 2 or 'ISO' for ISO images (more restrictive as 'POW2', best for USB loaders). The case of the keyword is ignored. The default key is 'ISO'. --chm is a shortcut for --chunk-mode.
	`--chunk-size`	sz	Define the minimal chunk size if creating a CISO or WIA file (for WIA details see option --compression}). The default is to calculate the chunk size from the input file size and find a good value by using a minimal value of 1 MiB for »--chunk-mode ISO« and 32 KiB for modes 32K and POW2. For the modes ISO and POW2 the value is rounded up to the next power of 2. This calculation also depends from option --max-chunks. The parameter 'sz' is a floating point number followed by an optional unit factor (one of 'cb' [=1] or 'kmgtpe' [base=1000] or 'KMGTPE' [base=1024]). The default unit is 'M' (MiB). If the number is prefixed with a '=' then options --chunk-mode and --max-chunks are ignored and the given value is used without any rounding or changing. If the input file size is not known (e.g. reading from pipe), its size is assumed as 12 GiB. --chs is a shortcut for --chunk-size.
`-C`	`--ciso`		Set image output file type to CISO (Compact ISO, same as WBI).
	`--color`	[=modus]	Define the modus for colored text output. Allowed keywords are: OFF or NO-COLORS to disable colors, AUTO (default) for automatic detection, ON for automatic detection but never OFF, 8-COLORS and 256-COLORS for 8 and 256 color support. Without parameter, ON is used. AUTO will enable colorized output only for terminals. AUTO and ON use environment variable TERM to find the correct color modus. If a command is prefixed by 'C-', then --color=ON is used implicitly as default.
	`--256-colors`		Short cut for --color=256-colors: Force colorized text with 256 color support.
	`--common-key`	index	This patching option defines the common key index as part of the TICKET. Keywords 0, STANDARD, 1 and KOREAN are accepted.
	`--compression`	mode	Select one compression method, level and chunk size for new WIA files. The syntax for mode is: [method] [.level] [@factor] 'method' is the name of the method. Possible compressions method are NONE, PURGE, BZIP2, LZMA and LZMA2. There are additional keywords: DEFAULT (=LZMA.5@20), FAST (=BZIP2.3@10), GOOD (=LZMA.5@20) BEST (=LZMA.7@50), and MEM (use best mode in respect to memory limit set by --mem). Additionally the single digit modes 0 (=NONE), 1 (=fast LZMA) .. 9 (=BEST)are defined. These additional keywords may change their meanings if a new compression method is implemented. '.level' is a point followed by one digit. It defines the compression level. The special value .0 means: Use default compression level (=.5). '@factor' is a factor for the chunk size. The base size is 2 MiB. The value @0 is replaced by the default factor @20 (40 MiB). If the factor is not set but option --chunk-size is set, the factor will be calculated by using a rounded value of that option. All three parts are optional. All default values may be changed in the future. --compr is a shortcut for --compression and --wia=mode a shortcut for »--wia --compression mode«. The command »wit COMPR« prints an overview about all compression modes.
	`--config`	file	Define a configuration file or a directory as source. In later case, file 'wiimms-iso-tools.conf' is searched. If option is not not set, then file 'wiimms-iso-tools.conf' is searched in different directories. Use command 'wszst CONFIG' to get more details.
	`--copy-gc`		If extracting a GameCube disc image, don't extract the real files to '/files/...'. Instead create a copy of the source image and store it as 'game.iso'. If the source image is already in this format, try to create a hard link and copy only if it fails.
	`--ctime`		Select 'ctime' (last status change time) for printing. --ctime is an abbreviation of »--time c«.
`-d`	`--dest`	path	Define a destination path (directory or file). The destination path is scanned for escape sequences (see option --esc) to allow generic paths.
`-D`	`--DEST`	path	Like --dest, but create the directory path automatically.
	`--disc-id`	id	This patching option changes the ID of the disc header to the given parameter. 1 to 6 characters are expected. Only defined characters not equal '.' are modified. The plus sign '+' is a wildcard for multiple '.' to fill the complete entered ID to 6 characters. Option --disc-id overrides the definition of option --id.
	`--disc-size`	size	Define a minimal (virtual) ISO disc size.
	`--domain`	domain	This patching option replaces the domain 'nintendowifi.net' by the new domain. The length of the new domain must not be larger than the old length (16 characters). If the new domain length is not larger than 11, then 'gamespy.com' of 'sake.gamespy.com' is replaced too. This is a special support for 'Super Smash Bros. Brawl'.
	`--dsync`	[=mode]	This option enables the usage of flag O_DSYNC when opening a partition at a hard drive for writing. With activated flag, writing an image is some percent slower, but the progress counters are exact again. Parameter MODE is optional. If set, it is one of OFF (disable), ON (enable) or AUTO (default). With AUTO, DSYNC is enabled if the progress counters are active. This option has only impact, if compiler and operation system support the flag O_DSYNC. Linux does.
	`--enc`	encoding	Define the encoding mode. The mode is one of NONE, HASHONLY, DECRYPT, ENCRYPT, SIGN or AUTO. The case of the keywords is ignored. The default mode is 'AUTO'.
`-E`	`--esc`	char	Define an alternative escape character for destination files. The default is '%'. For Windows (CYGWIN) it is a good choice to set '-E$' to avoid conflicts with command shell variables.
`-x`	`--exclude`	id	A comma separated list with ID4 and ID6 values is expected. '.' is a wildcard for exact 1 character and '+' is a wildcard for any number characters. If the parameter begins with a '@' the given file is read and each line is scanned for one ID. Images with the given ID are excluded from operation. Each use of this option expands the exclude list. See --include-first for precedence issues.
`-X`	`--exclude-path`	file_or_dir	Scan the ID of the source and add it to the exclude list. If the source is a directory then scan all images of the directory. Images with the given ID are excluded from operation. Each use of this option expands the exclude list. See --include-first for precedence issues.
	`--files`	ruleset	Append file select rules. This option can be used multiple times to extend the rule list. Rules beginning with a '+' or a '-' are allow or deny rules rules. Rules beginning with a ':' are macros for predefined rule sets.
	`--flat`		While extracting a disc image strip all path names of the source file and store all files in the same directory. This option sets the default for --pmode to NONE.
`-f`	`--force`		Force operation.
	`--fragments`		Print fragmentation info instead of region info. --frag is a short cut.
	`--fst`		Set image output mode to 'file system' (extracted ISO).
	`--gcz`		Set image output file type to GCZ (Dolphins GameCube Zip).
	`--gcz-block`	size	The value defines the block size, if creating a GCZ image. The default is 16K (also Dolphins default). Smaller values enlarge the managment data and reduce the compression ratio. Use the option with caution!
	`--gcz-zip`		If creating a GCZ image, a blockwise z-compression is tried. If the compressed data is larger than 98.5%, the uncompressed data is stored. Encrypted blocks are stored directly as uncompressed data, because the 98.5% test fails all the time. Option --gcz-zip disables this optimization for encrypted data and makes the creation process slower.
`-h`	`--help`		Stop parsing the command line, print a help message and exit.
	`--hss`	size	Define HD sector size. The parameter 'size' is a floating point number followed by an optional unit factor (one of 'cb' [=1] or 'kmgtpe' [base=1000] or 'KMGTPE' [base=1024]). Only power of 2 values larger or equal 512 are accepted. The default value is 512.
	`--http`		This patching option replaces 'https' request to 'http' in the files 'main.dol' and 'rel/StaticR.rel', if the files exist. It also replaces the sub-domain 'naswii' to 'nas'.
	`--id`	id	This patching option changes the ID of the disc to the given parameter. 1 to 6 characters are expected. Only defined characters not equal '.' are modified. The plus sign '+' is a wildcard for multiple '.' to fill the complete entered ID to 6 characters. The disc header, boot.bin, ticket.bin and tmd.bin are objects to modify. The option --modify selects the objects.
`-i`	`--ignore`		Ignore non existing files/discs without warning. If set twice then all non Wii and GameCube ISO images are ignored too.
	`--ignore-files`	ruleset	This option defines filter rules to ignore real files of the FST of the DATA partition. Fake signing is not necessary, but the partition becomes invalid, because the content of some files is not copied. If such file is accessed the Wii will halt immediately, because the verification of the checksum calculation fails. The processing order of file options is: »--rm-files --zero-files --ignore-files«.
	`--ignore-fst`		Disable composing and ignore FST directories as input. This legacy option is a shortcut for --allow-fst=off.
	`--ignore-setup`		While composing ignore the file 'setup.txt', which defines some partition parameters.
`-n`	`--include`	id	A comma separated list with ID values is expected. '.' is a wildcard for exact 1 character and '+' is a wildcard for any number characters. If the parameter begins with a '@' the given file is read and each line is scanned for one ID. Only images with the given ID are included into the operation. Each use of this option expands the include list. See --include-first for precedence issues.
	`--include-first`		The options --include, --include-path, --exclude and --exclude-path decide which discs are included into the operation. If neither include nor exclude options are used, than all disc are included into the operation. If only include options are used, than only the specified discs are operated. If only exclude options are used, than all all discs but not the excluded are operated. If include and exclude options are used together and --include-first is not set, than all discs are operated that are specified by any include option and not by any exclude option. If --include-first is set, than all discs are ignored that are specified by any exclude option and not by any include option.
`-N`	`--include-path`	file_or_dir	Scan the ID of the source and add it to the include list. If the source is a directory then scan all images of the directory. Only images with the given ID are included into the operation. Each use of this option expands the include list. See --include-first for precedence issues.
	`--inode`		Print information for all inodes (invalid discs too).
	`--install`		Manage configuration for an installation.
	`--io`	flags	Setup the IO mode for experiments. The standard file IO is based on open() function. The value '1' defines that WBFS IO is based on fopen() function. The value '2' defines the same for ISO files and value '4' for WIA files. You can combine the values by adding them.
	`--ios`	ios	This patching option defines the system version (IOS to load) within TMD. The format is 'HIGH:LOW' or 'HIGH-LOW' or 'LOW'. If only LOW is set than HIGH is assumed as 1 (standard IOS).
`-I`	`--iso`		Set image output file type to PLAIN ISO.
	`--itime`		Select 'itime' (insertion time) for printing. --itime is an abbreviation of »--time i«.
	`--job-limit`	num	Execute only the first 'num' jobs and exit. If done without errors the exit status is OK (zero).
	`--json`		Dump info using JSON syntax. Options --var and --array are ignored.
	`--lang`	lang	Define the language for titles.
	`--limit`	num	Limit the output to NUM messages.
	`--links`		Detect soft and hard linked source files while composing or extracting discs and try to create hard links instead of independent copies on the destination file system.
`-L`	`--logging`		This debug option enables the logging of internal memory maps. If set twice second level memory maps are printed too.
`-l`	`--long`		Print in long format. Multiple usage possible.
	`--makedoc`		Dump infos using MakeDoc syntax. Use »--var name« as variable name of the resulting map.
	`--max-chunks`	n	Define the maximal number of chunks if creating a CISO file. The default value is 8192 for »--chunk-mode ISO« and 32760 (maximal value) for all other modes. If this value is set than the automatic calculation of --chunk-size will be modified too. --mch is a shortcut for --max-chunks.
	`--mem`	size	This option defines a memory usage limit for compressing files (in MiB if no other unit is entered). When compressing a file with method MEM (see --compression) the the compression method, level and chunk size are selected with respect to this limit. If this option is not set or the value is 0, then the environment WIT_MEM is tried to read instead. If this fails, the tool tries to find out the total memory by reading /proc/meminfo. The limit is set to 80% of the total memory minus 50 MiB.
`-M`	`--mixed`		Print disc infos of all WBFS in one combined table.
	`--modify`	list	This patching option defines the impact of the options --name and --id. It expects a comma separated list of the following keywords (case ignored) as parameter: NONE, DISC, BOOT, TICKET, TMD, WBFS, TT, ALL and AUTO (default). All keywords can be prefixed by '+' to enable that option, by a '-' to disable it or by a '=' to enable that option and disable all others.
	`--mtime`		Select 'mtime' (last modification time) for printing. --mtime is an abbreviation of »--time m«.
	`--name`	name	This patching option changes the name (disc title) of the disc to the given parameter. Up to 63 characters are expected. The disc header and boot.bin are objects to modify. The option --modify selects the objects.
	`--neek`		Abbreviation of »--psel data --pmode none --files :neek --copy-gc«. The old name --sneek is accepted too.
`-e`	`--newer`		If source and destination have valid mtimes: Copy only if source is newer.
	`--no-check`		Disable automatic check of WBFS before modificastions.
	`--no-colors`		Short cut for --color=off: Deactivate colorized text. This is the default, if an output file is not a terminal.
	`--no-expand`		Do not expand directories to the containing files or images. This option does not change the behavior of --recurse.
	`--no-free`		The discs are only dropped (slot is marked free), but the correspondent blocks are not freed. You should run CHECK or REPAIR to repair the WBFS after using this option.
`-H`	`--no-header`		Suppress printing of header and footer.
	`--no-link`		Don't try to create a hard link if copying the image forced by the option --copy-gc.
	`--no-sort`		Don't sort. Same as --sort=none.
	`--no-split`		Disable output file splitting. This is the default, but in future versions, the new option --auto-split becomes the default.
	`--no-utf-8`		Disables UTF-8 support for filenames.
	`--numeric`		Force numeric output instead of printing names.
	`--old-style`		Print in old style. This is important for tools and GUIs that are scanning the output.
`-1`	`--one-job`		Execute only the first job and exit. This is a shortcut for »--job-limit 1«.
`-o`	`--overwrite`		Overwrite already existing files without warning.
`-p`	`--part`	part	Define a primary WBFS file or partition. Multiple usage possible.
	`--php`		Dump infos using PHP syntax. Use »--var name« as variable name of the resulting object.
	`--pmode`	p-mode	This options set the prefix mode for listed or extracted files. One of the following values is allowed: AUTO, NONE, POINT, ID, NAME, INDEX, COMBI. The default value is 'AUTO'.
	`--prealloc`	[=mode]	This option enables or disables the disc space preallocation. If enabled the tools try to allocate disc space for the new files before writing the data. This reduces the fragmentation but also disables the sparse effect for preallocated areas. The optional parameter decides the preallocation mode: OFF (or 0), SMART (or 1), ALL (or 2). If no parameter is set, ALL is used. Mode 'OFF' disables the preallocation. Mode 'SMART' looks into the source disc to find out the writing areas. SMART is only available for ISO, CISO and WBFS file types. For other file types ALL is used instead. Mode 'ALL' (the default) preallocate the whole destination file. Because of the large holes in plain ISO images, the SMART mode is used for ISOs instead.
`-P`	`--progress`		Print progress counter. If --verbose is set at least twice, printing is enabled too. If progress is enabled, the default of --dsync is changed.
	`--psel`	list	This option set the scrubbing mode and defines, which disc partitions are handled. It expects a comma separated list of keywords, numbers and names; all together called parameter. All parameters are case insensitive and non ambiguous abbreviations of keywords are allowed. Each parameter becomes a rule and each rule is appended to a rule list. Rules prefixed by a minus sign are DENY rules. Rules prefixed by a plus sign or without a prefix are ALLOW rules. Each partition is compared with each rule until a rule matches the partition. If a match it found, the partition is enabled for a ALLOW rule or disabled for a DENY rule. The allowed keywords are: DATA, UPDATE, CHANNEL, PTAB0 .. PTAB3, ID, ALL, WHOLE and RAW. The following input formats are accepted too: ptype, #index, #<index, #<=index, #>index, #>=index and #tab_index.part_index.
`-q`	`--quiet`		Be quiet and print only error messages.
	`--raw`		Abbreviation of »--psel RAW«.
	`--rdepth`	depth	Set the maximum recurse depth for option --recurse. The default search depth is 10.
	`--recover`		Format a WBFS in recover mode: Write the WBFS sector, but don't reset the disc info area. Then look into each disc slot to find valid discs and restore them.
`-r`	`--recurse`	path	If path is not a directory, then it is used as a simple source file like --source. If parameter PATH contains at least one wildcard (e.g. '*.wbfs'), then PATH is used as search pattern and all found files are added. In order to use this variant, the calling shell must not interpret the wildcards. Therefore, the parameter must usually be enclosed in single or double quotes. Directories are scanned for source files recursively. The option --rdepth limits the search depth. Hidden files and hidden sub directories (file names begins with a point) and files with non supported file types (non ISO files for most commands) are ignored without notification.
	`--region`	region	This patching option defines the region of the disc. The region is one of JAPAN, USA, EUROPE, KOREA, FILE or AUTO (default). The case of the keywords is ignored. Unsigned numbers are also accepted.
`-R`	`--remove`		Remove source files/discs if operation is successful. If the source is an extracted file systems (FST) it isn't removed.
	`--repair`	mode	This option defines how to repair WBFS errors. The parameter is a comma separated list of the following keywords, case is ignored: NONE, FBT, INODES, STANDARD, RM-INVALID, RM-OVERLAP, RM-FREE, RM-EMPTY, RM-ALL, ALL. All keywords can be prefixed by '+' to enable that option, by a '-' to disable it or by a '=' to enable that option and disable all others.
	`--rm-files`	ruleset	This patching option defines filter rules to remove real files and directories from the FST of the DATA partition. Fake signing of the TMD is necessary. The processing order of file options is: »--rm-files --zero-files --ignore-files«.
	`--scan-progress`		Print a message for each found image while scanning the file system.
	`--sections`		Print in machine readable sections and parameter lines.
	`--security-fix`		Try to fix a security bug in the game. This is game dependent.
	`--set-time`	time	Use given time instead of current time.
	`--sh`		Dump info using SH syntax. Use »--var name« as prefix.
`-+`	`--show`	list	This option allows fine control over the things that are to be printed. The parameter is a comma separated list of the following keywords, case is ignored: NONE, INTRO, HEADER, SLOTS, GEOMETRY, D-ID, P-ID, P-TAB, P-INFO, P-MAP, D-MAP, W-MAP, TICKET, TMD, USAGE, PATCH, RELOCATE, FILES, UNUSED, OFFSET, SIZE, PATH and ALL. There are some combined keys: ID := D-ID,P-ID, PART := P-INFO,P-ID,P-MAP,TICKET,TMD, DISC := FILES,D-ID,D-MAP, MAP := P-MAP,D-MAP,W-MAP. All keywords can be prefixed by '+' to enable that option, by a '-' to disable it or by a '=' to enable that option and disable all others. The additional keywords DEC and HEX can be used to set a prefered number format. -HEADER suppresses the output of header lines. The commands recognize only some of these keywords and ignore the others. If --show is set, option --long is ignored for selecting output elements.
`-s`	`--size`	size	Define then total size of a WBFS file. 'size' is a floating number optionally followed by one of the single letter factors 'kKmMgGtT'. This value is only used while creating a new WBFS file.
`-S`	`--sort`	list	Define the sort mode for listings. The parameter is a comma separated list of the following keywords: NONE, NAME, TITLE, PATH, NINTENDO, FILE, SIZE, OFFSET, REGION, WBFS, NPART, FRAGMENTS, ITIME, MTIME, CTIME, ATIME, TIME = DATE, DEFAULT, ASCENDING, DESCENDING = REVERSE.
	`--source`	path	Use the entered file or directory as source. If parameter PATH contains at least one wildcard (e.g. '*.wbfs'), then PATH is used as search pattern and all found files are added. In order to use this variant, the calling shell must not interpret the wildcards. Therefore, the parameter must usually be enclosed in single or double quotes. Directories are expanded to all containing files but hidden files (file names begins with a point) are ignored. If a command needs only images then non image files of the directory are ignored without notification. The option --no-expand suppress the directory expansion.
`-z`	`--split`		Enable output file splitting. The default split size is 4 GB.
`-Z`	`--split-size`	sz	Enable output file splitting and define a split size. The parameter 'sz' is a floating point number followed by an optional unit factor (one of 'cb' [=1] or 'kmgtpe' [base=1000] or 'KMGTPE' [base=1024]). The default unit is 'G' (GiB).
`-y`	`--sync`		Synchronize the destination with all sources: Remove and copy discs until the destination WBFS contains exactly the same discs as all sources together. Remove and add only discs in respect to the include and exclude lists.
	`--sync-all`		Synchronize the destination with all sources like --sync. But use the include and exclude lists only to create the sync list and remove all disc on the destination WBFS that are not part of the sync list.
	`--technical`		Force a technical output instead of user friendly text. --tech is a short cut for --technical.
`-t`	`--test`		Run in test mode, modify nothing. >>> USE THIS OPTION IF UNSURE! <<<
	`--ticket-id`	id	This patching option changes the ID of ticket.bin to the given parameter. 1 to 4 characters are expected. Only defined characters not equal '.' are modified. The plus sign '+' is a wildcard for multiple '.' to fill the complete entered ID to 4 characters. Option --ticket-id overrides the definition of option --id.
	`--time`	list	Set time printing and sorting mode. The parameter is a comma separated list of the following keywords, case is ignored: RESET, OFF, ON, SINGLE, MULTI, NONE, ALL, I, M, C, A, DATE, TIME, SEC, IDATE, MDATE, CDATE, ADATE, ITIME, MTIME, CTIME, ATIME, ISEC, MSEC, CSEC, ASEC.
`-T`	`--titles`	file	Read file for disc titles. -T/ disables automatic search for title files.
	`--tmd-id`	id	This patching option changes the ID of tmd.bin to the given parameter. 1 to 4 characters are expected. Only defined characters not equal '.' are modified. The plus sign '+' is a wildcard for multiple '.' to fill the complete entered ID to 4 characters. Option --tmd-id overrides the definition of option --id.
	`--trunc`		Truncate PLAIN ISO and WBFS images after creating or copying to the minimal needed size with respect to the block size.
	`--tt-id`	id	This is a short cut for »--ticket id --tmd id«. If TICKET and TMD differ, the game will freeze after loading. So it makes only sense to change TICKET and TMD IDs together.
`-U`	`--unique`		Eliminate multiple entries with same values.
`-u`	`--update`		Copy only non existing discs.
	`--utf-8`		Enables UTF-8 support for filenames (default).
	`--var`	varname	Use VARNAME as variable name or prefix on script output. The default variabe name is 'res'.
`-v`	`--verbose`		Be verbose and print more progress information. Multiple usage is possible: Progress counter is enabled if set at least two times. Extended logging is enabled if set at least four times. The impact of the other verbose levels are command dependent.
`-V`	`--version`		Stop parsing the command line, print a version info and exit.
`-B`	`--wbfs`		Set image output file type to WBFS (Wii Backup File System, default).
	`--wbfs-alloc`	mode	Select one WBFS block allocation modus: FIRST: Use always the first free WBFS block. NO-FRAG: Find large blocks to minimize fragmentation. AUTO (=default): Use modus NO-FRAG for partitions >=20GiB and modus FIRST for partitions <20GiB and for files.
	`--wbfs-id`	id	This patching option changes the ID of the WBFS header to the given parameter if adding a file to a WBFS or if creating a WBFS file. 1 to 6 characters are expected. The already patched disc ID of the source is used as base and only defined characters not equal '.' are modified. The plus sign '+' is a wildcard for multiple '.' to fill the complete entered ID to 6 characters. Option --wbfs-id overrides the definition of option --id.
`-W`	`--wdf`	[=param]	Set the image output file type to WDF (Wii Disc Format). The output format is either WDFv1 or WDFv2 (default). It depends of the input file format and of the aligning. --wdf=param is a short cut for »--wdf --align-wdf=param«.
	`--wdf1`	[=param]	Set image output file type to WDF and force version 1. --wdf1=param is a short cut for »--wdf1 --align-wdf=param«.
	`--wdf2`	[=param]	Set image output file type to WDF and force version 2. --wdf2=param is a short cut for »--wdf2 --align-wdf=param«.
	`--wia`	[=compr]	Set image output file type to WIA (Wii ISO Archive). The optional parameter is a compression mode and --wia=mode is a shortcut for »--wia --compression mode«.
	`--width`	width	Define the width (number of columns) for help and some other messages and disable the automatic detection of the terminal width.
	`--wiimmfi`		Patch the images for Wiimmfi, the new custom server. It is a short cut for »--http --domain wiimmfi.de --security-fix«.
	`--wss`	size	Define WBFS sector size. The parameter 'size' is a floating point number followed by an optional unit factor (one of 'cb' [=1] or 'kmgtpe' [base=1000] or 'KMGTPE' [base=1024]). Only power of 2 values larger or equal 1024 are accepted. If not set the WBFS sector size is calculated automatically.
	`--xhelp`		Stop parsing the command line and print a help message with all commands included. Exit after printing.
	`--zero-files`	ruleset	This patching option defines filter rules to zero (set size to zero) real files of the FST of the DATA partition. Fake signing of the TMD is necessary. The processing order of file options is: »--rm-files --zero-files --ignore-files«.