DISORDERFS(1)
=============
:doctype: manpage
:revdate: 2015-08-21

NAME
----
disorderfs - FUSE filesystem that introduces non-determinism


SYNOPSIS
--------
*disorderfs* ['OPTIONS'...] 'ROOTDIR' 'MOUNTPOINT'


DESCRIPTION
-----------
*disorderfs* is an overlay FUSE filesystem that introduces non-determinism
into filesystem metadata.  For example, it can randomize the order
in which directory entries are read.  This is useful for detecting
non-determinism in the build process.

'ROOTDIR' is the absolute path to the underlying directory that is to
be mirrored, and 'MOUNTPOINT' is where the overlay should be mounted.


OPTIONS
-------
See fusermount(1), mount.fuse(8), and mount(8) for a full list of options.

Options specific to *disorderfs*:

*--multi-user=yes|no*::
  Whether or not to allow other users to access the overlay mount
  (default: no).  When enabled, disorderfs accesses the underlying
  file with the same credentials (user ID, group ID, supplemental
  group list) as the process accessing the overlaid file.  This
  is different from FUSE's *allow_other* option, which allows
  other users access, but causes disorderfs to access the underlying
  filesystem with the credentials of the user running disorderfs, which
  is usually undesirable.
  +
  *--multi-user=yes* requires disorderfs to run as root.

*--shuffle-dirents=yes|no*::
  Whether or not to randomly shuffle directory entries (default: no).
  The directory entries are shuffled every time the directory is read,
  so repeated reads of the same directory will probably return different
  results.

*--reverse-dirents=yes|no*::
  Whether or not to return directory entries in reverse order (default: yes).

*--pad-blocks='N'*::
  Add 'N' to the st_blocks field in struct stat(2) (default: 1).

*--help*, *-h*::
  Display help.

*--version*, *-V*::
  Display the version.


BUGS
----
'ROOTDIR' must be specified as an absolute path ('MOUNTPOINT' may be
absolute or relative).


AUTHOR
------
Andrew Ayer <agwa@andrewayer.name>
