1pumount(1)                  General Commands Manual                 pumount(1)
2
3
4

NAME

6       pumount - umount arbitrary hotpluggable devices as normal user
7
8

SYNOPSIS

10       pumount [ options ] device
11
12

DESCRIPTION

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

OPTIONS

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

POLICY

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

PUMOUNT AND MISSING DEVICES

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

SEE ALSO

87       pmount(1), cryptsetup(1), umount(8)
88
89

AUTHOR

91       pmount is developed by Martin Pitt <martin.pitt@canonical.com>.
92
93
94
95Martin Pitt                     August 27, 2004                     pumount(1)
Impressum