SQ(1)

NAME
sq sign - Signs messages or data files

SYNOPSIS
sq [GLOBAL OPTIONS] sign [OPTIONS] FILE

DESCRIPTION
Signs messages or data files.

Creates signed messages or detached signatures. Detached signatures are often used to sign software packages.

The converse operation is "sq verify".

"sq sign" respects the reference time set by the top-level "--time" argument. When set, it uses the specified time instead of the current time, when determining what keys are valid, and it sets the signature's creation time to the reference time instead of the current time.

OPTIONS

  Global options

--cert-store=PATH
    Specifies the location of the certificate store

-f, --force=FORCE
    Overwrites existing files

--keyring=PATH
    Specifies the location of a keyring to use

--known-notation=NOTATION
    Adds NOTATION to the list of known notations

--no-cert-store=NO_CERT_STORE
    Disables the use of a certificate store

--output-format=FORMAT
    Produces output in FORMAT, if possible

--output-version=VERSION
    Produces output variant VERSION.

--pep-cert-store=PATH
    Specifies the location of a pEp certificate store

--time=TIME
    Sets the reference time as ISO 8601 formatted timestamp

--trust-root=FINGERPRINT|KEYID
    Considers the specified certificate to be a trust root

  Subcommand options

-B, --binary=BINARY
    Emits binary data

-a, --append=APPEND
    Appends a signature to existing signature

--cleartext-signature=CLEARSIGN
    Creates a cleartext signature

--detached=DETACHED
    Creates a detached signature

--merge=SIGNED-MESSAGE
    Merges signatures from the input and SIGNED-MESSAGE

-n, --notarize=NOTARIZE
    Signs a message and all existing signatures

--notation=NAME
    Adds a notation to the certification.

-o, --output=FILE
    Writes to FILE or stdout if omitted

--private-key-store=KEY_STORE
    Provides parameters for private key store

--signer-file=KEY_FILE
    Signs the message using the key in KEY_FILE

EXAMPLES

Create a signed message

    sq sign --signer-file juliet.pgp message.txt

Create a detached signature

    sq sign --detached --signer-file juliet.pgp message.txt

Create a signature with the specified creation time

    sq sign --time 20020304 --detached --signer-file juliet.pgp message.txt

SEE ALSO
sq(1).

For the full documentation see <https://docs.sequoia-pgp.org/sq/>.

VERSION
0.30.1 (sequoia-openpgp 1.16.0, using Nettle 3.9 (Cv448: true))