bup-split(1)                General Commands Manual               bup-split(1)

<?><?><?> (NAME)
       bup-split - <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> bup

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       bup split [-t] [-c] [-n name] COMMON_OPTIONS

       bup split -b COMMON_OPTIONS

       bup split -copy COMMON_OPTIONS

       bup split -noop [-t|-b] COMMON_OPTIONS

       COMMON_OPTIONS
              [-r host:path] [-v] [-q] [-d seconds-since-epoch] [--bench]
              [--max-pack-size=bytes] [-#] [--bwlimit=bytes]
              [--max-pack-objects=n] [--fanout=count] [--keep-boundaries]
              [--git-ids | filenames...]

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> bup split <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?><?> (<?><?> <?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> stdin <?><?><?><?><?><?><?><?>)<?>
       <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       (rolling checksum) <?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?>
       <?><?><?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?> bup
       <?><?><?><?><?> <?><?><?><?><?><?><?><?>.  <?><?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
       (<?><?><?><?> <<<?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>>>
       <?><?> deduplicated <?><?><?><?><?><?><?>).

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

       <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?> bup split <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?> XML
       <?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?> <?><?><?><?> XML <?><?> <?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?> <?><?><?><?><?><?>
       <?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
       <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?>.

       <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> tar(1) <?><?> cpio(1) <?><?> bup split
       <?><?><?>.  <?><?><?><?><?><?> <?><?> <?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> tarball <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?>
       <?><?><?> <?><?><?><?><?><?><?><?> bup <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> tarball <?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>.
       (<?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> bup save <?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?>
       <?><?><?>).

       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
       bup-join(1) <?><?><?><?><?><?><?> <?><?><?><?>.

<?><?><?><?><?><?><?> (MODES)
       <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       -n <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?>.

       -n, --name=name
              <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
              <?><?> <?><?><?><?> <?><?><?> <?><?> <?><?><?> name
              <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
              <?><?> <?><?><?> <?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?>.
              <?><?><?> name <?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
              <?><?> <?><?><?><?><?><?><?> name <?><?><?><?><?> <?><?>
              <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.
              (<?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?> <?><?> <?><?> <?><?><?> <?><?><?><?><?><?> <?>
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
              <?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?><?> <?><?><?><?>.)  <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?> <?><?><?><?> <?><?> <?><?><?> "data" <?><?> VFS <?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?> <?><?>
              <?><?><?><?> bup fuse<?> bup ftp <?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?><?>.

       -t, --tree
              <?><?><?><?><?> <?><?><?><?> <?><?><?> (git tree id)
              <?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?><?>.

       -c, --commit
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?> (git commit id)
              <?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?><?>.

       -b, --blobs
              <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?> <?><?><?> (git blob ids) <?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?>
              <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>.
              <?><?><?><?><?><?><?><?> <?><?> -n<?> -t<?> <?> -c.

       --noop <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?> <?><?>
              <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?> "bupsplit" <?><?> <?><?>
              <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?>.  <?><?><?><?><?><?><?><?>
              <?><?> -b <?><?> -t <?><?><?><?><?> <?><?><?> <?><?> blob<?><?>
              <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?>
              <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
              (<?><?><?> <?><?><?><?><?> <?><?><?><?>).  <?><?><?>
              <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> bupsplit
              <?><?><?><?> <?><?><?>.  <?><?><?><?><?><?><?><?> <?><?> -n <?>
              -c.

       --copy <?><?><?><?><?> --noop<?> <?><?><?> <?><?><?><?><?><?><?> <?><?>
              <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> (stdout)
              <?><?><?> <?><?><?><?><?><?><?><?>.  <?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?> read+bupsplit+write <?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?>.  <?><?><?><?><?><?><?><?> <?><?> -n<?> -t<?> -c<?>
              <?> -b.

<?><?><?><?><?><?><?><?> (OPTIONS)
       -r, --remote=[user@]host:[path], --remote=URL
              <?><?><?><?><?> <?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
              <?><?><?><?> <?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              SSH.  <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?> REMOTE OPTIONS <?><?> bup(1) <?><?>
              <?><?><?><?><?><?>.

       -d, --date=seconds-since-epoch
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?> <?><?><?><?> <?><?><?><?><?><?> (<?><?><?><?><?><?><?><?>
              <?><?> 1970-01-01).

       -q, --quiet
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?>.

       -v, --verbose
              <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?>
              <?><?><?><?><?><?> (<?><?><?><?><?><?><?> <?><?><?> <?><?>
              <?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?>).

       --git-ids
              <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?> <?><?><?>.
              <?><?><?><?><?> bup split <?><?><?><?><?><?> <?><?> <?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?> <?><?> (<?><?> <?><?><?><?>
              <?><?><?><?> <?><?> <?><?><?><?> bup) <?><?><?><?><?><?><?><?>
              <?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>.  <?><?><?>
              <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?> bup <?><?><?><?>
              <?><?><?><?>.  <?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
              --keep-boundaries <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?>.

       --keep-boundaries
              <?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?>.
              <?><?><?><?> <?><?><?><?><?><?>
              blob<?><?>/<?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?>.  <?><?><?> <?><?>
              <?><?><?><?><?><?><?> <?><?> --keep-boundaries<?> <?><?>
              <?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?>.  <?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?> <?><?> blob<?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?> <?><?> blob <?><?><?> <?><?>
              <?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> blob
              <?><?><?>.

       --bench
              <?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?> (stderr).

       --max-pack-size=bytes
              <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?> (packfiles)
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>.
              <?><?><?><?><?><?><?> <?> <?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?>.  <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>.

       --max-pack-objects=numobjs
              <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?>.  <?><?><?><?><?><?><?> <?><?><?>
              <?><?><?><?> <?><?><?> <?><?><?>.  <?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?>.

       --fanout=numobjs
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?> numobjs <?><?><?>
              <?><?><?><?><?>.

       --bwlimit=bytes/sec
              <?><?><?> <?><?> bytes/sec <?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>.  <?><?><?>
              <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?>
              <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?>.  <?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?> k<?> M<?> <?><?> G <?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?>*<?><?><?><?><?>
              <?><?><?><?>*<?><?><?><?>*<?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?>.

       -#, --compress=#
              <?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?> #
              <?><?><?><?><?> <?><?><?><?><?><?> (<?><?><?><?><?><?> <?><?> 0
              <?><?> 9<?> <?><?> 9 <?><?><?><?><?><?><?><?> <?> 0 <?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?>).
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?> pack.compression <?><?>
              core.compression<?> <?><?> 1 (<?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?> <?> <?><?>) <?><?><?>.

<?><?><?><?><?><?><?> (EXAMPLES)
              $ tar -cf - /etc | bup split -r myserver: -n mybackup-tar
              tar: Removing leading /' from member names
              Indexing objects: 100% (196/196), done.

              $ bup join -r myserver: mybackup-tar | tar -tf - | wc -l
              1961

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       bup-join(1), bup-index(1), bup-save(1), bup-on(1), ssh_config(5)

<?><?><?><?><?><?> BUP (BUP)
       <?><?><?><?> <?><?> <?><?><?><?><?><?> bup(1).

<?><?><?><?><?><?><?><?><?> (AUTHORS)
       Avery Pennarun <apenwarr@gmail.com>.

Bup 0.34+                         2026-09-01                      bup-split(1)