/usr/include/ace/Null_Semaphore.h is in libace-dev 6.0.1-3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 | // -*- C++ -*-
//==========================================================================
/**
* @file Null_Semaphore.h
*
* $Id: Null_Semaphore.h 91626 2010-09-07 10:59:20Z johnnyw $
*
* Moved from Synch.h.
*
* @author Douglas C. Schmidt <schmidt@cs.wustl.edu>
*/
//==========================================================================
#ifndef ACE_NULL_SEMAPHORE_H
#define ACE_NULL_SEMAPHORE_H
#include /**/ "ace/pre.h"
#include "ace/os_include/os_errno.h"
#include "ace/os_include/sys/os_types.h"
#if !defined (ACE_LACKS_PRAGMA_ONCE)
# pragma once
#endif /* ACE_LACKS_PRAGMA_ONCE */
ACE_BEGIN_VERSIONED_NAMESPACE_DECL
class ACE_Time_Value;
/**
* @class ACE_Null_Semaphore
*
* @brief Implement a do nothing ACE_Semaphore, i.e., all the methods are
* no ops.
*
* Although the methods are no-ops, the return values are different for
* the blocking as opposed to timed acquires. The blocking version of
* acquire() is often used to serialize access to a critical section,
* whereas the timed version is often used to wait for another thread
* to update some condition or change some shared state. When using an
* ACE_Null_Semaphore, however, there's no other thread involved to
* change a state or condition (otherwise, a null semaphore would be
* inappropriate). Returning an error value signifies that the
* state or condition has not been (and can't be) changed, which is
* consistent with the behavior of the threaded case where a timeout
* occurs before the state or condition is changed.
*/
class ACE_Null_Semaphore
{
public:
ACE_Null_Semaphore (unsigned int = 1,
int = 0,
const ACE_TCHAR * = 0,
void * = 0,
int = 0x7fffffff) {}
~ACE_Null_Semaphore (void) {}
/// Return 0.
int remove (void) {return 0;}
/// Return 0.
int acquire (void) {return 0;}
/// Return -1 with @c errno == @c ETIME.
int acquire (ACE_Time_Value &) {errno = ETIME; return -1;}
/// Return -1 with @c errno == @c ETIME.
int acquire (ACE_Time_Value *) {errno = ETIME; return -1;}
/// Return 0.
int tryacquire (void) {return 0;}
/// Return 0.
int release (void) {return 0;}
/// Return 0.
int release (size_t) {return 0;}
/// Return 0.
int acquire_write (void) {return 0;}
/// Return 0.
int tryacquire_write (void) {return 0;}
/// Return 0.
int tryacquire_write_upgrade (void) {return 0;}
/// Return 0.
int acquire_read (void) {return 0;}
/// Return 0.
int tryacquire_read (void) {return 0;}
/// Dump the state of an object.
void dump (void) const {}
/// Declare the dynamic allocation hooks.
//ACE_ALLOC_HOOK_DECLARE;
};
ACE_END_VERSIONED_NAMESPACE_DECL
#include /**/ "ace/post.h"
#endif /* ACE_NULL_SEMAPHORE_H */
|