home *** CD-ROM | disk | FTP | other *** search
/ PC World 2000 February / PCWorld_2000-02_cd.bin / Software / Servis / FFE / COMM.SWG / 0001_BLUEWAVE.pas next >
Pascal/Delphi Source File  |  1996-09-03  |  11KB  |  262 lines
  1. BlueWave mail packets
  2. ======================
  3.  
  4.  
  5.  
  6.         Naming conventions : BBSID.ddn
  7.                 dd - two letter abbreviation of the day of week.
  8.                 n  - digit, number of packet.
  9.                 Example : MYBBS.MO1.
  10.  
  11.         Mail packet files :
  12.  
  13.         BBSID.INF       - contains user data and BBS configuration.
  14. Purpouse and contents of this file are similar to CONTOL.DAT in QWK
  15. mail packets.
  16.  
  17.         BBSID.MIX       - conference index file. Contains total number,
  18. number of personal messages in each selected conference and start of
  19. conference in message header file.
  20.  
  21.         BBSID.FTI       - message header file. Records are grouped
  22. by conference and also contain offset and length of message text.
  23.  
  24.         BBSID.DAT       - message text file. Text of all messages
  25. in packet without any delimiters between messages. Lines may be
  26. terminated with either CR alone or CR/LF pairs.
  27.  
  28.  
  29.  
  30. Layout of BBSID.INF file
  31.  
  32.         Size
  33. Offset  (Count) Format          Description
  34. ___-----------------------------------------------------------------------
  35. 0000    1       BYTE            BlueWave version number
  36. 0001    13 (5)  ASCIIZ str.     Names of welcome/news files, up to 5
  37.                         Files may not be present in packet
  38. 0042    10      n/a             Unknown
  39. 004C    43      ASCIIZ str.     User real name
  40. 0077    43      ASCIIZ str.     User alias
  41. 00A2    21      ASCIIZ str.     Password
  42.                         Password is forced to upper case and encrypted
  43.                         by adding decimal 10 (0Ah) to each byte
  44. 00B7    1       BYTE            Password usage
  45.                         bit 0           Use password in door
  46.                         bit 1           Use password in reader
  47. 00B8    2       WORD            Zone
  48. 00BA    2       WORD            Net
  49. 00BC    2       WORD            Node
  50. 00BE    2       WORD            Point
  51. 00C0    43      ASCIIZ str.     Sysop name
  52. 00EB    65      ASCIIZ str.     BBS name
  53.                         Left-justified and padded with spaces
  54. 012C    1       BYTE            File request limit
  55.                         0 if file requests disabled
  56. 012D    6       n/a             Unknown
  57. 0133    2       WORD            Door setup flags
  58.                         bit 0           Use door hotkeys
  59.                         bit 1           Use door expert mode
  60.                         bit 2           Unknown
  61.                         bit 3           Use door graphics
  62.                         bit 4           Filter messages from user
  63. 0135    21 (10) ASCIIZ str.     Keywords
  64.                         Forced to upper case
  65. 0207    21 (10) ASCIIZ str.     Filters
  66.                         Forced to upper case
  67. 02D9    80 (3)  ASCIIZ str.     Bundling macros
  68. 03C9    2       WORD            Unknown
  69. 03CB    2       WORD            Netmail credits
  70. 03CD    2       WORD            Netmail debits
  71. 03CF    255     n/a             Unknown
  72. 04CE    80 (?)  see below       Conference description records
  73. ___-----------------------------------------------------------------------
  74.  
  75. Layout of BBSID.INF file conference description records
  76. (one record for each BBS conference )
  77.  
  78.         Size
  79. Offset  (Count) Format          Description
  80. ___-----------------------------------------------------------------------
  81. 0000    6       ASCIIZ str.     Conference number
  82. 0006    21      ASCIIZ str.     Conference name
  83. 001B    50      ASCIIZ str.     Conference description
  84. 004D    1       BYTE            Conference attributes
  85.                         bit 0           Conference selected for download
  86.                         bits 2,1        Reply From: field
  87.                                 = 00            Put user alias
  88.                                 = 01            Put user real name
  89.                                 = 10            Allow to enter any name
  90.                         bits 4,3        Conference type
  91.                                 = 00            Local
  92.                                 = 01            Echo mail
  93.                                 = 10            Netmail
  94.                         bit 5           Write permission
  95.                                 = 0             Read only
  96.                                 = 1             Allowed to enter messages
  97.                         bits 7,6        Message security
  98.                                 = 00            User selected
  99.                                 = 01            Force public
  100.                                 = 10            Force private
  101. 004E    2       n/a             Unknown
  102. -----------------------------------------------------------------------
  103.  
  104. Layout of BBSID.MIX file records
  105. (one record for each selected conference, regardless whether it
  106. contains any messages)
  107.  
  108.         Size
  109. Offset  (Count) Format          Description
  110. -----------------------------------------------------------------------
  111. 0000    6       ASCIIZ str.     Conference number
  112. 0006    2       WORD            Total number of messages
  113. 0008    2       WORD            Number of personal messages
  114. 000A    4       DWORD           Offset of first message in this conference
  115.                                 in message header file (BBSID.FTI)
  116. -----------------------------------------------------------------------
  117.  
  118.  
  119. Layout of BBSID.FTI (message header) file records
  120. (one record for each message in packet)
  121.  
  122.         Size
  123. Offset  (Count) Format          Description
  124. -----------------------------------------------------------------------
  125. 0000    36      ASCIIZ str.     Name of sender ("From" field)
  126. 0024    36      ASCIIZ str.     Name of receiver ("To" field)
  127. 0048    72      ASCIIZ str.     Message subject
  128. 0090    20      ASCIIZ str.     Message date and time
  129.                         Example: "06 Aug 92  22:45:00"
  130.                         Format of date and time string depends
  131.                         from door configuration.
  132. 00A4    2       WORD            Message number
  133. 00A6    2       WORD            Number of previous message in thread
  134.                                 ("Refer")
  135. 00A8    2       WORD            Number of next message in thread
  136.                                 ("See also")
  137. 00AA    4       DWORD           Offset of message text in BBSID.DAT file
  138. 00AE    4       DWORD           Length (in bytes) of message text
  139. 00B2    2       WORD            Message attributes
  140.                         bit 0           Private
  141.                         bit 1           Crash
  142.                         bit 2           Received
  143.                         bit 3           Sent
  144.                         bit 4           File attach
  145.                         bit 5           In transit
  146.                         bit 6           Orphan
  147.                         bit 7           Kill/Sent
  148.                         bit 8           Local
  149.                         bit 9           Hold
  150.                         bit 10          Read
  151.                                 BlueWave mail reader updates this
  152.                                 bit to keep track of read messages
  153.                         bit 11          File request
  154.                         bit 12          Direct
  155.                         bit 13          Replied
  156.                                 BlueWave mail reader updates this
  157.                                 bit to indicate user has replied to
  158.                                 this message
  159.                         bits 15, 14     Unknown
  160. 00B4    2       WORD            Origin zone
  161. 00B6    2       WORD            Origin net
  162. 00B8    2       WORD            Origin node
  163. -----------------------------------------------------------------------
  164.  
  165. BlueWave reply packets
  166. =======================
  167.  
  168.         Naming conventions : Reply packets are named BBSID.NEW.
  169.  
  170.         Reply packet files:
  171.  
  172.         BBSID.UPI       - Upload information file. Contains mail reader
  173. registration number, possibly some other information and reply header
  174. records, if packet contains any replies.
  175.  
  176.         Reply text files (optional)     - ASCII files containing text of
  177. individual replies. BlueWave mail reader creates filenames from conference
  178. number and reply number, for example, 143.001.
  179.  
  180.         BBSID.PDQ (optional)    - Offline configuration data.
  181.  
  182.         BBSID.REQ (optional)    - File requests.
  183.  
  184.  
  185. Layout of BBSID.UPI file
  186.  
  187.         Size
  188. Offset  (Count) Format          Description
  189. -----------------------------------------------------------------------
  190. 0000    9       ASCIIZ str.     Reader registration number
  191. 0009    46      n/a             Unknown
  192. 0037    194 (?) see below       Reply header records
  193. -----------------------------------------------------------------------
  194.  
  195.  
  196. Layout of reply headers in BBSID.UPI file
  197. (one for each reply in packet)
  198.  
  199.         Size
  200. Offset  (Count) Format          Description
  201. -----------------------------------------------------------------------
  202. 0000    36      ASCIIZ str.     Name of sender ("From" field)
  203. 0024    36      ASCIIZ str.     Name of receiver ("To" field)
  204. 0048    72      ASCIIZ str.     Reply subject
  205. 0090    4       DWORD           Reply date and time
  206.                         Unix time stamp (number of seconds since midnight,
  207.                         January 1, 1970, GMT)
  208. 0094    13      ASCIIZ str.     Name of file containing reply text.
  209. 00A1    21      ASCIIZ str.     Name of conference
  210. -----------------------------------------------------------------------
  211.  
  212.  
  213. Offline configuration
  214. ======================
  215.  
  216.         If any changes are made to door configuration offline, BlueWave
  217. mail reader includes BBSID.PDQ file in the reply packet. This file
  218. contains the following information:
  219.  
  220.         Size
  221. Offset  (Count) Format          Description
  222. -----------------------------------------------------------------------
  223. 0000    21 (10) ASCIIZ str.     Keywords
  224.                         Forced to upper case
  225. 00D2    21 (10) ASCIIZ str.     Filters
  226.                         Forced to upper case
  227. 01A4    78 (3)  ASCIIZ str.     Bundling macros
  228. 028E    21      ASCIIZ str.     Password
  229.                         Password is forced to upper case and encrypted
  230.                         by adding decimal 10 (0Ah) to each byte
  231. 02A3    1       BYTE            Password usage
  232.                         bit 0           Use password in door
  233.                         bit 1           Use password in reader
  234. 02A4    2       WORD            Door setup flags
  235.                         bit 0           Use door hotkeys
  236.                         bit 1           Use door expert mode
  237.                         bit 2           Unknown
  238.                         bit 3           Use door graphics
  239.                         bit 4           Filter messages from user
  240. 02A6    21 (?)  ASCIIZ str.     Names of selected conferences
  241. -----------------------------------------------------------------------
  242.  
  243.  
  244. File requests
  245. ==============
  246.  
  247.         If any files are requested, BlueWave mail reader includes
  248. BBSID.REQ file in the reply packet:
  249.  
  250.         Size
  251. Offset  (Count) Format          Description
  252. -----------------------------------------------------------------------
  253. 0000    13 (?)  ASCIIZ str.     Names of requested files
  254. -----------------------------------------------------------------------
  255.  
  256. EXTENSION:???
  257. OCCURENCES:PC
  258. PROGRAMS:Several off-line readers
  259. SEE ALSO:QWK
  260.  
  261.  
  262.