Project: Webinterface II - Fidonet (FTN) Messagebase Structure: HMB (Hudson)
| /***************************************************************************\ * msgbase.h - message base header file * ***************************************************************************** * * * mb_lib (msgbase library) v1.00 * * (hudson message base access / manipulation routines) * * * * this c version (c) f.w. van wensveen 1993. all rights reserved. * * original pascal source code (c) richard faasen and in fase productions, * * the netherlands. * * * * first revision: 17/08/1992 * * * \***************************************************************************/ /* first, a c++ fixup ******************************************************/ #ifndef __mb_lib_h #define __mb_lib_h #ifdef __cplusplus extern "c" { #endif /* includes and defines ****************************************************/ #include <dir.h> #define hcr 0x0d /* hard carriage return */ #define scr 0x8d /* soft carriage return */ #define lf 0x0a /* line feed */ #define kludge 0x01 /* kludge denominator */ #define bell 0x07 /* bell character / ring a ding */ #define nokludges 0x00 /* txt_dump shouldn't dump kludges */ #define kludges 0x01 /* txt_dump should dump kludges */ /* critical errors */ #define not_err 0x00 /* no error */ #define mem_err 0x01 /* memory error - out of memory */ #define frd_err 0x02 /* file read error */ #define fwr_err 0x03 /* file write error */ #define fcr_err 0x04 /* file create error */ #define mno_err 0x05 /* message base not open error */ #define irn_err 0x06 /* invalid record no., out of bound */ #define mbc_err 0x07 /* msg base corrupt */ #define ma_deleted 0x01 /* message attributes */ #define ma_unsent 0x02 #define ma_netmail 0x04 #define ma_private 0x08 #define ma_received 0x10 #define ma_unmoved 0x20 #define ma_local 0x40 #define na_kill 0x01 /* hudson netmail attributes */ #define na_sent 0x02 #define na_file 0x04 #define na_crash 0x08 #define na_receipt 0x10 #define na_audit 0x20 #define na_return 0x40 #define nm_private 0x0001 /* opus (*.msg) netmail attributes */ #define nm_crash 0x0002 #define nm_received 0x0004 #define nm_sent 0x0008 #define nm_file 0x0010 #define nm_transit 0x0020 #define nm_orphan 0x0040 #define nm_kill 0x0080 #define nm_local 0x0100 #define nm_hold 0x0200 #define nm_unused 0x4000 #define nm_request 0x0800 #define nm_receipt 0x1000 #define nm_isreceipt 0x2000 #define nm_audit 0x4000 #define nm_updatereq 0x8000 /**************************** c a u t i o n ********************************/ /* the strings in the hudson message base files are all pascal convention */ /* strings - a length byte followed by the actual characters. */ /* i have attempted to maintain this format by defining the strings as a */ /* structure containing a length byte and a character array, but this */ /* lead to too much trouble from the programmers point of view. so the */ /* strings in the following structure are just defined as arrays of chars. */ /* they may only be read from and written to disk using the read and write */ /* functions in this library, which convert the string formats from pascal */ /* to c format and vice versa. they may not be read and written directly!! */ /* writing structures to the message base by any other means than the */ /* functions provided therefore will cause corruption of the message base. */ /***************************************************************************/ typedef struct { /* msginfo.bbs structure definition */ unsigned int low_msg; /* lowest msg # in message base */ unsigned int high_msg; /* highest msg # in message base */ unsigned int total_msgs; /* total # of messages in base */ unsigned int total_on_board [200]; /* number of messages / board */ } msginfo_record; typedef struct { /* msgidx.bbs structure definiton */ int msg_num; /* message # */ unsigned char board; /* board # where msg is stored */ } msgidx_record; typedef char msgtoidx_record [36]; /* msgtoidx.bbs structure def. */ typedef struct { /* msghdr.bbs structure definition */ int msgnum; /* message number */ unsigned int prev_reply; /* msg # of previous reply, 0 if no */ unsigned int next_reply; /* msg # of next reply, 0 if none */ unsigned int times_read; /* # of times msg was read, unused */ unsigned int start_block; /* record # of msg in msgtxt.bbs */ unsigned int num_blocks; /* # of records in msgtxt.bbs */ unsigned int dest_net; /* destination net */ unsigned int dest_node; /* destination node */ unsigned int orig_net; /* origin net */ unsigned int orig_node; /* origin node */ unsigned char dest_zone; /* destination zone */ unsigned char orig_zone; /* origin zone */ unsigned int cost; /* cost (netmail) */ unsigned char msg_attr; /* msg attributes. bits as follows: */ /* 0 : deleted */ /* 1 : unsent */ /* 2 : netmail */ /* 3 : private */ /* 4 : received */ /* 5 : unmoved outgoing echo */ /* 6 : local */ /* 7 : reserved */ unsigned char net_attr; /* netmail attributes. bits follow: */ /* 0 : kill/sent */ /* 1 : sent */ /* 2 : file attach */ /* 3 : crash */ /* 4 : receipt request */ /* 5 : audit request */ /* 6 : is a return receipt */ /* 7 : reserved */ unsigned char board; /* message board # */ char post_time [6]; /* time message was posted */ char post_date [9]; /* date message was posted */ char who_to [36]; /* recipient to whom msg is sent */ char who_from [36]; /* sender who posted message */ char subject [73]; /* subject line of message */ } msghdr_record; typedef struct { /* msgtxt.bbs structure definition */ unsigned char str_len; /* this string is stored in memory */ char str_txt [255]; /* in pascal format to reduce */ } msgtxt_record; /* overhead, so take care! */ /* the strings in the *.msg file header (opus style) aren't pascal type */ /* strings but have the 'normal' asciiz format. */ typedef struct { /* opus-style (*.msg) msg format */ char who_from [36]; /* sender who posted message */ char who_to [36]; /* recipient to whom msg is sent */ char subject [72]; /* subject line of message */ char datetime [20]; /* date/time msg was last edited */ unsigned int times_read; /* # of times message was read */ unsigned int dest_node; /* destination node */ unsigned int orig_node; /* origin node */ unsigned int cost; /* cost to send netmail msg */ unsigned int orig_net; /* origin net */ unsigned int dest_net; /* destination net */ unsigned int dest_zone; /* destination zone (these fields) */ unsigned int orig_zone; /* origin zone (were padded ) */ unsigned int dest_point; /* destination point (with 8 0's ) */ unsigned int orig_point; /* origin point (in fsc-0001 ) */ unsigned int reply_to; /* msg # to which this one replies */ unsigned int attribute; /* msg attributes. bits as follows: */ /* 0 : private */ /* 1 : crash */ /* 2 : received */ /* 3 : sent */ /* 4 : file attached */ /* 5 : in transit */ /* 6 : orphan */ /* 7 : kill when sent */ /* 8 : locak */ /* 9 : hold for pickup */ /* 10 : unused */ /* 11 : file request */ /* 12 : return receipt request */ /* 13 : is a return receipt */ /* 14 : audit request */ /* 15 : file update request */ unsigned int next_reply; /* next msg in reply chain */ } net_record; /* message text is stored as follows: a linked list of records contains */ /* pointers to a msgtxt record. this record contains 255 bytes of message */ /* text. this message text block list (mtbl) can be changed at will. */ /* because the programmer won't work with the 'raw' message text in ram */ /* directly, the string format of the message text is *not* converted. the */ /* text blocks contain the strings in pascal format. */ typedef struct __mtbl__ { /* element of msg text block list */ msgtxt_record * txt; /* pointer to text block */ struct __mtbl__ * next; /* pointer to next struct in list */ } mtbl; typedef mtbl * m_text; /* text handle - ptr to mtbl start */ /* public data *************************************************************/ extern msginfo_record msginfo; /* global msginfo record */ extern int _cdecl errortype; /* indicate type of error occurred */ extern char _cdecl errorstring []; /* printable string with error msg. */ /* macro's and prototypes **************************************************/ /* manipulating message text in memory */ m_text txt_new (char *); /* create new text */ int txt_add (m_text, char *); /* add a line of text */ void txt_dispose (m_text); /* dispose of text */ int txt_dump (m_text, int (*) (char *), unsigned char, unsigned char); /* dump message text */ /* message base file access */ int msg_open (char *); /* open message base */ void msg_close (void); /* close message base */ /* message base file locking */ int msg_lock (char *); /* lock message base */ void msg_unlock (void); /* unlock message base */ /* reading message base */ int msg_read_info (void); /* read msginfo.bbs */ int msg_read_hdr (long, msghdr_record *); /* read msghdr.bbs */ int msg_read_idx (long, msgidx_record *); /* read msgidx.bbs */ int msg_read_toidx (long, msgtoidx_record *); /* the same with */ m_text msg_read_text (msghdr_record *); /* read text 4 spec'd msg */ /* writing message base */ int msg_write_info (void); /* write msginfo.bbs */ int msg_write_hdr (long, msghdr_record *); /* write msghdr.bbs */ int msg_write_idx (long, msgidx_record *); /* write msgidx.bbs */ int msg_write_toidx (long, msgtoidx_record *); /* msgtoidx.bbs */ int msg_write_text (msghdr_record *, m_text); /* new/change txt */ int msg_write_new (msghdr_record *, m_text); /* write new msg */ int msg_kill (long); /* kill message */ /* message manipulation support routines */ long msg_msgnr2recnr (unsigned int); /* convert msg # to rec # */ unsigned int msg_recnr2msgnr (long); /* convert rec # to msg # */ void msg_hdr_clear (msghdr_record *); /* clear header record */ int msg_fixup4d (msghdr_record *, m_text); /* hdr -> @intl */ /* message base search routines */ long msg_firstinboard (unsigned char); /* get # of 1st msg in brd */ long msg_lastinboard (unsigned char); /* get # of last msg in b.*/ long msg_nextinboard (long); /* get # of next msg in b.*/ long msg_previnboard (long); /* get # of prev msg in b.*/ long msg_firstto (msgtoidx_record *); /* get # of 1st msg to.. */ long msg_lastto (msgtoidx_record *); /* get # of last msg to.. */ long msg_nextto (long); /* get # of next msg to.. */ long msg_prevto (long); /* get # of prev msg to.. */ /* netmail search and manipulation support routines */ int net_first (char *); /* get # of first net msg */ int net_last (char *); /* get # of last net msg */ int net_next (char *, int); /* get # of next net msg */ int net_prev (char *, int); /* get # of prev net msg */ void net_hdr_clear (net_record *); /* clear a netmail header */ int net_fixup4d (net_record *, m_text); /* intl/fmpt/topt */ int net_getlastread (char *); /* get *.msg lastread ptr */ int net_setlastread (char *, int); /* set *.msg lastread ptr */ /* reading and writing netmail */ int net_read_hdr (char *, int, net_record *); /* read net. hdr */ m_text net_read_text (char *, int); /* read netmail text */ int net_write (char *, int, net_record *, m_text); /* write net. */ int net_kill (char *, int); /* kill *.msg netmail msg */ /* wrap up the c++ fixup ***************************************************/ #ifdef __cplusplus } #endif #endif /* __mb_lib_h */ /* eof */ |
| © 2003-2024 by Ulrich Schroeter | 02510 | |