TQSL - digitally sign amateur radio contact logs
is a file format and set of procedures that is used to send
digitally signed QSL information (logs of contacts between amateur radio
operators). One notable service that makes use of TrustedQSL is ARRL's
Logbook of the World.
program is used to digitally sign contact log files using a
digital certificate. It is also used to generate requests for digital
certificates and to store the resulting received digital certificates.
(Certificates used to be handled by a separate program, tqslcert
all functions are now handled by tqsl).
This manual page briefly documents the tqsl
documentation is also available:
accepts these command line options:
- -b begin_date and -e end_date
- Supply a start date and end date for QSOs to be signed. If
present, any QSOs before the begin date will be ignored, and any after the
end date will be ignored. If either begin or end are omitted, then the
corresponding limit is ignored. You should specify -d with this
option to suppress the normal date range dialog as these options will
override the user-specified dates if given.
- Suppress date-range dialog. If present, the QSO date-range
dialog will not be shown for files that follow this option on the command
- -l location_name
- Selects an existing station location. This location will be
used for the commands that follow. If the station location doesn't exist,
tqsl will just exit.
- -o output_file
- Writes the resulting signed log file to output_file
instead of a default name based on the input log-file name.
- Add or edit station location. If there is a preceding -l
option the specified location will be edited. If there is no preceding -l
option, a new station location is being added.
- -x (or) -q
- Exit tqsl. If this argument is used it should be the
last one on the command line. If this argument is not present, tqsl
will begin normal operation after successfully processing all command-line
- Upload log file. If this argument is used, the input files
will be signed then automatically uploaded to the Logbook of the World web
site for processing.
- Display the version number of tqsl and exit.
- -i filename
- Import a certificate - either a signed response (.tq6) or a
certificate stored with a private key in PKCS#12 format (.p12).
- -t filename
- Open a diagnostic trace file at startup. This file will log
internal TQSL function calls for debugging purposes.
- Any command-line parameter that is not an option or an
option's argument will be treated as the name of a log file (ADIF or
Cabrillo) to be signed. The resulting signed file (.tq8) will be placed in
the same directory as the log file, overwriting any existing .tq8 file of
the same name. (Note: If this option is not preceded by a -l option that
selects the station location to be used for signing, the Select Station
Location for Signing dialog will be presented.) File names that contain
spaces or other shell-special characters should be quoted in a manner
suitable for the operating system and shell that's being used. If -u is
used, the signed log is not saved to disk but is instead uploaded and
submitted to Logbook of the World.
N.B.: If the private key needed to sign a log is protected by a password,
the user will be prompted to supply that password for each file being
trustedqsl was written by "American Radio Relay League, Inc." and the
TrustedQSL authors. Please see the AUTHORS.txt file in the source distribution
for a list of contributors.
This manual page was originally prepared by Kamal Mostafa
<firstname.lastname@example.org>, for the Debian project (and may be used by