github.com/StackExchange/blackbox/v2@v2.0.1-0.20220331193400-d84e904973ab/docs/file-ops.md (about)

     1  How to add/remove a file into the system?
     2  =========================================
     3  
     4  # Adding files:
     5  
     6  - If you need to, start the GPG Agent: `eval $(gpg-agent --daemon)`
     7  - Add the file to the system:
     8  
     9  ```
    10  blackbox file add path/to/file.name.key
    11  
    12  # If you want to delete the old plaintext:
    13  blackbox file add --shred path/to/file.name.key
    14  ```
    15  
    16  Multiple file names can be specified on the command line:
    17  
    18  Example 1: Register 2 files:
    19  
    20  ```
    21  blackbox file add --shred file1.txt file2.txt
    22  ```
    23  
    24  Example 2: Register all the files in `$DIR`:
    25  
    26  ```
    27  find $DIR -type f -not -name '*.gpg' -print0 | xargs -0 blackbox file add
    28  ```
    29  
    30  
    31  # Removing files
    32  
    33  This command
    34  
    35  ```
    36  blackbox file remove path/to/file.name.key
    37  ```
    38  
    39  TODO(tlim): Add examples.
    40  
    41  # List files
    42  
    43  To see what files are currently enrolled in the system:
    44  
    45  ```
    46  blackbox file list
    47  ```
    48  
    49  You can also see their status:
    50  
    51  ```
    52  blackbox status
    53  blackbox status just_one_file.txt
    54  blackbox status --type ENCRYPTED
    55  ```