A valid FST is a partition directory or a disc directory with one or more partitions. Most commands of wit and wwt (like »wit COPY« or »wwt ADD«) accept a valid FST as input like any other ISO format (see »file formats«). If opening such a FST directory the internal file layer will scan the source directory and will build a memory map of partitions and files. This is fast.
When reading this virtual ISO then the source files are read and encrypted as needed. After reading the complete disc and before closing the output files, the H3 and H4 hashes are updated and TICKET and TMD are trucha signed. The modified parts are then written again to the destination file.
| Files and Directories of FST | ||
|---|---|---|
| path | mode | description |
| required | Base directory which contains the extracted partition header and all other directories. | |
| optional |
This text file allows the user to define composing options.
Eeach line contains one option.
The general syntax is: The following 4 parameters are supported:
|
|
| optional | The TICKET of the partition. If not exists the TICKET will be created from scratch. The ID4 of the TICKET will be patched by the option --id. The TICKET will be trucha signed. | |
| optional | The TMD of the partition. If not exists the TMD will be created from scratch. The ID4, the disc title and the system version of the TMD will be patched by the options --id, --name and --ios. The TMD will be trucha signed. | |
| optional | The certificate of the partition. If not exists a standard cert chain will be used. | |
| ignored | When extracting a file system this file will be extracted too. It contains all H3 hash values. It is not needed for composing because it will be generated automatically. | |
| optional | Directory of disc files. Only the disc files of the DATA partition are used. | |
| optional | This are the first 128 bytes of the Wii disc.
If this file is missed then ID and disc titles are copied from The ID6 and the disc title of the header will be patched by the options --id and --name.
Only the |
|
| optional | If »--region AUTO« fails and this file exists, than 32 bytes are read
to setup the region info at disc offset
Only the |
|
| required | Directory of system files. | |
| required | A file with 1088 (0x440) bytes is expected.
The ID6 and the disc title of the header
will be patched by the options --id and --name.
The command »wit DUMP« can dump the data structure of |
|
| optional | A file with 8192 (0x2000) bytes is expected.
If missing, a generic version is created.
Before v3.05a, this file was required. |
|
| required | The application loader is expected. | |
| required | The main executable is expected.
Hint: The command »wit DUMP« can dump the data structure of |
|
| ignored | When extracting a file system this file will be extracted too.
It contains the file table of the real files of the Wii disc.
It is not needed for composing because it will be generated automatically.
Hint: The command »wit DUMP« can dump the content of |
|
| required | Directory of real files.
All sub directories (recursivley) and files not beginning with a point (
If directories or files beginning with a |
|
| optional | This is an optional file.
Each line contains one filename beginning with
These files are ignored and not included into the image regardless of |
|
| optional | This is an optional file.
Each line contains one filename beginning with
Files beginning with a point ( |
|
If all required files and sub directories exist then the base directory is a valid FST partition.
If composing from a FST partition it becomes a DATA partition (partition type
If you are unsure about the files, extract an image and compare the extracted files with this documentation.
| Options | |||
|---|---|---|---|
| Option | Param | Description | |
| --ignore-fst | Disable composing and ignore FST directories as input. This legacy option is a shortcut for --allow-fst=off. | ||
| --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
All keywords can be prefixed by |
|
| --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. | |
| --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. | |
| --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. | |
| --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. | |
| --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. | |
| --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. | |
| --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. | |
| --region | region | This patching option defines the region of the disc. The region is one of |
|
| --ios | ios | This patching option defines the system version (IOS to load) within TMD. The format is |
|
| --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'. | |
| -L | --logging | This debug option enables the logging of internal memory maps. If set twice second level memory maps are printed too. | |
The command »wit DUMP« dumps the data structure of any ISO image including FST to standard output. This is good for fast control the design of the virtual disc. Use the option --long multiple times to get more details. Remember: Because only parts of the virtual image are read the caluclation of hash and the signing are incomplete.
»wit DUMP« can also dump information about
Use »wit FILES« to list the files of the virtual ISO image. Combine it with the option --files to filter files. Use »wit EXTRACT« in combination with option --files to extract and confirm the patched system files.