git.sesse.net Git - vlc/blob - modules/misc/logger.c

   1 /*****************************************************************************
   2  * logger.c : file logging plugin for vlc
   3  *****************************************************************************
   4  * Copyright (C) 2002 the VideoLAN team
   5  * $Id$
   6  *
   7  * Authors: Samuel Hocevar <sam@zoy.org>
   8  *
   9  * This program is free software; you can redistribute it and/or modify
  10  * it under the terms of the GNU General Public License as published by
  11  * the Free Software Foundation; either version 2 of the License, or
  12  * (at your option) any later version.
  13  *
  14  * This program is distributed in the hope that it will be useful,
  15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17  * GNU General Public License for more details.
  18  *
  19  * You should have received a copy of the GNU General Public License
  20  * along with this program; if not, write to the Free Software
  21  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
  22  *****************************************************************************/
  23
  24 /*****************************************************************************
  25  * Preamble
  26  *****************************************************************************/
  27
  28 #ifdef HAVE_CONFIG_H
  29 # include "config.h"
  30 #endif
  31
  32 #include <vlc_common.h>
  33 #include <vlc_plugin.h>
  34 #include <vlc_interface.h>
  35 #include <vlc_playlist.h>
  36 #include <vlc_charset.h>
  37
  38 #include <errno.h>                                                 /* ENOMEM */
  39
  40 #ifdef UNDER_CE
  41 #   define _IONBF 0x0004
  42 #endif
  43
  44 #define MODE_TEXT 0
  45 #define MODE_HTML 1
  46 #define MODE_SYSLOG 2
  47
  48 #ifdef __APPLE__
  49 #define LOG_DIR "Library/Logs/"
  50 #endif
  51
  52 #define LOG_FILE_TEXT "vlc-log.txt"
  53 #define LOG_FILE_HTML "vlc-log.html"
  54
  55 #define LOG_STRING( msg, file ) fwrite( msg, strlen( msg ), 1, file );
  56
  57 #define TEXT_HEADER "-- logger module started --\n"
  58 #define TEXT_FOOTER "-- logger module stopped --\n"
  59
  60 #define HTML_HEADER \
  61     "<!DOCTYPE html PUBLIC \"-//W3C//DTD HTML 4.01//EN\"\n" \
  62     "  \"http://www.w3.org/TR/html4/strict.dtd\">\n" \
  63     "<html>\n" \
  64     "  <head>\n" \
  65     "    <title>vlc log</title>\n" \
  66     "    <meta http-equiv=\"Content-Type\" content=\"text/html; charset=UTF-8\">\n" \
  67     "  </head>\n" \
  68     "  <body style=\"background-color: #000000; color: #aaaaaa;\">\n" \
  69     "    <pre>\n" \
  70     "      <b>-- logger module started --</b>\n"
  71 #define HTML_FOOTER \
  72     "      <b>-- logger module stopped --</b>\n" \
  73     "    </pre>\n" \
  74     "  </body>\n" \
  75     "</html>\n"
  76
  77 #if HAVE_SYSLOG_H
  78 #include <syslog.h>
  79 #endif
  80
  81 /*****************************************************************************
  82  * intf_sys_t: description and status of log interface
  83  *****************************************************************************/
  84 struct intf_sys_t
  85 {
  86     int i_mode;
  87     FILE *p_rrd;
  88     mtime_t last_update;
  89     time_t now;  /* timestamp for rrd-log */
  90
  91     FILE *    p_file; /* The log file */
  92     msg_subscription_t *p_sub;
  93 };
  94
  95 /*****************************************************************************
  96  * Local prototypes
  97  *****************************************************************************/
  98 static int  Open    ( vlc_object_t * );
  99 static void Close   ( vlc_object_t * );
 100 static void Run     ( intf_thread_t * );
 101
 102 static void FlushQueue        ( msg_subscription_t *, FILE *, int, int );
 103 static void TextPrint         ( const msg_item_t *, FILE * );
 104 static void HtmlPrint         ( const msg_item_t *, FILE * );
 105 #ifdef HAVE_SYSLOG_H
 106 static void SyslogPrint       ( const msg_item_t *);
 107 #endif
 108
 109 static void DoRRD( intf_thread_t *p_intf );
 110
 111 /*****************************************************************************
 112  * Module descriptor
 113  *****************************************************************************/
 114 static const char *const mode_list[] = { "text", "html"
 115 #ifdef HAVE_SYSLOG_H
 116 ,"syslog"
 117 #endif
 118 };
 119 static const char *const mode_list_text[] = { N_("Text"), "HTML"
 120 #ifdef HAVE_SYSLOG_H
 121 , "syslog"
 122 #endif
 123 };
 124
 125 #define LOGMODE_TEXT N_("Log format")
 126 #ifdef HAVE_SYSLOG_H
 127 #define LOGMODE_LONGTEXT N_("Specify the log format. Available choices are " \
 128   "\"text\" (default), \"html\", and \"syslog\" (special mode to send to " \
 129   "syslog instead of file.")
 130 #else
 131 #define LOGMODE_LONGTEXT N_("Specify the log format. Available choices are " \
 132   "\"text\" (default) and \"html\".")
 133 #endif
 134
 135 vlc_module_begin();
 136     set_shortname( N_( "Logging" ) );
 137     set_description( N_("File logging") );
 138
 139     set_category( CAT_ADVANCED );
 140     set_subcategory( SUBCAT_ADVANCED_MISC );
 141
 142     add_file( "logfile", NULL, NULL,
 143              N_("Log filename"), N_("Specify the log filename."), false );
 144         change_unsafe();
 145     add_string( "logmode", "text", NULL, LOGMODE_TEXT, LOGMODE_LONGTEXT,
 146                 false );
 147         change_string_list( mode_list, mode_list_text, 0 );
 148
 149     add_file( "rrd-file", NULL, NULL, N_("RRD output file") ,
 150                     N_("Output data for RRDTool in this file." ), true );
 151
 152     set_capability( "interface", 0 );
 153     set_callbacks( Open, Close );
 154 vlc_module_end();
 155
 156 /*****************************************************************************
 157  * Open: initialize and create stuff
 158  *****************************************************************************/
 159 static int Open( vlc_object_t *p_this )
 160 {
 161     intf_thread_t *p_intf = (intf_thread_t *)p_this;
 162     char *psz_mode, *psz_file, *psz_rrd_file;
 163
 164     CONSOLE_INTRO_MSG;
 165     msg_Info( p_intf, "using logger..." );
 166
 167     /* Allocate instance and initialize some members */
 168     p_intf->p_sys = (intf_sys_t *)malloc( sizeof( intf_sys_t ) );
 169     if( p_intf->p_sys == NULL )
 170     {
 171         msg_Err( p_intf, "out of memory" );
 172         return -1;
 173     }
 174
 175     psz_mode = var_CreateGetString( p_intf, "logmode" );
 176     if( psz_mode )
 177     {
 178         if( !strcmp( psz_mode, "text" ) )
 179         {
 180             p_intf->p_sys->i_mode = MODE_TEXT;
 181         }
 182         else if( !strcmp( psz_mode, "html" ) )
 183         {
 184             p_intf->p_sys->i_mode = MODE_HTML;
 185         }
 186 #ifdef HAVE_SYSLOG_H
 187         else if( !strcmp( psz_mode, "syslog" ) )
 188         {
 189             p_intf->p_sys->i_mode = MODE_SYSLOG;
 190         }
 191 #endif
 192         else
 193         {
 194             msg_Warn( p_intf, "invalid log mode `%s', using `text'", psz_mode );
 195             p_intf->p_sys->i_mode = MODE_TEXT;
 196         }
 197
 198         free( psz_mode );
 199     }
 200     else
 201     {
 202         msg_Warn( p_intf, "no log mode specified, using `text'" );
 203         p_intf->p_sys->i_mode = MODE_TEXT;
 204     }
 205
 206     if( p_intf->p_sys->i_mode != MODE_SYSLOG )
 207     {
 208         psz_file = config_GetPsz( p_intf, "logfile" );
 209         if( !psz_file )
 210         {
 211 #ifdef __APPLE__
 212             if( asprintf( &psz_file, "%s/"LOG_DIR"/%s", config_GetHomeDir(),
 213                 (p_intf->p_sys->i_mode == MODE_HTML) ? LOG_FILE_HTML
 214                                                      : LOG_FILE_TEXT ) == -1 )
 215                 psz_file = NULL;
 216 #else
 217             switch( p_intf->p_sys->i_mode )
 218             {
 219             case MODE_HTML:
 220                 psz_file = strdup( LOG_FILE_HTML );
 221                 break;
 222             case MODE_TEXT:
 223             default:
 224                 psz_file = strdup( LOG_FILE_TEXT );
 225                 break;
 226             }
 227 #endif
 228             msg_Warn( p_intf, "no log filename provided, using `%s'",
 229                                psz_file );
 230         }
 231
 232         /* Open the log file and remove any buffering for the stream */
 233         msg_Dbg( p_intf, "opening logfile `%s'", psz_file );
 234         p_intf->p_sys->p_file = utf8_fopen( psz_file, "at" );
 235         if( p_intf->p_sys->p_file == NULL )
 236         {
 237             msg_Err( p_intf, "error opening logfile `%s'", psz_file );
 238             free( p_intf->p_sys );
 239             free( psz_file );
 240             return -1;
 241         }
 242         setvbuf( p_intf->p_sys->p_file, NULL, _IONBF, 0 );
 243
 244         free( psz_file );
 245
 246         switch( p_intf->p_sys->i_mode )
 247         {
 248         case MODE_HTML:
 249             LOG_STRING( HTML_HEADER, p_intf->p_sys->p_file );
 250             break;
 251         case MODE_TEXT:
 252         default:
 253             LOG_STRING( TEXT_HEADER, p_intf->p_sys->p_file );
 254             break;
 255         }
 256
 257     }
 258     else
 259     {
 260         p_intf->p_sys->p_file = NULL;
 261 #ifdef HAVE_SYSLOG_H
 262         openlog( "vlc", LOG_PID|LOG_NDELAY, LOG_DAEMON );
 263 #endif
 264     }
 265
 266     p_intf->p_sys->last_update = 0;
 267     p_intf->p_sys->p_rrd = NULL;
 268
 269     psz_rrd_file = config_GetPsz( p_intf, "rrd-file" );
 270     if( psz_rrd_file && *psz_rrd_file )
 271     {
 272         p_intf->p_sys->p_rrd = utf8_fopen( psz_rrd_file, "w" );
 273     }
 274
 275     p_intf->p_sys->p_sub = msg_Subscribe( p_intf );
 276     p_intf->pf_run = Run;
 277
 278     return 0;
 279 }
 280
 281 /*****************************************************************************
 282  * Close: destroy interface stuff
 283  *****************************************************************************/
 284 static void Close( vlc_object_t *p_this )
 285 {
 286     intf_thread_t *p_intf = (intf_thread_t *)p_this;
 287
 288     /* Flush the queue and unsubscribe from the message queue */
 289     FlushQueue( p_intf->p_sys->p_sub, p_intf->p_sys->p_file,
 290                 p_intf->p_sys->i_mode,
 291                 var_CreateGetInteger( p_intf, "verbose" ) );
 292     msg_Unsubscribe( p_intf, p_intf->p_sys->p_sub );
 293
 294     switch( p_intf->p_sys->i_mode )
 295     {
 296     case MODE_HTML:
 297         LOG_STRING( HTML_FOOTER, p_intf->p_sys->p_file );
 298         break;
 299     case MODE_TEXT:
 300 #ifdef HAVE_SYSLOG_H
 301     case MODE_SYSLOG:
 302         closelog();
 303         break;
 304 #endif
 305     default:
 306         LOG_STRING( TEXT_FOOTER, p_intf->p_sys->p_file );
 307         break;
 308     }
 309
 310     /* Close the log file */
 311     if( p_intf->p_sys->i_mode != MODE_SYSLOG )
 312         fclose( p_intf->p_sys->p_file );
 313
 314     /* Destroy structure */
 315     free( p_intf->p_sys );
 316 }
 317
 318 /*****************************************************************************
 319  * Run: rc thread
 320  *****************************************************************************
 321  * This part of the interface is in a separate thread so that we can call
 322  * exec() from within it without annoying the rest of the program.
 323  *****************************************************************************/
 324 static void Run( intf_thread_t *p_intf )
 325 {
 326     while( !p_intf->b_die )
 327     {
 328         FlushQueue( p_intf->p_sys->p_sub, p_intf->p_sys->p_file,
 329                     p_intf->p_sys->i_mode,
 330                     var_CreateGetInteger( p_intf, "verbose" ) );
 331         if( p_intf->p_sys->p_rrd )
 332             DoRRD( p_intf );
 333
 334         msleep( INTF_IDLE_SLEEP );
 335     }
 336 }
 337
 338 /*****************************************************************************
 339  * FlushQueue: flush the message queue into the log
 340  *****************************************************************************/
 341 static void FlushQueue( msg_subscription_t *p_sub, FILE *p_file, int i_mode,
 342                         int i_verbose )
 343 {
 344     int i_start, i_stop;
 345
 346     vlc_mutex_lock( p_sub->p_lock );
 347     i_stop = *p_sub->pi_stop;
 348     vlc_mutex_unlock( p_sub->p_lock );
 349
 350     if( p_sub->i_start != i_stop )
 351     {
 352         /* Append all messages to log file */
 353         for( i_start = p_sub->i_start;
 354              i_start != i_stop;
 355              i_start = (i_start+1) % VLC_MSG_QSIZE )
 356         {
 357             switch( p_sub->p_msg[i_start].i_type )
 358             {
 359             case VLC_MSG_ERR:
 360                 if( i_verbose < 0 ) continue;
 361                 break;
 362             case VLC_MSG_INFO:
 363                 if( i_verbose < 0 ) continue;
 364                 break;
 365             case VLC_MSG_WARN:
 366                 if( i_verbose < 1 ) continue;
 367                 break;
 368             case VLC_MSG_DBG:
 369                 if( i_verbose < 2 ) continue;
 370                 break;
 371             }
 372
 373             switch( i_mode )
 374             {
 375             case MODE_HTML:
 376                 HtmlPrint( &p_sub->p_msg[i_start], p_file );
 377                 break;
 378 #ifdef HAVE_SYSLOG_H
 379             case MODE_SYSLOG:
 380                 SyslogPrint( &p_sub->p_msg[i_start] );
 381                 break;
 382 #endif
 383             case MODE_TEXT:
 384             default:
 385                 TextPrint( &p_sub->p_msg[i_start], p_file );
 386                 break;
 387             }
 388         }
 389
 390         vlc_mutex_lock( p_sub->p_lock );
 391         p_sub->i_start = i_start;
 392         vlc_mutex_unlock( p_sub->p_lock );
 393     }
 394 }
 395
 396 static const char *ppsz_type[4] = { ": ", " error: ",
 397                                     " warning: ", " debug: " };
 398
 399 static void TextPrint( const msg_item_t *p_msg, FILE *p_file )
 400 {
 401     LOG_STRING( p_msg->psz_module, p_file );
 402     LOG_STRING( ppsz_type[p_msg->i_type], p_file );
 403     LOG_STRING( p_msg->psz_msg, p_file );
 404     LOG_STRING( "\n", p_file );
 405 }
 406
 407 #ifdef HAVE_SYSLOG_H
 408 static void SyslogPrint( const msg_item_t *p_msg )
 409 {
 410     static const int i_prio[4] = { LOG_INFO, LOG_ERR, LOG_WARNING, LOG_DEBUG };
 411     int i_priority = i_prio[p_msg->i_type];
 412
 413     if( p_msg->psz_header )
 414         syslog( i_priority, "%s%s %s: %s", p_msg->psz_header,
 415                 ppsz_type[p_msg->i_type],
 416                 p_msg->psz_module, p_msg->psz_msg );
 417     else
 418         syslog( i_priority, "%s%s: %s", p_msg->psz_module,
 419                 ppsz_type[p_msg->i_type], p_msg->psz_msg );
 420
 421 }
 422 #endif
 423
 424 static void HtmlPrint( const msg_item_t *p_msg, FILE *p_file )
 425 {
 426     static const char *ppsz_color[4] = { "<span style=\"color: #ffffff\">",
 427                                          "<span style=\"color: #ff6666\">",
 428                                          "<span style=\"color: #ffff66\">",
 429                                          "<span style=\"color: #aaaaaa\">" };
 430
 431     LOG_STRING( p_msg->psz_module, p_file );
 432     LOG_STRING( ppsz_type[p_msg->i_type], p_file );
 433     LOG_STRING( ppsz_color[p_msg->i_type], p_file );
 434     LOG_STRING( p_msg->psz_msg, p_file );
 435     LOG_STRING( "</span>\n", p_file );
 436 }
 437
 438 static void DoRRD( intf_thread_t *p_intf )
 439 {
 440     if( mdate() - p_intf->p_sys->last_update < 1000000 )
 441         return;
 442     p_intf->p_sys->last_update = mdate();
 443
 444     if( p_intf->p_libvlc->p_stats )
 445     {
 446         time(&p_intf->p_sys->now);
 447         lldiv_t din = lldiv( p_intf->p_libvlc->p_stats->f_input_bitrate * 1000000,
 448                              1000 );
 449         lldiv_t ddm = lldiv( p_intf->p_libvlc->p_stats->f_demux_bitrate * 1000000,
 450                              1000 );
 451         lldiv_t dout = lldiv( p_intf->p_libvlc->p_stats->f_output_bitrate * 1000000,
 452                              1000 );
 453         fprintf( p_intf->p_sys->p_rrd,
 454                    "%"PRIi64":%lld.%03u:%lld.%03u:%lld.%03u\n",
 455                    (uintmax_t)p_intf->p_sys->now,
 456                    din.quot, (unsigned int)din.rem,
 457                    ddm.quot, (unsigned int)ddm.rem,
 458                    dout.quot, (unsigned int)dout.rem );
 459         fflush( p_intf->p_sys->p_rrd );
 460     }
 461 }