blob: fdaca9f312a4d8e6ca3eb30b342406a318de23e8 (
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
108
109
110
111
112
113
114
115
116
|
.TH "" "" ""
.SH NAME
\-
.\" Man page generated from reStructeredText.
.SH SYNOPSIS
A stand\-alone Puppet filebucket client.
.SH USAGE
.\" visit_block_quote
.TP
.B filebucket [\-h|\-\-help] [\-V|\-\-version] [\-d|\-\-debug] [\-v|\-\-verbose]
[\-l|\-\-local] [\-r|\-\-remote]
[\-s|\-\-server <server>] [\-b|\-\-bucket <directory>] <file> <file> ...
.\" depart_block_quote
.SH DESCRIPTION
This is a stand\-alone filebucket client for sending files to a local or
central filebucket.
.SH USAGE
This client can operate in three modes, with only one mode per call:
.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.
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+.
.SH EXAMPLE
.\" visit_block_quote
$ filebucket backup /etc/passwd
/etc/passwd: 429b225650b912a2ee067b0a4cf1e949
$ filebucket restore /tmp/passwd 429b225650b912a2ee067b0a4cf1e949
$
.\" depart_block_quote
.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
argument.
See the configuration file documentation at
http://reductivelabs.com/projects/puppet/reference/configref.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
.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.
server: The server to send the file to, instead of locally.
verbose: Print extra information.
version: Print version information.
.SH EXAMPLE
.\" visit_block_quote
filebucket \-b /tmp/filebucket /my/file
.\" depart_block_quote
.SH AUTHOR
Luke Kanies
.SH COPYRIGHT
Copyright (c) 2005 Reductive Labs, LLC Licensed under the GNU Public
License
.\" Generated by docutils manpage writer on 2008-03-22 17:46.
.\"
|