BUPSTASH-LIST(1)                 User Commands                BUPSTASH-LIST(1)

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

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

       bupstash list [<?><?><?><?><?><?><?><?>] <?><?><?><?><?><?><?>...

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

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

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

   <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>:
       $ bupstash list name='*.tar'
       ...
       $ bupstash list timestamp='2020*'
       ...

<?><?><?><?><?><?><?><?><?> <?><?><?><?> (SPECIAL TAGS)
       <?><?><?><?><?> Bupstash <?><?> <?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?> <?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?>.

   decryption-key-id
       <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?> --query-encrypted
       <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?>. <?><?><?> <?><?><?><?><?> <?><?><?> <?><?>
       <?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?> <?> <?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>.

   size
       <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>.
       <?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
       bupstash-get(1) <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>.

   timestamp
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
       YYYY/MM/DD HH:MM:SS.

<?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> (QUERY CACHING)
       <?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> (<?><?><?><?>) <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <?> <?><?><?> <?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?>. <?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?> <?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> (query
       cache) <?><?><?><?> <?><?><?><?><?><?>.

       <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> (query-cache)<?> <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?>
       <?><?><?>: $BUPSTASH_QUERY_CACHE <?><?>
       $XDG_CACHE_HOME/.cache/bupstash/bupstash.qcache <?><?>
       $HOME/.cache/bupstash/bupstash.qcache.

       <?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?> <?><?><?><?> (<?><?><?><?><?> id=$FULL_ID) <?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?> <?><?>
       <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?>. <?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>.

<?><?><?><?><?><?><?><?> <?><?><?><?><?> (OUTPUT FORMATS)
   Human
       <?><?><?><?><?><?> <?><?> --format <?><?><?> human <?><?><?><?><?>
       <?><?><?> <?><?><?><?><?> bupstash list <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?>:


           KEY=VALUE KEY=VALUE KEY=VALUE ....




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

   JSONl1
       <?><?><?><?><?><?> <?><?> --format <?><?><?> jsonl1 <?><?><?><?><?>
       <?><?><?> <?><?><?><?><?> bupstash list <?><?> <?><?> <?><?><?> <?><?>
       <?><?><?> JSON <?><?><?><?><?> <?><?><?><?><?><?>.

       <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> (schema)
       <?><?><?><?><?> <?><?><?> <?><?><?>:


           {
             "id": hexstring,
             "decryption_key_id": hexstring,
             "data_tree": {
               "address": hexstring,
               "height": number,
               "data_chunk_count": number
             },
             "index_tree": {
               "address": hexstring,
               "height": number,
               "data_chunk_count": number
             },
             "data_size": number, // If decryption key present.
             "index_size": number,  // If decryption key present.
             "put_key_id": hexstring,  // If decryption key present.
             "data_hash_key_part": hexstring,  // If decryption key present.
             "index_hash_key_part": hexstring,  // If decryption key present.
             "unix_timestamp_millis": number,
             "tags": {
               string : string,
               ...
           }




       <?><?><?> --query-encrypted <?><?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?>.

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

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

       --query-encrypted
              <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?><?>
              <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?> <?><?>
              <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> 'decryption-key-id' <?><?> <?><?><?>
              <?><?><?><?><?><?>.

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

       --format FORMAT
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
              <?><?> <?><?><?><?><?> 'human' <?><?> 'jsonl'.

       --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
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?> (query cache) <?><?><?>
              <?><?><?><?><?><?><?>.

<?><?><?><?><?><?><?> (EXAMPLES)
   <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?> <?><?><?><?><?><?><?>
       $ bupstash list name=backup.tar and timestamp=2020/07/*
       id="aa87fdbc72241f363568bbb888c0834e" name="backup.tar" size="106.34MB" timestamp="2020-07-24 15:25:00"
       id="d271ec0b989cfc20e10d01380115747e" name="backup.tar" size="146.38MB" timestamp="2020-07-29 15:25:24"
       ...

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

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