Tools to make secret sharing easier.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

157 lines
3.9 KiB

.TH GFSEC-SPLIT 08/30/2015 "gfsecret @PACKAGE_VERSION@"
gfsec-split \- Split a file into shares and dispatch them
.SY gfsec-split
.RB [ \-h | --help ]
.RB [ \-v | --version ]
.RB [ \-n | --threshold
.IR N ]
.RB [ \-c | --config
.IR file ]
.RB [ \-i | --interactive ]
.RB [ \-k | --keep ]
.RB [ \-o | --output
.IR file ]
.RB [ \-r | --restore-cmd
.IR command ]
.RB [ \-d | --destroy-cmd
.IR command ]
.RB [ \-l | --list-supports ]
.B file
.B URI...
.B gfsec-split
splits a file into a number of shares and dispatches
the resulting shares onto external storage supports.
The splitted file can then be temporarily reconstructed
using the accompanying program
.BR gfsec-use (1).
.BR -h ", " --help
Display the help message.
.BR -v ", " --version
Display the version message.
.BR -n ", " --threshold " " \fiN\fR
Specify the minimal number of shares required to
re-assemble the splitted file. Default is 2.
.BR -c ", " --config " " \fifile\fR
Write the configuration file (allowing to reconstruct
the secret with
.BR gfsec-use (1)
) to the specified file. Default is the basename of
the splitted file in $XDG_CONFIG_HOME/gfsecret.
If \fiFILE\fR is a single filename without extension and
without a directory part, the file will be placed under
the $XDG_CONFIG_HOME/gfsecret directory with a .conf
.BR -i ", " --interactive
Present the user with an interactive menu to specify the
shares to create.
.BR -k ", " --keep
By default,
.B gfsec-split
will delete the original file once it has been
successfully splitted. Use this option to prevent
the file to be deleted.
.BR -o ", " --output " " \fIfile\fR
Specify the location where gfsec-use will write the
reconstructed secret. The default is to use the
original location. If set to an empty string, no
location will be written in the configuration file.
.BR -r ", " --restore-cmd " " \fIcommand\fR
Specify the command that gfsec-use will call to
restore the secret.
.BR -d ", " --destroy-cmd " " \fIcommand\fR
Specify the command that gfsec-use will call to
destroy the secret when it is no longer needed.
The same command will also be called by gfsec-split
to destroy the secret once it has been splitted,
unless the -k option has been used.
.BR -l ", " --list-supports
List all the currently available supports which can
be used to store shares, then quit.
Shares are described using a URI-like syntax. For each share,
the URI indicates a storage device and a pathname on that device.
Supported URI schemes are:
Indicates a file on the local filesystem.
Indicates a file on the external volume identified
by the specified UUID.
Indicates a file on the external volume identified
by the specified label.
Indicates a file on the MTP device identified by the
specified serial number.
gfsec-split \\
/home/alice/mysecret \\
file:///home/alice/.local/share/gfsecret/mysecret \\
label://USBSTICK/mysecret \\
mtp://RF2GB6X704P/Documents/mysecret \\
The above example will split the file
.I /home/alice/mysecret
into three shares: one on the local filesystem, one on the
USB mass storage device with the label \fIUSBSTICK\fR, and
one on the MTP-compliant device with the serial \fIRF2GB6X704P\fR.
A configuration file will be written in
.I $XDG_CONFIG_HOME/gfsecret/mysecret
allowing to automatically reconstruct the file with
.BR gfsec-use (1)
provided at least one of the two removable supports are
Report bugs to
Damien Goutte-Gattat
.ME .
.BR gfsec-use (1),
.BR gfsplit (1),
.BR gfcombine (1),
.BR libgfshare (3),
.BR gfshare (7)
.ad l
Copyright \(co 2017 Damien Goutte-Gattat
This program is released under the GNU General Public License.
See the COPYING file in the source distribution or
.UE .