NAME

       pumount - umount arbitrary hotpluggable devices as normal user

SYNOPSIS

       pumount [ options ] device

DESCRIPTION

       pumount  is  a  wrapper around the standard umount program which permits normal users to umount removable
       devices without a matching /etc/fstab entry.

       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.

       pumount expects the device as its only argument. This will umount device from a directory below /media if
       policy is met (see below).

       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 need to match exactly the  corresponding  entry  in
       /etc/fstab, including the LABEL= or UUID= part.

       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).

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.

       --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.

       -h, --help
              Print a help message and exit successfully.

       -d, --debug
              Enable verbose debug messages.

       --version
              Print the current version number and exit successfully.

POLICY

       The umount will succeed if all of the following conditions are met:

       • 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

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.

SEE ALSO

       pmount(1), cryptsetup(1), umount(8)

AUTHOR

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