1 // citserver's main() function lives here.
3 // Copyright (c) 1987-2022 by the citadel.org team
5 // This program is open source software; you can redistribute it and/or modify
6 // it under the terms of the GNU General Public License version 3.
8 // This program is distributed in the hope that it will be useful,
9 // but WITHOUT ANY WARRANTY; without even the implied warranty of
10 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11 // GNU General Public License for more details.
16 #include <sys/types.h>
20 #include <libcitadel.h>
21 #include "citserver.h"
22 #include "svn_revision.h"
23 #include "modules_init.h"
26 #include "serv_extensions.h"
27 #include "citadel_dirs.h"
31 const char *CitadelServiceUDS="citadel-UDS";
32 const char *CitadelServiceTCP="citadel-TCP";
33 int sanity_diag_mode = 0;
36 // Create or remove a lock file, so we only have one Citadel Server running at a time.
37 // Set 'op' to nonzero to lock, zero to unlock.
38 void ctdl_lockfile(int op) {
39 static char lockfilename[PATH_MAX];
43 syslog(LOG_DEBUG, "main: creating lockfile");
44 snprintf(lockfilename, sizeof lockfilename, "%s/citadel.lock", ctdl_run_dir);
45 fp = fopen(lockfilename, "w");
47 syslog(LOG_ERR, "%s: %m", lockfilename);
50 if (flock(fileno(fp), (LOCK_EX|LOCK_NB)) != 0) {
51 syslog(LOG_ERR, "main: cannot lock %s , is another citserver running?", lockfilename);
57 syslog(LOG_DEBUG, "main: removing lockfile");
59 flock(fileno(fp), LOCK_UN);
64 // Here's where it all begins.
65 int main(int argc, char **argv) {
68 int a; // General-purpose variables
69 struct passwd pw, *pwp = NULL;
71 int drop_root_perms = 1;
72 int max_log_level = LOG_INFO;
73 char *ctdldir = CTDLDIR;
74 int syslog_facility = LOG_DAEMON;
76 struct passwd *p = NULL;
78 struct stat filestats;
81 // Tell 'em who's in da house
82 syslog(LOG_INFO, " ");
83 syslog(LOG_INFO, " ");
84 syslog(LOG_INFO, "*** Citadel server engine ***\n");
85 syslog(LOG_INFO, "Version %d (build %s) ***", REV_LEVEL, svn_revision());
86 syslog(LOG_INFO, "Copyright (C) 1987-2022 by the Citadel development team.");
87 syslog(LOG_INFO, " ");
88 syslog(LOG_INFO, "This program is open source software: you can redistribute it and/or");
89 syslog(LOG_INFO, "modify it under the terms of the GNU General Public License, version 3.");
90 syslog(LOG_INFO, " ");
91 syslog(LOG_INFO, "This program is distributed in the hope that it will be useful,");
92 syslog(LOG_INFO, "but WITHOUT ANY WARRANTY; without even the implied warranty of");
93 syslog(LOG_INFO, "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the");
94 syslog(LOG_INFO, "GNU General Public License for more details.");
95 syslog(LOG_INFO, " ");
96 syslog(LOG_INFO, "%s", libcitadel_version_string());
98 // parse command-line arguments
99 while ((a=getopt(argc, argv, "cl:dh:x:t:B:Dru:s:")) != EOF) switch(a) {
101 // test this binary for compatibility and exit
103 fprintf(stderr, "%s: binary compatibility confirmed\n", argv[0]);
107 // identify the desired syslog facility
109 safestrncpy(facility, optarg, sizeof(facility));
110 syslog_facility = SyslogFacility(facility);
113 // run in the background if -d was specified
115 running_as_daemon = 1;
118 // specify the data directory
123 // identify the desired logging severity level
125 max_log_level = atoi(optarg);
140 // -r tells the server not to drop root permissions.
141 // Don't use this unless you know what you're doing.
146 // -u tells the server what uid to run under...
153 p = getpwnam(optarg);
163 // -s tells the server to behave differently during sanity checks
165 sanity_diag_mode = atoi(optarg);
168 // any other parameter makes it crash and burn
170 fprintf(stderr, "citserver: usage: "
181 if (chdir(ctdldir) != 0) {
182 syslog(LOG_ERR, "main: unable to change directory to [%s]: %m", ctdldir);
186 syslog(LOG_INFO, "main: running in data directory %s", ctdldir);
189 if ((ctdluid == 0) && (drop_root_perms == 0)) {
190 fprintf(stderr, "citserver: cannot determine user to run as; please specify -r or -u options\n");
191 exit(CTDLEXIT_UNUSER);
194 // Last ditch effort to determine the user name ... if there's a user called "citadel" then use that
196 p = getpwnam("citadel");
201 p = getpwnam("guest");
211 // initialize the master context
212 InitializeMasterCC();
213 InitializeMasterTSD();
215 setlogmask(LOG_UPTO(max_log_level));
217 ( running_as_daemon ? (LOG_PID) : (LOG_PID | LOG_PERROR) ),
221 // daemonize, if we were asked to
222 if (running_as_daemon) {
227 if ((mkdir(ctdl_run_dir, 0755) != 0) && (errno != EEXIST)) {
228 syslog(LOG_ERR, "main: unable to create run directory [%s]: %m", ctdl_run_dir);
231 if (chown(ctdl_run_dir, ctdluid, (pwp==NULL)?-1:pw.pw_gid) != 0) {
232 syslog(LOG_ERR, "main: unable to set the access rights for [%s]: %m", ctdl_run_dir);
236 init_sysdep(); // Initialize...
237 master_startup(); // Do non system dependent startup functions
238 check_control(); // Check/sanitize/initialize control record, fix user indexes
239 syslog(LOG_INFO, "main: upgrading modules"); // Run any upgrade entry points
242 // Load the user for the masterCC or create them if they don't exist
243 if (CtdlGetUser(&masterCC.user, "SYS_Citadel")) {
244 // User doesn't exist. We can't use create user here as the user number needs to be 0
245 strcpy (masterCC.user.fullname, "SYS_Citadel") ;
246 CtdlPutUser(&masterCC.user);
247 CtdlGetUser(&masterCC.user, "SYS_Citadel"); // Just to be safe
250 // Bind the server to a Unix-domain socket (user client access)
251 CtdlRegisterServiceHook(0,
253 citproto_begin_session,
258 // Bind the server to a Unix-domain socket (admin client access)
259 CtdlRegisterServiceHook(0,
260 file_citadel_admin_socket,
261 citproto_begin_admin_session,
265 chmod(file_citadel_admin_socket, S_IRWXU); // for your eyes only
267 // Bind the server to our favorite TCP port (usually 504).
268 CtdlRegisterServiceHook(CtdlGetConfigInt("c_port_number"),
270 citproto_begin_session,
275 // Load any server-side extensions available here.
276 syslog(LOG_INFO, "main: initializing server extensions");
277 initialise_modules(0);
279 // If we need host auth, start our chkpwd daemon.
280 if (CtdlGetConfigInt("c_auth_mode") == AUTHMODE_HOST) {
281 start_chkpwd_daemon();
284 // check, whether we're fired up another time after a crash.
285 // if, post an aide message, so the admin has a chance to react.
288 // Now that we've bound the sockets, change to the Citadel user id and its corresponding group ids
289 if (drop_root_perms) {
290 cdb_chmod_data(); // make sure we own our data files
291 getpwuid_r(ctdluid, &pw, pwbuf, sizeof(pwbuf), &pwp);
293 syslog(LOG_ERR, "main: WARNING, getpwuid(%ld): %m Group IDs will be incorrect.", (long)CTDLUID);
295 initgroups(pw.pw_name, pw.pw_gid);
296 if (setgid(pw.pw_gid)) {
297 syslog(LOG_ERR, "main: setgid(%ld): %m", (long)pw.pw_gid);
300 syslog(LOG_INFO, "main: changing uid to %ld", (long)CTDLUID);
301 if (setuid(CTDLUID) != 0) {
302 syslog(LOG_ERR, "main: setuid() failed: %m");
304 #if defined (HAVE_SYS_PRCTL_H) && defined (PR_SET_DUMPABLE)
305 prctl(PR_SET_DUMPABLE, 1);
309 // We want to check for idle sessions once per minute
310 CtdlRegisterSessionHook(terminate_idle_sessions, EVT_TIMER, PRIO_CLEANUP + 1);
312 // Go into multithreaded mode. When this call exits, the server is stopping.
315 // Get ready to shut down the server.
316 int exit_code = master_cleanup(exit_signal);
318 if (restart_server) {
319 syslog(LOG_INFO, "main: *** CITADEL SERVER IS RESTARTING ***");
320 execv(argv[0], argv);