Back to index

citadel  8.12
Functions | Variables
server_main.c File Reference
#include "sysdep.h"
#include <stdlib.h>
#include <unistd.h>
#include <stdio.h>
#include <fcntl.h>
#include <ctype.h>
#include <signal.h>
#include <sys/types.h>
#include <sys/stat.h>
#include <sys/wait.h>
#include <sys/socket.h>
#include <syslog.h>
#include <time.h>
#include <limits.h>
#include <netinet/in.h>
#include <netdb.h>
#include <sys/un.h>
#include <string.h>
#include <pwd.h>
#include <errno.h>
#include <stdarg.h>
#include <grp.h>
#include <libcitadel.h>
#include "citadel.h"
#include "server.h"
#include "serv_extensions.h"
#include "sysdep_decls.h"
#include "threads.h"
#include "citserver.h"
#include "support.h"
#include "config.h"
#include "control.h"
#include "database.h"
#include "user_ops.h"
#include "housekeeping.h"
#include "svn_revision.h"
#include "citadel_dirs.h"
#include "context.h"
#include "modules_init.h"
#include "ecrash.h"
#include "snprintf.h"

Go to the source code of this file.

Functions

void go_threading (void)
int main (int argc, char **argv)

Variables

const char * CitadelServiceUDS = "citadel-UDS"
const char * CitadelServiceTCP = "citadel-TCP"

Function Documentation

void go_threading ( void  )

Definition at line 193 of file threads.c.

{
       if (pthread_key_create(&ThreadKey, NULL) != 0) {
              syslog(LOG_EMERG, "pthread_key_create() : %s", strerror(errno));
              abort();
       }

       /* Second call to module init functions now that threading is up */
       initialise_modules(1);

       /* Begin with one worker thread.  We will expand the pool if necessary */
       CtdlThreadCreate(worker_thread);

       /* The supervisor thread monitors worker threads and spawns more of them if it finds that
        * they are all in use.  FIXME make the 256 max threads a configurable value.
        */
       while (!server_shutting_down) {
              if ((active_workers == num_workers) && (num_workers < 256)) {
                     CtdlThreadCreate(worker_thread);
              }
              usleep(1000);
       }

       /* When we get to this point we are getting ready to shut down our Citadel server */
       if (!EventQShuttingDown)
       {
              EventQShuttingDown = 1;
              ShutDownEventQueues();
       }
       while (!EVQShutDown)
              usleep(1000);


       terminate_all_sessions();          /* close all client sockets */
       CtdlShutdownServiceHooks();        /* close all listener sockets to prevent new connections */
       PerformSessionHooks(EVT_SHUTDOWN); /* run any registered shutdown hooks */

       int countdown = 30;
       while ( (num_workers > 0) && (countdown-- > 0)) {
              syslog(LOG_DEBUG, "Waiting %d seconds for %d worker threads to exit",
                     countdown, num_workers
              );
              usleep(1000);
       }
}

Here is the caller graph for this function:

int main ( int  argc,
char **  argv 
)

Definition at line 90 of file server_main.c.

{
       char facility[32];
       int a;               /* General-purpose variables */
       struct passwd pw, *pwp = NULL;
       char pwbuf[SIZ];
       int drop_root_perms = 1;
       int relh=0;
       int home=0;
       int dbg=0;
       char relhome[PATH_MAX]="";
       char ctdldir[PATH_MAX]=CTDLDIR;
       int syslog_facility = LOG_DAEMON;
       const char *eDebuglist[] = {NULL, NULL};
#ifdef HAVE_RUN_DIR
       struct stat filestats;
#endif
#ifdef HAVE_BACKTRACE
       eCrashParameters params;
//     eCrashSymbolTable symbol_table;
#endif

       /* initialize the master context */
       InitializeMasterCC();
       InitializeMasterTSD();

       /* parse command-line arguments */
       while ((a=getopt(argc, argv, "l:dh:x:t:Dr")) != EOF) switch(a) {

              case 'l':
                     safestrncpy(facility, optarg, sizeof(facility));
                     syslog_facility = SyslogFacility(facility);
                     break;

              /* run in the background if -d was specified */
              case 'd':
                     running_as_daemon = 1;
                     break;

              case 'h':
                     relh = optarg[0] != '/';
                     if (!relh) {
                            safestrncpy(ctdl_home_directory, optarg, sizeof ctdl_home_directory);
                     }
                     else {
                            safestrncpy(relhome, optarg, sizeof relhome);
                     }
                     home=1;
                     break;

              case 'x':
                     eDebuglist [0] = optarg;
                     break;

              case 't':     /* deprecated */
                     break;

              case 'D':
                     dbg = 1;
                     break;

              /* -r tells the server not to drop root permissions.
               * Don't use this unless you know what you're doing.
               */
              case 'r':
                     drop_root_perms = 0;
                     break;

              default:
              /* any other parameter makes it crash and burn */
                     fprintf(stderr,      "citserver: usage: "
                                   "citserver "
                                   "[-l LogFacility] "
                                   "[-d] [-D] [-r] "
                                   "[-h HomeDir]\n"
                     );
                     exit(1);
       }

       openlog("citserver",
              ( running_as_daemon ? (LOG_PID) : (LOG_PID | LOG_PERROR) ),
              syslog_facility
       );

       calc_dirs_n_files(relh, home, relhome, ctdldir, dbg);
       /* daemonize, if we were asked to */
       if (running_as_daemon) {
              start_daemon(0);
              drop_root_perms = 1;
       }

#ifdef HAVE_BACKTRACE
       bzero(&params, sizeof(params));
       params.filename = file_pid_paniclog;
       panic_fd=open(file_pid_paniclog, O_APPEND|O_CREAT|O_DIRECT);
       params.filep = fopen(file_pid_paniclog, "a+");
       params.debugLevel = ECRASH_DEBUG_VERBOSE;
       params.dumpAllThreads = TRUE;
       params.useBacktraceSymbols = 1;
       params.signals[0]=SIGSEGV;
       params.signals[1]=SIGILL;
       params.signals[2]=SIGBUS;
       params.signals[3]=SIGABRT;
       eCrash_Init(&params);
       eCrash_RegisterThread("MasterThread", 0);
#endif

       /* Tell 'em who's in da house */
       syslog(LOG_NOTICE, " ");
       syslog(LOG_NOTICE, " ");
       syslog(LOG_NOTICE,
              "*** Citadel server engine v%d.%02d (build %s) ***",
              (REV_LEVEL/100), (REV_LEVEL%100), svn_revision());
       syslog(LOG_NOTICE, "Copyright (C) 1987-2012 by the Citadel development team.");
       syslog(LOG_NOTICE, "This program is distributed under the terms of the GNU "
                                   "General Public License.");
       syslog(LOG_NOTICE, " ");
       syslog(LOG_DEBUG, "Called as: %s", argv[0]);
       syslog(LOG_INFO, "%s", libcitadel_version_string());

       /* Load site-specific configuration */
       syslog(LOG_INFO, "Loading citadel.config");
       get_config();

       /* get_control() MUST MUST MUST be called BEFORE the databases are opened!! */
       syslog(LOG_INFO, "Acquiring control record");
       get_control();

       put_config();

#ifdef HAVE_RUN_DIR
       /* on some dists rundir gets purged on startup. so we need to recreate it. */

       if (stat(ctdl_run_dir, &filestats)==-1){
#ifdef HAVE_GETPWUID_R
#ifdef SOLARIS_GETPWUID
              pwp = getpwuid_r(config.c_ctdluid, &pw, pwbuf, sizeof(pwbuf));
#else // SOLARIS_GETPWUID
              getpwuid_r(config.c_ctdluid, &pw, pwbuf, sizeof(pwbuf), &pwp);
#endif // SOLARIS_GETPWUID
#else // HAVE_GETPWUID_R
              pwp = NULL;
#endif // HAVE_GETPWUID_R

              if ((mkdir(ctdl_run_dir, 0755) != 0) && (errno != EEXIST))
                     syslog(LOG_EMERG, 
                                  "unable to create run directory [%s]: %s", 
                                  ctdl_run_dir, strerror(errno));

              if (chown(ctdl_run_dir, config.c_ctdluid, (pwp==NULL)?-1:pw.pw_gid) != 0)
                     syslog(LOG_EMERG, 
                                  "unable to set the access rights for [%s]: %s", 
                                  ctdl_run_dir, strerror(errno));
       }
                     

#endif

       /* Initialize... */
       init_sysdep();

       /*
        * Do non system dependent startup functions.
        */
       master_startup();

       /*
        * Check that the control record is correct and place sensible values if it isn't
        */
       check_control();
       
       /*
        * Run any upgrade entry points
        */
       syslog(LOG_INFO, "Upgrading modules.");
       upgrade_modules();
       
/*
 * Load the user for the masterCC or create them if they don't exist
 */
       if (CtdlGetUser(&masterCC.user, "SYS_Citadel"))
       {
              /* User doesn't exist. We can't use create user here as the user number needs to be 0 */
              strcpy (masterCC.user.fullname, "SYS_Citadel") ;
              CtdlPutUser(&masterCC.user);
              CtdlGetUser(&masterCC.user, "SYS_Citadel"); /* Just to be safe */
       }
       
       /*
        * Bind the server to a Unix-domain socket (user client access)
        */
       CtdlRegisterServiceHook(0,
                            file_citadel_socket,
                            citproto_begin_session,
                            do_command_loop,
                            do_async_loop,
                            CitadelServiceUDS);

       /*
        * Bind the server to a Unix-domain socket (admin client access)
        */
       CtdlRegisterServiceHook(0,
                            file_citadel_admin_socket,
                            citproto_begin_admin_session,
                            do_command_loop,
                            do_async_loop,
                            CitadelServiceUDS);
       chmod(file_citadel_admin_socket, S_IRWXU);       /* for your eyes only */

       /*
        * Bind the server to our favorite TCP port (usually 504).
        */
       CtdlRegisterServiceHook(config.c_port_number,
                            NULL,
                            citproto_begin_session,
                            do_command_loop,
                            do_async_loop,
                            CitadelServiceTCP);

                            
       
       
       /*
        * Load any server-side extensions available here.
        */
       syslog(LOG_INFO, "Initializing server extensions");
       
       initialise_modules(0);

       eDebuglist[1] = getenv("CITADEL_LOGDEBUG");
       CtdlSetDebugLogFacilities(eDebuglist, 2);

       /*
        * If we need host auth, start our chkpwd daemon.
        */
       if (config.c_auth_mode == AUTHMODE_HOST) {
              start_chkpwd_daemon();
       }


       /*
        * check, whether we're fired up another time after a crash.
        * if, post an aide message, so the admin has a chance to react.
        */
       checkcrash ();


       /*
        * Now that we've bound the sockets, change to the Citadel user id and its
        * corresponding group ids
        */
       if (drop_root_perms) {
              cdb_chmod_data();    /* make sure we own our data files */

#ifdef HAVE_GETPWUID_R
#ifdef SOLARIS_GETPWUID
              pwp = getpwuid_r(config.c_ctdluid, &pw, pwbuf, sizeof(pwbuf));
#else // SOLARIS_GETPWUID
              getpwuid_r(config.c_ctdluid, &pw, pwbuf, sizeof(pwbuf), &pwp);
#endif // SOLARIS_GETPWUID
#else // HAVE_GETPWUID_R
              pwp = NULL;
#endif // HAVE_GETPWUID_R

              if (pwp == NULL)
                     syslog(LOG_CRIT, "WARNING: getpwuid(%ld): %s"
                               "Group IDs will be incorrect.\n", (long)CTDLUID,
                            strerror(errno));
              else {
                     initgroups(pw.pw_name, pw.pw_gid);
                     if (setgid(pw.pw_gid))
                            syslog(LOG_CRIT, "setgid(%ld): %s", (long)pw.pw_gid,
                                   strerror(errno));
              }
              syslog(LOG_INFO, "Changing uid to %ld", (long)CTDLUID);
              if (setuid(CTDLUID) != 0) {
                     syslog(LOG_CRIT, "setuid() failed: %s", strerror(errno));
              }
#if defined (HAVE_SYS_PRCTL_H) && defined (PR_SET_DUMPABLE)
              prctl(PR_SET_DUMPABLE, 1);
#endif
       }

       /* We want to check for idle sessions once per minute */
       CtdlRegisterSessionHook(terminate_idle_sessions, EVT_TIMER, PRIO_CLEANUP + 1);

       go_threading();
       
       master_cleanup(exit_signal);
       return(0);
}

Here is the call graph for this function:


Variable Documentation

const char* CitadelServiceTCP = "citadel-TCP"

Definition at line 81 of file server_main.c.

const char* CitadelServiceUDS = "citadel-UDS"

Definition at line 80 of file server_main.c.