/[LeafOK_CVS]/lbbs/include/section_list.h
ViewVC logotype

Diff of /lbbs/include/section_list.h

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.2 by sysadm, Wed May 21 05:36:04 2025 UTC Revision 1.18 by sysadm, Tue May 27 07:21:43 2025 UTC
# Line 16  Line 16 
16    
17  #include "common.h"  #include "common.h"
18  #include "bbs.h"  #include "bbs.h"
19    #include <time.h>
20    
21  #define BBS_article_title_max_len 80  #define BBS_article_title_max_len 80
22    #define BBS_article_limit_per_section 50000
23    #define BBS_article_limit_per_page 20
24    
25  // Limit of articles (including those marked as deleted) per section = BBS_article_limit_per_block * BBS_article_block_limit_per_section  #define ARTICLE_PER_BLOCK 1000
 #define BBS_article_limit_per_block 1000  
 #define BBS_article_block_limit_per_section 50  
26    
27  struct article_t  struct article_t
28  {  {
29          int32_t aid;          int32_t aid;
30          int32_t tid;          int32_t tid;
31            int32_t sid;
32          int32_t cid;          int32_t cid;
33          int32_t uid;          int32_t uid;
34          int32_t prior_aid;          struct article_t *p_prior;               // prior article
35          int32_t next_aid;          struct article_t *p_next;                // next article
36            struct article_t *p_topic_prior; // same topic
37            struct article_t *p_topic_next;  // same topic
38          int8_t visible;          int8_t visible;
39          int8_t excerption;          int8_t excerption;
40          int8_t ontop;          int8_t ontop;
41          int8_t lock;          int8_t lock;
42            int8_t transship;
43          char username[BBS_username_max_len + 1];          char username[BBS_username_max_len + 1];
44          char nickname[BBS_nickname_max_len + 1];          char nickname[BBS_nickname_max_len + 1];
45          char title[BBS_article_title_max_len + 1];          char title[BBS_article_title_max_len + 1];
46            time_t sub_dt;
47  };  };
48  typedef struct article_t ARTICLE;  typedef struct article_t ARTICLE;
49    
50  struct article_block_t  struct section_list_t
 {  
         ARTICLE articles[BBS_article_limit_per_block];  
         int32_t article_count;  
         struct article_block_t *p_next_block;  
 };  
 typedef struct article_block_t ARTICLE_BLOCK;  
   
 struct section_data_t  
51  {  {
52          int32_t sid;          int32_t sid;
53            int32_t class_id;
54            int8_t enable;
55          char sname[BBS_section_name_max_len + 1];          char sname[BBS_section_name_max_len + 1];
56          char stitle[BBS_section_title_max_len + 1];          char stitle[BBS_section_title_max_len + 1];
57          char master_name[BBS_username_max_len + 1];          char master_name[BBS_username_max_len + 1];
58          ARTICLE_BLOCK *p_head_block;          int read_user_level;
59          ARTICLE_BLOCK *p_tail_block;          int write_user_level;
         ARTICLE_BLOCK *p_block[BBS_article_block_limit_per_section];  
         int32_t block_count;  
         int32_t block_head_aid[BBS_article_block_limit_per_section];  
60          int32_t article_count;          int32_t article_count;
61          int32_t delete_count;          int32_t topic_count;
62            int32_t visible_article_count;
63            int32_t visible_topic_count;
64            ARTICLE *p_article_head;
65            ARTICLE *p_article_tail;
66            ARTICLE *p_page_first_article[BBS_article_limit_per_section / BBS_article_limit_per_page];
67            int32_t page_count;
68            int32_t last_page_visible_article_count;
69  };  };
70  typedef struct section_data_t SECTION_DATA;  typedef struct section_list_t SECTION_LIST;
71    
72    // article_block_count * ARTICLE_PER_BLOCK should be
73    // no less than BBS_article_limit_per_section * BBS_max_section,
74    // in order to allocate enough memory for blocks
75    extern int article_block_init(const char *filename, int block_count);
76    extern void article_block_cleanup(void);
77    
78    extern int set_article_block_shm_readonly(void);
79    extern int detach_article_block_shm(void);
80    
81    extern int article_block_reset(void);
82    
83    extern ARTICLE *article_block_find_by_aid(int32_t aid);
84    extern ARTICLE *article_block_find_by_index(int index);
85    
86    extern int32_t article_block_last_aid(void);
87    extern int article_block_article_count(void);
88    
89    extern int article_count_of_topic(int32_t aid);
90    
91    extern int section_list_init(const char *filename);
92    extern void section_list_cleanup(void);
93    
94    extern int set_section_list_shm_readonly(void);
95    extern int detach_section_list_shm(void);
96    
97    extern SECTION_LIST *section_list_create(int32_t sid, const char *sname, const char *stitle, const char *master_name);
98    extern void section_list_reset_articles(SECTION_LIST *p_section);
99    extern SECTION_LIST *section_list_find_by_name(const char *sname);
100    extern SECTION_LIST *section_list_find_by_sid(int32_t sid);
101    extern int get_section_index(SECTION_LIST *p_section);
102    
103    extern int section_list_append_article(SECTION_LIST *p_section, const ARTICLE *p_article_src);
104    extern int section_list_set_article_visible(SECTION_LIST *p_section, int32_t aid, int8_t visible);
105    
106    // *p_page, *p_offset will be set as page / offset of the article with aid in *p_section (including both visible and invisible articles)
107    // *pp_next will be set as pointer to the next article of the article with aid
108    // *pp_next will be set as head article of the section if the article with aid locates at the tail of the section
109    extern ARTICLE *section_list_find_article_with_offset(SECTION_LIST *p_section, int32_t aid, int32_t *p_page, int32_t *p_offset, ARTICLE **pp_next);
110    
111  extern int section_data_pool_init(const char *filename, int article_block_count);  extern int section_list_calculate_page(SECTION_LIST *p_section, int32_t start_aid);
112  extern void section_data_pool_cleanup(void);  extern int section_list_move_topic(SECTION_LIST *p_section_src, SECTION_LIST *p_section_dest, int32_t aid);
113    
114  extern SECTION_DATA *section_data_create(const char *sname, const char *stitle, const char *master_name);  extern int section_list_try_rd_lock(SECTION_LIST *p_section, int wait_sec);
115  extern int section_data_free_block(SECTION_DATA *p_section);  extern int section_list_try_rw_lock(SECTION_LIST *p_section, int wait_sec);
116  extern SECTION_DATA *section_data_find_by_name(const char *sname);  extern int section_list_rd_unlock(SECTION_LIST *p_section);
117    extern int section_list_rw_unlock(SECTION_LIST *p_section);
118  extern int section_data_append_article(SECTION_DATA *p_section, const ARTICLE *p_article);  extern int section_list_rd_lock(SECTION_LIST *p_section);
119  extern ARTICLE *section_data_find_article_by_aid(SECTION_DATA *p_section, int32_t aid);  extern int section_list_rw_lock(SECTION_LIST *p_section);
 extern ARTICLE *section_data_find_article_by_index(SECTION_DATA *p_section, int index);  
 extern int section_data_mark_del_article(SECTION_DATA *p_section, int32_t aid);  

Legend:
Removed lines/characters  
Changed lines/characters
  Added lines/characters
webmaster@leafok.com
 ViewVC Help
Powered by ViewVC 1.3.0-beta1