Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
TQSL(5)			      File Formats Manual		       TQSL(5)

       TQSL - digitally	sign amateur radio contact logs

       tqsl -i [certificate-file]...

       tqsl [OPTIONS] [log-file]...

       TrustedQSL  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.

       The tqsl	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 pro-
       gram, tqslcert, but all functions are now handled by tqsl).

       This manual page	briefly	documents  the	tqsl  program.	 Complete
       documentation is	also available:

	 tqsl: file:///usr/share/TrustedQSL/help/tqslapp/main.htm

       tqsl 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  ig-
	      nored.  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.

       -d     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.

       -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.

       -s     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

       -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 pro-
	      cessing all command-line arguments.

       -u     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     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

       -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 op-
	      tion'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  pre-
	      sented.) File names that contain spaces or other shell-spe-
	      cial 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.

       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 <ka->,	for the	Debian project (and may	be used	 by  oth-

			       August  28, 2013			       TQSL(5)


Want to link to this manual page? Use this URL:

home | help