1pumount(1) General Commands Manual pumount(1)
2
3
4
6 pumount - umount arbitrary hotpluggable devices as normal user
7
8
10 pumount [ options ] device
11
12
14 pumount is a wrapper around the standard umount program which permits
15 normal users to umount removable devices without a matching /etc/fstab
16 entry.
17
18 pumount also supports encrypted devices which use dm-crypt and have
19 LUKS metadata. If a LUKS-capable cryptsetup is installed, pumount will
20 umount the mapped device instead and call cryptsetup to close the
21 decrypted device afterwards.
22
23 pumount expects the device as its only argument. This will umount
24 device from a directory below /media if policy is met (see below).
25
26 Please note that, as with pmount, you can use labels and uuids as
27 described in fstab (5) for devices present in /etc/fstab. In this
28 case, the device name need to match exactly the corresponding entry in
29 /etc/fstab, including the LABEL= or UUID= part.
30
31
32
34 -l, --lazy
35 Lazy unmount. Detach the filesystem from the filesystem hierar‐
36 chy now, and cleanup all references to the filesystem as soon as
37 it is not busy anymore. (Requires kernel 2.4.11 or later.)
38 IMPORTANT NOTES This option should not be used unless you really
39 know what you are doing, as chances are high that it will result
40 in data loss on the removable drive. Please run pumount manually
41 and wait until it finishes. In addition, pumount will not
42 luksClose a device which was unmounted lazily.
43
44
45 --luks-force
46 Normally, pumount will not luksClose (see cryptsetup(1)) a
47 device pmount did not open. However, you can bypass this
48 restriction with this flag. You probably will need it if you did
49 mess around with the /var/lock/pmount_luks directory.
50
51
52 -h, --help
53 Print a help message and exit successfully.
54
55
56 -d, --debug
57 Enable verbose debug messages.
58
59
60 --version
61 Print the current version number and exit successfully.
62
63
65 The umount will succeed if all of the following conditions are met:
66
67
68 · device is a block device in /dev/ (it does not need to exist if -l is
69 supplied)
70
71 · device is not in /etc/fstab (if it is, pmount executes umount
72 device as the calling user to handle this transparently)
73
74 · device is mounted according to /etc/mtab and /proc/mounts with the
75 calling user's uid
76
77 · mount point is in /media
78
79
81 pumount now supports unmounting devices that have gone missing for some
82 reason, such as a brutal removal of the device, or a kernel/hardware
83 problem. Just specify the mount point as argument for pumount.
84
85
87 pmount(1), cryptsetup(1), umount(8)
88
89
91 pmount is developed by Martin Pitt <martin.pitt@canonical.com>.
92
93
94
95Martin Pitt August 27, 2004 pumount(1)