[−][src]Crate sq
A command-line frontend for Sequoia.
Usage
Sequoia is an implementation of OpenPGP. This is a command-line frontend.
USAGE:
sq [FLAGS] [OPTIONS] <SUBCOMMAND>
FLAGS:
-f, --force Overwrite existing files
-h, --help Prints help information
-V, --version Prints version information
OPTIONS:
--home <DIRECTORY> Sets the home directory to use
-p, --policy <NETWORK-POLICY> Sets the network policy to use
-s, --store <STORE> Sets the realm and store to use [default: org.sequoia-pgp.contacts/default]
SUBCOMMANDS:
decrypt Decrypts an OpenPGP message
encrypt Encrypts a message
sign Signs a message
verify Verifies a message
store Interacts with key stores
keyserver Interacts with keyservers
autocrypt Autocrypt support
dearmor Removes ASCII Armor from a file
enarmor Applies ASCII Armor to a file
help Prints this message or the help of the given subcommand(s)
inspect Inspects a sequence of OpenPGP packets
key Manipulates keys
list Lists key stores and known keys
packet OpenPGP Packet manipulation
wkd Interacts with Web Key Directories
Subcommand decrypt
Decrypts an OpenPGP message
USAGE:
sq decrypt [FLAGS] [OPTIONS] [--] [FILE]
FLAGS:
--dump Print a packet dump to stderr
--dump-session-key Prints the session key to stderr
-h, --help Prints help information
-x, --hex Print a hexdump (implies --dump)
-V, --version Prints version information
OPTIONS:
-o, --output <FILE> Sets the output file to use
--public-key-file <TPK-FILE>... Public key to verify with, given as a file (can be given multiple times)
--secret-key-file <TSK-FILE>... Secret key to decrypt with, given as a file (can be given multiple times)
-n, --signatures <N> The number of valid signatures required. Default: 0
ARGS:
<FILE> Sets the input file to use
Subcommand encrypt
Encrypts a message
USAGE:
sq encrypt [FLAGS] [OPTIONS] [--] [FILE]
FLAGS:
-B, --binary Don't ASCII-armor encode the OpenPGP data
-h, --help Prints help information
-s, --symmetric Encrypt with a password (can be given multiple times)
-V, --version Prints version information
OPTIONS:
-o, --output <FILE> Sets the output file to use
-r, --recipient <LABEL>... Recipient to encrypt for (can be given multiple times)
--recipient-key-file <TPK-FILE>... Recipient to encrypt for, given as a file (can be given multiple times)
--signer-key-file <TSK-FILE>... Secret key to sign with, given as a file (can be given multiple times)
ARGS:
<FILE> Sets the input file to use
Subcommand sign
Signs a message
USAGE:
sq sign [FLAGS] [OPTIONS] [--] [FILE]
FLAGS:
-a, --append Append signature to existing signature
-B, --binary Don't ASCII-armor encode the OpenPGP data
--detached Create a detached signature
-h, --help Prints help information
-n, --notarize Signs a message and all existing signatures
-V, --version Prints version information
OPTIONS:
-o, --output <FILE> Sets the output file to use
--secret-key-file <TSK-FILE>... Secret key to sign with, given as a file (can be given multiple times)
ARGS:
<FILE> Sets the input file to use
Subcommand verify
Verifies a message
USAGE:
sq verify [OPTIONS] [--] [FILE]
FLAGS:
-h, --help Prints help information
-V, --version Prints version information
OPTIONS:
--detached <SIG-FILE> Verifies a detached signature
-o, --output <FILE> Sets the output file to use
--public-key-file <TPK-FILE>... Public key to verify with, given as a file (can be given multiple times)
-n, --signatures <N> The number of valid signatures required. Default: 0
ARGS:
<FILE> Sets the input file to use
Subcommand store
Interacts with key stores
USAGE:
sq store <SUBCOMMAND>
FLAGS:
-h, --help Prints help information
-V, --version Prints version information
SUBCOMMANDS:
add Add a key identified by fingerprint
delete Deletes bindings or stores
export Exports a key
help Prints this message or the help of the given subcommand(s)
import Imports a key
list Lists keys in the store
log Lists the keystore log
stats Get stats for the given label
Subcommand store add
Add a key identified by fingerprint
USAGE:
sq store add <LABEL> <FINGERPRINT>
FLAGS:
-h, --help Prints help information
-V, --version Prints version information
ARGS:
<LABEL> Label to use
<FINGERPRINT> Key to add
Subcommand store delete
Deletes bindings or stores
USAGE:
sq store delete [FLAGS] [LABEL]
FLAGS:
-h, --help Prints help information
--the-store Delete the selected store (change with --store)
-V, --version Prints version information
ARGS:
<LABEL> Delete binding with this label
Subcommand store export
Exports a key
USAGE:
sq store export [FLAGS] [OPTIONS] <LABEL>
FLAGS:
-B, --binary Don't ASCII-armor encode the OpenPGP data
-h, --help Prints help information
-V, --version Prints version information
OPTIONS:
-o, --output <FILE> Sets the output file to use
ARGS:
<LABEL> Label to use
Subcommand store import
Imports a key
USAGE:
sq store import <LABEL> [FILE]
FLAGS:
-h, --help Prints help information
-V, --version Prints version information
ARGS:
<LABEL> Label to use
<FILE> Sets the input file to use
Subcommand store list
Lists keys in the store
USAGE:
sq store list
FLAGS:
-h, --help Prints help information
-V, --version Prints version information
Subcommand store log
Lists the keystore log
USAGE:
sq store log [LABEL]
FLAGS:
-h, --help Prints help information
-V, --version Prints version information
ARGS:
<LABEL> List messages related to this label
Subcommand store stats
Get stats for the given label
USAGE:
sq store stats <LABEL>
FLAGS:
-h, --help Prints help information
-V, --version Prints version information
ARGS:
<LABEL> Label to use
Subcommand keyserver
Interacts with keyservers
USAGE:
sq keyserver [OPTIONS] <SUBCOMMAND>
FLAGS:
-h, --help Prints help information
-V, --version Prints version information
OPTIONS:
-s, --server <URI> Sets the keyserver to use
SUBCOMMANDS:
get Retrieves a key
help Prints this message or the help of the given subcommand(s)
send Sends a key
Subcommand keyserver get
Retrieves a key
USAGE:
sq keyserver get [FLAGS] [OPTIONS] <KEYID>
FLAGS:
-B, --binary Don't ASCII-armor encode the OpenPGP data
-h, --help Prints help information
-V, --version Prints version information
OPTIONS:
-o, --output <FILE> Sets the output file to use
ARGS:
<KEYID> ID of the key to retrieve
Subcommand keyserver send
Sends a key
USAGE:
sq keyserver send [FILE]
FLAGS:
-h, --help Prints help information
-V, --version Prints version information
ARGS:
<FILE> Sets the input file to use
Subcommand autocrypt
Autocrypt support
USAGE:
sq autocrypt <SUBCOMMAND>
FLAGS:
-h, --help Prints help information
-V, --version Prints version information
SUBCOMMANDS:
decode Converts Autocrypt-encoded keys to OpenPGP TPKs
encode-sender Encodes the senders' OpenPGP TPKs into an Autocrypt header
help Prints this message or the help of the given subcommand(s)
Subcommand autocrypt decode
Converts Autocrypt-encoded keys to OpenPGP TPKs
USAGE:
sq autocrypt decode [OPTIONS] [FILE]
FLAGS:
-h, --help Prints help information
-V, --version Prints version information
OPTIONS:
-o, --output <FILE> Sets the output file to use
ARGS:
<FILE> Sets the input file to use
Subcommand autocrypt encode-sender
Encodes the senders' OpenPGP TPKs into an Autocrypt header
USAGE:
sq autocrypt encode-sender [OPTIONS] [FILE]
FLAGS:
-h, --help Prints help information
-V, --version Prints version information
OPTIONS:
--address <address> Select userid to use. [default: primary userid]
-o, --output <FILE> Sets the output file to use
--prefer-encrypt <prefer-encrypt> Sets the prefer-encrypt attribute [default: nopreference] [possible
values: nopreference, mutual]
ARGS:
<FILE> Sets the input file to use
Subcommand dearmor
Removes ASCII Armor from a file
USAGE:
sq dearmor [OPTIONS] [FILE]
FLAGS:
-h, --help Prints help information
-V, --version Prints version information
OPTIONS:
-o, --output <FILE> Sets the output file to use
ARGS:
<FILE> Sets the input file to use
Subcommand enarmor
Applies ASCII Armor to a file
USAGE:
sq enarmor [OPTIONS] [FILE]
FLAGS:
-h, --help Prints help information
-V, --version Prints version information
OPTIONS:
--kind <KIND> Selects the kind of header line to produce [default: file] [possible values: message,
publickey, secretkey, signature, file]
-o, --output <FILE> Sets the output file to use
ARGS:
<FILE> Sets the input file to use
Subcommand inspect
Inspects a sequence of OpenPGP packets
USAGE:
sq inspect [FLAGS] [FILE]
FLAGS:
--certifications Print third-party certifications
-h, --help Prints help information
--keygrips Print keygrips of keys and subkeys
-V, --version Prints version information
ARGS:
<FILE> Sets the input file to use
Subcommand key
Manipulates keys
USAGE:
sq key <SUBCOMMAND>
FLAGS:
-h, --help Prints help information
-V, --version Prints version information
SUBCOMMANDS:
generate Generates a new key
help Prints this message or the help of the given subcommand(s)
Subcommand key generate
Generates a new key
USAGE:
sq key generate [FLAGS] [OPTIONS] --export <OUTFILE>
FLAGS:
--can-sign The key has a signing-capable subkey (default)
--cannot-encrypt The key will not be able to encrypt data
--cannot-sign The key will not be able to sign data
-h, --help Prints help information
-V, --version Prints version information
--with-password Prompt for a password to protect the generated key with.
OPTIONS:
--can-encrypt <PURPOSE> The key has an encryption-capable subkey (default) [possible values: transport,
rest, all]
-c, --cipher-suite <CIPHER-SUITE> Cryptographic algorithms used for the key. [default: cv25519] [possible
values: rsa3k, cv25519]
--expiry <EXPIRY> When the key should expire. Either 'N[ymwd]', for N years, months, weeks, or
days, or 'never'.
-e, --export <OUTFILE> Exports the key instead of saving it in the store
--rev-cert <FILE or -> Sets the output file for the revocation certificate. Default is <OUTFILE>.rev,
mandatory if OUTFILE is '-'.
-u, --userid <EMAIL> Primary user ID
Subcommand list
Lists key stores and known keys
USAGE:
sq list <SUBCOMMAND>
FLAGS:
-h, --help Prints help information
-V, --version Prints version information
SUBCOMMANDS:
bindings Lists all bindings in all key stores
help Prints this message or the help of the given subcommand(s)
keys Lists all keys in the common key pool
log Lists the server log
stores Lists key stores
Subcommand list bindings
Lists all bindings in all key stores
USAGE:
sq list bindings [PREFIX]
FLAGS:
-h, --help Prints help information
-V, --version Prints version information
ARGS:
<PREFIX> List only bindings from stores with the given realm prefix
Subcommand list keys
Lists all keys in the common key pool
USAGE:
sq list keys
FLAGS:
-h, --help Prints help information
-V, --version Prints version information
Subcommand list log
Lists the server log
USAGE:
sq list log
FLAGS:
-h, --help Prints help information
-V, --version Prints version information
Subcommand list stores
Lists key stores
USAGE:
sq list stores [PREFIX]
FLAGS:
-h, --help Prints help information
-V, --version Prints version information
ARGS:
<PREFIX> List only stores with the given realm prefix
Subcommand packet
OpenPGP Packet manipulation
USAGE:
sq packet <SUBCOMMAND>
FLAGS:
-h, --help Prints help information
-V, --version Prints version information
SUBCOMMANDS:
dump Lists OpenPGP packets
help Prints this message or the help of the given subcommand(s)
split Splits a message into OpenPGP packets
Subcommand packet dump
Lists OpenPGP packets
USAGE:
sq packet dump [FLAGS] [OPTIONS] [FILE]
FLAGS:
-h, --help Prints help information
-x, --hex Print a hexdump
--mpis Print MPIs
-V, --version Prints version information
OPTIONS:
-o, --output <FILE> Sets the output file to use
--session-key <SESSION-KEY> Session key to decrypt encryption containers
ARGS:
<FILE> Sets the input file to use
Subcommand packet split
Splits a message into OpenPGP packets
USAGE:
sq packet split [OPTIONS] [FILE]
FLAGS:
-h, --help Prints help information
-V, --version Prints version information
OPTIONS:
-p, --prefix <FILE> Sets the prefix to use for output files (defaults to the input filename with a dash, or
'output')
ARGS:
<FILE> Sets the input file to use
Subcommand wkd
Interacts with Web Key Directories
USAGE:
sq wkd <SUBCOMMAND>
FLAGS:
-h, --help Prints help information
-V, --version Prints version information
SUBCOMMANDS:
get Writes to the standard output the TPK retrieved from a Web Key Directory, given an email address
help Prints this message or the help of the given subcommand(s)
url Prints the Web Key Directory URL of an email address.
Subcommand wkd get
Writes to the standard output the TPK retrieved from a Web Key Directory, given an email address
USAGE:
sq wkd get [FLAGS] <EMAIL_ADDRESS>
FLAGS:
-B, --binary Don't ASCII-armor encode the OpenPGP data
-h, --help Prints help information
-V, --version Prints version information
ARGS:
<EMAIL_ADDRESS> The email address from which to obtain the TPK from a WKD.
Subcommand wkd url
Prints the Web Key Directory URL of an email address.
USAGE:
sq wkd url <EMAIL_ADDRESS>
FLAGS:
-h, --help Prints help information
-V, --version Prints version information
ARGS:
<EMAIL_ADDRESS> The email address from which to obtain the WKD URI.