osbthread.h

Go to the documentation of this file.

// OSB library ************************************************ -*- C++ -*-
/*
  AUTHOR(S): Stephan Broennimann (vb)

  RCS information
   $Name: OSB_060808 $
   $Revision: 1.10 $

  License
   OSB rating and billing library for communication networks
   Copyright (C) 2004, 2005, 2006  OSB systems

   This file may be distributed and/or modify under the terms of the
   GNU General Public License (GPL) as published by the Free Software
   Foundation which is provided in the file LICENSE.GPL included in the
   packaging of this file.

   The file is distributed in the hope that it will be useful, but WITHOUT
   ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
   FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
   for more details.

   Holders of a OSB Commercial License may use this file under the terms
   and conditions of this commercial license.
 */
#ifndef _OSBTHREAD_H_
#define _OSBTHREAD_H_

// ************************************************************************
// included header files
// + standard includes
#include <pthread.h>

// + libraries

// + local headers

// + class declarations

// ************************************************************************
// namespace extensions
namespace OSB_APP {

// ************************************************************************
// free functions
    extern "C" void* callThreadFunction(void* threadBase);

// ************************************************************************
// class definitions

    class ThreadBase {
        // Allow to call ThreadBase::threadFunction and
        // ThreadBase::hasReturned.
        friend void* callThreadFunction(void* threadBase);
    public:
        ThreadBase(int id = 0);
        virtual ~ThreadBase();

        virtual int start();
        bool running() const;
        int stop() const;
        int rc() const;

        int stop(int newStop);
        virtual int join(
            bool doStop,
            int  signum  = 0
        );
    public:
        int id_;

    protected:
        virtual void threadFunction() = 0;
        int lock() const;
        int unlock() const;
        void rc(int ret);

    private:
        void hasReturned();
    private:
        bool running_;

    protected:
        int stop_;
        int rc_;
        pthread_t  thread_;
        mutable pthread_mutex_t mutex_;
    };

}                                       // namespace OSB_APP
#endif                                  // #ifndef _OSBTHREAD_H_

---