.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.35
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sh \" Subsection heading
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  | will give a
.\" real vertical bar.  \*(C+ will give a nicer C++.  Capital omega is used to
.\" do unbreakable dashes and therefore won't be available.  \*(C` and \*(C'
.\" expand to `' in nroff, nothing in troff, for use with C<>.
.tr \(*W-|\(bv\*(Tr
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
'br\}
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.if \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.\"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.hy 0
.if n .na
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "ENCFSCTL 1"
.TH ENCFSCTL 1 "2009-11-29" "1.7.3" "Encrypted Filesystem"
.SH "NAME"
encfsctl \- administrative tool for working with EncFS filesystems
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
\&\fBencfsctl\fR [\fIcommand\fR \fIcommand_args\fR]
.PP
\&\fBencfsctl\fR \fIrootdir\fR
.PP
\&\fBencfsctl\fR info \fIrootdir\fR
.PP
\&\fBencfsctl\fR passwd \fIrootdir\fR
.PP
\&\fBencfsctl\fR showcruft \fIrootdir\fR
.PP
\&\fBencfsctl\fR decode [\-\-extpass=prog] \fIrootdir\fR [encoded name ...]
.PP
\&\fBencfsctl\fR encode [\-\-extpass=prog] \fIrootdir\fR [plaintext name ...]
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\fBencfsctl\fR is an administrative tool for working with EncFS filesystems.  It
is capable of changing the user supplied password, displaying basic information
about an encrypted volume, and other related operations.
.SH "COMMANDS"
.IX Header "COMMANDS"
.IP "\fBinfo\fR" 4
.IX Item "info"
Display basic information about the filesystem.  Takes a single argument,
\&\fIrootdir\fR, which is the root directory of the encrypted filesystem.  The
filesystem need not be mounted.  \fBInfo\fR is also the default command if only a
root directory is provided on the command line.
.IP "\fBpasswd\fR" 4
.IX Item "passwd"
Allows changing the password of the encrypted filesystem.  The user will be
prompted for the existing password and the new password.
.IP "\fBshowcruft\fR" 4
.IX Item "showcruft"
Recursively search through the entire volume and display all files which are
not decodable (only checks filename encoding, not block \s-1MAC\s0 headers).  This
might be useful for cleanup in case you've made use of features which create
files which are not decodable under the primary key.
.IP "\fBdecode\fR" 4
.IX Item "decode"
Allows you to specify an encoded name on the command line, and displays
decoded version.  This is mostly useful for debugging, as debug messages always
display encrypted filenames (to avoid leaking sensitive data through the debug
channels).  So this command provides a way to decode the filenames.
.Sp
The \fB\-\-extpass\fR option can be used to specify the program which returns the
password \- just like with encfs.
.Sp
If no names are specified on the command line, then a list of filenames will be
read from stdin and decoded.
.IP "\fBencode\fR" 4
.IX Item "encode"
Allows you to specify a filename on the command line, and displays its
encoded version. This is useful if e.g. you are taking a backup of an
encrypted directory and would like to exclude some files.
.Sp
The \fB\-\-extpass\fR option can be used to specify the program which returns the
password \- just like with encfs.
.Sp
If no names are specified on the command line, then a list of filenames
will be read from stdin and encoded.
.SH "EXAMPLES"
.IX Header "EXAMPLES"
Show information about an encrypted filesystem:
.PP
.Vb 1
\& % encfsctl info ~/.crypt
.Ve
.PP
.Vb 7
\& Version 5 configuration; created by EncFS 1.1 (revision 20040504)
\& Filesystem cipher: "ssl/aes" , version 2:1:1
\& Filename encoding: "nameio/block" , version 3:0:1
\& Key Size: 192 bits
\& Block Size: 512 bytes
\& Each file contains 8 byte header with unique IV data.
\& Filesname encoded using IV chaining mode.
.Ve
.SH "DISCLAIMER"
.IX Header "DISCLAIMER"
This library is distributed in the hope that it will be useful, but \s-1WITHOUT\s0 \s-1ANY\s0
\&\s-1WARRANTY\s0; without even the implied warranty of \s-1MERCHANTABILITY\s0 or \s-1FITNESS\s0 \s-1FOR\s0 A
\&\s-1PARTICULAR\s0 \s-1PURPOSE\s0.  Please refer to the \*(L"\s-1COPYING\s0\*(R" file distributed with
\&\fBencfs\fR for complete details.
.SH "AUTHORS"
.IX Header "AUTHORS"
EncFS was written by Valient Gough <vgough@pobox.com>.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fIencfs\fR\|(1)