home *** CD-ROM | disk | FTP | other *** search
/ TAP YIPL / TAP_and_YIPL_Collection_CD.iso / PHREAK / GENERAL / THC_TS10.ZIP / DATFILE.DOC < prev    next >
Text File  |  1996-05-01  |  5KB  |  126 lines
  1. /******************************************************************************
  2.  *
  3.  * NOTE
  4.  * 
  5.  * This textfile describes the structure of the THC-SCAN DATFILE.
  6.  * You can rename it to THC-SCAN.H and use it as an C Header File.
  7.  * If you are programming nice tools for THC-SCAN you can write me an email
  8.  * to vh@campus.de and send me the program. If it is good i'll include it
  9.  * into the next version.
  10.  *
  11.  * 
  12.  * The structure of the DataFile :
  13.  *
  14.  * Byte  1 &  2  are shortcuts of the program -> TS
  15.  * Byte  3 &  4  is the versionnumber of THC-SCAN
  16.  * Byte  5 - 27  this is the dialmask used for the scan
  17.  * Byte    28    scanmode used (see below: Scanmode numbers)
  18.  * Byte 29 - 30  minutes used for scanning altogether in this DAT file
  19.  * Byte 31 - 32  <Reserved>
  20.  * Byte 33 - 10032 are the data for the numbers (see below: Data structure)
  21.  *                (the size of the datfile is either 42(one X in the dialmask),
  22.  *                 132(XX),1032(XXX) or 10032(XXXX) bytes)
  23.  *  
  24.  * 
  25.  * Scanmode Numbers (byte no. 28) : 
  26.  *    0  -  not defined. (THC-SCAN version before 0.8a or converted TL datfile)
  27.  *    1  -  Carrier Scan Mode used.
  28.  *    2  -  Tone Scan Mode used.
  29.  *    3  -  Carrier Scan Mode + Autonom/Manual Mode used.
  30.  *    4  -  Tone Scan Mode + Autonom/Manual Mode used.
  31.  *
  32.  *
  33.  *
  34.  * Data Structure : Each byte-33 refers to phonenumber Ending. 1 Byte = 1 Number
  35.  * Byte 33 = 0000, Byte 34 = 0001, etc.
  36.  *
  37.  *
  38.  * IDentifications
  39.  *    0 # UnDialed
  40.  *    1 # OutRanged 
  41.  *    8 * Busy     (1)
  42.  *   16 # Excluded
  43.  *   24   Uninteresting
  44.  *   32 * Timeout
  45.  *   40 * Ringout
  46.  *   48 # Unused (Not available) number
  47.  *   56   Manual Dialed (AUTONOM MODE used)
  48.  *   64 * Carrier (autonom identified mode or a lost carriers)
  49.  *   72 * Carrier with Connect Data
  50.  *   80 * Carrier with Connect Data & Auto Hack Mode was enganged
  51.  *   88   Carrier with Connect Data & Manual Hack Mode was enganged
  52.  *   96   Carrier & Auto Hack Mode was enganged   [not in use by now]
  53.  *  104   Carrier & Manual Hack Mode was enganged [not in use by now]
  54.  *  112      <reserved>
  55.  *  120 * Fax
  56.  *  128 # Voice (standard/other)
  57.  *  136   Voice Interesting
  58.  *  144   Voice Girl
  59.  *  152   Voice Asshole
  60.  *  160      <reserved>
  61.  *  168 * Tone (standard)
  62.  *  176   Tone (manually mode done)               [in use now!]
  63.  *  184      <reserved>
  64.  *  192 # VMB (standard)
  65.  *  200   VMB (manually mode done)                [in use now!]
  66.  *  208      <reserved>
  67.  *  216      <reserved>
  68.  *  224 # Customize 1 (manual)
  69.  *  232 # Customize 2 (manual)
  70.  *  240 # Customize 3 (manual)
  71.  *  248 # Unkown/Auto-Done (the other side picked up, and hanged up again later)
  72.  *
  73.  *  * means the program can do this identification automatically 
  74.  *    if correctly set & configured & modem supports it
  75.  *  # those can be indirectly identified or are set by program init.
  76.  *    Not every modem can do this, nor can every user make it out how to do it ;-)
  77.  *  All others must be identified manually.   
  78.  *
  79.  * As you can notice, the step range is 8 ... this is for the rings.
  80.  * If 0-7 rings were detected on that numbers, this number is added the ID code.
  81.  * If the ring counter is greater as 7, it will be reset to 7.
  82.  * Example : 123 is a Fax which had 3 rings.
  83.  *
  84.  * (1) For BUSY this is special. If READIAL-BUSY in the config menu is set or
  85.  * you scan with  -*:8x  then for every try which was dialed with the result of
  86.  * busy, it will increase by one. when it has reached 7 (15 in the datafile)
  87.  * it won't never be dialed again. The only possibility to dial this is by
  88.  * directly scanning them with -*:15 
  89.  *
  90.  ******************************************************************************/
  91.  
  92. typedef unsigned char byte;
  93. typedef unsigned int  word;
  94.  
  95. struct thcscan_datfile_header {
  96.   /* Header 32 bytes */
  97.     char  ProgramUsed[2];      /* 'TS' for THC-SCAN     */
  98.     byte  ReleaseNo;           /* 0x00 = 0.    would be */  
  99.     byte  RevisionNo;          /* 0x09 = .9      v0.9   */  
  100.     char  Dialmask[23];        /* Dialmask used         */
  101.     byte  ModeUsed;            /* Scanmode used with Datfile (see above)    */
  102.     word  Minutes;             /* Minutes spent on scanning on this Datfile */
  103.     byte  Reserved[2];         /* Reserved Bytes for future use             */
  104.   /* Data is not defined here because this can be byte[10] to byte[10000]   */
  105.   /* (use  byte[10000] Data;  and  word DataSize; )                         */
  106. };
  107.  
  108.  
  109. /*
  110.    {* Structure record for TURBO PASCAL added by THE ANALYST *}
  111.    Var thcscan_datfile_header : record
  112.                                    ProgramUsed : array[1..2] of char;
  113.                                    ReleaseNo   : byte;
  114.                                    RevisionNo  : byte;
  115.                                    Dialmask    : array[1..23] of char;
  116.                                    ModeUsed    : byte;
  117.                                    Minutes     : word;
  118.                                    Reserved    : array[1..2] of byte;
  119.                                 end;
  120.    {* thcscan_datfile_data is array[0..x] of byte, where x is either *}
  121.    {* 9, 99, 999 or 9999. (use 9999 and a size pointer)              *}
  122. */
  123.  
  124.  
  125. /* End Of File */
  126.