lbbs/include/user_list.h

/* SPDX-License-Identifier: GPL-3.0-or-later */
/*
 * user_list
 *   - data model and basic operations of (online) user list
 *
 * Copyright (C) 2004-2025  Leaflet <leaflet@leafok.com>
 */

#ifndef _USER_LIST_H_
#define _USER_LIST_H_

#include "bbs.h"
#include "common.h"
#include <mysql.h>

enum user_list_constant_t
{
        BBS_user_limit_per_page = 20,
        BBS_session_id_length = 32,

        BBS_user_intro_avg_len = 256,
        BBS_user_intro_max_len = 4096,
        BBS_user_intro_max_line = 10,
};

struct user_info_t
{
        int32_t id;
        int32_t uid;
        char username[BBS_username_max_len + 1];
        char nickname[BBS_nickname_max_len + 1];
        char gender;
        int8_t gender_pub;
        int32_t life;
        int32_t exp;
        int32_t visit_count;
        time_t signup_dt;
        time_t last_login_dt;
        time_t last_logout_dt;
        time_t birthday;
        const char *intro;
};
typedef struct user_info_t USER_INFO;

struct user_info_index_uid_t
{
        int32_t uid;
        int32_t id;
};
typedef struct user_info_index_uid_t USER_INFO_INDEX_UID;

struct user_list_t
{
        USER_INFO users[BBS_max_user_count];
        USER_INFO_INDEX_UID index_uid[BBS_max_user_count];
        int32_t user_count;
        char user_intro_buf[BBS_user_intro_avg_len * BBS_max_user_count];
};
typedef struct user_list_t USER_LIST;

struct user_online_info_t
{
        int32_t id;
        char session_id[BBS_session_id_length + 1];
        USER_INFO user_info;
        char ip[IP_ADDR_LEN];
        char current_action[BBS_current_action_max_len + 1];
        const char *current_action_title;
        time_t login_tm;
        time_t last_tm;
};
typedef struct user_online_info_t USER_ONLINE_INFO;

struct user_online_list_t
{
        USER_ONLINE_INFO users[BBS_max_user_online_count];
        USER_INFO_INDEX_UID index_uid[BBS_max_user_online_count];
        int32_t user_count;
        int32_t guest_count;
};
typedef struct user_online_list_t USER_ONLINE_LIST;

extern int user_list_pool_init(const char *filename);
extern int user_list_pool_cleanup(void);
extern int set_user_list_pool_shm_readonly(void);
extern int detach_user_list_pool_shm(void);

extern int user_list_pool_reload(int online_user);

extern int query_user_list(int page_id, USER_INFO *p_users, int *p_user_count, int *p_page_count);
extern int query_user_online_list(int page_id, USER_ONLINE_INFO *p_online_users, int *p_user_count, int *p_page_count);

extern int get_user_list_count(int *p_user_cnt);
extern int get_user_online_list_count(int *p_user_cnt, int *p_guest_cnt);
extern int get_user_login_count(int *p_login_cnt);

extern int query_user_info(int32_t id, USER_INFO *p_user);
extern int query_user_info_by_uid(int32_t uid, USER_INFO *p_user, char *p_intro_buf, size_t intro_buf_len);
extern int query_user_info_by_username(const char *username_prefix, int max_user_cnt,
                                                                           int32_t uid_list[], char username_list[][BBS_username_max_len + 1]);

extern int query_user_online_info(int32_t id, USER_ONLINE_INFO *p_user);
extern int query_user_online_info_by_uid(int32_t uid, USER_ONLINE_INFO *p_users, int *p_user_cnt, int start_id);

extern int get_user_id_list(int32_t *p_uid_list, int *p_user_cnt, int start_uid);

extern int user_stat_update(void);
extern int user_article_cnt_inc(int32_t uid, int n);
extern int get_user_article_cnt(int32_t uid);

#endif //_USER_LIST_H_
1	sysadm	1.21	/* SPDX-License-Identifier: GPL-3.0-or-later */
2			/*
3			* user_list
4			* - data model and basic operations of (online) user list
5			*
6	sysadm	1.22	* Copyright (C) 2004-2025 Leaflet <leaflet@leafok.com>
7	sysadm	1.21	*/
8	sysadm	1.1
9			#ifndef _USER_LIST_H_
10			#define _USER_LIST_H_
11
12			#include "bbs.h"
13	sysadm	1.13	#include "common.h"
14	sysadm	1.24	#include <mysql.h>
15	sysadm	1.1
16	sysadm	1.23	enum user_list_constant_t
17			{
18			BBS_user_limit_per_page = 20,
19			BBS_session_id_length = 32,
20	sysadm	1.2
21	sysadm	1.23	BBS_user_intro_avg_len = 256,
22			BBS_user_intro_max_len = 4096,
23			BBS_user_intro_max_line = 10,
24			};
25	sysadm	1.10
26	sysadm	1.1	struct user_info_t
27			{
28	sysadm	1.6	int32_t id;
29	sysadm	1.1	int32_t uid;
30			char username[BBS_username_max_len + 1];
31			char nickname[BBS_nickname_max_len + 1];
32			char gender;
33			int8_t gender_pub;
34			int32_t life;
35			int32_t exp;
36	sysadm	1.10	int32_t visit_count;
37	sysadm	1.1	time_t signup_dt;
38			time_t last_login_dt;
39	sysadm	1.16	time_t last_logout_dt;
40	sysadm	1.1	time_t birthday;
41	sysadm	1.10	const char *intro;
42	sysadm	1.1	};
43			typedef struct user_info_t USER_INFO;
44
45	sysadm	1.6	struct user_info_index_uid_t
46			{
47			int32_t uid;
48			int32_t id;
49			};
50			typedef struct user_info_index_uid_t USER_INFO_INDEX_UID;
51
52	sysadm	1.1	struct user_list_t
53			{
54			USER_INFO users[BBS_max_user_count];
55	sysadm	1.6	USER_INFO_INDEX_UID index_uid[BBS_max_user_count];
56	sysadm	1.1	int32_t user_count;
57	sysadm	1.10	char user_intro_buf[BBS_user_intro_avg_len * BBS_max_user_count];
58	sysadm	1.1	};
59			typedef struct user_list_t USER_LIST;
60
61	sysadm	1.5	struct user_online_info_t
62			{
63	sysadm	1.6	int32_t id;
64	sysadm	1.5	char session_id[BBS_session_id_length + 1];
65			USER_INFO user_info;
66			char ip[IP_ADDR_LEN];
67			char current_action[BBS_current_action_max_len + 1];
68			const char *current_action_title;
69			time_t login_tm;
70			time_t last_tm;
71			};
72			typedef struct user_online_info_t USER_ONLINE_INFO;
73
74			struct user_online_list_t
75			{
76			USER_ONLINE_INFO users[BBS_max_user_online_count];
77	sysadm	1.9	USER_INFO_INDEX_UID index_uid[BBS_max_user_online_count];
78	sysadm	1.5	int32_t user_count;
79	sysadm	1.18	int32_t guest_count;
80	sysadm	1.5	};
81			typedef struct user_online_list_t USER_ONLINE_LIST;
82	sysadm	1.1
83	sysadm	1.17	extern int user_list_pool_init(const char *filename);
84	sysadm	1.25	extern int user_list_pool_cleanup(void);
85	sysadm	1.1	extern int set_user_list_pool_shm_readonly(void);
86			extern int detach_user_list_pool_shm(void);
87
88	sysadm	1.5	extern int user_list_pool_reload(int online_user);
89	sysadm	1.1
90	sysadm	1.2	extern int query_user_list(int page_id, USER_INFO p_users, int p_user_count, int *p_page_count);
91	sysadm	1.5	extern int query_user_online_list(int page_id, USER_ONLINE_INFO p_online_users, int p_user_count, int *p_page_count);
92	sysadm	1.2
93	sysadm	1.18	extern int get_user_list_count(int *p_user_cnt);
94			extern int get_user_online_list_count(int p_user_cnt, int p_guest_cnt);
95	sysadm	1.19	extern int get_user_login_count(int *p_login_cnt);
96	sysadm	1.18
97	sysadm	1.6	extern int query_user_info(int32_t id, USER_INFO *p_user);
98	sysadm	1.20	extern int query_user_info_by_uid(int32_t uid, USER_INFO p_user, char p_intro_buf, size_t intro_buf_len);
99			extern int query_user_info_by_username(const char *username_prefix, int max_user_cnt,
100			int32_t uid_list[], char username_list[][BBS_username_max_len + 1]);
101	sysadm	1.8
102	sysadm	1.6	extern int query_user_online_info(int32_t id, USER_ONLINE_INFO *p_user);
103	sysadm	1.8	extern int query_user_online_info_by_uid(int32_t uid, USER_ONLINE_INFO p_users, int p_user_cnt, int start_id);
104	sysadm	1.3
105	sysadm	1.13	extern int get_user_id_list(int32_t p_uid_list, int p_user_cnt, int start_uid);
106
107			extern int user_stat_update(void);
108	sysadm	1.15	extern int user_article_cnt_inc(int32_t uid, int n);
109			extern int get_user_article_cnt(int32_t uid);
110	sysadm	1.13
111	sysadm	1.1	#endif //_USER_LIST_H_
webmaster@leafok.com	ViewVC Help
Powered by ViewVC 1.3.0-beta1