BUPSTASH-NEW-SUB-KEY(1)          User Commands         BUPSTASH-NEW-SUB-KEY(1)

<?><?><?> (NAME)
       bupstash-new-sub-key - <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> bupstash

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

       bupstash new-sub-key -k KEY -o SUB_KEY

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> bupstash new-sub-key <?><?> <?><?><?><?> <?><?><?><?>
       bupstash <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?>.

       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?> <?><?>
       <?><?><?><?><?> 'put' <?>'list' <?> 'list-contents' <?><?><?><?><?>.
       <?><?><?><?><?><?><?> 'put' <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       'list' <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> 'list-contents' <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> 'bupstash put' <?><?><?><?><?>.

       <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?>-<?><?><?><?><?> (list only)<?> <?><?><?><?><?> <?><?><?><?>
       <?><?> <?><?> <?><?><?> <?><?><?><?> (cron job) <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>.

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

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

       <?><?><?><?>: <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?> - <?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
       <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?>. <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> bupstash-serve(1) <?><?><?><?><?><?><?>
       <?><?><?><?>. <?><?><?> <?><?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?> authorized_keys <?><?><?><?><?> <?><?> ssh
       <?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> sudo <?><?> doas <?><?><?><?><?> <?><?><?>.

<?><?><?><?><?><?><?><?> (OPTIONS)
       -k, --key PATH
              <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?>
              <?><?> <?><?><?><?> <?><?><?><?><?><?>.

       -o, --output PATH
              <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?>
              <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>.

       --put  <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>
              'put' <?><?><?><?><?><?><?><?> <?><?><?>.

       --list <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?> <?> <?><?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?>.

       --list-contents
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?>
              'list-contents' <?><?><?><?><?> <?><?><?> (<?><?><?><?><?><?>
              --list <?><?><?> <?><?><?>).

<?><?><?><?><?><?><?> (EXAMPLES)
   <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?>
       <?><?><?> <?><?><?><?> (put only)
       $ bupstash new-sub-key --put -k backups.key -o ./put.key
       $ bupstash put -k ./backups-put.key ./data

   <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> (listing key)
       $ bupstash new-sub-key -k ./backups.key -o ./list.key --list
       $ bupstash list -k ./list.key

   <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> (content listing key)
       $ bupstash new-sub-key -k ./backups.key -o ./list-contents.key --list-contents
       $ bupstash list-contents -k ./list-contents.key name=some-backup.tar

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

bupstash                          2026-09-01           BUPSTASH-NEW-SUB-KEY(1)