BUPSTASH-GET(1)                  User Commands                 BUPSTASH-GET(1)

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

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

       bupstash get [<?><?><?><?><?><?><?><?>] QUERY...

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> bupstash get <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?> bupstash <?><?>
       <?><?><?><?><?> <?> <?><?><?><?><?><?><?><?> <?><?><?><?> <?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> (stdout) <?><?><?><?><?>
       <?><?><?><?><?><?>. <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?> <?><?> <?><?> <?><?> <?><?><?><?><?> tar <?><?><?><?><?>
       <?><?><?><?><?><?>.

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

<?><?><?><?> <?><?><?><?><?><?><?> (QUERY LANGUAGE)
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?> bupstash-query-language(7) <?><?>
       <?><?><?><?><?><?>.

<?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> (QUERY CACHING)
       <?><?><?><?><?> get <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
       bupstash-list(1) <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>.

<?><?><?><?><?><?><?><?> <?><?><?> (SPARSE FILES)
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> tarball<?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?> <?><?>
       <?><?><?> <?><?><?><?><?><?> <?><?><?><?> (holes) <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?> bupstash restore
       <?><?><?><?><?><?><?> <?><?><?><?>.

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

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

       --pick PATH
              <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?>
              <?><?><?><?><?><?><?><?>.

       --query-cache PATH
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?>
              $BUPSTASH_QUERY_CACHE<?>
              $XDG_CACHE_HOME/.cache/bupstash/bupstash.qcache <?><?>
              $HOME/.cache/bupstash/bupstash.qcache <?><?><?><?><?> <?><?><?>.

       --utc-timestamps
              <?><?><?><?><?> <?> <?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> (UTC)
              <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>.

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

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

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

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

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

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

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

<?><?><?><?><?><?><?> (EXAMPLES)
   <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
       $ bupstash get id=14ebd2073b258b1f55c5bbc889c49db4 > ./data.file

   <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?><?> <?>
       <?><?><?><?><?> <?><?><?><?><?>
       $ bupstash get name=backup.tar and timestamp=2020/19/* > ./restore.tar

   <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?><?>-tar <?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       $ bupstash get --pick=path/to/file.txt id=$id
       $ bupstash get --pick=path/to/dir id=$id | tar ...

   <?><?><?><?><?><?> <?><?> <?><?><?><?><?> tarball
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?> tarball <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?> tar <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>.


           # <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?><?><?>.
           $ id=$(bupstash put ./data)

           # <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?> <?><?><?><?><?><?><?> <?><?> tar
           $ mkdir restore
           $ bupstash get id=$id | tar -C ./restore -xvf -




<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       bupstash(1), bupstash-put(1), bupstash-list(1), bupstash-restore(1),
       bupstash-rm(1), bupstash-keyfiles(7), bupstash-query-language(7)

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