File	Date	Author	Commit
doc	2023-04-26	Christophe DUVERGER	[30e041] v1.16
man8	2024-03-29	Christophe DUVERGER	[17d740] v1.18
src	2024-03-29	Christophe DUVERGER	[17d740] v1.18
AUTHORS	2023-05-03	Christophe DUVERGER	[ff6bb2] v1.16
BUGS	2024-03-13	Christophe DUVERGER	[f020e8] v1.17
CMakeLists.txt	2024-03-29	Christophe DUVERGER	[17d740] v1.18
COPYING	2023-04-26	Christophe DUVERGER	[c02661] Initial commit
ChangeLog	2024-03-29	Christophe DUVERGER	[17d740] v1.18
FindFUSE.cmake	2023-04-26	Christophe DUVERGER	[30e041] v1.16
INSTALL	2023-05-03	Christophe DUVERGER	[a78512] v1.16
NEWS	2023-05-03	Christophe DUVERGER	[ff6bb2] v1.16
README	2024-03-13	Christophe DUVERGER	[f020e8] v1.17
TODO	2023-04-26	Christophe DUVERGER	[c02661] Initial commit
doxygen.cfg	2023-04-26	Christophe DUVERGER	[30e041] v1.16
split.sh	2023-05-25	Christophe DUVERGER	[a29bd0] v1.16
test.sh	2024-03-13	Christophe DUVERGER	[f020e8] v1.17

Read Me

FATX filesystem support (Xbox 360)

Copyright (C) 2012-2024 Christophe Duverger

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, version 3 of the License.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.

USAGE:
This package includes 5 tools:
- fusefatx to mount a FATX filesystem
- mkfs.fatx to create a FATX filesystem
- label.fatx to print or change the label of a FATX filesystem
- fsck.fatx to check a FATX filesystem
- unrm.fatx to try to recover deleted files on a FATX filesystem

For each of these commands you can get help by either typing:
<command name> -h or <command name> --help (like "fusefatx -h") to
get command syntax
or
man <command name> (like "man fusefatx") to access to command man
page

- fusefatx:
You can use "fusefatx <device name> <directory name>" to mount a
FATX partition in a directory.
The device name can be a usual device like /dev/sdb or a standard
file containing a FATX partition.
The directory name is the mount point where the filesystem structure
will appear.
You can mount the filesystem in read-only mode with the -t option:
"fusefatx -t /dev/sdb /mnt"
The -r option is used to search for deleted files in the filesystem
and have them appear in the mount point in order to recover them:
"fusefatx -r /dev/sdb /mnt"
In that case, the filesystem is mounted read only.

- mkfs.fatx:
This tool is used to make a brand new FATX filesystem, but be careful
as it erases everything existing in the device.
Basic usage:
"mkfs.fatx <device name>"
The device name can be a usual device like /dev/sdb or a standard
file.
The option -l is used to set the filesystem label:
"mkfs.fatx /dev/sdb -l MYNAME"

- label.fatx:
"label.fatx <device name>" displays the label of an existing FATX
filesystem.
The device name can be a usual device like /dev/sdb or a standard
file containing a FATX partition.
The option -l is used to change the filesystem label:
"label.fatx /dev/sdb -l MYNAME"

- fsck.fatx:
fsck.fatx scans a FATX filesystem and checks its consistency, correcting
errors if any:
"fsck.fatx <device name>"
The device name can be a usual device like /dev/sdb or a standard
file containing a FATX partition.
The -t option enables running this tool in dry-run mode, in that
case, the filesystem is opened in read only mode:
"fsck.fatx -t /dev/sdb"
The -a option avoids asking the user to answer resolution
questions, so that the tool chooses the default answer:
"fsck.fatx -a /dev/sdb"

- unrm.fatx:
unrm.fatx searches in a FATX filesystem for deleted files and
proposes to recover them inside the FATX filesystem or outside.
Basic usage:
"unrm.fatx <device name>"
The device name can be a usual device like /dev/sdb or a standard
file containing a FATX partition.
The -t option enables running this tool in dry-run mode, in that
case, the filesystem is opened in read only mode:
"unrm.fatx -t /dev/sdb"
The -l option enables recovering deleted files outside the FATX
filesystem in the current directory (from where the tool is called)
"unrm.fatx -l /dev/sdb"
The user will be prompted for each deleted file found to recover it
or not.