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
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
|
<?xml version="1.0" encoding="UTF-8"?>
<refentry version="5.0" xmlns="http://docbook.org/ns/docbook"
xmlns:xlink="http://www.w3.org/1999/xlink"
xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:svg="http://www.w3.org/2000/svg"
xmlns:m="http://www.w3.org/1998/Math/MathML"
xmlns:html="http://www.w3.org/1999/xhtml"
xmlns:db="http://docbook.org/ns/docbook">
<refmeta>
<refentrytitle>bbackupd</refentrytitle>
<manvolnum>8</manvolnum>
<refmiscinfo class="manual">Box Backup</refmiscinfo>
<refmiscinfo class="source">Box Backup</refmiscinfo>
<refmiscinfo class="version">0.11</refmiscinfo>
</refmeta>
<refnamediv>
<refname>bbackupd</refname>
<refpurpose>Box Backup client daemon</refpurpose>
</refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
<command>bbackupd</command>
<arg>-DFkqvVT</arg>
<arg>-c config-file</arg>
<arg>-t tag</arg>
</cmdsynopsis>
</refsynopsisdiv>
<refsection>
<title>Description</title>
<para><command>bbackupd</command> runs on client computers in the
background, finding new files to back up. When it is time for a backup,
<command>bbackupd</command> will connect to the server
(<command>bbstored</command>) to upload the files.</para>
<para>A running <command>bbackupd</command> daemon can be controlled with
the <command>bbackupctl</command> command, to make it shut down, reload
its configuration, or start an immediate backup.</para>
<para><command>bbackupd</command> needs to be configured to tell it which
files to back up, how often, and to which server (running
<command>bbstored</command>). See the Client Configuration page for more
information. For this, you must write a configuration file. You must
either place it in the default location, or tell
<command>bbackupd</command> where to find it.</para>
<para>You can check the default location with the <option>-h</option>
option. The default on Unix systems is usually
<filename>/etc/box/bbackupd.conf</filename>. On Windows systems, it is
<filename>bbackupd.conf</filename> in the same directory where
<command>bbackupd.exe</command> is located. If bbackupd cannot find or
read the configuration file, it will log an error message and exit.</para>
<para><command>bbackupd</command> usually writes log messages to the
system logs, using the facility <function>local5</function>, which you can
use to filter them to send them to a separate file. It can also write them
to the console, see options below. If <command>bbackupd</command> is not
doing what you expect, please check the logs first of all.</para>
<refsection>
<title>Options</title>
<variablelist>
<varlistentry>
<term><option>-c</option> config-file</term>
<listitem>
<para>Use the specified configuration file. If <option>-c</option>
is omitted, the last argument is the configuration file. If none
is specified, the default is used (see above).</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-D</option></term>
<listitem>
<para>Debugging mode. Do not fork into the background (do not run
as a daemon). Not available on Windows.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-F</option></term>
<listitem>
<para>No-fork mode. Same as <option>-D</option> for bbackupd. Not
available on Windows.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-k</option></term>
<listitem>
<para>Keep console open after fork, keep writing log messages to
it. Not available on Windows.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-q</option></term>
<listitem>
<para>Run more quietly. Reduce verbosity level by one. Available
levels are <varname>NOTHING</varname>, <varname>FATAL</varname>,
<varname>ERROR</varname>, <varname>WARNING</varname>,
<varname>NOTICE</varname>, <varname>INFO</varname>,
<varname>TRACE</varname>, <varname>EVERYTHING</varname>. Default
level is <varname>NOTICE</varname> in non-debugging builds. Use
once to drop to <varname>WARNING</varname> level, twice for
<varname>ERROR</varname> level, four times for no logging at
all.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>-v</term>
<listitem>
<para>Run more verbosely. Increase verbosity level by one. Use
once to raise to <varname>INFO</varname> level, twice for
<varname>TRACE</varname> level, three times for
<varname>EVERYTHING</varname> (currently the same as
<varname>TRACE</varname>).</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-V</option></term>
<listitem>
<para>Run at maximum verbosity (<varname>EVERYTHING</varname>
level).</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-t</option> tag</term>
<listitem>
<para>Tag each console message with specified marker. Mainly
useful in testing when running multiple daemons on the same
console.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-T</option></term>
<listitem>
<para>Timestamp each line of console output.</para>
</listitem>
</varlistentry>
</variablelist>
</refsection>
</refsection>
<refsection>
<title>Files</title>
<para><filename>/etc/box/bbackupd.conf</filename></para>
</refsection>
<refsection>
<title>See Also</title>
<para><citerefentry>
<refentrytitle>bbackupd.conf</refentrytitle>
<manvolnum>5</manvolnum>
</citerefentry>, <citerefentry>
<refentrytitle>bbackupd-config</refentrytitle>
<manvolnum>8</manvolnum>
</citerefentry>, <citerefentry>
<refentrytitle>bbackupctl</refentrytitle>
<manvolnum>8</manvolnum>
</citerefentry></para>
</refsection>
<refsection>
<title>Authors</title>
<para><author>
<personname>Ben Summers</personname>
</author></para>
<para><author>
<personname>Per Thomsen</personname>
</author></para>
<para><author>
<personname>James O'Gorman</personname>
</author></para>
</refsection>
</refentry>
|
