affuse(1)

✨ affuse(1) — NAME ✨

okay bestie, so affuse is literally the tool that lets you provide access to AFF containers 🦋 main character energy fr. 💅

---

🎀 SYNOPSIS 🎀

affuse [<FUSE library options>] aff_image mount_point

---

💖 DESCRIPTION 💖

okay so affuse gives you access to AFF containers, and that unlocks several advanced operations 🔥 it's giving power user 👑

this file is part of the AFFLIBv3, which is the thing that provides AFF 🌸

AFF is an open and extensible file format for storing disk images and their associated metadata ✨ it's super useful in a bunch of scenarios, like computer forensics investigations 🕵️‍♀️ no cap, it's iconic.

---

🌈 OPTIONS 🌈

🧚 FUSE options:

• -d -o debug — ngl this turns on debug output, and it implies -f 🙈
• -f — keeps things in the foreground 🫶
• -s — turns off multi-threaded operation 💜
• -o allow_other — lets other users get in on the access 🌸
• -o allow_root — lets root in too 👑
• -o auto_unmount — auto unmounts when the process ends 🦋
• -o nonempty — lets you mount over a non-empty file or dir, lowkey risky but allowed 💀
• -o default_permissions — the kernel handles the permission checks 🔥
• -o fsname=NAME — sets the filesystem name 🎀
• -o subtype=NAME — sets the filesystem type 🍓
• -o large_read — issues large read requests (2.4 only) ✨
• -o max_read=N — sets the max size of read requests 💅
• -o hard_remove — immediate removal, files don't get hidden 😭
• -o use_ino — lets the filesystem pick the inode numbers 🌈
• -o readdir_ino — tries to fill in d_ino in readdir 🧚
• -o direct_io — uses direct I/O 💖
• -o kernel_cache — caches files in the kernel 💜
• -o [no]auto_cache — caching based on modification times, which is off by default 🦋
• -o umask=M — sets file permissions, in octal 🎀
• -o uid=N — sets the file owner 🫶
• -o gid=N — sets the file group 🌸
• -o entry_timeout=T — cache timeout for names, default 1.0s ⭐
• -o negative_timeout=T — cache timeout for deleted names, default 0.0s 💀
• -o attr_timeout=T — cache timeout for attributes, default 1.0s ⭐
• -o ac_attr_timeout=T — auto cache timeout for attributes, defaults to attr_timeout 🔥
• -o noforget — never forgets cached inodes 🧚
• -o remember=T — remembers cached inodes for T seconds, default 0s 🍓
• -o nopath — doesn't supply the path unless it's actually needed 💅
• -o intr — lets requests get interrupted 😭
• -o intr_signal=NUM — the signal to send on interrupt, default 10 🌈
• -o modules=M1[:M2...] — names of the modules to push onto the filesystem stack 👑
• -o max_write=N — sets the max size of write requests 💖
• -o max_readahead=N — sets the max readahead 🦋
• -o max_background=N — sets the max number of background requests 🌸
• -o congestion_threshold=N — sets the kernel's congestion threshold 🎀
• -o async_read — reads happen asynchronously, and this is the default ✨
• -o sync_read — reads happen synchronously 🫶
• -o atomic_o_trunc — enables atomic open+truncate support 💜
• -o big_writes — enables writes larger than 4kB 🔥
• -o no_remote_lock — disables remote file locking 💀
• -o no_remote_flock — disables remote file locking (BSD) 🙈
• -o no_remote_posix_lock — disables remote file locking (POSIX), the original typo'd it as "remove" but we know what it means 🍓
• -o [no_]splice_write — uses splice to write to the fuse device 🧚
• -o [no_]splice_move — moves data while splicing to the fuse device 🌈
• -o [no_]splice_read — uses splice to read from the fuse device 💅

🌷 Module options: 🌷

[iconv]

• -o from_code=CHARSET — the original encoding of file names, default UTF-8 🌸
• -o to_code=CHARSET — the new encoding of the file names, default UTF-8 🦋

[subdir]

• -o subdir=DIR — prepends this directory to all paths, and it's mandatory 🚨
• -o [no]rellinks — transforms absolute symlinks into relative ones 🫶

---

📝 NOTES 📝

okay bestie, to unmount, just run fusermount3 -u mount_point 💅✨

---

👯 SEE ALSO 👯

affcat(1), affcompare(1), affconvert(1), affcopy(1), affcrypto(1), affdiskprint(1), affinfo(1), affix(1), affrecover(1), affsegment(1), affsign(1), affstats(1), affverify(1), affxml(1) 🌈

---

💜 AUTHOR 💜

the AFFLIB was written by Simson L. Garfinkel <simsong@acm.org> and Basis Technology, Inc. 🫶

this manual page was written by Joao Eriberto Mota Filho <eriberto@debian.org> for the Debian project (but may be used by others) 🎀

---

okay that's the tea, bestie 🧚 AFFUSE 3.7.4, Oct 2014, affuse(1) forever ✨💖