1()                                                                          ()
2
3
4

NAME

6        -
7
8
9

SYNOPSIS

11       A stand-alone Puppet filebucket client.
12
13
14

USAGE

16       filebucket [-h|--help] [-V|--version] [-d|--debug] [-v|--verbose]
17              [-l|--local]  [-r|--remote]  [-s|--server <server>] [-b|--bucket
18              <directory>] <file> <file> ...
19
20
21
22

DESCRIPTION

24       This is a stand-alone filebucket client for sending files to a local or
25       central filebucket.
26
27
28

USAGE

30       This client can operate in three modes, with only one mode per call:
31
32
33
34       backup: Send one or more files to the specified file bucket. Each sent
35              file is printed with its resulting md5 sum.
36
37
38
39       get: Return the text associated with an md5 sum. The text is printed
40              to stdout, and only one file can be retrieved at a time.
41
42
43
44       restore: Given a file path and an md5 sum, store the content associated
45              with  the  sum  into the specified file path. You can specify an
46              entirely new path to this argument; you are  not  restricted  to
47              restoring the content to its original location.
48
49              Note  that  +filebucket+ defaults to using a network-based file‐
50              bucket available on the server  named  +puppet+.  To  use  this,
51              you´ll  have  to be running as a user with valid Puppet certifi‐
52              cates. Alternatively, you can use  your  local  file  bucket  by
53              specifying +--local+.
54
55
56

EXAMPLE

58       $        filebucket        backup        /etc/passwd       /etc/passwd:
59       429b225650b912a2ee067b0a4cf1e949  $  filebucket   restore   /tmp/passwd
60       429b225650b912a2ee067b0a4cf1e949 $
61
62
63
64

OPTIONS

66       Note that any configuration parameter that´s valid in the configuration
67       file is also a valid long argument. For example, ´ssldir´  is  a  valid
68       configuration  parameter,  so you can specify ´--ssldir <directory>´ as
69       an argument.
70
71       See  the  configuration   file   documentation   at   http://reductive
72       labs.com/projects/puppet/reference/configref.html  for the full list of
73       acceptable parameters. A commented list of  all  configuration  options
74       can also be generated by running puppet with ´--genconfig´.
75
76       debug:   Enable full debugging.
77
78       help:    Print this help message
79
80
81
82       local: Use the local filebucket. This will use the default
83              configuration information.
84
85
86
87       remote: Use a remote filebucket. This will use the default
88              configuration information.
89
90              server:  The server to send the file to, instead of locally.
91
92              verbose: Print extra information.
93
94              version: Print version information.
95
96
97

EXAMPLE

99       filebucket -b /tmp/filebucket /my/file
100
101
102
103

AUTHOR

105       Luke Kanies
106
107
108
110       Copyright  (c)  2005  Reductive Labs, LLC Licensed under the GNU Public
111       License
112
113
114
115
116
117                                                                            ()
Impressum