pumount(1)

💖 pumount(1) — the girlies' guide to yeeting removable drives 💖

okay bestie, welcome to pumount, a general commands manual page and honestly? she's iconic. she lets you, a normal user, unmount hotpluggable devices. yes, you. no root arc required. periodt. 👑

---

✨ NAME ✨

pumount — umount arbitrary hotpluggable devices as normal user

---

🌸 SYNOPSIS 🌸

pumount [ options ] device

like that's it. one device. she's low maintenance fr.

---

🦋 DESCRIPTION 🦋

so pumount is a wrapper around the standard umount program, and the way it serves is: it lets normal users umount removable devices without a matching /etc/fstab entry. no fstab, no problem, we move. 💅

pumount also supports encrypted devices which use dm-crypt and have LUKS metadata. If a LUKS-capable cryptsetup is installed, pumount will umount the mapped device instead and call cryptsetup to close the decrypted device afterwards. it's giving teamwork, it's giving delegation. ✨

pumount expects the device as its only argument. This will umount device from a directory below /media if policy is met (see below, bestie, the policy section is right there, don't skip it 🫶).

Please note that, as with pmount, you can use labels and uuids as described in fstab(5) for devices present in /etc/fstab. In this case, the device name needs to match exactly the corresponding entry in /etc/fstab, including the LABEL= or UUID= part. exact match only, no vibes-based guessing, she will not be lenient. 😤

Important note for Debian: The permission to execute pumount is restricted to members of the system group plugdev. Please add all desktop users who shall be able to use pmount to this group by executing

adduser user plugdev

(as root). yes you actually have to do this. no you can't skip it. 💀

---

✨ OPTIONS ✨

• -l, --lazy — Lazy unmount. Detach the filesystem from the filesystem hierarchy now, and cleanup all references to the filesystem as soon as it is not busy anymore. (Requires kernel 2.4.11 or later.)

IMPORTANT NOTES — This option should not be used unless you really know what you are doing, as chances are high that it will result in data loss on the removable drive. Please run pumount manually and wait until it finishes. In addition, pumount will not luksClose a device which was unmounted lazily. like bestie I am BEGGING you to be careful with this one 😭

• --luks-force — Normally, pumount will not luksClose (see cryptsetup(1)) a device pmount did not open. However, you can bypass this restriction with this flag. You probably will need it if you did mess around with the /var/lock/pmount_luks directory. (not me telling on myself for poking around in /var/lock/pmount_luks 🙈)
• -h, --help — Print a help message and exit successfully. she's helpful and she leaves gracefully. queen behavior. 👑
• -d, --debug — Enable verbose debug messages. for when you wanna see everything that's happening, main character energy but for logs. 🔥
• --version — Print the current version number and exit successfully. also leaves gracefully. consistency. ✨

---

🌈 POLICY 🌈

The umount will succeed if all of the following conditions are met — like, all of them, it's not a pick-one situation:

• device is a block device in /dev/ (it does not need to exist if -l is supplied)
• device is not in /etc/fstab (if it is, pmount executes umount device as the calling user to handle this transparently)
• device is mounted according to /etc/mtab and /proc/mounts with the calling user's uid
• mount point is in /media

vibe check passed = unmount unlocked. fail the vibe check = no unmount for you. 🎀

---

🧚 PUMOUNT AND MISSING DEVICES 🧚

pumount now supports unmounting devices that have gone missing for some reason, such as a brutal removal of the device, or a kernel/hardware problem. Just specify the mount point as argument for pumount.

yep. device ghosted you? you can still unmount the ghost. she's emotionally mature like that. 💜

---

⭐ SEE ALSO ⭐

• pmount(1)
• cryptsetup(1)
• umount(8)

the friend group. go read them. iykyk. 💖

---

👑 AUTHOR 👑

pmount is developed by Martin Pitt <martin.pitt@canonical.com>.

---

okay that's the whole page bestie, go forth and unmount responsibly 🫶✨

this was Martin Pitt's pumount(1) page, dated August 27, 2004 — yes, 2004, she's a vintage icon and she still slays 💅🌸