udevil(1)

💾 udevil — the manual, but make it cute

okay so bestie, welcome to udevil(1), from the General Commands Manual section 💖 this is your little backstage pass to the whole thing, no gatekeeping, we're going through every single flag together. grab a snack 🍓

---

✨ NAME ✨

udevil — the alternative storage media interface 👑 (yes that's the whole name, she's iconic like that)

---

🦋 SYNOPSIS 🦋

udevil [OPTIONS] COMMAND [COMMAND-OPTIONS] [COMMAND-ARGUMENTS]

that's it, that's the shape of every single call you're ever gonna make 💅

---

🌸 DESCRIPTION 🌸

so udevil is the alternative storage media interface, and lowkey she does SO much:

• she mounts and unmounts removable devices and network shares, and the way she does it is without requiring a password (she's set suid, that's the whole trick 🫶)
• she shows you device information like it's a lil gossip session
• she monitors device changes so you always know what's plugging in and out 👀
• and she comes with the devmon automounting script bundled in, like a free gift with purchase 🎀

no cap, it's giving "your friend who actually knows what's going on with the drives." ✨

---

🌈 EXAMPLES 🌈

okay here's where it gets fun, strap in, there's a LOT and they're all gems 💎

udevil mount /dev/sdd1
udevil mount -o ro,noatime /dev/sdd1
udevil mount -o ro,noatime /dev/sdd1 /media/custom
udevil mount /tmp/example.iso  # ISO file
udevil mount ftp://sys.domain  # ftp site - requires curlftpfs or ftpfs
udevil mount ftp://user:pass@sys.domain/share # ftp share with user and password
udevil mount ftp://user:pass@sys.domain:21/share # ftp share with port, user and password
udevil mount -t ftpfs sys.domain  # ftp site with ftpfs
udevil mount -t curlftpfs sys.domain # ftp site with curl
udevil mount -t curlftpfs user:pass@sys.domain # ftp site with curl u/p
udevil mount nfs://sys.domain:/share # nfs share
udevil mount sys.domain:/share # nfs share
udevil mount smb://sys.domain/share  # samba share w/ cifs
udevil mount smb://user:pass@10.0.0.1:50/share # samba share w/ u/p/port
udevil mount smb://WORKGROUP/user@sys.domain  # samba share w/ workgroup
udevil mount //sys.domain/share # samba share w/ cifs
udevil mount //sys.domain/share -t smbfs # samba share w/ smbfs
udevil mount ssh://user@sys.domain # sshfs with user - requires sshfs
udevil mount -t sshfs user@sys.domain # sshfs with user
udevil mount http://sys.domain/dav/  # WebDAV - requires davfs2
udevil mount tmpfs # make a ram drive
WARNING !!! a password on the command line is UNSAFE - see filesystem docs

⚠️ okay bestie I need you to READ that last line again. putting a password straight on the command line is UNSAFE, fr fr, go look at the filesystem docs, I'm not playing 😭

and then the unmount era 💅

udevil umount /dev/sdd1
udevil umount /media/disk
udevil umount -l /media/disk
udevil umount /tmp/example.iso

informationnnn 🦋

udevil info /dev/sdd1

watch the vibes 👀

udevil monitor

and the lil cleanup moment 🧹

udevil clean

---

🎀 OPTIONS 🎀

just two lil guys here, both absolute sweethearts:

• --verbose — print details, she's a talker, she tells you everything 🗣️
• --quiet — minimal output, she's giving mysterious, silent, unbothered 💅

---

🧭 USAGE 🧭

here's the actual menu of what you can ask her to do 👑

🧲 MOUNT — Mounts DEVICE to mount point DIR with MOUNT-OPTIONS

udevil mount|--mount [MOUNT-OPTIONS] [[-b|--block-device] DEVICE] [DIR]

MOUNT-OPTIONS:

• -|--types|--filesystem-type|--mount-fstype TYPE — set the filesystem type (see man mount) 🗂️
• -o|--options|--mount-options OPT,... — pass mount options (see man mount) ✨
• --no-user-interaction — ignored (for compatibility) 🫥

🔓 umount — unmount era

udevil umount|unmount|--unmount|--umount [UNMOUNT-OPTIONS]
   {[-b|--block-device] DEVICE}|DIR

UNMOUNT-OPTIONS:

• -l — lazy unmount (see man umount) 😴
• -f — force unmount (see man umount) 💪
• --no-user-interaction — ignored (for compatibility) 🫥

🔍 INFO — Show information about DEVICE emulating udisks v1 output

udevil info|--show-info|--info [-b|--block-device] DEVICE

she spills the tea, and it's formatted to emulate udisks v1 output 💬

👀 MONITOR — Display device events emulating udisks v1 output

udevil monitor|--monitor

live updates, like a stream but for your drives 📡

🧹 CLEAN — Remove unmounted udevil-created mount dirs in media dirs

udevil clean

sweeping up the lil leftover dirs she made, so tidy 🧼

🆘 HELP — Show this help

udevil help|--help|-h

when you forget literally everything, she's got you 🫶

---

💜 AUTHOR 💜

this manual page was written by Mateusz Łukasik <mati75@linuxmint.pl>, for the Debian GNU/Linux system (but may be used by others). absolute legend, we stan 💖

---

and that's the whole page bestie!! this was udevil(1) from March 2013, and that lil udevil(1) in the corner at the bottom? that's her signature, she signs her work 💅✨ bye ily, go mount something responsibly 🎀🌈