XDELTA3(1)                  General Commands Manual                 XDELTA3(1)

<?><?><?> (NAME)
       xdelta3 - <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> VCDIFF (RFC 3284)

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       xdelta3 [command] [options] [input [output]]

<?><?><?><?><?><?><?> (DESCRIPTION)
       xdelta3 <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?> <?><?> <?><?> <?><?><?><?> <?>
       <?><?><?><?><?><?><?><?><?><?> VCDIFF (RFC 3284) <?><?><?><?><?><?><?>
       <?><?><?><?><?><?>.

<?><?><?><?><?><?><?> (COMMANDS)
       config <?><?><?><?><?><?><?><?> xdelta3 <?><?> <?><?><?>
              <?><?><?><?><?><?>

       decode <?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> -d
              <?><?><?><?><?> <?><?><?><?><?><?>

       encode <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?> -e <?><?><?><?><?> <?><?><?><?><?><?>
              (<?><?><?><?><?><?><?>)

       test   <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>

       printdelta
              <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?>
              <?><?><?><?>

       printhdr
              <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?><?><?> <?><?><?><?>

       printhdrs
              <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?> <?><?><?><?><?><?><?><?>

       recode <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?>/<?><?><?><?><?><?>


<?><?><?><?><?><?><?><?> (OPTIONS)
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>:

       -0 .. -9
              <?><?><?> <?><?><?><?><?><?><?><?><?><?>

       -c     <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> (stdout)

       -d     <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>

       -e     <?><?><?><?><?><?><?><?><?><?>

       -f     <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>

       -h     <?><?><?><?><?> <?><?><?><?><?><?>

       -q     <?><?><?><?> <?><?><?><?><?><?>

       -v     <?><?><?><?> <?><?><?><?> (<?><?><?><?><?><?> <?> <?><?><?>)

       -V     <?><?><?><?><?> <?><?><?><?>


       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>:

       -B     bytes <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>

       -W     bytes <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>

       -P     size <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?>

       -I     size <?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?><?> (<?> =
              <?><?><?><?><?><?><?>)


       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>:

       -s     source <?><?><?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?> (<?><?>
              <?><?><?><?> <?><?><?><?>)

       -S [djw]
              <?><?><?><?>/<?><?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>

       -N     <?><?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?>

       -D     <?><?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
              (encode/decode)

       -R     <?><?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
              (decode)

       -G     <?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?><?> (<?><?> encode).
              <?><?><?><?><?><?> <?><?><?><?><?><?><?> xdelta3 <?><?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?>
              <?><?><?><?><?><?> <?><?> decode <?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
              -G <?><?> <?><?><?><?><?> <?><?><?><?><?> (legacy)
              <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> xdelta3
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?>
              <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>.

       -n     <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> (checksum) (<?><?>
              encode/decode)

       -a     <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?>
              (armor).  <?><?><?><?> <?><?><?> (<?><?><?><?><?><?><?><?><?><?>
              <?><?> <?><?><?><?> <?><?> BLAKE3) <?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?>. <?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?> xdelta3 <?><?><?><?><?><?><?><?><?>
              BLAKE3 <?><?><?><?> <?> <?><?><?><?> <?><?> <?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?> name#blake3 <?><?>
              <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?>. <?><?> encode<?> <?><?><?> <?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?> <?> <?><?><?><?> <?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?> (seekable) <?><?><?><?>
              <?><?> decode<?> <?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?>
              <?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?>
              <?><?> <?><?> <?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?>. <?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?> (<?><?><?><?><?><?><?> <?><?><?><?><?><?><?>)
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
              <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
              xdelta3 <?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?> <?>
              <?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?>
              <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?> - <?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?> - <?><?><?> decode
              <?><?><?><?><?> "already up to date" <?><?><?><?><?><?> <?>
              <?><?> <?><?><?><?><?> <?><?><?><?> <?> <?><?><?><?><?>
              <?><?><?><?><?><?><?>.  -a <?><?><?> <?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?> <?><?><?><?> <?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?>
              <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?>. <?><?><?><?><?> merge <?><?> <?><?><?><?><?>
              <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?>.  <?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?>
              (<?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?>) <?><?>
              <?><?> xdelta3 <?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?> <?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

       -C     <?><?><?><?><?><?><?><?> <?><?><?> (encode<?>
              <?><?><?><?><?><?><?><?><?>)

       -A [apphead]
              <?><?><?><?><?><?><?><?><?><?><?><?>/<?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?> (encode)

       -J     <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> (<?><?><?>
              <?><?><?><?><?>/<?><?><?><?><?><?>)

       -T     <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?><?><?> (test)


<?><?><?><?><?> <?><?><?><?> (EXIT STATUS)
       0      <?><?><?><?><?><?><?><?><?><?><?>.

       2      <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?>
              <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
              <?><?><?> <?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>.

       1      <?><?> <?><?><?><?> <?><?><?><?>.


<?><?><?><?> (NOTES)
       <?><?><?><?><?><?> <?><?> xdelta3 <?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> (bzip2<?> gzip<?> xz<?> <?><?>
       compress) <?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?> <?><?><?><?><?> decode
       <?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?>. <?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> bzip2 <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> gzip <?> xz
       <?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?>
       <?><?><?><?><?><?><?> <?> <?><?> <?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?><?>. <?><?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       (B, G, Z, Y) <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?> <?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> B9.  <?><?> -R <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> -D <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?> -G <?><?><?><?>
       <?><?><?> <?><?><?> <?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>.

       <?><?><?><?><?> <?><?><?><?><?> XDELTA <?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?>:

              XDELTA="-s source-x.y.tar.gz" \
              tar --use-compress-program=xdelta3 -cf \
              target-x.z.tar.gz.vcdiff target-x.y/


<?><?><?><?><?><?><?> (EXAMPLES)
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       SOURCE <?> TARGET <?> <?><?><?><?><?> OUT<?> <?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> "djw":

       xdelta3 -S djw -s SOURCE TARGET OUT

       <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?> <?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>:

       xdelta3 -S djw -s SOURCE < TARGET > OUT

       <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> OUT <?><?>
       <?><?><?><?><?><?><?> <?><?> SOURCE <?> <?><?><?><?><?> TARGET:

       xdelta3 -d -s SOURCE OUT TARGET


<?><?><?><?><?><?><?><?><?> (AUTHORS)
       <?><?><?><?><?><?><?> xdelta3 <?><?><?><?> Josh MacDonald
       <josh.macdonald@gmail.com> <?><?><?><?><?> <?><?><?> <?><?><?>.

       <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> Leo 'costela'
       Antunes <costela@debian.org> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?> (<?><?><?>
       <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?> <?><?><?>).

Xdelta3                           August 2009                       XDELTA3(1)