Description:
A FUSE-based fault injection filesystem
Last Change:
Clone URL:
ssh://bronevichok.ru/unreliablefs.git

Commit Briefs

5a4f902409 Sergey Bronnikov

Add configuration support (configuration_file, origin/configuration_file)

Patch adds command line options and configuration file support to unreliablefs. unreliablefs can be managed in runtime using simple .INI configuration file. unreliablefs config uses configuration language which provides a structure similar to what's found in Microsoft Windows INI files or used by configparser Python module [2]. To make it possible third-party C library [1] has been imported. There is only one supported error injection - "errinj_noop" that replaces file operation with no operation. More error injections are coming. 1. https://github.com/benhoyt/inih 2. https://docs.python.org/3/library/configparser.html Closes #3 Closes #18 Closes #1 Closes #7 Closes #12 Closes #60

diff | patch | tree

Branches

configuration_file
summary | commit briefs | commits
cpack
summary | commit briefs | commits
errinj_errno
summary | commit briefs | commits
errinj_kill_caller
summary | commit briefs | commits
fix_cmake_test_target
summary | commit briefs | commits
fix_macos
summary | commit briefs | commits
gh-pages
summary | commit briefs | commits
github-actions
summary | commit briefs | commits
ligurio/fix-tests-on-ubuntu
summary | commit briefs | commits
ligurio/gh-62
summary | commit briefs | commits
ligurio/gh-86
summary | commit briefs | commits
ligurio/gh-90
summary | commit briefs | commits
ligurio/gh-93
summary | commit briefs | commits
master
summary | commit briefs | commits
support-custom-options
summary | commit briefs | commits
update-readme
summary | commit briefs | commits

Tags

0.2.0
Fix building on FreeBSD
tag | commit briefs | commits

Tree

.cirrus.ymlcommits | blame
.gitignorecommits | blame
CMakeLists.txtcommits | blame
LICENSEcommits | blame
README.mdcommits | blame
cmake/
conf.ccommits | blame
conf.hcommits | blame
tests/
unreliablefs.1commits | blame
unreliablefs.ccommits | blame
unreliablefs.conf.5commits | blame
unreliablefs.hcommits | blame
unreliablefs_errinj.ccommits | blame
unreliablefs_errinj.hcommits | blame
unreliablefs_ops.ccommits | blame
unreliablefs_ops.hcommits | blame

README.md

## UnreliableFS

[![Build Status](https://api.cirrus-ci.com/github/ligurio/unreliablefs.svg)](https://cirrus-ci.com/github/ligurio/unreliablefs)

is a FUSE-based fault injection filesystem that allows to change
fault-injections in runtime.

Supported fault injections are:

- `errinj_noop` - replace file operation with no operation
  (similar to [libeatmydata](https://github.com/stewartsmith/libeatmydata),
  but applicable to any file operation).

### Building

Prerequisites:

- CentOS: `dnf install -y gcc -y cmake fuse fuse-devel`
- Ubuntu: `apt-get install -y gcc cmake fuse libfuse-dev`
- FreeBSD: `pkg install gcc cmake fusefs-libs pkgconf`
- OpenBSD: `pkg_add cmake`
- macOS: `brew install --cask osxfuse`

```sh
$ mkdir build && cd build
$ cmake -DCMAKE_BUILD_TYPE=Debug .. && make -j
```

### Using

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