~mrooney/ecryptfs/nautilus-integration

« back to all changes in this revision

Viewing changes to doc/manpage/ecryptfs-rewrite-file.1

  • Committer: Dustin Kirkland
  • Date: 2009-01-26 18:08:13 UTC
  • Revision ID: git-v1:1abdd21606f764382f2abc8a73abda091ace76fd
clear relevant keys on helper unmount

If the user calls the ecryptfs-umount-private helper, clear the kernel
keyring of the keys used by that private helper.

This should help assuage bug:
https://bugs.launchpad.net/ecryptfs/+bug/313812

Signed-off-by: Dustin Kirkland <kirkland@canonical.com>

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
.TH ecryptfs-rewrite-file 1 2009-03-20 ecryptfs-utils "eCryptfs"
2
 
.SH NAME
3
 
ecryptfs-rewrite-file \- force a file to be rewritten (reencrypted) in the lower filesystem
4
 
 
5
 
.SH SYNOPSIS
6
 
\fBecryptfs-rewrite-file [file1] [file2] [file3] ...\fP
7
 
 
8
 
.SH DESCRIPTION
9
 
This script takes one or more files/directories/symlinks as arguments, moves each of them to a temporary file, and the moves them back to the original name.  This causes the file to be rewritten (and reencrypted) in the lower filesystem.
10
 
 
11
 
This script may be combined with \fBfind\fP(1) and \fBxargs\fP(1) to rewrite an entire eCryptfs mountpoint, unmount, and sync:
12
 
 
13
 
  find . -xdev -print0 | xargs -r -0 /usr/bin/ecryptfs-rewrite-file
14
 
  ecryptfs-umount-private
15
 
  sync
16
 
 
17
 
It is advised that this script is executed in runlevel 1 or 3, to avoid simultanteous writes and race conditions with targeted files.
18
 
 
19
 
\fBUSING THIS SCRIPT WHILE GNOME, KDE, OR OTHER APPLICATIONS ARE RUNNING MAY CAUSE DATA LOSS.\fP
20
 
 
21
 
.SH SEE ALSO
22
 
.PD 0
23
 
.TP
24
 
\fBfind\fP(1), \fBxargs\fP(1), \fBecryptfs-umount-private\fP(1), \fBsync\fP(1)
25
 
 
26
 
.TP
27
 
\fIhttp://launchpad.net/ecryptfs/\fP
28
 
.PD
29
 
 
30
 
.SH AUTHOR
31
 
This manpage was written by Dustin Kirkland <kirkland@canonical.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.
32
 
 
33
 
On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL.