gui/man/barrybackup.1

   1 .\"                                      Hey, EMACS: -*- nroff -*-
   2 .\" First parameter, NAME, should be all caps
   3 .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
   4 .\" other parameters are allowed: see man(7), man(1)
   5 .TH BARRYBACKUP 1 "May 29, 2008"
   6 .\" Please adjust this date whenever revising the manpage.
   7 .\"
   8 .\" Some roff macros, for reference:
   9 .\" .nh        disable hyphenation
  10 .\" .hy        enable hyphenation
  11 .\" .ad l      left justify
  12 .\" .ad b      justify to both left and right margins
  13 .\" .nf        disable filling
  14 .\" .fi        enable filling
  15 .\" .br        insert line break
  16 .\" .sp <n>    insert n+1 empty lines
  17 .\" for manpage-specific macros, see man(7)
  18 .SH NAME
  19 .B barrybackup
  20 \- Barry Project's backup program for the BlackBerry handheld
  21 .SH SYNOPSIS
  22 .B barrybackup
  23 [-?][-d]
  24 .SH DESCRIPTION
  25 .PP
  26 .B barrybackup
  27 is a GUI application for backing up and restoring Blackberry handheld
  28 databases.
  29
  30 The application allows for filtering of databases for both backup
  31 and restore, so not all databases need to be backed up at once,
  32 nor all restored.
  33
  34 Backups and configuration files are stored by default in the user's
  35 home directory, under ~/.barry/backup/PIN.  The backup files are
  36 compressed tarballs containing specially named files for each record
  37 of the databases.
  38 .SH OPTIONS
  39 .TP
  40 .B \-d
  41 .B \-\-debug-output
  42 Enables low level protocol debug output written to stdout/stderr.
  43 .TP
  44 .B \-\-display=DISPLAY
  45 Specify which X display to use.
  46 .TP
  47 .B \-?
  48 .B \-\-help
  49 Show summary of options.
  50 .TP
  51 .B \-v
  52 Dump verbose protocol data during operation.
  53 .TP
  54 .B \-h, \-\-help
  55 Show summary of options.
  56
  57 .SH TAR FORMAT
  58 Backups are stored in tar format, compressed with gzip.  Backup files
  59 are named with the following pattern:
  60
  61         PIN-YYYYMMDD-HHMMSS.tar.gz
  62
  63 Each record is appended to the tar file using the following pattern
  64 for the filename:
  65
  66         DBname/RecordID RecordTypeID
  67
  68 That is, the database name is used as the directory name, and
  69 the filename contains the record ID and record type ID separated
  70 by a space.
  71
  72 Database names can contain spaces.
  73
  74 Record IDs are generally unique, but not all Blackberry devices
  75 mandate this, so it is possible, but rare, to have two records
  76 in the tar file with the same filename.  This is ok.  The only problem you'd
  77 see is if you expanded such a tar file to a filesystem.  The restore
  78 process just reads in the filename sequentially and writes them to
  79 the device, so duplicate record IDs are not a problem.
  80
  81 .SH AUTHOR
  82 .nh
  83 .B barrybackup
  84 is part of the Barry project.
  85 This manual page was written by Chris Frey.
  86 .SH SEE ALSO
  87 .PP
  88 http://www.netdirect.ca/software/packages/barry/index.php
  89