diff options
Diffstat (limited to 'man/man8/filebucket.8')
| -rw-r--r-- | man/man8/filebucket.8 | 72 |
1 files changed, 29 insertions, 43 deletions
diff --git a/man/man8/filebucket.8 b/man/man8/filebucket.8 index 3d4d15978..de2dee733 100644 --- a/man/man8/filebucket.8 +++ b/man/man8/filebucket.8 @@ -2,120 +2,106 @@ .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 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\'ll have to be +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 $ filebucket backup /etc/passwd /etc/passwd: 429b225650b912a2ee067b0a4cf1e949 $ filebucket restore /tmp/passwd 429b225650b912a2ee067b0a4cf1e949 $ - .UNINDENT .UNINDENT - .SH 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 +.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://reductivelabs.com/trac/puppet/wiki/ConfigurationReference\fP for the full list of acceptable parameters. A commented list of all configuration options can also be generated by running puppet with -\'\-\-genconfig\'. - +\(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 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 on 2009-12-30 19:24. +.\" Generated by docutils manpage writer. .\" +. |