prevnext   » WIT: Wiimms ISO Tools » wfuse: Wiimms FUSE Tool

wfuse: Wiimms FUSE Tool

Mount a Wii or GameCube image or a WBFS file or partition to a mount point using FUSE (Filesystem in USErspace). Use 'wfuse --umount mountdir' for unmounting.


1.   Syntax

wfuse [option]... source mountdir
wfuse --umount mountdir...

2.   Features of wfuse

Read »Features« for features of the whole toolset.

3.   Options in alphabetic order

Option Param Description
-O --allow-other This option is a short cut for '-o allow_other'. It enables re-exporting of the mounted file system for example by a samba server.
-c --create If the mount point does not exist, create it and remove it on unmount.
-h --help Stop parsing the command line, print a help message and exit.
-H --help-fuse Stop parsing the command line and print a FUSE help message.
-l --lazy Lazy unmount: Detach the mounted file system from the file system hierarchy now, and cleanup all references to the file system as soon as it is not busy anymore.
-o --option param This option is forwarded to FUSE command line scanner as '-o param'.
-p --param param The parameter is forwarded to the FUSE command line scanner.
-q --quiet Be quiet and print only error messages.
-r --remount If the mount point is already mounted, try silently to unmount it first.
-u --umount Enter 'unmount mode' and unmount each entered directory by calling 'fusermount -u mountdir' or alternatively 'umount mountdir'.
-V --version Stop parsing the command line, print a version info and exit.
--width width Define the width (number of columns) for help and some other messages and disable the automatic detection of the terminal width.
--xhelp Same as --help.

4.   Layout of the filesystem

The complete mounted file system is readonly.

4.1   ISO images

For ISO images all supported file formats are accepted. This is the directory structure for ISO images:
  /info.txt                base info file
  /iso/info.txt            ISO info file
  /iso/disc.iso            plain ISO image
  /iso/part/               the base folder of all partitions
  /iso/part/PART/          one folder for each disc partition
  /iso/part/PART/*         files like cert, ticket, tmd, h3, ...
  /iso/part/PART/disc/*    related disc infos
  /iso/part/PART/sys/*     system files like main.dol, fst.bin, ...
  /iso/part/PART/files/*   real file system
  /iso/part/*              some more handy softlinks to the partitions

PART is the unique partition index in the format tab.idx where tab is the zero based index of the partition table and idx the zero based partition index. The very first partition is always 0.0. To make access easier, the softlinks data, update and channel are available if such partiton exists. The softlink main points to the main partition. In generally it is the same as data, but it points to an other partition if no data partition is available.

/iso/disc.iso is the raw representation of the ISO image. This file is not availabe if viewing a FST image.

4.2   WBFS files and partitions

WBFS files and WBFS partitions are accepted. This is the directory structure for a WBFS:
  /info.txt            base info file
  /wbfs/info.txt       WBFS info file
  /wbfs/id/*           for each disc the ID6 as softlink to ../slot/*
  /wbfs/title/*        for each disc the title as softlink to ../slot/*
  /wbfs/slot/*         for each disc on WBFS one sub directory
  /wbfs/slot/INDEX/*   A ISO image structure like the "/iso/..." above.

All IDs are listet in /wbfs/id/ and all titles in /wbfs/title/. Each directory entry is a softlink to the corresponding slot ../slot/INDEX/.

The INDEX in /wbfs/slot/INDEX/ is the zero based slot index as decimal number. Each slot directory contains the full sub directory structure like /iso/... for ISO images. This means that each file of each disc is available.

4.3   WBFS images

A WBFS file with exact 1 disc is interpreted as ISO image. For such images both, the /iso/... and the /wbfs/... directory structure is available, but /iso is a softlink into /wbfs/slot/INDEX/.