Difference between revisions of "Files"

From Tučňák Wiki
Jump to: navigation, search
(New page: ''Remark: Character ~ (tilde) is short cut of user home directory (bash# echo $HOME).'' Files which are described below are saved in plain text format. Is possible to edit these files but...)
 
Line 3: Line 3:
 
Files which are described below are saved in plain text format. Is possible to edit these files but it is necessary to keep format of files. In other case Tucnak shouldn't work properly.
 
Files which are described below are saved in plain text format. Is possible to edit these files but it is necessary to keep format of files. In other case Tucnak shouldn't work properly.
  
* tucnak - is one binary file. If Tucnak is install from source code it's installed to /usr/local/bin. If Tucnak is install from package it's installed to /usr/bin mostly.
+
=Binaries=
* tucnakrc - configuration file of Tucnak program. Tucnak reads this file from directory ~/tucnak/. When it don't found configuration file in ~/tucnak/ it reads from /etc. File is saved only to ~/tucnak/ directory.
+
==tucnak==
* tucnakrc.local - This file has the same structure as tucnakrc file. Is determine to set specific local options as define LPT address e.g. cwda_port = 0x3bc. Tucnak only reads this file and it is necessary to create and edit it manually.
+
Is one binary file. If Tucnak is install from source code it's installed to /usr/local/bin. If Tucnak is install from package it's installed to /usr/bin mostly. On Debian it's /usr/bin/tucnak2 and command tucnak2 is found via /etc/alternatives.
* tucnakcw - File with apair callsign-locator. Each callsign has saved maximally two locators.
+
==soundwrapper==
* tucnakdw -File with information about DXCC countries. Each country has saved information about possible large squares and centre of activity in the country. Tucnak doesn't write to this file. The file is read from directories /etc/ and ~/tucnak/.
+
Suided binary allows to access to /dev/console for PC speaker control
* cty.dat - Follows up information to tucnakdw. Tucnak don't write to this file. The file is read from directories /etc/ and ~/tucnak/.
 
* tucnakwiz - this file contains information about contest as kind of pointing, etc. Tucnak doesn't write to this file. The file is read from /etc/ and ~/tucnak/.
 
* tucnakcor - (since 1.00). It's readed from ~/tucnak. When it fails then it's read from /usr(/local)/share1/tucnak/. It's data for generating the polar world wide map.
 
  
 +
=Configuration=
 +
==~/tucnak/tucnakrc==
 +
Configuration file of Tucnak program. When it don't found configuration file it reads from internal hardcoded default.
 +
==tucnakrc.local==
 +
This file has the same structure as tucnakrc file. Is determine to set specific local options. Tucnak only reads this file after loading tucnakrc. It is necessary to create and maintain it manually.
 +
 +
=Call-WWL database=
 +
==tucnakcw==
 +
File with apair callsign-locator. Each callsign has saved maximally two locators. Format is similar to Taclog's taclog.c_w but not same when one call has two wwls. Format is:
 +
CALL WWL YYYYMMDD QRV
 +
f.e.
 +
DR5A JO30EM 20071006 CEGHK
 +
Second locator is saved as next line.
 +
 +
=DXC files & others=
 +
All these files are optional. Tucnak is reading these when are existing, in other case uses own hardcoded defaults.
 +
==~/tucnak/tucnakdw==
 +
File with information about DXCC countries. Each country has saved information about possible large squares and centre of activity in the country. Tucnak doesn't write to this file.
 +
Format of file is:
 +
 +
# 1th row - The official prefix of the DXCC                                                                                         
 +
# 2nd row - The list of WWL in the DXCC (separated by a gap).                                                                       
 +
#          The first WWL is the most effective one or midlands                                                                     
 +
#          or Capital City of DXCC.                                                                                               
 +
# 3rd row - The most effective WWL from JN69UO                                                                                     
 +
# There is a free row between DXCC's                                                                                               
 +
#
 +
 +
OK                                                                                                                                 
 +
JN79 JO70 JO60 JO80 JO90 JN69 JN89 JN99 JN68 JN78 JN88 JN98 JO71                                                                   
 +
JN89JM JO80IA                                                                                                                       
 +
                                                                                                                                   
 +
==~/tucnak/cty.dat==
 +
Follows up information to tucnakdw. Tucnak doesn't write to this file. You can download new version from http://www.country-files.com/cty/index.htm and place it into ~/tucnak.
 +
 +
==~/tucnak/tucnakwiz==
 +
This file contains information about contest as kind of pointing, etc. Tucnak doesn't write to this file.
 +
 +
=Contest files=
 
Each contest is saved to differed directory. Name of directories is created from date of contest e.g. ~/tucnak/2003083.1. It is possible to have many contest in one day or one contest on one computer under one user (thought telnet, ssh) with many running Tucnaks. Each contest with the same date has different number behind point.
 
Each contest is saved to differed directory. Name of directories is created from date of contest e.g. ~/tucnak/2003083.1. It is possible to have many contest in one day or one contest on one computer under one user (thought telnet, ssh) with many running Tucnaks. Each contest with the same date has different number behind point.
  

Revision as of 10:18, 17 November 2007

Remark: Character ~ (tilde) is short cut of user home directory (bash# echo $HOME).

Files which are described below are saved in plain text format. Is possible to edit these files but it is necessary to keep format of files. In other case Tucnak shouldn't work properly.

Binaries

tucnak

Is one binary file. If Tucnak is install from source code it's installed to /usr/local/bin. If Tucnak is install from package it's installed to /usr/bin mostly. On Debian it's /usr/bin/tucnak2 and command tucnak2 is found via /etc/alternatives.

soundwrapper

Suided binary allows to access to /dev/console for PC speaker control

Configuration

~/tucnak/tucnakrc

Configuration file of Tucnak program. When it don't found configuration file it reads from internal hardcoded default.

tucnakrc.local

This file has the same structure as tucnakrc file. Is determine to set specific local options. Tucnak only reads this file after loading tucnakrc. It is necessary to create and maintain it manually.

Call-WWL database

tucnakcw

File with apair callsign-locator. Each callsign has saved maximally two locators. Format is similar to Taclog's taclog.c_w but not same when one call has two wwls. Format is:

CALL WWL YYYYMMDD QRV

f.e.

DR5A JO30EM 20071006 CEGHK

Second locator is saved as next line.

DXC files & others

All these files are optional. Tucnak is reading these when are existing, in other case uses own hardcoded defaults.

~/tucnak/tucnakdw

File with information about DXCC countries. Each country has saved information about possible large squares and centre of activity in the country. Tucnak doesn't write to this file. Format of file is:

# 1th row - The official prefix of the DXCC                                                                                          
# 2nd row - The list of WWL in the DXCC (separated by a gap).                                                                        
#           The first WWL is the most effective one or midlands                                                                      
#           or Capital City of DXCC.                                                                                                 
# 3rd row - The most effective WWL from JN69UO                                                                                       
# There is a free row between DXCC's                                                                                                 
#

OK                                                                                                                                   
JN79 JO70 JO60 JO80 JO90 JN69 JN89 JN99 JN68 JN78 JN88 JN98 JO71                                                                     
JN89JM JO80IA                                                                                                                        
                                                                                                                                    

~/tucnak/cty.dat

Follows up information to tucnakdw. Tucnak doesn't write to this file. You can download new version from http://www.country-files.com/cty/index.htm and place it into ~/tucnak.

~/tucnak/tucnakwiz

This file contains information about contest as kind of pointing, etc. Tucnak doesn't write to this file.

Contest files

Each contest is saved to differed directory. Name of directories is created from date of contest e.g. ~/tucnak/2003083.1. It is possible to have many contest in one day or one contest on one computer under one user (thought telnet, ssh) with many running Tucnaks. Each contest with the same date has different number behind point.

Files in ~/tucnak/<date>:

  • <letter>.txt e.g. c.txt, e.txt. This files are main files for individual bands. Files use information about station, QTH, points of both finished and unfinished contacts. Format is compatible with EDI format and should be accepted by organizer of contest. Files has DOS end of line (`\n' `\r').
  • <letter>.swp eg. c.swp, e.swp. are files where is saved all typed text from input line ended by enter key. You are able to reconstruct all reports manually from this file. desc - contains information displayed during start of contest as date of contest, callsign and name of contest.
  • desc - contains information displayed in start of contest as date of contest, callsign and name of contest.
  • log - content of log window.
  • sked - information about received skeds
  • talk - content of talk window. That's good idea to read after contest :-).

Band's label are marked according to EDI format e.g. `50 MHz', `70 MHz', ..... `248 GHz'. All bands has assigned one letter label which is used on place where isn't enough place.