| commit | d2acdb1c8e4531562fc77fe566896e771d03026e | [log] [tgz] |
|---|---|---|
| author | Ashish Bijlani <ashish.bijlani@gmail.com> | Tue May 02 09:18:49 2023 -0500 |
| committer | GitHub <noreply@github.com> | Tue May 02 09:18:49 2023 -0500 |
| tree | d59ddb65225c9b7dc492939e74d229d21640a09c | |
| parent | b853870db92b087584b2e904e8846f9832916e27 [diff] |
Update README.md
Note for consulting/customization, please reach out to the author.
We have modifed the FUSE driver to support ExtFUSE feature. Therefore, you will have to install and run a our modified kernel. To clone the kernel sources do:
$ git clone --branch ExtFUSE-1.0 https://github.com/extfuse/linux $ cd linux $ make menuconfig --> General setup [*] Enable bpf() system call --> File systems <*> FUSE (Filesystem in Userspace) support [*] Extension framework for FUSE $ make -j4 $ sudo make install -j4 $ make headers_install
In menuconfig step, DO NOT select FUSE as a kernel module as it will cause the kernel compilation to fail; instead, build FUSE into the kernel.
Boot into the new kernel. Clone ExtFUSE library sources and build. Export the path to repo as EXTFUSE_REPO_PATH. You will need LLVM/Clang toolchain to build.
$ git clone https://github.com/extfuse/extfuse $ cd extfuse $ export EXTFUSE_REPO_PATH=$(pwd) $ LLC=llc-3.8 CLANG=clang-3.8 make
The eBPF code for handling FUSE requests in the kernel can be found in bpf/extfuse.c. Once you build the library, compiled eBPF bytecode can be found in src/extfuse.o.
Finally, you will also need a modified FUSE library. To clone its source repo:
$ git clone --branch ExtFUSE-1.0 https://github.com/extfuse/libfuse
Follow instructions here to build libfuse. NOTE that you will need to run ./makeconf.sh to create the configure script.
You can test ExtFUSE functionality with a simple stackable FUSE file system here. NOTE that you will need to copy $EXTFUSE_REPO_PATH/src/extfuse.o to /tmp before you test StackFS because the name and path is hard-coded in StackFS_LL.c.
$ git clone https://github.com/ashishbijlani/StackFS $ cd StackFS $ make $ cp $EXTFUSE_REPO_PATH/bpf/extfuse.o /tmp/. $ sudo sh -c "LD_LIBRARY_PATH=$EXTFUSE_REPO_PATH ./StackFS_ll -o max_write=131072 -o writeback_cache -o splice_read -o splice_write -o splice_move -r $ROOT_DIR $MNT_DIR -o allow_other"
If you use this work for your research, we would deep appreciate a citation to our USENIX ATC '19 Paper
@inproceedings {234870,
author = {Ashish Bijlani and Umakishore Ramachandran},
title = {Extension Framework for File Systems in User space},
booktitle = {2019 {USENIX} Annual Technical Conference ({USENIX} {ATC} 19)},
year = {2019},
isbn = {978-1-939133-03-8},
address = {Renton, WA},
pages = {121--134},
url = {https://www.usenix.org/conference/atc19/presentation/bijlani},
publisher = {{USENIX} Association},
}