SIMPLE-MTPFS(1)

SIMPLE-MTPFS(1) 💅✨

okay so bestie, this is the manual for SIMPLE-MTPFS, from the User Commands section, and it's literally the moment your MTP device stops being a mystery. no cap, it's giving "filesystem driver but make it fashion". 🎀

---

🌸 NAME 🌸

SIMPLE-MTPFS — filesystem driver for MTP based devices. yes bestie, that's the whole name and it's iconic. 🦋

---

🌈 SYNOPSIS 🌈

💖 mounting 💖

simple-mtpfs <device> mountpoint [options]

✨ unmounting ✨

fusermount -u mountpoint

---

🧚 DESCRIPTION 🧚

SIMPLE-MTPFS (Simple Media Transfer Protocol FileSystem) is lowkey a whole file system for Linux — and also for other operating systems that have a FUSE implementation, like Mac OS X or FreeBSD. it operates on files that live on MTP devices attached via USB to your local machine. so yeah, it's the bridge between you and your device. 🫶

On the local computer where SIMPLE-MTPFS is mounted, the implementation makes use of the FUSE (Filesystem in Userspace) kernel module. the practical effect? the end user — that's you, bestie — can seamlessly interact with MTP device files. slay. 💅

---

💜 OPTIONS 💜

⭐ general options:

• -o opt,[opt...] — mount options, obviously. you're setting the vibe of the mount. 🎀
• -h, --help — print help. your bestie when you're lost.
• -V, --version — print version. proof you're on the right release, periodt.

🍓 SIMPLE-MTPFS options:

• -l, --list-devices — list available MTP devices. supports the <device> option. think of it as a little headcount of who's connected. 🙈
  • --device — select device no. to mount. you pick the one, main character energy only. 👑
• -o enable-move — enable move operation, which can be very slow (depends on the moved content). > ngl, this is a warning: moves can be so slow, the speed fully depends on the content being moved. don't come for me, I'm just the messenger. 💀

🦋 FUSE options:

• -d, -o debug — enable debug output (implies -f). it's giving detective mode. 🔍
• -f — foreground operation. no background sneaky business. ✨
• -s — disable multi-threaded operation. one thing at a time, we're being chill. 🧚
• -o allow_other — allow access to other users. sharing is caring. 💖
• -o allow_root — allow access to root. hi root, welcome to the function. 👑
• -o nonempty — allow mounts over non-empty file/dir. yes, even when there's stuff there already. 🎀
• -o default_permissions — enable permission checking by kernel. the kernel is doing the vibes check. ✅
• -o fsname=NAME — set filesystem name. name it something cute, iykyk.
• -o subtype=NAME — set filesystem type. another name slot, another slay.
• -o large_read — issue large read requests (2.4 only). retro energy, only for the 2.4 girlies. 🌸
• -o max_read=N — set maximum size of read requests. keep it reasonable, bestie.
• -o hard_remove — immediate removal (don't hide files). no hiding, no games. 💅
• -o use_ino — let filesystem set inode numbers. give it the power. ⭐
• -o readdir_ino — try to fill in d_ino in readdir. it's trying its best, okay? 🥺
• -o direct_io — use direct I/O. no detours, straight to the point. 🚀
• -o kernel_cache — cache files in kernel. the kernel is holding onto those files like memories. 🧠
• -o [no]auto_cache — enable caching based on modification times. time-based, as it should be. ⏰
• -o umask=M — set file permissions (octal). the classic permission flex, in octal. 🔢
• -o uid=N — set file owner. who runs the world? you decide. 👑
• -o gid=N — set file group. squad assignment, but make it numeric. 🫶
• -o entry_timeout=T — cache timeout for names (1.0s). the default is literally 1.0s. ✨
• -o negative_timeout=T — cache timeout for deleted names (0.0s). default 0.0s, gone girl. 💀
• -o attr_timeout=T — cache timeout for attributes (1.0s). 1.0s default, iconic. 🎀
• -o ac_attr_timeout=T — auto cache timeout for attributes (attr_timeout). it takes after attr_timeout, cute. 🦋
• -o intr — allow requests to be interrupted. consent, but for requests. 🙌
• -o intr_signal=NUM — signal to send on interrupt (10). default is 10, no cap. 🔔
• -o modules=M1[:M2...] — names of modules to push onto filesystem stack. stack 'em like a boss. 🧱
• -o max_write=N — set maximum size of write requests. writes, but within limits. ✍️
• -o max_readahead=N — set maximum readahead. looking ahead, but with boundaries. 👀
• -o async_read — perform reads asynchronously (default). the default, so it's the main character. 🔥
• -o sync_read — perform reads synchronously. waiting its turn, respectfully. 🕰️

---

👑 AUTHORS 👑

SIMPLE-MTPFS has been written by Peter Hatina <phatina@gmail.com>. a legend, fr fr. 🫶

---

okay and before you go, bestie, this whole manual is for SIMPLE-MTPFS version 0.2, dated January 2015 — so that's the source/version and the date in the footer. it's giving vintage but still relevant. periodt. 💖🎀✨