.TH   "" "" ""
.SH NAME
 \- 
.\" Man page generated from reStructeredText.
.
.SH SYNOPSIS
.sp
A stand\-alone Puppet filebucket client.
.SH USAGE
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.TP
.B puppet filebucket [\-h|\-\-help] [\-V|\-\-version] [\-d|\-\-debug] [\-v|\-\-verbose]
.
[\-l|\-\-local] [\-r|\-\-remote]
[\-s|\-\-server <server>] [\-b|\-\-bucket <directory>] <file> <file> ...
.UNINDENT
.UNINDENT
.UNINDENT
.SH DESCRIPTION
.sp
This is a stand\-alone filebucket client for sending files to a local or
central filebucket.
.SH USAGE
.sp
This client can operate in three modes, with only one mode per call:
.INDENT 0.0
.TP
.B backup:  Send one or more files to the specified file bucket. Each sent
.
file is printed with its resulting md5 sum.
.TP
.B get:     Return the text associated with an md5 sum. The text is printed
.
to stdout, and only one file can be retrieved at a time.
.TP
.B restore: Given a file path and an md5 sum, store the content associated
.
with the sum into the specified file path. You can specify an
entirely new path to this argument; you are not restricted to
restoring the content to its original location.
.UNINDENT
.sp
Note that +filebucket+ defaults to using a network\-based filebucket
available on the server named +puppet+. To use this, you\(aqll have to be
running as a user with valid Puppet certificates. Alternatively, you can
use your local file bucket by specifying +\-\-local+.
.SH EXAMPLE
.INDENT 0.0
.INDENT 3.5
.sp
$ puppet filebucket backup /etc/passwd
/etc/passwd: 429b225650b912a2ee067b0a4cf1e949
$ puppet filebucket restore /tmp/passwd 429b225650b912a2ee067b0a4cf1e949
$
.UNINDENT
.UNINDENT
.SH OPTIONS
.sp
Note that any configuration parameter that\(aqs valid in the configuration
file is also a valid long argument. For example, \(aqssldir\(aq is a valid
configuration parameter, so you can specify \(aq\-\-ssldir <directory>\(aq as an
argument.
.sp
See the configuration file documentation at
\fI\%http://docs.puppetlabs.com/references/stable/configuration.html\fP for the
full list of acceptable parameters. A commented list of all
configuration options can also be generated by running puppet with
\(aq\-\-genconfig\(aq.
.sp
debug:   Enable full debugging.
.sp
help:    Print this help message
.INDENT 0.0
.TP
.B local:   Use the local filebucket. This will use the default
.
configuration information.
.TP
.B remote:  Use a remote filebucket. This will use the default
.
configuration information.
.UNINDENT
.sp
server:  The server to send the file to, instead of locally.
.sp
verbose: Print extra information.
.sp
version: Print version information.
.SH EXAMPLE
.INDENT 0.0
.INDENT 3.5
.sp
puppet filebucket \-b /tmp/filebucket /my/file
.UNINDENT
.UNINDENT
.SH AUTHOR
.sp
Luke Kanies
.SH COPYRIGHT
.sp
Copyright (c) 2005 Reductive Labs, LLC Licensed under the GNU Public
License
.\" Generated by docutils manpage writer.
.\" 
.