In memory of Ben “bushing” Byer, who passed away on Monday, February 8th, 2016.

Changes

Jump to navigation Jump to search

Wiifuse (view source)

Revision as of 14:28, 15 March 2008

101 bytes added ,  14:28, 15 March 2008
m
small fixes, no updates
Line 5: Line 5:  
:Copyright (C) 2005 Janusz Dziemidowicz (rraptorr at nails.eu.org)
 
:Copyright (C) 2005 Janusz Dziemidowicz (rraptorr at nails.eu.org)
   −
*'''latest stable version: [[#v0.1.2|v0.1.2]]'''
+
*'''Latest stable version: [[#v0.1.2|v0.1.2]]'''
−
*'''current version: [[#v0.2.0-wip1|v0.2.0-wip1]]'''
+
*'''Current version: [[#v0.2.0-wip1|v0.2.0-wip1]]'''
   −
==readme==
     −
===about===
+
==Readme==
−
:wiifuse is a program that allows you to mount a gamecube or wii dvd disc image as a read-only part of the file system. this allows users to browse the directory structure and read the files within.
     −
:in contrast to the gamecube, wii images do have multiple partitions. these are encrypted, and wiifuse supports on the fly decryption - provided you have the required 128bit AES key.
+
===About===
 +
:wiifuse is a program that allows you to mount a Gamecube or Wii DVD disc image as a read-only part of the file system. This allows users to browse the directory structure and read the files within.
   −
:further, wiifuse provides access to special data found on these discs. among others, this includes the main executable and informational things like the game name.
+
:In contrast to the Gamecube, Wii images have multiple partitions. These are encrypted and wiifuse supports on-the-fly decryption - provided you have the required 128bit AES key.
   −
===requirements===
+
:Further, wiifuse provides access to special data found on these discs. Among others, this includes the main executable and informational things like the game's name.
−
:*an operating system which
  −
:**is supported by [http://fuse.sourceforge.net/ FUSE]
  −
:**supports POSIX compatible threads
  −
:*FUSE 2.6.x or higher
  −
:*[http://openssl.org/ openssl]
     −
===build===
+
===Requirements===
−
:to build wiifuse, you will need a working compiler and the development packages for the required libraries, have a look at the [[#os specific notes|os specific notes]].
+
:*An operating system which
−
:the archive includes a <tt>Makefile</tt>, so just run
+
:**is supported by [http://fuse.sourceforge.net/ FUSE],
−
:<code>make</code>
+
:**supports POSIX compatible threads,
 +
:*FUSE 2.6.x (or higher) and
 +
:*[http://openssl.org/ OpenSSL]
   −
===usage===
+
===Build===
−
:<code>./wiifuse <image_file> <mount_point> [<FUSE library options>]</code>
+
:To build wiifuse, you will need a working compiler and the development packages for the required libraries; have a look at the [[#OS-Specific Notes|OS-specific notes]].
 +
:The archive includes a <tt>Makefile</tt>, so just run
 +
:<code>'''make'''</code>
   −
:hints:
+
===Usage===
−
:*append <code>-f</code> for debug messages (process won't daemonize).
+
:<code>'''./wiifuse <image_file> <mount_point> [<FUSE library options>]'''</code>
−
:*append <code>-o allow_other</code> to let other users access the mount point.
  −
:*append <code>-h</code> for common FUSE library options.
  −
:*use <code>fusermount -u <mount_point></code> to unmount a previously mounted image.
     −
===example===
+
:Hints:
 +
:*Append <code>-f</code> for debug messages (process won't daemonize).
 +
:*Append <code>-o allow_other</code> to let other users access the mount point.
 +
:*Append <code>-h</code> for common FUSE library options.
 +
:*Use <code>'''fusermount -u <mount_point>'''</code> to unmount a previously mounted image.
 +
 
 +
===Example===
 
<code>
 
<code>
−
:$ ./wiifuse ~/zelda_tp.iso ~/wii_image -o allow_other
+
:'''$ ./wiifuse ~/zelda_tp.iso ~/wii_image -o allow_other'''
 
:$ ls -l ~/wii_image
 
:$ ls -l ~/wii_image
 
</code>
 
</code>
Line 62: Line 63:  
</code>
 
</code>
   −
===troubleshooting===
+
 
−
:*check if the FUSE kernel module is loaded
+
===Troubleshooting===
−
:**linux: <code>lsmod | grep fuse</code>
+
:*Check if the FUSE kernel module is loaded:
 +
:**linux: <code>'''lsmod | grep fuse'''</code>
 
:**freebsd: <code>kldstat | grep fuse</code>
 
:**freebsd: <code>kldstat | grep fuse</code>
−
:**os x: <code>kextstat | grep fuse</code>
+
:**OS X: <code>kextstat | grep fuse</code>
−
:*verify your key file, the '''md5sum''' of the 16 byte file (without line feed) currently is <tt>8d1a2ebcd82a3469b77facf15d9c8e50</tt>.
+
:*Verify your key file, the MD5-sum of the 16 byte file (without line feed) currently is <tt>8d1a2ebcd82a3469b77facf15d9c8e50</tt>.
−
:*append <code>-d 2>&1 | tee ~/wiifuse.log</code> to the wiifuse cmdline. this will create a logfile called <tt>wiifuse.log</tt> in your home directory, open it in your favorite text editor to get an idea of whats going wrong.
+
:*Append <code>-d 2>&1 | tee ~/wiifuse.log</code> to the wiifuse cmdline. This will create a logfile called <tt>wiifuse.log</tt> in your home directory. Open it in your favorite text editor to get an idea of what's going wrong.
−
:if you still can't get it working, copy and paste the content of that logfile to something like [http://rafb.net/paste/ rafb] and /msg me the resulting link.
+
:If you still can't get it working, copy and paste the content of that logfile to something like [http://rafb.net/paste/ rafb] and /msg me (dhewg) the resulting link on IRC.
 +
 
 +
 
 +
==OS-Specific Notes==
   −
==os specific notes==
+
===Debian / Ubuntu===
 +
:To install the binaries provided below, do the following:
 +
:<code>'''dpkg -i wiifuse_0.2.0-wip1-1_i386.deb'''</code>
   −
===debian / ubuntu===
+
:To build wiifuse you need to fetch these required packages:
−
:to build wiifuse you need to install these required packages:
+
:<code>'''aptitude (or apt-get) install build-essential fuse-utils libfuse-dev libssl-dev'''</code>
−
:<code>apt-get install build-essential fuse-utils libfuse-dev libssl-dev</code>
  −
:you can nevertheless also use the binaries provided below. install them with
  −
:<code>dpkg -i wiifuse_0.2.0-wip1-1_i386.deb</code>
     −
:to mount an image without root privileges, add the user to the <code>fuse</code> group:
+
:To mount an image without root privileges, add the user to the <code>fuse</code> group:
−
:<code>adduser dhewg fuse</code>
+
:<code>'''adduser dhewg fuse'''</code>
   −
===gentoo===
+
===Gentoo===
−
:*<code>emerge sys-fs/fuse</code>
+
:*<code>'''emerge sys-fs/fuse'''</code>
   −
===freebsd===
+
===FreeBSD===
−
:install the required ports:
+
:Install the required ports:
−
:*sysutils/fusefs-kmod
+
:*'''sysutils/fusefs-kmod'''
−
:*sysutils/fusefs-libs
+
:*'''sysutils/fusefs-libs'''
   −
:[http://fuse4bsd.creo.hu/ further doc's]
+
:Further docs can be found [http://fuse4bsd.creo.hu/ here].
   −
===os x===
+
===OS X===
−
:required software:
+
:Required software:
 
:*[http://code.google.com/p/macfuse/ macfuse]
 
:*[http://code.google.com/p/macfuse/ macfuse]
 
:*[http://developer.apple.com/tools/xcode/ Xcode]
 
:*[http://developer.apple.com/tools/xcode/ Xcode]
   −
==download==
+
 
 +
==Download==
    
===v0.2.0-wip1===
 
===v0.2.0-wip1===
 
:[[media:Wiifuse-0.2.0-wip1.tgz|wiifuse-0.2.0-wip1.tgz]]
 
:[[media:Wiifuse-0.2.0-wip1.tgz|wiifuse-0.2.0-wip1.tgz]]
   −
:Binary for debian unstable (and probably latest Ubuntu as well):
+
:Binary for Debian unstable (and probably latest Ubuntu as well):
 
::[[media:Wiifuse_0.2.0-wip1-1_i386.tgz|wiifuse_0.2.0-wip1-1_i386.tgz]]
 
::[[media:Wiifuse_0.2.0-wip1-1_i386.tgz|wiifuse_0.2.0-wip1-1_i386.tgz]]
   Line 112: Line 117:  
:[[media:Wiifuse-0.1.1.tgz|wiifuse-0.1.1.tgz]]
 
:[[media:Wiifuse-0.1.1.tgz|wiifuse-0.1.1.tgz]]
   −
==changelog==
+
 
 +
==Changelog==
    
:*v0.2.0-wip1
 
:*v0.2.0-wip1
Alexx
6

edits

Retrieved from "https://wiibrew.org/wiki/Special:MobileDiff/5399"

Navigation menu