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

wwt skeleton

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.

Contents

1.   Syntax

wwt SKELETON [id6]...

2.   Options

Options
Option Param Description
-T --titles file Read file for disc titles. -T/ disables automatic search for title files.
--utf-8 Enables UTF-8 support for filenames (default).
--no-utf-8 Disables UTF-8 support for filenames.
--lang lang Define the language for titles.
-a --auto Search for WBFS partitions using '/proc/partitions' or searching hard disks in '/dev/'.
-A --all Use all WBFS partitions found.
-p --part part Define a primary WBFS file or partition. Multiple usage possible.
--no-check Disable automatic check of WBFS before modifications.
-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.
-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.
-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.
--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.

-1 --one-job Execute only the first job and exit. This is a shortcut for »--job-limit 1«.
--job-limit num Execute only the first 'num' jobs and exit. If done without errors the exit status is OK (zero).
-q --quiet Be quiet and print only error messages.
-L --logging This debug option enables the logging of internal memory maps. If set twice second level memory maps are printed too.
-t --test Run in test mode, modify nothing.

>>> USE THIS OPTION IF UNSURE! <<<

--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.

--raw Abbreviation of »--psel RAW«.
-i --ignore Ignore non existing discs without any warning.
-W --wdf [=param] Set the image output file type to WDF (Wii Disc Format). The output format is either WDFv1 or WDFv2. It depends of the input file format and of the aligning. --wdf=param is a short cut for »--wdf --align-wdf=param«.
-I --iso Set image output file type to PLAIN ISO.
-C --ciso Set image output file type to CISO (Compact ISO, same as WBI).
-B --wbfs Set image output file type to WBFS (Wii Backup File System, default).
-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.

3.   Description

With the SKELETON command the user can create a small database of all owned games. Therefor the command copies the disc header and all partitions headers and some bytes of mail.dol and apploader.img and the complete internal directory structure (FST.bin).

All copied data is placed at the same location as its origin. Because of this a skeletion looks like a Wii discs, but all files are zeroed. Moreover the skeleton is decrypted and all hash values are removed. The typical size of a skeleton is about 4KB up to 700KB. Because of decryption a skeleton is compressible.

For more details see command wit SKELETON#desc.

4.   Usual error/exit codes:

0 == OK             : All done without errors.
SYNTAX ERROR        : At least one syntax error in command line found.
MISSING PARAMETERS  : No parameters (ID6) given.
NO WBFS FOUND       : No WBFS partition found.
TO MUCH WBFS FOUND  : Two or more no WBFS partition found but --all missed.
WDISC NOT FOUND     : Disc not found on any WBFS partition.
REMOVE ERROR        : Error while removing a disc from a WBFS.
READ ERROR          : Error while reading the WBFS.
WRITE ERROR         : Error while writing a ISO image.