WiiNandFuse: Difference between revisions

wiinandfuse
wiinandfuse
General
Author	Yellows8
Type	PC utilities
Version	1.1
License	MIT License
Last Updated	2010/05/12
Links
	Download
	Website
	Source

Latest revision as of 03:27, 30 March 2023

Wiinandfuse is a Linux app that allows you to mount Wii NAND images and SFFS dumps with FUSE.

Wiinandfuse supports Bootmii dumps, raw NAND dumps with ECC and without ECC.

Features

Metadata and files are read and write.
HMAC verification of SFFS is supported.
Writing is disabled if HMAC verification is disabled with the -h option.
ECC correction is disabled since it's broken. Thus raw dumps from flash programmers, etc, will have corruption.
Reading pages that are corrupted and need ECC correction will fail when the -e option isn't used, but only for files since the SFFS init code doesn't check if there was ECC errors.
Usage of the UID/GID, and permissions from NAND is supported with the -p option. This doesn't restrict file access. Listing and usage of certain SFFS supercluster versions is supported with the -g option.
Dumping of nodes' raw filename is supported with the -d option.
Supported FUSE fs functions: statfs(statvfs), getattr(stat), readdir, open, release, read, rename, chown, chmod, unlink, rmdir, mknod, mkdir, truncate.

User guide

Usage:

wiinandfuse <nand.bin> <mount point> <options>

Options:

-s: Dump contains only the 4MB SFFS. Reading files will do nothing, the data reading buffers will be cleared.
-k: Directory name of keys to use for raw NAND images. Default for keyname is "default". Path: $HOME/.wii/<keyname>
-p: Use NAND permissions. UID and GUI of objects will be set to the NAND UID/GID, as well as the permissions. This option only enables setting the UID/GID and permissions in stat, the open and readdir functions don't check permissions.
-g<supercluster>: Use the specified SFFS supercluster index. If no number is specified, the superclusters are listed.
-h: Disable SFFS HMAC verification. Default is enabled.
-v: Abort/EIO if HMAC verification of SFFS or file data fails. If SFFS verification fails, wiinandfuse aborts and NAND isn't mounted. If file data verification fails, read will return EIO.
-r<supercluster>: Disable round-robin SFFS updating, default is on. When disabled, only the first metadata update has the version and supercluster increased. If supercluster is specified, the specified supercluster index has the version set to the version of the oldest supercluster minus one.
-e: Ignore ECC errors, default is disabled. When disabled, when pages have invalid ECC reads return EIO.

Changelog

v1.1

Added support for writing metadata and files, and more options.

v1.0

Initial release.

Credits

Bootmii MINI and ppcskel for nandfs structures and functions from nandfs.c and nand.c nand_correct function.
Mike Scott for his rijndeal.c.
Segher for zestig, for SFFS node permissions format, and tools.c
fs_hmac.c by gray and bushing
Steve Reid's sha1.c

External Links

Google Code - https://code.google.com/archive/p/wmb-asm
WiiBrew - https://wiibrew.org/wiki/Wiinandfuse

@@ Line 1: / Line 1: @@
-{{#seo:
-|title=Wii Homebrew PC Tools (PC utilities) - GameBrew
-|title_mode=append
-|image=wii-logo.jpg
-|image_alt=wiinandfuse
-}}
 {{Infobox Wii Homebrews
 |title=wiinandfuse
-|image=wii-logo.jpg
+|image=wii2.png
-|description=Mount Wii NAND images and SFFS dumps with FUSE.
+|description=Linux app to mount Wii NAND images and SFFS dumps with FUSE
 |author=Yellows8
 |lastupdated=2010/05/12
@@ Line 14: / Line 8: @@
 |version=1.1
 |license=MIT
-|download=https://dlhb.gamebrew.org/wiihomebrews/wiinandfusewii.7z
+|download=https://dlhb.gamebrew.org/wiihomebrews/wiinandfuse.7z
 |website=https://code.google.com/archive/p/wmb-asm
 |source=https://code.google.com/archive/p/wmb-asm/downloads
 }}
-'''Wiinandfuse''' is an app that mount Wii NAND images and SFFS dumps with FUSE.
+Wiinandfuse is a Linux app that allows you to mount Wii NAND images and SFFS dumps with FUSE.
 Wiinandfuse supports Bootmii dumps, raw NAND dumps with ECC and without ECC.
-==How To Use Wiinandfuse?==
-<pre>
-wiinandfuse <nand.bin> <mount point> <options>
-Options:
--s: Dump contains only the 4MB SFFS. Reading files will do nothing, the data reading buffers will be cleared.
--k: Directory name of keys to use for raw NAND images. Default for keyname is "default". Path: $HOME/.wii/<keyname>
--p: Use NAND permissions. UID and GUI of objects will be set to the NAND UID/GID, as well as the permissions. This option only enables setting the UID/GID and permissions in stat, the open and readdir functions don't check permissions.
--g<supercluster>: Use the specified SFFS supercluster index. If no number is specified, the superclusters are listed.
--h: Disable SFFS HMAC verification. Default is enabled.
--v: Abort/EIO if HMAC verification of SFFS or file data fails. If SFFS verification fails, wiinandfuse aborts and NAND isn't mounted. If file data verification fails, read will return EIO.
--r<supercluster>: Disable round-robin SFFS updating, default is on. When disabled, only the first metadata update has the version and supercluster increased. If supercluster is specified, the specified supercluster index  has the version set to the version of the oldest supercluster minus one.
--e: Ignore ECC errors, default is disabled. When disabled, when pages have invalid ECC reads return EIO.
-</pre>
 == Features ==
@@ Line 53: / Line 24: @@
 *Usage of the UID/GID, and permissions from NAND is supported with the -p option. This doesn't restrict file access. Listing and usage of certain SFFS supercluster versions is supported with the -g option.
 *Dumping of nodes' raw filename is supported with the -d option.
+*Supported FUSE fs functions: statfs(statvfs), getattr(stat), readdir, open, release, read, rename, chown, chmod, unlink, rmdir, mknod, mkdir, truncate.
-Supported FUSE fs functions:
+==User guide==
-*statfs(statvfs),
+Usage:
-*getattr(stat),
+ wiinandfuse <nand.bin> <mount point> <options>
-*readdir,
-*open,
+Options:
-*release,
+*<code>-s</code>: Dump contains only the 4MB SFFS. Reading files will do nothing, the data reading buffers will be cleared.
-*read,
+*<code>-k</code>: Directory name of keys to use for raw NAND images. Default for keyname is "default". Path: $HOME/.wii/<keyname>
-*rename,
+*<code>-p</code>: Use NAND permissions. UID and GUI of objects will be set to the NAND UID/GID, as well as the permissions. This option only enables setting the UID/GID and permissions in stat, the open and readdir functions don't check permissions.
-*chown,
+*<code>-g<supercluster></code>: Use the specified SFFS supercluster index. If no number is specified, the superclusters are listed.
-*chmod,
+*<code>-h</code>: Disable SFFS HMAC verification. Default is enabled.
-*unlink,
+*<code>-v</code>: Abort/EIO if HMAC verification of SFFS or file data fails. If SFFS verification fails, wiinandfuse aborts and NAND isn't mounted. If file data verification fails, read will return EIO.
-*rmdir,
+*<code>-r<supercluster></code>: Disable round-robin SFFS updating, default is on. When disabled, only the first metadata update has the version and supercluster increased. If supercluster is specified, the specified supercluster index has the version set to the version of the oldest supercluster minus one.
-*mknod,
+*<code>-e</code>: Ignore ECC errors, default is disabled. When disabled, when pages have invalid ECC reads return EIO.
-*mkdir,
-*truncate.
 == Changelog ==
@@ Line 85: / Line 55: @@
 ==External Links==
-* Wiibrew - https://wiibrew.org/wiki/Wiinandfuse
+* Google Code - https://code.google.com/archive/p/wmb-asm
-* Google Source - https://code.google.com/archive/p/wmb-asm
+* WiiBrew - https://wiibrew.org/wiki/Wiinandfuse