TRUSTEDQSL(5)							File Formats Manual						     TRUSTEDQSL(5)

NAME

       TrustedQSL - digitally sign amateur radio contact logs

SYNOPSIS

       tqslcert [certificate-file]...

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

DESCRIPTION

       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 tqslcert program is used to generate requests for digital certificates and to store the resulting received digital certificates.

       The tqsl program is used to digitally sign contact log files using a digital certificate.

       This manual page briefly documents the tqslcert and tqsl programs.  Complete documentation is also available:

	 tqslcert: file:///usr/share/TrustedQSL/help/tqslcert/main.htm

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

OPTIONS

       tqslcert accepts TQSL certificate files which may optionally be specified on the command line.

       tqsl accepts these command line options:

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

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

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

       This manual page was prepared by Kamal Mostafa <kamal@whence.com>, for the Debian project (and may be used by others).

								  March 31, 2011						     TRUSTEDQSL(5)