.\" generated with Ronn/v0.7.3
.\" http://github.com/rtomayko/ronn/tree/0.7.3
.
.TH "FILEBUCKET" "8" "August 2010" "" ""
A stand\-alone Puppet filebucket client\.puppet filebucket [\-h|\-\-help] [\-V|\-\-version] [\-d|\-\-debug] [\-v|\-\-verbose]
.
.IP "" 4
.
.nf

 [\-l|\-\-local] [\-r|\-\-remote]
 [\-s|\-\-server <server>] [\-b|\-\-bucket <directory>] <file> <file> \.\.\.
.
.fi
.
.IP "" 0
This is a stand\-alone filebucket client for sending files to a local or central filebucket\.This client can operate in three modes, with only one mode per call:
.
.P
backup: Send one or more files to the specified file bucket\. Each sent
.
.IP "" 4
.
.nf

     file is printed with its resulting md5 sum\.
.
.fi
.
.IP "" 0
.
.P
get: Return the text associated with an md5 sum\. The text is printed
.
.IP "" 4
.
.nf

     to stdout, and only one file can be retrieved at a time\.
.
.fi
.
.IP "" 0
.
.P
restore: Given a file path and an md5 sum, store the content associated
.
.IP "" 4
.
.nf

     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\.
.
.fi
.
.IP "" 0
.
.P
Note that +filebucket+ defaults to using a network\-based filebucket available on the server named +puppet+\. To use this, you\'ll have to be running as a user with valid Puppet certificates\. Alternatively, you can use your local file bucket by specifying +\-\-local+\.$ puppet filebucket backup /etc/passwd /etc/passwd: 429b225650b912a2ee067b0a4cf1e949 $ puppet filebucket restore /tmp/passwd 429b225650b912a2ee067b0a4cf1e949 $Note that any configuration parameter that\'s valid in the configuration file is also a valid long argument\. For example, \'ssldir\' is a valid configuration parameter, so you can specify \'\-\-ssldir \fIdirectory\fR\' as an argument\.
.
.P
See the configuration file documentation at http://docs\.puppetlabs\.com/references/stable/configuration\.html for the full list of acceptable parameters\. A commented list of all configuration options can also be generated by running puppet with \'\-\-genconfig\'\.
.
.P
debug: Enable full debugging\.
.
.P
help: Print this help message
.
.P
local: Use the local filebucket\. This will use the default
.
.IP "" 4
.
.nf

     configuration information\.
.
.fi
.
.IP "" 0
.
.P
remote: Use a remote filebucket\. This will use the default
.
.IP "" 4
.
.nf

     configuration information\.
.
.fi
.
.IP "" 0
.
.P
server: The server to send the file to, instead of locally\.
.
.P
verbose: Print extra information\.
.
.P
version: Print version information\.puppet filebucket \-b /tmp/filebucket /my/fileLuke KaniesCopyright (c) 2005 Puppet Labs, LLC Licensed under the GNU Public License