common/exceptions.h

Go to the documentation of this file.

// -*- C++ -*-
//
// ***** BEGIN LICENSE BLOCK *****
// Version: MPL 1.1/GPL 2.0/LGPL 2.1
// 
// The contents of this file are subject to the Mozilla Public License
// Version 1.1 (the "License"); you may not use this file except in
// compliance with the License. You may obtain a copy of the License at
// http://www.mozilla.org/MPL/
// 
// Software distributed under the License is distributed on an "AS IS"
// basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See
// the License for the specific language governing rights and limitations
// under the License.
// 
// The Original Code is the consmgr network/serial-line monitoring package.
// 
// The Initial Developer of the Original Code is Chris P. Ross.
// Portions created by the Initial Developer are Copyright (C) 2000-2008
// the Initial Developer.  All Rights Reserved.
// 
// Contributor(s):
// 
// Alternatively, the contents of this file may be used under the terms of
// either the GNU General Public License Version 2 or later (the "GPL"), or
// the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
// in which case the provisions of the GPL or the LGPL are applicable instead
// of those above. If you wish to allow use of your version of this file only
// under the terms of either the GPL or the LGPL, and not to allow others to
// use your version of this file under the terms of the MPL, indicate your
// decision by deleting the provisions above and replace them with the notice
// and other provisions required by the GPL or the LGPL. If you do not delete
// the provisions above, a recipient may use your version of this file under
// the terms of any one of the MPL, the GPL or the LGPL.
// 
// ***** END LICENSE BLOCK *****


#ifndef __EXCEPTIONS_H
#define __EXCEPTIONS_H

#include <string>
#include <iostream>

#include "consmgr.h"

extern char *__progname;                /* Program name, from crt0. */


//
// Exception-related classes, for creating and catching specific
// types of exceptions.
//

class CMException : public std::exception {
  public:
    virtual const char* what() const throw()
        { return(_what.c_str()); }

  protected:
    ~CMException() throw() {}

    std::string         _what;
};

class pthread_exception : public CMException {
  public:
    pthread_exception(const char*f, const int l, const int r,
                      const std::string&m);
    ~pthread_exception() throw() {}

    const char *        what(void) const throw();

  private:
    std::string description;    
    std::string filename;       
    int         line_number;    
    int         result_code;    
};

#define PTHREAD_CHECK_AND_THROW(rc, str)        if ((rc) != 0) throw(pthread_exception(__FILE__, __LINE__, (rc), (str)))

class fireball : public CMException {
  public:
    fireball(const int exit_val, const std::string &msg,
             const bool with_errno=false);
    ~fireball() throw() {}

    inline void bail(std::ostream &out) const throw() {
        out << _what << std::endl;
        exit(exit_val);
    }

    const char *        what(void) const throw();

  private:
    const std::string   message;
    int                 exit_val;
    bool                with_errno;
    int                 saved_errno;
};

class CMInvalidParameter : public CMException {
  public:
    CMInvalidParameter(const std::string &explanation)
    { _what = std::string("Invalid parameter: ") + explanation; }
//    ~CMInvalidParameter() throw() {}

#if 0
    const char *        what(void) const throw()
    { return(_what.c_str()); }
#endif
};

class CMUnsupported : public CMException {
  public:
    CMUnsupported(const std::string &explanation)
    { _what = std::string("Unsupported operation: ") + explanation; }
//    ~CMUnsupported() throw() {}

#if 0
    const char *        what(void) const throw()
    { return(_what.c_str()); }
#endif
};

class CMStateChange : public CMException {
};

class CMFailure : public CMException {
  public:
    CMFailure(const std::string &explanation, bool use_errno=false);

  private:
    int         saved_errno;
};

#define CATCH_OR_DIE(ec)        catch (pthread_exception &pe) { \
                                    std::cerr << pe.what() << std::endl; \
                                    exit((ec)); \
                                } catch (fireball &f) { \
                                    f.bail(std::cerr); \
                                } catch (std::exception &e) { \
                                    std::cerr << "Standard exception: " \
                                              << e.what() << std::endl; \
                                    exit((ec)); \
                                } catch (...)

#define CATCH_STR_OR_DIE(ec)    catch (pthread_exception &pe) { \
                                    std::cerr << pe.what() << std::endl; \
                                    exit((ec)); \
                                } catch (fireball &f) { \
                                    f.bail(std::cerr); \
                                } catch (char *s) { \
                                    std::cerr << s << std::endl; \
                                    exit((ec)); \
                                } catch (string &s) { \
                                    std::cerr << s << std::endl; \
                                    exit((ec)); \
                                } catch (std::exception &e) { \
                                    std::cerr << "Standard exception: " \
                                              << e.what() << std::endl; \
                                    exit((ec)); \
                                } catch (...)
#endif  /* __EXCEPTIONS_H */

---