blob: dc2d60e63bb38a66dc3e1bec3faf0dde14f3f6f7 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
|
.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.
.\"
.
|
