umount.ecryptfs_private - Man Page

eCryptfs private unmount helper.

Synopsis

umount.ecryptfs_private [-f]

NOTE: This program will not clear the relevant keys from the user's keyring.  For this reason, it is recommended that users use ecryptfs-umount-private(1) instead!

Options

Options available for the umount.ecryptfs_private command:

-f

Force the unmount, ignoring the value of the mount counter in /tmp/ecryptfs-USERNAME-Private

Description

umount.ecryptfs_private is a mount helper utility for non-root users to unmount a cryptographically mounted private directory, ~/Private.

If, and only if:
 - the private mount passphrase is in their kernel keyring, and
 - the current user owns both ~/.Private and ~/Private, and
 - ~/.Private is currently mounted on ~/Private
 - the mount counter is 0 (counter is ignored if -f option is used)

This program will:
 - unmount ~/Private

The only setuid operationis in this program are the call to umount and updating /etc/mtab.

The system administrator can add the pam_ecryptfs.so module to the PAM stack and automatically perform the unmount on logout. See pam_ecryptfs(8).

Files

~/.Private - underlying directory containing encrypted data

~/Private - mountpoint containing decrypted data (when mounted)

~/.ecryptfs/Private.sig - file containing signature of mountpoint passphrase

/tmp/ecryptfs-USERNAME-Private - file containing the mount counter, incremented on each mount, decremented on each unmount

See Also

ecryptfs(7), ecryptfs-setup-private(1), keyctl(1), mount(8), mount.ecryptfs_private(1), pam_ecryptfs(8)

/usr/share/doc/ecryptfs-utils/ecryptfs-faq.html

http://ecryptfs.org/

Author

This manpage and the umount.ecryptfs_private utility was written by Dustin Kirkland <kirkland@ubuntu.com> for Ubuntu systems (but may be used by others).  Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2 or any later version published by the Free Software Foundation.

On Debian and Ubuntu systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL.

Referenced By

ecryptfs-setup-private(1), ecryptfs-umount-private(1), mount.ecryptfs_private(1).

2008-07-21 ecryptfs-utils