man/btarcmp.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 BTARCMP 1 "January 20, 2010"
   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 btarcmp
  20 \- a diff for Barry tar backup files
  21 .SH SYNOPSIS
  22 .B btarcmp
  23 [\-b][\-d db][\-D db][\-h][\-I charset][\-P][\-S][\-v] tar0 tar1
  24 .SH DESCRIPTION
  25 .PP
  26 .B btarcmp
  27 takes two Barry backup tar files on the command line, and displays
  28 the differences it finds between them.  If records can be parsed,
  29 individual field differences are also displayed.  Added and removed
  30 records are noted.  Differences in database availability are noted as
  31 well.  If unable to parse the records, hex dumps are used.
  32 .SH OPTIONS
  33 .TP
  34 .B \-b
  35 Use brief filename markers.  Useful when tar filenames are extremely long.
  36 .TP
  37 .B \-d db
  38 Name of database to compare.  Can be used multiple times to compare
  39 multiple databases.  If not specified, all databases are compared.
  40 .TP
  41 .B \-D db
  42 Name of database to skip.  Can be used multiple times.  Overrides all
  43 other database selection options.
  44 .TP
  45 .B \-h
  46 Show summary of options.
  47 .TP
  48 .B \-I charset
  49 Specifies the iconv charset to use for converting international strings.
  50 The Blackberry uses the WINDOWS\-1252 charset, which is incompatible with
  51 the more common code pages used in Linux.  The most useful charset to use
  52 with this option is UTF\-8, and is highly recommended.  Any other charset
  53 available via 'iconv \-\-list' can be used here too, but may not be
  54 successful for some character conversions.
  55 .TP
  56 .B \-S
  57 Displays list of known database records, which can be parsed.
  58 .TP
  59 .B \-v
  60 Verbose output, which includes record data of added and deleted records
  61 in the output.  If used twice, hex data is printed as well.
  62
  63 .SH AUTHOR
  64 .nh
  65 .B btarcmp
  66 is part of the Barry project.
  67 .SH SEE ALSO
  68 .PP
  69 http://www.netdirect.ca/barry
  70