epan/report_err.c

   1 /* report_err.c
   2 * Routines for code that can run in GUI and command-line environments to
   3 * use to report errors to the user (e.g., I/O errors, or problems with
   4 * preference settings).
   5 *
   6 * The application using libwireshark will register error-reporting
   7 * routines, and the routines defined here will call the registered
   8 * routines.  That way, these routines can be called by code that
   9 * doesn't itself know whether to pop up a dialog or print something
  10 * to the standard error.
  11 *
  12 * $Id$
  13 *
  14 * Wireshark - Network traffic analyzer
  15 * By Gerald Combs <gerald@wireshark.org>
  16 * Copyright 1998 Gerald Combs
  17 *
  18 * This program is free software; you can redistribute it and/or
  19 * modify it under the terms of the GNU General Public License
  20 * as published by the Free Software Foundation; either version 2
  21 * of the License, or (at your option) any later version.
  22 *
  23 * This program is distributed in the hope that it will be useful,
  24 * but WITHOUT ANY WARRANTY; without even the implied warranty of
  25 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  26 * GNU General Public License for more details.
  27 *
  28 * You should have received a copy of the GNU General Public License
  29 * along with this program; if not, write to the Free Software
  30 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
  31 */
  32 #ifdef HAVE_CONFIG_H
  33 #include "config.h"
  34 #endif
  35
  36 #include <glib.h>
  37 #include <stdarg.h>
  38 #include "report_err.h"
  39
  40 static void (*report_failure_func)(const char *, va_list);
  41 static void (*report_open_failure_func)(const char *, int, gboolean);
  42 static void (*report_read_failure_func)(const char *, int);
  43 static void (*report_write_failure_func)(const char *, int);
  44
  45 void init_report_err(void (*report_failure_fcn_p)(const char *, va_list),
  46                      void (*report_open_failure_fcn_p)(const char *, int, gboolean),
  47                      void (*report_read_failure_fcn_p)(const char *, int),
  48                      void (*report_write_failure_fcn_p)(const char *, int))
  49 {
  50         report_failure_func = report_failure_fcn_p;
  51         report_open_failure_func = report_open_failure_fcn_p;
  52         report_read_failure_func = report_read_failure_fcn_p;
  53         report_write_failure_func = report_write_failure_fcn_p;
  54 }
  55
  56 /*
  57  * Report a general error.
  58  */
  59 void
  60 report_failure(const char *msg_format, ...)
  61 {
  62         va_list ap;
  63
  64         va_start(ap, msg_format);
  65         (*report_failure_func)(msg_format, ap);
  66         va_end(ap);
  67 }
  68
  69 /*
  70  * Report an error when trying to open or create a file.
  71  * "err" is assumed to be an error code from Wiretap; positive values are
  72  * UNIX-style errnos, so this can be used for open failures not from
  73  * Wiretap as long as the failure code is just an errno.
  74  */
  75 void
  76 report_open_failure(const char *filename, int err,
  77                                         gboolean for_writing)
  78 {
  79         (*report_open_failure_func)(filename, err, for_writing);
  80 }
  81
  82 /*
  83  * Report an error when trying to read a file.
  84  * "err" is assumed to be a UNIX-style errno.
  85  */
  86 void
  87 report_read_failure(const char *filename, int err)
  88 {
  89         (*report_read_failure_func)(filename, err);
  90 }
  91
  92 /*
  93  * Report an error when trying to write a file.
  94  * "err" is assumed to be a UNIX-style errno.
  95  */
  96 void
  97 report_write_failure(const char *filename, int err)
  98 {
  99         (*report_write_failure_func)(filename, err);
 100 }