FreeBSD Manual Pages
TQSL(5) File Formats Manual TQSL(5) NAME TQSL - digitally sign amateur radio contact logs SYNOPSIS tqsl -i [certificate-file]... tqsl -s [stationlocation]... tqsl [OPTIONS] [log-file]... DESCRIPTION TrustedQSL is a file format and set of procedures that is used to send dig- itally signed QSL information (logs of contacts between amateur radio oper- ators). One notable service that makes use of TrustedQSL is ARRL's Logbook of the World. The tqsl program is used to digitally sign contact log files using a digi- tal certificate. It is also used to generate requests for digital certifi- cates and to store the resulting received digital certificates. (Certifi- cates used to be handled by a separate program, tqslcert, but all functions are now handled by tqsl). This manual page briefly documents the tqsl program. Complete documenta- tion is also available: tqsl: file:///usr/share/TrustedQSL/help/tqslapp/main.htm OPTIONS tqsl accepts these command line options: -a, --action= action [abort, all, compliant, or ask ] Specify a default dialog action when non-compliant QSOs are detected (these are cases with invalid callsigns, QSOs already uploaded, for examples. The option value abort causes TQSL to abort signing when an invalid QSO is processed. all causes all QSOs to be signed, ig- noring errors. compliant indicates that invalid QSOs should be skipped, and ask asks the user how to proceed. -b, --begindate= begin_date and -e, --enddate= 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. -c, --callsign= callsign Specify the default callsign for log signing. -d, --nodate Suppress date-range dialog. If present, the QSO date-range dialog will not be shown for files that follow this option on the command line. -f,--verify=option [ignore, reportl, or update ] Specify QSO verification action for QTH details. This option con- trols how location information in an ADIF file is handled. Using ig- nore indicates that TQSL should ignore location data. Using report causes TQSL to report any discrepancies between the currently se- lected Station Location and the ADIF location information. Using updaate causes the new location details from the ADIF file to be used, overriding the Station Location details. -h, --help Displays command line usage summary. -i, --import= filename Import a certificate - either a signed response (.tq6) or a certifi- cate stored with a private key in PKCS#12 format (.p12). -l, --location= 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. -n, --updates Check for updates to TQSL, the configuration file, and for certifi- cate expiration. -o, --outut= output_file Writes the resulting signed log file to output_file instead of a de- fault name based on the input log-file name. -p, --password= password Specify the pasphrase for the callsign certificate being used to sign a log. -s, --editlocation location-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 op- tion, a new station location is being added. -t, --diagnose= filename Open a diagnostic trace file at startup. This file will log internal TQSL function calls for debugging purposes. -u, --upload 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. -v, --version Display the version number of tqsl and exit. -w, --wipe Delete the contact upload database. This should be used only for cases where that database has become corrupted, typically due to Or- acle BerkeleyDB misbehavior. -x,--batch (or) -q,--quiet 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 nor- mal operation after successfully processing all command-line argu- ments. log-files Any command-line parameter that is not an option or an option's ar- gument 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 op- tion 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 signed. AUTHOR trustedqsl was written by "American Radio Relay League, Inc." and the TrustedQSL authors. Please see the AUTHORS.txt file in the source distribu- tion for a list of contributors. This manual page was originally prepared by Kamal Mostafa <ka- mal@whence.com>, for the Debian project (and may be used by others). February 3, 2025 TQSL(5)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | AUTHOR
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=tqsl&sektion=5&manpath=FreeBSD+Ports+15.1.quarterly>