.TH "fatsort" "1" "2011" "FATSort 0.9.15"
.SH NAME
FATSort \- FAT filesystem sorting utility
.SH SYNOPSIS
.B fatsort [options] device
.SH DESCRIPTION
FATsort sorts directory structures of FAT filesystems.
Many MP3 hardware players don't sort files automatically but play them in the order they were transmitted to the device. FATSort can help here.
.SH OPTIONS
.TP
.B \-c
This option causes FATSort to ignore the case of filenames (e.g. 'example.mp3' is equal to 'EXAMPLE.MP3').
.TP
.B \-f
Force sorting even if the device is mounted or if FATSort cannot determine if the device is mounted.
.TP
.B \-h
Shows some help information.
.TP
.B \-i
Prints some file system information of the specified device.
.TP
.B \-l
FATSort will not sort directory structures, but just print the current order.
.TP
.BI \-o \ type
This options specifies how FATSort will sort files and directories.
.I type
can be 'd' for directories before files (which is the default), 'f' for files before directories, or 'a' for no differentiation between files and directories.
.TP
.B \-n
Uses natural order to sort directory structures instead of  alphanumeric order.
For example, an alphanumeric order would be
.RS
.RS
file123.mp3
.RE
.RS
file21.mp3
.RE
.RS
file3.mp3
.RE
and the corresponding natural order would be
.RS
.br
file3.mp3
.RE
.RS
.br
file21.mp3
.RE
.RS
.br
file123.mp3.
.RE
.RE
.TP
.B \-q
FATSort will work quietly without printing additional information messages.
.TP
.B \-r
Sorts the directories in reverse order (Z-A).
.TP
.B \-R
Sorts the directories in random order.
.TP
.B \-v
Shows version information only.
.TP
The following options can be specified multiple times:
.TP
.BI \-d \ directory
Sort
.I directory
only
.TP
.BI \-D \ directory
Sort
.I directory
and all subdirectories
.TP
.BI \-x \ directory
Don't sort
.I directory
.TP
.BI \-X \ directory
Don't sort
.I directory
and all subdirectories
.TP
.BI \-I \ prefix
Ignore filename prefix
.I prefix
during sorting. For example, passing option -I "the " tells FATSort to sort 'The Beatles.mp3' like 'Beatles.mp3'.
.SH EXAMPLES
.TP
Sort FAT filesystem on an USB stick:
.B "fatsort /dev/sda1"
.TP
Sort FAT filesystem in a file:
.B "fatsort /home/user/fat16_fs.img"
.TP
Sort directory /dir1 and all subdirectories except /dir1/dirA:
.B "fatsort /dev/sda1 -D /dir1 -x /dir1/dirA"
.TP
Ignore prefixes 'a ' and 'the ' during sorting:
.B "fatsort /dev/sda1 -I ""a "" -I ""the ""
.SH AUTHOR
Boris Leidner <fatsort(at)formenos.de>
.SH "SEE ALSO"
.BR mount (8)
.BR fsck (8)
.SH NOTES
FAT12 is not supported yet.
.SH "REPORT BUGS"
Please report bugs to fatsort(at)formenos.de. Thanks.