src/OSspecific/POSIX/timer.H

   1 /*---------------------------------------------------------------------------*\
   2   =========                 |
   3   \\      /  F ield         | foam-extend: Open Source CFD
   4    \\    /   O peration     | Version:     3.2
   5     \\  /    A nd           | Web:         http://www.foam-extend.org
   6      \\/     M anipulation  | For copyright notice see file Copyright
   7 -------------------------------------------------------------------------------
   8 License
   9     This file is part of foam-extend.
  10
  11     foam-extend is free software: you can redistribute it and/or modify it
  12     under the terms of the GNU General Public License as published by the
  13     Free Software Foundation, either version 3 of the License, or (at your
  14     option) any later version.
  15
  16     foam-extend is distributed in the hope that it will be useful, but
  17     WITHOUT ANY WARRANTY; without even the implied warranty of
  18     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  19     General Public License for more details.
  20
  21     You should have received a copy of the GNU General Public License
  22     along with foam-extend.  If not, see <http://www.gnu.org/licenses/>.
  23
  24 Class
  25     Foam::timer
  26
  27 Description
  28     Implements a timeout mechanism via sigalarm.
  29
  30     Example usage:
  31     @code
  32         timer myTimer(5);     // 5 sec
  33         ..
  34         if (timedOut(myTimer))
  35         {
  36             // timed out
  37         }
  38         else
  39         {
  40             // do something possible blocking
  41         }
  42     @endcode
  43
  44     Constructor set signal handler on sigalarm and alarm(). Destructor
  45     clears these.
  46
  47     timedOut is macro because setjmp can't be in member function of timer.
  48     ?something to do with stack frames.
  49
  50 Warning
  51     The setjmp restores complete register state so including local vars
  52     held in regs. So if in blocking part something gets calced in a stack
  53     based variable make sure it is declared 'volatile'.
  54
  55 SourceFiles
  56     timer.C
  57
  58 \*---------------------------------------------------------------------------*/
  59
  60 #ifndef timer_H
  61 #define timer_H
  62
  63 #include "className.H"
  64
  65 #include <signal.h>
  66 #include <setjmp.h>
  67
  68 // * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
  69
  70 //- check it a timeout has occured
  71 //  keep setjmp in same stack frame so no function calls
  72 #define timedOut(x) \
  73     (((x).newTimeOut_ > 0) ? setjmp(Foam::timer::envAlarm) : false)
  74
  75 namespace Foam
  76 {
  77
  78 /*---------------------------------------------------------------------------*\
  79                            Class timer Declaration
  80 \*---------------------------------------------------------------------------*/
  81
  82 class timer
  83 {
  84     // Private data
  85
  86         //- old signal masks
  87         static struct sigaction oldAction_;
  88
  89         //- old alarm() value
  90         static unsigned int oldTimeOut_;
  91
  92
  93     // Private Member Functions
  94
  95         //- alarm handler
  96         static void signalHandler(int);
  97
  98
  99 public:
 100
 101     // Public data
 102
 103         //- Declare name of the class and its debug switch
 104         ClassName("timer");
 105
 106         //- current time out value. Needed by macro timedOut
 107         unsigned int newTimeOut_;
 108
 109         //- state for setjmp. Needed by macro timedOut
 110         static jmp_buf envAlarm;
 111
 112
 113     // Constructors
 114
 115         //- Construct from components.
 116         //  newTimeOut=0 makes it do nothing.
 117         timer(const unsigned int newTimeOut);
 118
 119
 120     // Destructor
 121
 122         ~timer();
 123 };
 124
 125
 126 // * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
 127
 128 } // End namespace Foam
 129
 130 // * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
 131
 132 #endif
 133
 134 // ************************************************************************* //