.\" This man page was generated from MANPAGE-XRAY.md. View it using 'man ./gocryptfs-xray.1'
.\"
.\" Automatically generated by Pandoc 3.1.12.1
.\"
.TH "GOCRYPTFS\-XRAY" "1" "Jan 2018" "" ""
.SH NAME
gocryptfs\-xray \- examine gocryptfs\-related data
.SH SYNOPSIS
.SS Examine encrypted file/directory
gocryptfs\-xray CIPHERDIR/ENCRYPTED\-FILE\-OR\-DIR
.SS Decrypt and show master key
gocryptfs\-xray \-dumpmasterkey CIPHERDIR/gocryptfs.conf
.SS Encrypt paths
gocryptfs\-xray \-encrypt\-paths SOCKET
.SH DESCRIPTION
Available options are listed below.
.SS \-0
Use \[rs]0 instead of \[rs]n as separator for \-decrypt\-paths and
\-encrypt\-paths.
.SS \-aessiv
Assume AES\-SIV mode instead of AES\-GCM when examining an encrypted
file.
Is not needed and has no effect in \f[CR]\-dumpmasterkey\f[R] mode.
.SS \-decrypt\-paths
Decrypt file paths using gocryptfs control socket.
Reads from stdin.
See \f[CR]\-ctlsock\f[R] in gocryptfs(1).
.SS \-dumpmasterkey
Decrypts and shows the master key.
.SS \-encrypt\-paths
Encrypt file paths using gocryptfs control socket.
Reads from stdin.
See \f[CR]\-ctlsock\f[R] in gocryptfs(1).
.SH EXAMPLES
Examine an encrypted file:
.IP
.EX
gocryptfs\-xray myfs/mCXnISiv7nEmyc0glGuhTQ
.EE
.PP
Print the master key:
.IP
.EX
gocryptfs\-xray \-dumpmasterkey myfs/gocryptfs.conf
.EE
.PP
Mount gocryptfs with control socket and use gocryptfs\-xray to encrypt
some paths:
.IP
.EX
gocryptfs \-ctlsock myfs.sock myfs myfs.mnt
echo \-e \[dq]foo\[rs]nbar\[dq] | gocryptfs\-xray \-encrypt\-paths myfs.sock
.EE
.SH SEE ALSO
gocryptfs(1) fuse(8)
.SH AUTHORS
github.com/rfjakob.