]> arthur.barton.de Git - ngircd-alex.git/blobdiff - src/ngircd/log.c
Slightly reoder startup steps, and enhance logging
[ngircd-alex.git] / src / ngircd / log.c
index 1cf83c31c7e1925424edcaf1cdb2f0679da277f5..a47ce92cd81571025a446ecd0f54b8553dcf9020 100644 (file)
 /*
  * ngIRCd -- The Next Generation IRC Daemon
- * Copyright (c)2001,2002 by Alexander Barton (alex@barton.de)
+ * Copyright (c)2001-2019 Alexander Barton (alex@barton.de) and Contributors.
  *
- * Dieses Programm ist freie Software. Sie koennen es unter den Bedingungen
- * der GNU General Public License (GPL), wie von der Free Software Foundation
- * herausgegeben, weitergeben und/oder modifizieren, entweder unter Version 2
- * der Lizenz oder (wenn Sie es wuenschen) jeder spaeteren Version.
- * Naehere Informationen entnehmen Sie bitter der Datei COPYING. Eine Liste
- * der an ngIRCd beteiligten Autoren finden Sie in der Datei AUTHORS.
- *
- * $Id: log.c,v 1.33 2002/05/27 13:09:27 alex Exp $
- *
- * log.c: Logging-Funktionen
+ * 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 2 of the License, or
+ * (at your option) any later version.
+ * Please read the file COPYING, README and AUTHORS for more information.
  */
 
-
 #include "portab.h"
 
-#include "imp.h"
+/**
+ * @file
+ * Logging functions
+ */
+
 #include <assert.h>
-#include <errno.h>
-#include <stdarg.h>
+#ifdef PROTOTYPES
+# include <stdarg.h>
+#else
+# include <varargs.h>
+#endif
 #include <stdio.h>
-#include <string.h>
 #include <sys/types.h>
+#include <time.h>
 #include <unistd.h>
 
-#ifdef USE_SYSLOG
-#include <syslog.h>
+#ifdef SYSLOG
+# include <syslog.h>
 #endif
 
 #include "ngircd.h"
-#include "defines.h"
 #include "conn.h"
-#include "client.h"
 #include "channel.h"
 #include "irc-write.h"
+#include "conf.h"
 
-#include "exp.h"
 #include "log.h"
 
+static bool Is_Daemon;
 
-LOCAL CHAR Error_File[FNAME_LEN];
-LOCAL CHAR Init_Txt[127];
-
-
-LOCAL VOID Wall_ServerNotice PARAMS(( CHAR *Msg ));
 
-
-GLOBAL VOID
-Log_Init( VOID )
+static void
+Log_Message(int Level, const char *msg)
 {
-#ifdef USE_SYSLOG
-       /* Syslog initialisieren */
-       openlog( PACKAGE, LOG_CONS|LOG_PID, LOG_LOCAL5 );
-#endif
-
-       /* Hello World! */
-       Log( LOG_NOTICE, "%s started.", NGIRCd_Version( ));
-         
-       /* Informationen uebern den "Operation Mode" */
-       strcpy( Init_Txt, "" );
-#ifdef DEBUG
-       if( NGIRCd_Debug )
-       {
-               if( Init_Txt[0] ) strcat( Init_Txt, ", " );
-               strcat( Init_Txt, "debug-mode" );
-       }
-#endif
-       if( NGIRCd_NoDaemon )
-       {
-               if( Init_Txt[0] ) strcat( Init_Txt, ", " );
-               strcat( Init_Txt, "no-daemon-mode" );
+       if (!Is_Daemon) {
+               /* log to console */
+               fprintf(stdout, "[%ld:%d %4ld] %s\n", (long)getpid(), Level,
+                               (long)(time(NULL) - NGIRCd_Start), msg);
+               fflush(stdout);
        }
-       if( NGIRCd_Passive )
-       {
-               if( Init_Txt[0] ) strcat( Init_Txt, ", " );
-               strcat( Init_Txt, "passive-mode" );
-       }
-#ifdef SNIFFER
-       if( NGIRCd_Sniffer )
-       {
-               if( Init_Txt[0] ) strcat( Init_Txt, ", " );
-               strcat( Init_Txt, "network sniffer" );
+#ifdef SYSLOG
+       else {
+               syslog(Level, "%s", msg);
        }
 #endif
-       if( Init_Txt[0] ) Log( LOG_INFO, "Activating: %s.", Init_Txt );
-} /* Log_Init */
+}
 
 
-GLOBAL VOID
-Log_InitErrorfile( VOID )
+/**
+ * Initialitze logging.
+ * This function is called before the configuration file is read in.
+ *
+ * @param Daemon_Mode Set to true if ngIRCd is running as daemon.
+ */
+GLOBAL void
+Log_Init(bool Daemon_Mode)
 {
-       /* "Error-Log" initialisieren: stderr in Datei umlenken. Dort
-        * landen z.B. alle Ausgaben von assert()-Aufrufen. */
+       Is_Daemon = Daemon_Mode;
 
-       /* Dateiname zusammen bauen */
-       sprintf( Error_File, ERROR_DIR"/"PACKAGE"-%ld.err", (INT32)getpid( ));
-
-       /* stderr umlenken */
-       fflush( stderr );
-       if( ! freopen( Error_File, "w", stderr ))
-       {
-               Log( LOG_ERR, "Can't reopen stderr (\"%s\"): %s", Error_File, strerror( errno ));
-               return;
-       }
-
-       /* Einige Infos in das Error-File schreiben */
-       fputs( ctime( &NGIRCd_Start ), stderr );
-       fprintf( stderr, "%s started.\n", NGIRCd_Version( ));
-       fprintf( stderr, "Activating: %s\n\n", Init_Txt[0] ? Init_Txt : "-" );
-       fflush( stderr );
-
-       Log( LOG_DEBUG, "Redirected stderr to \"%s\".", Error_File );
-} /* Log_InitErrfile */
+#ifdef SYSLOG
+#ifndef LOG_CONS     /* Kludge: mips-dec-ultrix4.5 has no LOG_CONS */
+#define LOG_CONS 0
+#endif
+#ifdef LOG_DAEMON
+       openlog(PACKAGE, LOG_CONS|LOG_PID, LOG_DAEMON);
+#else
+       openlog(PACKAGE, LOG_CONS|LOG_PID, 0);
+#endif
+#endif
+       Log(LOG_NOTICE, "%s starting ...", NGIRCd_Version);
+} /* Log_Init */
 
 
-GLOBAL VOID
-Log_Exit( VOID )
+/**
+ * Re-init logging after reading the configuration file.
+ */
+GLOBAL void
+Log_ReInit(void)
 {
-       /* Good Bye! */
-       Log( LOG_NOTICE, PACKAGE" done.");
+#ifdef SYSLOG
+#ifndef LOG_CONS     /* Kludge: mips-dec-ultrix4.5 has no LOG_CONS */
+#define LOG_CONS 0
+#endif
+       closelog();
+       openlog(PACKAGE, LOG_CONS|LOG_PID, Conf_SyslogFacility);
+#endif
+}
 
-       /* Error-File (stderr) loeschen */
-       if( unlink( Error_File ) != 0 ) Log( LOG_ERR, "Can't delete \"%s\": %s", Error_File, strerror( errno ));
 
-#ifdef USE_SYSLOG
-       /* syslog abmelden */
-       closelog( );
+GLOBAL void
+Log_Exit( void )
+{
+       Log(LOG_NOTICE, "%s done%s, served %lu connection%s.", PACKAGE_NAME,
+           NGIRCd_SignalRestart ? " (restarting)" : "", Conn_CountAccepted(),
+           Conn_CountAccepted() == 1 ? "" : "s");
+#ifdef SYSLOG
+       closelog();
 #endif
 } /* Log_Exit */
 
 
-GLOBAL VOID
-Log( INT Level, CONST CHAR *Format, ... )
+/**
+ * Log function for debug messages.
+ * This function is only functional when the program is compiled with debug
+ * code enabled; otherwise it is an empty function which the compiler will
+ * hopefully mangle down to "nothing" (see log.h). Therefore you should use
+ * LogDebug(...) in favor to Log(LOG_DEBUG, ...).
+ * @param Format Format string like printf().
+ * @param ... Further arguments.
+ */
+#ifdef DEBUG
+# ifdef PROTOTYPES
+GLOBAL void
+LogDebug( const char *Format, ... )
+# else
+GLOBAL void
+LogDebug( Format, va_alist )
+const char *Format;
+va_dcl
+# endif /* PROTOTYPES */
 {
-       /* Eintrag in Logfile(s) schreiben */
+       char msg[MAX_LOG_MSG_LEN];
+       va_list ap;
 
-       CHAR msg[MAX_LOG_MSG_LEN];
-       BOOLEAN snotice;
+       if (!NGIRCd_Debug) return;
+#ifdef PROTOTYPES
+       va_start( ap, Format );
+#else
+       va_start( ap );
+#endif
+       vsnprintf( msg, MAX_LOG_MSG_LEN, Format, ap );
+       va_end( ap );
+       Log(LOG_DEBUG, "%s", msg);
+}
+#endif /* DEBUG */
+
+
+/**
+ * Logging function of ngIRCd.
+ * This function logs messages to the console and/or syslog, whichever is
+ * suitable for the mode ngIRCd is running in (daemon vs. non-daemon).
+ * If LOG_snotice is set, the log messages goes to all user with the mode +s
+ * set and the local &SERVER channel, too.
+ * Please note: you should use LogDebug(...) for debug messages!
+ * @param Level syslog level (LOG_xxx)
+ * @param Format Format string like printf().
+ * @param ... Further arguments.
+ */
+#ifdef PROTOTYPES
+GLOBAL void
+Log( int Level, const char *Format, ... )
+#else
+GLOBAL void
+Log( Level, Format, va_alist )
+int Level;
+const char *Format;
+va_dcl
+#endif
+{
+       char msg[MAX_LOG_MSG_LEN];
+       bool snotice;
        va_list ap;
 
        assert( Format != NULL );
@@ -146,10 +179,10 @@ Log( INT Level, CONST CHAR *Format, ... )
        if( Level & LOG_snotice )
        {
                /* Notice an User mit "s" Mode */
-               snotice = TRUE;
+               snotice = true;
                Level &= ~LOG_snotice;
        }
-       else snotice = FALSE;
+       else snotice = false;
 
 #ifdef DEBUG
        if(( Level == LOG_DEBUG ) && ( ! NGIRCd_Debug )) return;
@@ -157,103 +190,123 @@ Log( INT Level, CONST CHAR *Format, ... )
        if( Level == LOG_DEBUG ) return;
 #endif
 
-       /* String mit variablen Argumenten zusammenbauen ... */
+#ifdef PROTOTYPES
        va_start( ap, Format );
+#else
+       va_start( ap );
+#endif
        vsnprintf( msg, MAX_LOG_MSG_LEN, Format, ap );
        va_end( ap );
 
-       if( NGIRCd_NoDaemon )
-       {
-               /* auf Konsole ausgeben */
-               printf( "[%d] %s\n", Level, msg );
-       }
+       Log_Message(Level, msg);
 
-       if( Level <= LOG_CRIT )
-       {
-               /* Kritische Meldungen in Error-File (stderr) */
-               fprintf( stderr, "%s\n", msg );
-               fflush( stderr );
-       }
-
-#ifdef USE_SYSLOG
-       /* Syslog */
-       syslog( Level, msg );
-#endif
-
-       if( snotice )
-       {
-               /* NOTICE an lokale User mit "s"-Mode */
-               Wall_ServerNotice( msg );
+       if (snotice) {
+               /* Send NOTICE to all local users with mode +s and to the
+                * local &SERVER channel */
+               Log_ServerNotice('s', "%s", msg);
+               Channel_LogServer(msg);
        }
 } /* Log */
 
 
-GLOBAL VOID
-Log_Init_Resolver( VOID )
+GLOBAL void
+Log_Init_Subprocess(char UNUSED *Name)
 {
-#ifdef USE_SYSLOG
-       openlog( PACKAGE, LOG_CONS|LOG_PID, LOG_LOCAL5 );
+#ifdef SYSLOG
+       openlog(PACKAGE, LOG_CONS|LOG_PID, Conf_SyslogFacility);
 #endif
-} /* Log_Init_Resolver */
+#ifdef DEBUG
+       Log_Subprocess(LOG_DEBUG, "%s sub-process starting, PID %ld.",
+                    Name, (long)getpid());
+#endif
+}
 
 
-GLOBAL VOID
-Log_Exit_Resolver( VOID )
+GLOBAL void
+Log_Exit_Subprocess(char UNUSED *Name)
 {
-#ifdef USE_SYSLOG
+#ifdef DEBUG
+       Log_Subprocess(LOG_DEBUG, "%s sub-process %ld done.",
+                    Name, (long)getpid());
+#endif
+#ifdef SYSLOG
        closelog( );
 #endif
-} /* Log_Exit_Resolver */
-
+}
 
-GLOBAL VOID
-Log_Resolver( CONST INT Level, CONST CHAR *Format, ... )
-{
-       /* Eintrag des Resolver in Logfile(s) schreiben */
 
-#ifndef USE_SYSLOG
-       return;
+#ifdef PROTOTYPES
+GLOBAL void
+Log_Subprocess(const int Level, const char *Format, ...)
 #else
-
-       CHAR msg[MAX_LOG_MSG_LEN];
+GLOBAL void
+Log_Subprocess(Level, Format, va_alist)
+const int Level;
+const char *Format;
+va_dcl
+#endif
+{
+       char msg[MAX_LOG_MSG_LEN];
        va_list ap;
 
-       assert( Format != NULL );
+       assert(Format != NULL);
 
 #ifdef DEBUG
-       if(( Level == LOG_DEBUG ) && ( ! NGIRCd_Debug )) return;
+       if ((Level == LOG_DEBUG) && (!NGIRCd_Debug))
+               return;
 #else
-       if( Level == LOG_DEBUG ) return;
+       if (Level == LOG_DEBUG)
+               return;
 #endif
 
-       /* String mit variablen Argumenten zusammenbauen ... */
-       va_start( ap, Format );
-       vsnprintf( msg, MAX_LOG_MSG_LEN, Format, ap );
-       va_end( ap );
-
-       /* ... und ausgeben */
-       syslog( Level, msg );
-
+#ifdef PROTOTYPES
+       va_start(ap, Format);
+#else
+       va_start(ap);
 #endif
-} /* Log_Resolver */
+       vsnprintf(msg, MAX_LOG_MSG_LEN, Format, ap);
+       va_end(ap);
 
+       Log_Message(Level, msg);
+}
 
-LOCAL VOID
-Wall_ServerNotice( CHAR *Msg )
-{
-       /* Server-Notice an entsprechende User verschicken */
 
+/**
+ * Send a log message to all local users flagged with the given user mode.
+ * @param UserMode User mode which the target user must have set,
+ * @param Format The format string.
+ */
+#ifdef PROTOTYPES
+GLOBAL void
+Log_ServerNotice(const char UserMode, const char *Format, ... )
+#else
+GLOBAL void
+Log_ServerNotice(UserMode, Format, va_alist)
+const char UserMode;
+const char *Format;
+va_dcl
+#endif
+{
        CLIENT *c;
+       char msg[MAX_LOG_MSG_LEN];
+       va_list ap;
 
-       assert( Msg != NULL );
+       assert(Format != NULL);
 
-       c = Client_First( );
-       while( c )
-       {
-               if(( Client_Conn( c ) > NONE ) && ( Client_HasMode( c, 's' ))) IRC_WriteStrClient( c, "NOTICE %s :%s", Client_ThisServer( ), Msg );
-               c = Client_Next( c );
+#ifdef PROTOTYPES
+       va_start(ap, Format);
+#else
+       va_start(ap);
+#endif
+       vsnprintf(msg, MAX_LOG_MSG_LEN, Format, ap);
+       va_end(ap);
+
+       for(c=Client_First(); c != NULL; c=Client_Next(c)) {
+               if (Client_Conn(c) > NONE && Client_HasMode(c, UserMode))
+                       IRC_WriteStrClient(c, "NOTICE %s :%s%s", Client_ID(c),
+                                                       NOTICE_TXTPREFIX, msg);
        }
-} /* Wall_ServerNotice */
+} /* Log_ServerNotice */
 
 
 /* -eof- */