prevnext   » WIT: Wiimms ISO Tools » wit: Wiimms ISO Tool » wit list

wit list

List all found ISO files.

Contents

1.   Syntax

wit LIST [source]...

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 WBFS partitions using '/proc/partitions' or searching hard disks in '/dev/' and use all readable as source. This works like »wwt --auto --all«.
-s --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.

--no-expand Do not expand directories to the containing files or images. This option does not change the behavior of --recurse.
-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.

--rdepth depth Set the maximum recurse depth for option --recurse. The default search depth is 10.
-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).
--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.
-L --logging This debug option enables the logging of internal memory maps. If set twice second level memory maps are printed too.
-U --unique Eliminate multiple entries with same ID6.
-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.
--no-sort Don't sort. Same as --sort=none.
--sections Print in machine readable sections and parameter lines.
-H --no-header Suppress printing of header and footer.
-l --long If set, the size in MiB and the region is printed too. If set twice, a date columns is added. If set three times, a second line with number or partitions, file type and real path is added.
--real-path Print real path instead of entered path.
--unit list This option set the output unit for sizes. The parameter is a comma separated list of the following keywords, case is ignored: 1000=10, 1024=2, BYTES, K, M, G, T, P, E, KB, MB, GB, TB, PB, EB, KIB, MIB, GIB, TIB, PIB, EIB, HDS, WDS, GAMECUBE=GC, WII, AUTO and DEFAULT.

The values 1000 and 1024 (=default base) set the base factor and BYTES, K, M, G, T, P, E the SI factor. MB is a shortcut for 1000,M and MIB for 1024,M; this is also valid for the other SI factors. AUTO selects a value dependent SI factor.

HDS and WDS forces the output as multiple of the HD or Wii disc sector size (512 or 32768 bytes). GAMECUBE and WII forces the output of a floating point value as multiple of the single layer ISO images size of the given type.

DEFAULT allows the command to select a adequate size unit.

-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.
--scan-progress Print a message for each found image while scanning the file system.
--itime Select 'itime' (insertion time) for printing. --itime is an abbreviation of »--time i«.
--mtime Select 'mtime' (last modification time) for printing. --mtime is an abbreviation of »--time m«.
--ctime Select 'ctime' (last status change time) for printing. --ctime is an abbreviation of »--time c«.
--atime Select 'atime' (last access time) for printing. --atime is an abbreviation of »--time a«.
--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.