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 \-h, \-\-help
  52 Show summary of options.
  53
  54 .SH TAR FORMAT
  55 Backups are stored in tar format, compressed with gzip.  Backup files
  56 are named with the following pattern:
  57
  58         PIN-YYYYMMDD-HHMMSS.tar.gz
  59
  60 Each record is appended to the tar file using the following pattern
  61 for the filename:
  62
  63         DBname/RecordID RecordTypeID
  64
  65 That is, the database name is used as the directory name, and
  66 the filename contains the record ID and record type ID separated
  67 by a space.
  68
  69 Database names can contain spaces.
  70
  71 Record IDs are generally unique, but not all Blackberry devices
  72 mandate this, so it is possible, but rare, to have two records
  73 in the tar file with the same filename.  This is ok.  The only problem you'd
  74 see is if you expanded such a tar file to a filesystem.  The restore
  75 process just reads in the filename sequentially and writes them to
  76 the device, so duplicate record IDs are not a problem.
  77
  78 .SH AUTHOR
  79 .nh
  80 .B barrybackup
  81 is part of the Barry project.
  82 This manual page was written by Chris Frey.
  83 .SH SEE ALSO
  84 .PP
  85 http://www.netdirect.ca/software/packages/barry/index.php
  86