» 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

- wfuse is able to mount Wii and GameCube images of file formats ISO, WDF, WIA, CISO, WBFS, GCZ and FST. It can also mount complete WBFS partitions. The mounted file system is read only.
- The general directory layout is /WBFS/ISO/WiiPartition/Files.
- For WBFS, the discs can be accessed by slot, ID and title.
- For each image, standalone or part of a WBFS, all virtual and real files are available in the file system structure. There is also a disc.iso image to access the plain ISO.
- wfuse is available as binary for Linux/i386, Linux/x86_64 and Mac (univiversal binary) and comes with the WIT distribution. Cygwin/Windows is not supported.

Read »Features« for features of the whole toolset.

## 3. Options in alphabetic order

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