1TQSL(5) File Formats Manual TQSL(5)
2
6 TQSL - digitally sign amateur radio contact logs
7
9 tqsl -i [certificate-file]...
10 tqsl [OPTIONS] [log-file]...
12
14 TrustedQSL is a file format and set of procedures that is used to
15 send digitally signed QSL information (logs of contacts between
16 amateur radio operators). One notable service that makes use of
17 TrustedQSL is ARRL's Logbook of the World.
18 The tqsl program is used to digitally sign contact log files using
20 a digital certificate. It is also used to generate requests for
21 digital certificates and to store the resulting received digital
22 certificates. (Certificates used to be handled by a separate pro‐
23 gram, tqslcert, but all functions are now handled by tqsl).
24 This manual page briefly documents the tqsl program. Complete
26 documentation is also available:
27 tqsl: file:///usr/share/TrustedQSL/help/tqslapp/main.htm
29
31 tqsl accepts these command line options:
32 -b begin_date and -e end_date
35 Supply a start date and end date for QSOs to be signed. If
36 present, any QSOs before the begin date will be ignored,
37 and any after the end date will be ignored. If either begin
38 or end are omitted, then the corresponding limit is
39 ignored. You should specify -d with this option to suppress
40 the normal date range dialog as these options will override
41 the user-specified dates if given.
42 -d Suppress date-range dialog. If present, the QSO date-range
44 dialog will not be shown for files that follow this option
45 on the command line.
46 -l location_name
49 Selects an existing station location. This location will be
50 used for the commands that follow. If the station location
51 doesn't exist, tqsl will just exit.
52 -o output_file
55 Writes the resulting signed log file to output_file instead
56 of a default name based on the input log-file name.
57 -s Add or edit station location. If there is a preceding -l
60 option the specified location will be edited. If there is
61 no preceding -l option, a new station location is being
62 added.
63 -x (or) -q
66 Exit tqsl. If this argument is used it should be the last
67 one on the command line. If this argument is not present,
68 tqsl will begin normal operation after successfully pro‐
69 cessing all command-line arguments.
70 -u Upload log file. If this argument is used, the input files
73 will be signed then automatically uploaded to the Logbook
74 of the World web site for processing.
75 -v Display the version number of tqsl and exit.
78 -i filename
81 Import a certificate - either a signed response (.tq6) or a
82 certificate stored with a private key in PKCS#12 format
83 (.p12).
84 -t filename
86 Open a diagnostic trace file at startup. This file will log
87 internal TQSL function calls for debugging purposes.
88 log-files
90 Any command-line parameter that is not an option or an
91 option's argument will be treated as the name of a log file
92 (ADIF or Cabrillo) to be signed. The resulting signed file
93 (.tq8) will be placed in the same directory as the log
94 file, overwriting any existing .tq8 file of the same name.
95 (Note: If this option is not preceded by a -l option that
96 selects the station location to be used for signing, the
97 Select Station Location for Signing dialog will be pre‐
98 sented.) File names that contain spaces or other shell-spe‐
99 cial characters should be quoted in a manner suitable for
100 the operating system and shell that's being used. If -u is
101 used, the signed log is not saved to disk but is instead
102 uploaded and submitted to Logbook of the World.
103 N.B.: If the private key needed to sign a log is protected
105 by a password, the user will be prompted to supply that
106 password for each file being signed.
107
110 trustedqsl was written by "American Radio Relay League, Inc." and
111 the TrustedQSL authors. Please see the AUTHORS.txt file in the
112 source distribution for a list of contributors.
113 This manual page was originally prepared by Kamal Mostafa
115 <kamal@whence.com>, for the Debian project (and may be used by
116 others).
117 August 28, 2013 TQSL(5)