| 1 |
/*************************************************************************** |
/* SPDX-License-Identifier: GPL-3.0-or-later */ |
| 2 |
section_list.h - description |
/* |
| 3 |
------------------- |
* section_list |
| 4 |
Copyright : (C) 2004-2025 by Leaflet |
* - data models and basic operations of section and article |
| 5 |
Email : leaflet@leafok.com |
* |
| 6 |
***************************************************************************/ |
* Copyright (C) 2004-2025 Leaflet <leaflet@leafok.com> |
| 7 |
|
*/ |
|
/*************************************************************************** |
|
|
* * |
|
|
* This program is free software; you can redistribute it and/or modify * |
|
|
* it under the terms of the GNU General Public License as published by * |
|
|
* the Free Software Foundation; either version 3 of the License, or * |
|
|
* (at your option) any later version. * |
|
|
* * |
|
|
***************************************************************************/ |
|
| 8 |
|
|
| 9 |
#ifndef _SECTION_LIST_H_ |
#ifndef _SECTION_LIST_H_ |
| 10 |
#define _SECTION_LIST_H_ |
#define _SECTION_LIST_H_ |
| 14 |
#include "menu.h" |
#include "menu.h" |
| 15 |
#include <time.h> |
#include <time.h> |
| 16 |
|
|
| 17 |
#define BBS_article_title_max_len 160 |
enum section_list_constant_t |
| 18 |
#define BBS_article_limit_per_section 50000 |
{ |
| 19 |
#define BBS_article_limit_per_page 20 |
BBS_article_title_max_len = 160, |
| 20 |
|
BBS_article_limit_per_section = 50000, |
| 21 |
|
BBS_article_limit_per_page = 20, |
| 22 |
|
|
| 23 |
#define BBS_ontop_article_limit_per_section 10 |
BBS_ontop_article_limit_per_section = 10, |
| 24 |
|
|
| 25 |
#define ARTICLE_PER_BLOCK 1000 |
BBS_article_count_per_block = 1000, |
| 26 |
|
}; |
| 27 |
|
|
| 28 |
struct article_t |
struct article_t |
| 29 |
{ |
{ |
| 87 |
|
|
| 88 |
extern SECTION_LIST_POOL *p_section_list_pool; |
extern SECTION_LIST_POOL *p_section_list_pool; |
| 89 |
|
|
| 90 |
// article_block_count * ARTICLE_PER_BLOCK should be |
// article_block_count * BBS_article_count_per_block should be |
| 91 |
// no less than BBS_article_limit_per_section * BBS_max_section, |
// no less than BBS_article_limit_per_section * BBS_max_section, |
| 92 |
// in order to allocate enough memory for blocks |
// in order to allocate enough memory for blocks |
| 93 |
extern int article_block_init(const char *filename, int block_count); |
extern int article_block_init(const char *filename, int block_count); |
| 113 |
extern int detach_section_list_shm(void); |
extern int detach_section_list_shm(void); |
| 114 |
|
|
| 115 |
extern SECTION_LIST *section_list_create(int32_t sid, const char *sname, const char *stitle, const char *master_list); |
extern SECTION_LIST *section_list_create(int32_t sid, const char *sname, const char *stitle, const char *master_list); |
| 116 |
|
extern int section_list_update(SECTION_LIST *p_section, const char *sname, const char *stitle, const char *master_list); |
| 117 |
extern void section_list_reset_articles(SECTION_LIST *p_section); |
extern void section_list_reset_articles(SECTION_LIST *p_section); |
| 118 |
extern SECTION_LIST *section_list_find_by_name(const char *sname); |
extern SECTION_LIST *section_list_find_by_name(const char *sname); |
| 119 |
extern SECTION_LIST *section_list_find_by_sid(int32_t sid); |
extern SECTION_LIST *section_list_find_by_sid(int32_t sid); |
| 120 |
extern int get_section_index(SECTION_LIST *p_section); |
extern int get_section_index(SECTION_LIST *p_section); |
| 121 |
|
|
| 122 |
|
// sname could be NULL, or pointer to char[] in size >= sizeof(SECTION_LIST.sname) |
| 123 |
|
// stitle could be NULL, or pointer to char[] in size >= sizeof(SECTION_LIST.stitle) |
| 124 |
|
// master_list could be NULL, or pointer to char[] in size >= sizeof(SECTION_LIST.master_list) |
| 125 |
|
extern int get_section_info(SECTION_LIST *p_section, char *sname, char *stitle, char *master_list); |
| 126 |
|
|
| 127 |
extern int section_list_append_article(SECTION_LIST *p_section, const ARTICLE *p_article_src); |
extern int section_list_append_article(SECTION_LIST *p_section, const ARTICLE *p_article_src); |
| 128 |
extern int section_list_set_article_visible(SECTION_LIST *p_section, int32_t aid, int8_t visible); |
extern int section_list_set_article_visible(SECTION_LIST *p_section, int32_t aid, int8_t visible); |
| 129 |
|
|