2 * ngIRCd -- The Next Generation IRC Daemon
3 * Copyright (c)2001-2012 Alexander Barton (alex@barton.de) and Contributors.
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation; either version 2 of the License, or
8 * (at your option) any later version.
9 * Please read the file COPYING, README and AUTHORS for more information.
16 * The main program, including the C function main() which is called
17 * by the loader of the operating system.
29 #include <sys/types.h>
35 #if defined(DEBUG) && defined(HAVE_MTRACE)
48 #include "sighandlers.h"
56 static void Show_Version PARAMS(( void ));
57 static void Show_Help PARAMS(( void ));
59 static void Pidfile_Create PARAMS(( pid_t pid ));
60 static void Pidfile_Delete PARAMS(( void ));
62 static void Fill_Version PARAMS(( void ));
64 static void Random_Init PARAMS(( void ));
66 static void Setup_FDStreams PARAMS(( int fd ));
68 static bool NGIRCd_Init PARAMS(( bool ));
72 * The main() function of ngIRCd.
74 * Here all starts: this function is called by the operating system loader,
75 * it is the first portion of code executed of ngIRCd.
77 * @param argc The number of arguments passed to ngIRCd on the command line.
78 * @param argv An array containing all the arguments passed to ngIRCd.
79 * @return Global exit code of ngIRCd, zero on success.
82 main(int argc, const char *argv[])
84 bool ok, configtest = false;
85 bool NGIRCd_NoDaemon = false;
89 #if defined(DEBUG) && defined(HAVE_MTRACE)
90 /* enable GNU libc memory tracing when running in debug mode
91 * and functionality available */
97 NGIRCd_SignalQuit = NGIRCd_SignalRestart = false;
98 NGIRCd_Passive = false;
100 NGIRCd_Debug = false;
103 NGIRCd_Sniffer = false;
105 strlcpy(NGIRCd_ConfFile, SYSCONFDIR, sizeof(NGIRCd_ConfFile));
106 strlcat(NGIRCd_ConfFile, CONFIG_FILE, sizeof(NGIRCd_ConfFile));
110 /* parse conmmand line */
111 for (i = 1; i < argc; i++) {
113 if (argv[i][0] == '-' && argv[i][1] == '-') {
115 if (strcmp(argv[i], "--config") == 0) {
117 /* Ok, there's an parameter left */
118 strlcpy(NGIRCd_ConfFile, argv[i+1],
119 sizeof(NGIRCd_ConfFile));
124 if (strcmp(argv[i], "--configtest") == 0) {
129 if (strcmp(argv[i], "--debug") == 0) {
134 if (strcmp(argv[i], "--help") == 0) {
136 puts(""); Show_Help( ); puts( "" );
139 if (strcmp(argv[i], "--nodaemon") == 0) {
140 NGIRCd_NoDaemon = true;
143 if (strcmp(argv[i], "--passive") == 0) {
144 NGIRCd_Passive = true;
148 if (strcmp(argv[i], "--sniffer") == 0) {
149 NGIRCd_Sniffer = true;
153 if (strcmp(argv[i], "--version") == 0) {
158 else if(argv[i][0] == '-' && argv[i][1] != '-') {
160 for (n = 1; n < strlen(argv[i]); n++) {
163 if (argv[i][n] == 'd') {
168 if (argv[i][n] == 'f') {
169 if (!argv[i][n+1] && i+1 < argc) {
170 /* Ok, next character is a blank */
171 strlcpy(NGIRCd_ConfFile, argv[i+1],
172 sizeof(NGIRCd_ConfFile));
174 /* go to the following parameter */
181 if (argv[i][n] == 'h') {
183 puts(""); Show_Help(); puts("");
187 if (argv[i][n] == 'n') {
188 NGIRCd_NoDaemon = true;
191 if (argv[i][n] == 'p') {
192 NGIRCd_Passive = true;
196 if (argv[i][n] == 's') {
197 NGIRCd_Sniffer = true;
201 if (argv[i][n] == 't') {
206 if (argv[i][n] == 'V') {
212 printf("%s: invalid option \"-%c\"!\n",
213 PACKAGE_NAME, argv[i][n]);
214 printf("Try \"%s --help\" for more information.\n",
222 printf("%s: invalid option \"%s\"!\n",
223 PACKAGE_NAME, argv[i]);
224 printf("Try \"%s --help\" for more information.\n",
230 /* Debug level for "VERSION" command */
231 NGIRCd_DebugLevel[0] = '\0';
234 strcpy(NGIRCd_DebugLevel, "1");
237 if (NGIRCd_Sniffer) {
239 strcpy(NGIRCd_DebugLevel, "2");
244 Show_Version(); puts("");
248 while (!NGIRCd_SignalQuit) {
249 /* Initialize global variables */
250 NGIRCd_Start = time(NULL);
251 (void)strftime(NGIRCd_StartStr, 64,
252 "%a %b %d %Y at %H:%M:%S (%Z)",
253 localtime(&NGIRCd_Start));
255 NGIRCd_SignalRestart = false;
256 NGIRCd_SignalQuit = false;
258 /* Initialize modules, part I */
259 Log_Init(!NGIRCd_NoDaemon);
264 /* Initialize the "main program": chroot environment, user and
266 if (!NGIRCd_Init(NGIRCd_NoDaemon)) {
267 Log(LOG_ALERT, "Fatal: Initialization failed");
271 /* Initialize modules, part II: these functions are eventually
272 * called with already dropped privileges ... */
278 if (!io_library_init(CONNECTION_POOL)) {
280 "Fatal: Could not initialize IO routines: %s",
285 if (!Signals_Init()) {
287 "Fatal: Could not set up signal handlers: %s",
292 /* Create protocol and server identification. The syntax
293 * used by ngIRCd in PASS commands and the known "extended
294 * flags" are described in doc/Protocol.txt. */
296 snprintf(NGIRCd_ProtoID, sizeof NGIRCd_ProtoID, "%s%s %s|%s:%s",
297 PROTOVER, PROTOIRCPLUS, PACKAGE_NAME, PACKAGE_VERSION,
300 strcat(NGIRCd_ProtoID, "Z");
302 if (Conf_OperCanMode)
303 strcat(NGIRCd_ProtoID, "o");
305 snprintf(NGIRCd_ProtoID, sizeof NGIRCd_ProtoID, "%s%s %s|%s",
306 PROTOVER, PROTOIRC, PACKAGE_NAME, PACKAGE_VERSION);
308 strlcat(NGIRCd_ProtoID, " P", sizeof NGIRCd_ProtoID);
310 strlcat(NGIRCd_ProtoID, "Z", sizeof NGIRCd_ProtoID);
312 LogDebug("Protocol and server ID is \"%s\".", NGIRCd_ProtoID);
314 Channel_InitPredefined();
316 if (Conn_InitListeners() < 1) {
318 "Server isn't listening on a single port!" );
320 "%s exiting due to fatal errors!", PACKAGE_NAME);
341 * Generate ngIRCd "version strings".
343 * The ngIRCd version information is generated once and then stored in the
344 * NGIRCd_Version and NGIRCd_VersionAddition string variables for further
345 * usage, for example by the IRC command "VERSION" and the --version command
351 NGIRCd_VersionAddition[0] = '\0';
354 strlcpy( NGIRCd_VersionAddition, "SYSLOG", sizeof NGIRCd_VersionAddition );
357 if( NGIRCd_VersionAddition[0] )
358 strlcat( NGIRCd_VersionAddition, "+", sizeof NGIRCd_VersionAddition );
359 strlcat( NGIRCd_VersionAddition, "ZLIB", sizeof NGIRCd_VersionAddition );
362 if ( NGIRCd_VersionAddition[0] ) strlcat( NGIRCd_VersionAddition, "+", sizeof NGIRCd_VersionAddition );
363 strlcat( NGIRCd_VersionAddition, "SSL", sizeof NGIRCd_VersionAddition );
366 if( NGIRCd_VersionAddition[0] )
367 strlcat( NGIRCd_VersionAddition, "+", sizeof NGIRCd_VersionAddition );
368 strlcat( NGIRCd_VersionAddition, "TCPWRAP", sizeof NGIRCd_VersionAddition );
371 if( NGIRCd_VersionAddition[0] )
372 strlcat( NGIRCd_VersionAddition, "+", sizeof NGIRCd_VersionAddition );
373 strlcat( NGIRCd_VersionAddition, "IDENT", sizeof NGIRCd_VersionAddition );
376 if (NGIRCd_VersionAddition[0])
377 strlcat(NGIRCd_VersionAddition, "+", sizeof NGIRCd_VersionAddition);
378 strlcat(NGIRCd_VersionAddition, "PAM", sizeof NGIRCd_VersionAddition);
381 if( NGIRCd_VersionAddition[0] )
382 strlcat( NGIRCd_VersionAddition, "+", sizeof NGIRCd_VersionAddition );
383 strlcat( NGIRCd_VersionAddition, "DEBUG", sizeof NGIRCd_VersionAddition );
386 if( NGIRCd_VersionAddition[0] )
387 strlcat( NGIRCd_VersionAddition, "+", sizeof NGIRCd_VersionAddition );
388 strlcat( NGIRCd_VersionAddition, "SNIFFER", sizeof NGIRCd_VersionAddition );
391 if( NGIRCd_VersionAddition[0] )
392 strlcat( NGIRCd_VersionAddition, "+", sizeof NGIRCd_VersionAddition );
393 strlcat( NGIRCd_VersionAddition, "RFC", sizeof NGIRCd_VersionAddition );
396 if( NGIRCd_VersionAddition[0] )
397 strlcat( NGIRCd_VersionAddition, "+", sizeof NGIRCd_VersionAddition );
398 strlcat( NGIRCd_VersionAddition, "IRCPLUS", sizeof NGIRCd_VersionAddition );
401 if (NGIRCd_VersionAddition[0])
402 strlcat(NGIRCd_VersionAddition, "+", sizeof(NGIRCd_VersionAddition));
403 strlcat(NGIRCd_VersionAddition, "IPv6", sizeof(NGIRCd_VersionAddition));
405 if( NGIRCd_VersionAddition[0] )
406 strlcat( NGIRCd_VersionAddition, "-", sizeof( NGIRCd_VersionAddition ));
408 strlcat( NGIRCd_VersionAddition, TARGET_CPU, sizeof( NGIRCd_VersionAddition ));
409 strlcat( NGIRCd_VersionAddition, "/", sizeof( NGIRCd_VersionAddition ));
410 strlcat( NGIRCd_VersionAddition, TARGET_VENDOR, sizeof( NGIRCd_VersionAddition ));
411 strlcat( NGIRCd_VersionAddition, "/", sizeof( NGIRCd_VersionAddition ));
412 strlcat( NGIRCd_VersionAddition, TARGET_OS, sizeof( NGIRCd_VersionAddition ));
414 snprintf(NGIRCd_Version, sizeof NGIRCd_Version, "%s %s-%s",
415 PACKAGE_NAME, PACKAGE_VERSION, NGIRCd_VersionAddition);
420 * Display copyright and version information of ngIRCd on the console.
425 puts( NGIRCd_Version );
426 puts( "Copyright (c)2001-2012 Alexander Barton (<alex@barton.de>) and Contributors." );
427 puts( "Homepage: <http://ngircd.barton.de/>\n" );
428 puts( "This is free software; see the source for copying conditions. There is NO" );
429 puts( "warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE." );
434 * Display a short help text on the console.
435 * This help depends on the configuration of the executable and only shows
436 * options that are actually enabled.
442 puts( " -d, --debug log extra debug messages" );
444 puts( " -f, --config <f> use file <f> as configuration file" );
445 puts( " -n, --nodaemon don't fork and don't detach from controlling terminal" );
446 puts( " -p, --passive disable automatic connections to other servers" );
448 puts( " -s, --sniffer enable network sniffer and display all IRC traffic" );
450 puts( " -t, --configtest read, validate and display configuration; then exit" );
451 puts( " -V, --version output version information and exit" );
452 puts( " -h, --help display this help and exit" );
457 * Delete the file containing the process ID (PID).
460 Pidfile_Delete( void )
462 /* Pidfile configured? */
463 if( ! Conf_PidFile[0] ) return;
466 Log( LOG_DEBUG, "Removing PID file (%s) ...", Conf_PidFile );
469 if( unlink( Conf_PidFile ))
470 Log( LOG_ERR, "Error unlinking PID file (%s): %s", Conf_PidFile, strerror( errno ));
471 } /* Pidfile_Delete */
475 * Create the file containing the process ID of ngIRCd ("PID file").
477 * @param pid The process ID to be stored in this file.
480 Pidfile_Create(pid_t pid)
486 /* Pidfile configured? */
487 if( ! Conf_PidFile[0] ) return;
490 Log( LOG_DEBUG, "Creating PID file (%s) ...", Conf_PidFile );
493 pidfd = open( Conf_PidFile, O_RDWR|O_CREAT|O_EXCL, S_IRUSR|S_IWUSR|S_IRGRP|S_IROTH);
495 Log( LOG_ERR, "Error writing PID file (%s): %s", Conf_PidFile, strerror( errno ));
499 len = snprintf(pidbuf, sizeof pidbuf, "%ld\n", (long)pid);
500 if (len < 0 || len >= (int)sizeof pidbuf) {
501 Log(LOG_ERR, "Error converting pid");
506 if (write(pidfd, pidbuf, (size_t)len) != (ssize_t)len)
507 Log( LOG_ERR, "Can't write PID file (%s): %s", Conf_PidFile, strerror( errno ));
509 if( close(pidfd) != 0 )
510 Log( LOG_ERR, "Error closing PID file (%s): %s", Conf_PidFile, strerror( errno ));
511 } /* Pidfile_Create */
515 * Redirect stdin, stdout and stderr to apropriate file handles.
517 * @param fd The file handle stdin, stdout and stderr should be redirected to.
520 Setup_FDStreams(int fd)
528 /* Create new stdin(0), stdout(1) and stderr(2) descriptors */
529 dup2( fd, 0 ); dup2( fd, 1 ); dup2( fd, 2 );
530 } /* Setup_FDStreams */
534 * Get user and group ID of unprivileged "nobody" user.
537 * @param gid Group ID
538 * @return true on success.
541 NGIRCd_getNobodyID(uid_t *uid, gid_t *gid )
547 * It can return EINVAL instead of EPERM
548 * so, if we are already unprivileged,
549 * use id of current user.
551 if (geteuid() && getuid()) {
558 pwd = getpwnam("nobody");
562 if (!pwd->pw_uid || !pwd->pw_gid)
570 } /* NGIRCd_getNobodyID */
574 Random_Init_Kern(const char *file)
578 int fd = open(file, O_RDONLY);
580 if (read(fd, &seed, sizeof(seed)) == sizeof(seed))
589 * Initialize libc rand(3) number generator
594 if (Random_Init_Kern("/dev/urandom"))
596 if (Random_Init_Kern("/dev/random"))
598 if (Random_Init_Kern("/dev/arandom"))
600 srand(rand() ^ (unsigned)getpid() ^ (unsigned)time(NULL));
605 * Initialize ngIRCd daemon.
607 * @param NGIRCd_NoDaemon Set to true if ngIRCd should run in the
608 * foreground (and not as a daemon).
609 * @return true on success.
612 NGIRCd_Init(bool NGIRCd_NoDaemon)
614 static bool initialized;
615 bool chrooted = false;
618 int real_errno, fd = -1;
624 if (!NGIRCd_NoDaemon) {
625 /* open /dev/null before chroot() */
626 fd = open( "/dev/null", O_RDWR);
628 Log(LOG_WARNING, "Could not open /dev/null: %s",
632 /* SSL initialization */
633 if (!ConnSSL_InitLibrary())
635 "Warning: Error during SSL initialization, continuing ...");
638 if (Conf_Chroot[0]) {
639 if (chdir(Conf_Chroot) != 0) {
640 Log(LOG_ERR, "Can't chdir() in ChrootDir (%s): %s",
641 Conf_Chroot, strerror(errno));
645 if (chroot(Conf_Chroot) != 0) {
647 "Can't change root directory to \"%s\": %s",
648 Conf_Chroot, strerror(errno));
653 "Changed root and working directory to \"%s\".",
662 "ServerUID must not be %s(0), using \"nobody\" instead.",
663 pwd ? pwd->pw_name : "?");
664 if (!NGIRCd_getNobodyID(&Conf_UID, &Conf_GID)) {
666 "Could not get user/group ID of user \"nobody\": %s",
667 errno ? strerror(errno) : "not found" );
672 /* Change group ID */
673 if (getgid() != Conf_GID) {
674 if (setgid(Conf_GID) != 0) {
676 grp = getgrgid(Conf_GID);
677 Log(LOG_ERR, "Can't change group ID to %s(%u): %s",
678 grp ? grp->gr_name : "?", Conf_GID,
680 if (real_errno != EPERM)
686 if (getuid() != Conf_UID) {
687 if (setuid(Conf_UID) != 0) {
689 pwd = getpwuid(Conf_UID);
690 Log(LOG_ERR, "Can't change user ID to %s(%u): %s",
691 pwd ? pwd->pw_name : "?", Conf_UID,
693 if (real_errno != EPERM)
700 /* Normally a child process is forked which isn't any longer
701 * connected to ther controlling terminal. Use "--nodaemon"
702 * to disable this "daemon mode" (useful for debugging). */
703 if (!NGIRCd_NoDaemon) {
706 /* "Old" process: exit. */
712 "%s: Can't fork: %s!\nFatal error, exiting now ...\n",
713 PACKAGE_NAME, strerror(errno));
717 /* New child process */
721 setpgrp(0, getpid());
724 Log(LOG_ERR, "Can't change directory to '/': %s",
727 /* Detach stdin, stdout and stderr */
736 /* Check UID/GID we are running as, can be different from values
737 * configured (e. g. if we were already started with a UID>0. */
741 pwd = getpwuid(Conf_UID);
742 grp = getgrgid(Conf_GID);
744 Log(LOG_INFO, "Running as user %s(%ld), group %s(%ld), with PID %ld.",
745 pwd ? pwd->pw_name : "unknown", (long)Conf_UID,
746 grp ? grp->gr_name : "unknown", (long)Conf_GID, (long)pid);
749 Log(LOG_INFO, "Running with root directory \"%s\".",
753 Log(LOG_INFO, "Not running with changed root directory.");
755 /* Change working directory to home directory of the user we are
756 * running as (only when running in daemon mode and not in chroot) */
762 if (chdir(pwd->pw_dir) == 0)
764 "Changed working directory to \"%s\" ...",
768 "Notice: Can't change working directory to \"%s\": %s",
769 pwd->pw_dir, strerror(errno));
771 Log(LOG_ERR, "Can't get user informaton for UID %d!?", Conf_UID);