BUPSTASH-PUT(1)                  User Commands                 BUPSTASH-PUT(1)

<?><?><?> (NAME)
       bupstash-put - <?><?><?><?><?> <?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
       bupstash

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
       bupstash.

       bupstash put [<?><?><?><?><?><?><?><?>] [TAG=VAL...] [::]
       <?><?><?><?><?><?>...
       bupstash put --exec [<?><?><?><?><?><?><?><?>] [TAG=VAL...] [::]
       <?><?><?><?><?>

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> bupstash put <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> <?>
       <?><?> <?><?> <?><?><?><?> bupstash <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
       <?><?> <?><?><?><?>.

       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> tar <?><?><?><?><?><?><?> <?><?><?><?> <?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?> <?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> (stdout) <?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?> bupstash <?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> (deduplicate) <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>.
       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?> --send-log <?><?> <?><?>
       <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?>
       <?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>.

       <?><?><?><?> <?><?><?><?><?><?><?><?><?><?> put
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?> <?><?>
       bupstash-list(1) <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>.
       <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?> KEY=VALUE <?><?><?><?> <?><?><?><?><?><?><?>.
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> ^([a-zA-Z0-9\\-_]+)=(.+)$
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>-<?><?><?><?>
       <?><?><?><?> <?> <?><?><?><?><?><?><?><?><?> <?><?><?><?> - <?> _
       <?><?><?><?><?>. <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?> <?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

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

       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?>
       <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>.
       <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> (<?><?><?><?><?> NFS <?> sshfs) <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>. <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?> ssh:// <?><?> <?><?> <?><?><?><?><?> <?><?> bupstash serve
       <?><?> <?><?> <?><?><?><?> <?><?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?>.

<?><?><?><?> <?><?><?><?><?><?><?> (USAGE NOTES)
   <?><?><?><?><?> <?><?><?><?><?><?><?> (Incremental put)
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> bupstash
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?> 'put' <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?>
       <?><?><?><?><?> (send log) <?><?><?> <?><?><?><?><?><?>.

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

       o   <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?> <?><?> <?><?> <?><?><?><?><?> 'put' <?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?><?> <?> <?><?> bupstash <?><?><?><?><?>
           <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>.

       o   <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
           <?> <?><?> bupstash <?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?>.




       <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> 'put'<?> <?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>. <?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?>
       <?><?><?> cron <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?>.

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


           $ bupstash put --send-log /root/bupstash-backups.sendlog /home/
           # <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?> <?><?><?><?> <?><?><?> <?><?><?><?> <?><?> send log <?><?><?><?><?><?><?> <?><?><?><?><?><?>.
           $ bupstash put --send-log /root/bupstash-backups.sendlog /home/




   <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       (Concurrent filesystem modification)
       <?><?><?><?><?> Bupstash <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?>
       bupstash <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>. <?><?><?> bupstash
       <?><?> <?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?> bupstash <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?>.

       <?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?> <?><?> <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>. <?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?>
       <?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?> bupstash <?><?>
       <?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>.
       <?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
       ZFS<?> BTRFS <?> <?><?><?><?><?><?> LVM <?><?><?><?><?>.

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

   <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> (Default tags)
       <?><?><?><?><?> bupstash <?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?>.

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

       o   name<?> <?><?> <?><?><?> FILENAME <?><?> DIRNAME.tar
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?> --exec <?><?><?>
           <?><?><?><?><?><?>.




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

   <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> (Reserved tags)
       <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>:

       o   id

       o   decryption-key-id

       o   size

       o   timestamp




   <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?> (File actions)
       <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       --print-file-actions<?> <?><?><?><?><?> bupstash put <?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?> <?><?> stderr
       <?><?><?> <?><?><?><?><?><?>.

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


           $action $type $PATH




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

       o   + <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?>.

       o   ~ <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> stat
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?>.

       o   x <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?> <?><?>.




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

       o   f <?><?><?><?>

       o   l <?><?><?><?><?> <?><?><?><?><?><?>

       o   c <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>

       o   b <?><?><?><?><?><?> <?><?><?><?><?>

       o   d <?><?><?><?><?><?><?><?><?>

       o   p <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?> (fifo)




   <?><?><?><?> <?><?><?><?> (TIPS)
       o   <?><?><?><?><?> bupstash put <?><?><?><?><?><?><?> <?><?>
           <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?>
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?>
           <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
           <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?>.

       o   <?><?><?><?><?> bupstash serve --allow-put <?><?> <?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?><?> ssh <?><?><?><?><?>
           <?><?><?><?> <?><?> <?><?><?><?><?><?><?> ssh <?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?>.

       o   <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> tar <?><?> bupstash put <?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?> bupstash put <?><?><?> <?><?>
           <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?> <?><?>
           <?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?> send log
           <?><?><?><?><?><?><?> <?><?><?> <?> <?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?> <?> <?><?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> bupstash-list-contents(1)
           <?><?><?><?><?> <?><?><?>.




<?><?><?><?><?><?><?><?> (OPTIONS)
       -r, --repository REPO
              <?><?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?> <?><?><?><?>
              <?><?>. <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> ssh<?> <?><?><?><?> <?><?><?><?><?> <?><?><?>
              <?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?>
              ssh://$SERVER/$PATH <?><?><?><?>. <?><?> <?><?><?><?> <?><?><?>
              <?><?><?><?><?><?> <?><?> BUPSTASH_REPOSITORY
              <?><?><?><?><?><?><?> <?><?><?><?><?><?>.

       -k, --key KEY
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?>
              <?><?><?><?><?><?><?><?><?><?>. <?><?> <?><?><?><?> <?><?><?>
              <?><?><?><?><?><?> <?><?> BUPSTASH_KEY <?><?><?><?><?><?><?>
              <?><?><?><?><?><?>.

       -e, --exec
              <?><?><?><?><?><?><?> COMMAND <?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?> <?><?><?><?> <?><?> <?><?> <?><?> stdout <?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
              bupstash <?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>.

       --exclude PATTERN
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> (glob)
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?> <?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> tar
              <?><?><?><?><?>. <?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?>
              <?><?><?><?> <?> <?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?> <?><?>
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?> <?><?><?><?><?> <?><?> / <?><?><?>
              <?><?><?>. <?><?><?><?><?><?><?> <?><?><?><?> / <?><?> **/
              <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> **/ <?><?>
              <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?>. <?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>: * <?><?>
              <?><?><?> <?><?><?> <?><?> <?><?> <?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?> ** <?><?> <?><?> <?><?><?><?><?> <?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?> ? <?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?> <?> [<?>] <?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> (<?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?>
              <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>: [?]).

       --exclude-if-present FILENAME
              <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?>. <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>
              <?><?><?><?> <?><?><?>. <?><?><?> <?><?><?> <?><?><?><?><?><?>
              <?><?> <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?>. <?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> CACHEDIR.TAG<?> .backupexclude
              <?><?> .no-backup.

       --send-log PATH
              <?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?>
              $BUPSTASH_SEND_LOG<?>
              $XDG_CACHE_HOME/.cache/bupstash/bupstash.sendlog <?><?>
              $HOME/.cache/bupstash/bupstash.sendlog <?><?><?><?><?>
              <?><?><?>.

       --no-send-log
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?>
              <?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?> <?><?>. <?><?><?><?><?> --no-stat-caching
              <?><?><?>.

       --no-stat-caching
              <?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?> stat <?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?>.

       --no-default-tags
              <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?>.

       --compression ALGO
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?> <?><?> 'none'<?> 'lz4' <?><?> 'zstd[:$level]'.
              <?><?><?><?><?><?><?> 'zstd:3' <?><?><?>.

       --ignore-permission-errors
              <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?>
              <?><?><?><?><?><?> (permission denied)<?> <?>
              <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?>.

       --one-file-system
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?> (mount points) <?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?>.

       --xattrs
              <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
              (xattrs) <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?>.

       --print-file-actions
              <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
              '$a $t $path' <?><?> stderr <?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?><?> '<?><?><?><?><?><?><?> <?><?><?>
              <?><?><?><?>' <?><?> <?><?><?><?><?><?>.

       --print-stats
              <?><?><?> <?><?><?><?> put <?><?> stderr <?><?> <?><?>
              <?><?><?><?><?> <?><?><?>.

       --indexer-threads N
              <?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> (threads) <?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?>
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>.
              <?><?><?><?><?> <?><?><?><?><?><?><?> 1 <?><?><?>.

       --threads N
              <?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
              <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?>
              <?><?><?><?><?>. <?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?> <?><?><?>.

       --no-progress
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> (<?><?> <?><?><?><?><?> <?><?> stderr <?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>).

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

       -v, --verbose
              <?><?><?><?> <?><?><?><?><?> (verbose)<?> <?><?><?><?><?>
              --print-file-actions <?> --print-stats <?><?><?>.

<?><?><?><?><?><?><?><?> <?><?><?><?><?> (ENVIRONMENT)
       BUPSTASH_REPOSITORY
              <?><?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?> <?><?><?><?>
              <?><?>. <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> ssh <?><?><?><?> <?><?><?><?><?> <?><?><?>
              <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?>
              ssh://$SERVER/$PATH <?><?><?><?>.

       BUPSTASH_REPOSITORY_COMMAND
              <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?> <?><?><?><?><?> <?><?> bupstash-serve(1) <?><?><?><?>
              <?><?><?><?><?><?>. <?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

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

       BUPSTASH_KEY_COMMAND
              <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?>
              <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
              BUPSTASH_KEY <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?>
              <?><?><?>.

       BUPSTASH_SEND_LOG
              <?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?>
              <?><?><?><?> --send-log <?><?><?> <?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?>. <?><?><?><?> <?><?><?><?><?><?><?> <?><?>
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?>
              <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>
              '<?><?><?><?><?> <?><?><?><?><?><?><?>' <?><?>
              <?><?><?><?><?><?>.

       BUPSTASH_CHECKPOINT_SECONDS
              <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?> bupstash <?><?><?><?><?><?><?> <?><?>
              BUPSTASH_CHECKPOINT_SECONDS <?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?> (checkpoint) <?><?><?><?><?>
              <?><?><?><?><?><?>. <?><?><?> <?><?> <?><?><?><?><?><?><?><?>
              <?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>
              <?><?><?><?> <?><?><?><?><?><?> <?><?><?>. <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> 600 <?><?><?>
              <?><?> <?><?><?><?><?> <?><?> 10 <?><?><?><?><?>
              <?><?><?><?><?><?><?>.

<?><?><?><?><?><?><?> (EXAMPLES)
   <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> tar <?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> (deduplicate) <?><?><?><?><?><?><?><?>.


           # <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?><?><?>.
           $ ID="$(bupstash put ./data)"
           # <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>.
           $ bupstash list-contents id="$ID"
           # <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>.
           $ bupstash get id="$ID" | tar -xf -




   <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
       <?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?> ssh
       export BUPSTASH_KEY="/backups/backups-secret.key"
       export BUPSTASH_REPOSITORY="ssh://$SERVER/home/me/bupstash-repository"

       $ bupstash put ./data.file
       $ bupstash put ./directory
       $ bupstash put ./multiple-files.txt ./directory


   <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?>
       # <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?> postgres <?><?> pgdump
       $ bupstash put --exec name=dbdump.sql pgdump mydb

   <?><?><?><?><?> <?><?> <?><?> <?><?><?><?> ssh <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?> ssh
       $ export BUPSTASH_REPOSITORY_COMMAND="ssh -F ./my-ssh-config me@$SERVER bupstash serve /my/repo"
       $ bupstash put ./files

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       bupstash(1), bupstash-keyfiles(7)

bupstash                          2026-09-01                   BUPSTASH-PUT(1)