debian man page for puppet-filebucket

PUPPET-FILEBUCKET(8)						   Puppet manual					      PUPPET-FILEBUCKET(8)

NAME
       puppet-filebucket - Store and retrieve files in a filebucket

SYNOPSIS
       A stand-alone Puppet filebucket client.

USAGE
       puppet  filebucket mode [-h|--help] [-V|--version] [-d|--debug] [-v|--verbose] [-l|--local] [-r|--remote] [-s|--server server] [-b|--bucket
       directory] file file ...

       Puppet filebucket can operate in three modes, with only one mode per call:

       backup: Send one or more files to the specified file bucket. Each sent file is printed with its resulting md5 sum.

       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.

       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.

DESCRIPTION
       This is a stand-alone filebucket client for sending files to a local or central filebucket.

       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'.

OPTIONS
       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 directory' as an argument.

       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'.

       --debug
	      Enable full debugging.

       --help Print this help message

       --local
	      Use the local filebucket. This will use the default configuration information.

       --remote
	      Use a remote filebucket. This will use the default configuration information.

       --server
	      The server to send the file to, instead of locally.

       --verbose
	      Print extra information.

       --version
	      Print version information.

EXAMPLE
       $ puppet filebucket backup /etc/passwd
       /etc/passwd: 429b225650b912a2ee067b0a4cf1e949
       $ puppet filebucket restore /tmp/passwd 429b225650b912a2ee067b0a4cf1e949

AUTHOR
       Luke Kanies

COPYRIGHT
       Copyright (c) 2011 Puppet Labs, LLC Licensed under the Apache 2.0 License

Puppet Labs, LLC						     June 2012						      PUPPET-FILEBUCKET(8)