GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  BRACKUP::ROOT (3)

.ds Aq ’

NAME

Brackup::Root - describes the source directory (and options) for a backup

CONTENTS

EXAMPLE

In your ~/.brackup.conf file:



  [SOURCE:bradhome]
  path = /home/bradfitz/
  gpg_recipient = 5E1B3EC5
  chunk_size = 64MB
  ignore = ^\.thumbnails/
  ignore = ^\.kde/share/thumbnails/
  ignore = ^\.ee/(minis|icons|previews)/
  ignore = ^build/
  noatime = 1



CONFIG OPTIONS

<B>pathB> The directory to backup (recursively)
<B>gpg_recipientB> The public key signature to encrypt data with. See Using encryption in Brackup::Manual::Overview.
<B>chunk_sizeB> In units of bytes, kB, MB, etc. The max size of a chunk to be stored on the target. Files over this size are cut up into chunks of this size or smaller. The default is 64 MB if not specified.
<B>ignoreB> Perl5 regular expression of files not to backup. You may have multiple ignore lines.
<B>noatimeB> If true, don’t backup access times. They’re kinda useless anyway, and just make the *.brackup metafiles larger.
<B>merge_files_underB> In units of bytes, kB, MB, etc. If files are under this size. By default this feature is off (value 0), purely because it’s new, but 1 kB is a recommended size, and will probably be the default in the future. Set it to 0 to explicitly disable.
<B>max_composite_chunk_sizeB> In units of bytes, kB, MB, etc. The maximum size of a composite chunk, holding lots of little files. If this is too big, you’ll waste more space with future iterative backups updating files locked into this chunk with unchanged chunks.

Recommended, and default value, is 1 MB.

<B>smart_mp3_chunkingB> Boolean parameter. Set to one of {on,yes,true,1} to make mp3 files chunked along their metadata boundaries. If a file has both ID3v1 and ID3v2 chunks, the file will be cut into three parts: two little ones for the ID3 tags, and one big one for the music bytes.
<B>inheritB> The name of another Brackup::Root section to inherit from i.e. to use for any parameters that are not already defined in the current section. The example above could also be written:



  [SOURCE:defaults]
  chunk_size = 64MB
  noatime = 0

  [SOURCE:bradhome]
  inherit = defaults
  path = /home/bradfitz/
  gpg_recipient = 5E1B3EC5
  ignore = ^\.thumbnails/
  ignore = ^\.kde/share/thumbnails/
  ignore = ^\.ee/(minis|icons|previews)/
  ignore = ^build/
  noatime = 1



Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 BRACKUP::ROOT (3) 2010-11-01

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.