GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
UNRELIABLEFS(1) FreeBSD General Commands Manual UNRELIABLEFS(1)

unreliablefs
a FUSE-based fault-injecting filesystem

unreliablefs mountpoint [-basedir path] [-seed number] [-hvdf]

The unreliablefs is a filesystem that allows to inject errors on file operations. Without configuration it works as pass-through filesystem and redirects file operations to a file objects on a real filesystem.

unreliablefs uses Filesystem in Userspace (FUSE) that allows easy setup without requiring a kernel recompile or new kernel modules. Without any other configuration, any files in a mounted directory will be available unchanged. To mount filesystem it is required to specify mountpoint and after mount it will contain the same file tree as a root filesystem.

The options are as follows:

path
Specify path to a directory that should be mount.
number
Specify a seed.
Do not daemonize.
Do not daemonize. If this option is specified, unreliablefs will run in the foreground and log to stderr.
Show version.
Show usage.

Supported file operations are: access(2), chmod(2), chown(2), creat(2), fallocate(2), flock(2), fsync(2), ftruncate(2), getxattr(2), ioctl(2), link(2), listxattr(2), lock(2), lstat(2), mkdir(2), mknod(2), open(2), read(2), readdir(2), readlink(2), removexattr(2), rename(2), rmdir(2), setxattr(2), statfs(2), symlink(2), truncate(2), unlink(2), utimensat(2), write(2).

Following functions are unsupported on OpenBSD: removexattr(2), setxattr(2), getxattr(2), listxattr(2), flock(2), fallocate(2).

The unreliablefs utility exits 0 on success, and >0 if an error occurs.


$ mkdir /tmp/fs
$ unreliablefs /tmp/fs -basedir=/tmp -seed=1618680646
$ cat << EOF > /tmp/fs/unreliablefs.conf
[errinj_noop]
op_regexp = .*
path_regexp = .*
probability = 30
EOF
$ ls -la
$ umount /tmp/fs

fusermount(1), errno(2), fuse(4), fuse(8), unreliablefs.conf(5), mount.fuse(8)

The unreliablefs utility was written by Sergey Bronnikov.

Faults can be injected before a start of a file operation, and cannot be injected say in a middle of file operation. So if a file operation has been successfully started then unreliablefs will not affect it and final result entirely depends on a base filesystem and application that started file operation.
November 3, 2020 FreeBSD 13.1-RELEASE

Search for    or go to Top of page |  Section 1 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.