1 // Copyright 2010 The Kyua Authors.
2 // All rights reserved.
3 //
4 // Redistribution and use in source and binary forms, with or without
5 // modification, are permitted provided that the following conditions are
6 // met:
7 //
8 // * Redistributions of source code must retain the above copyright
9 //   notice, this list of conditions and the following disclaimer.
10 // * Redistributions in binary form must reproduce the above copyright
11 //   notice, this list of conditions and the following disclaimer in the
12 //   documentation and/or other materials provided with the distribution.
13 // * Neither the name of Google Inc. nor the names of its contributors
14 //   may be used to endorse or promote products derived from this software
15 //   without specific prior written permission.
16 //
17 // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
18 // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
19 // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
20 // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
21 // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
22 // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
23 // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
24 // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
25 // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
26 // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
27 // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
28 
29 /// \file utils/signals/exceptions.hpp
30 /// Exception types raised by the signals module.
31 
32 #if !defined(UTILS_SIGNALS_EXCEPTIONS_HPP)
33 #define UTILS_SIGNALS_EXCEPTIONS_HPP
34 
35 #include <stdexcept>
36 
37 namespace utils {
38 namespace signals {
39 
40 
41 /// Base exceptions for signals errors.
42 class error : public std::runtime_error {
43 public:
44     explicit error(const std::string&);
45     ~error(void) throw();
46 };
47 
48 
49 /// Denotes the reception of a signal to controlledly terminate execution.
50 class interrupted_error : public error {
51     /// Signal that caused the interrupt.
52     int _signo;
53 
54 public:
55     explicit interrupted_error(const int signo_);
56     ~interrupted_error(void) throw();
57 
58     int signo(void) const;
59 };
60 
61 
62 /// Exceptions for errno-based errors.
63 ///
64 /// TODO(jmmv): This code is duplicated in, at least, utils::fs.  Figure
65 /// out a way to reuse this exception while maintaining the correct inheritance
66 /// (i.e. be able to keep it as a child of signals::error).
67 class system_error : public error {
68     /// Error number describing this libc error condition.
69     int _original_errno;
70 
71 public:
72     explicit system_error(const std::string&, const int);
73     ~system_error(void) throw();
74 
75     int original_errno(void) const throw();
76 };
77 
78 
79 }  // namespace signals
80 }  // namespace utils
81 
82 
83 #endif  // !defined(UTILS_SIGNALS_EXCEPTIONS_HPP)
84