/usr/include/pion/admin_rights.hpp is in libpion-dev 5.0.7+dfsg-4.
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 | // ---------------------------------------------------------------------
// pion: a Boost C++ framework for building lightweight HTTP interfaces
// ---------------------------------------------------------------------
// Copyright (C) 2007-2014 Splunk Inc. (https://github.com/splunk/pion)
//
// Distributed under the Boost Software License, Version 1.0.
// See http://www.boost.org/LICENSE_1_0.txt
//
#ifndef __PION_ADMIN_RIGHTS_HEADER__
#define __PION_ADMIN_RIGHTS_HEADER__
#include <pion/config.hpp>
#include <pion/logger.hpp>
#include <boost/cstdint.hpp>
#include <boost/thread/mutex.hpp>
namespace pion { // begin namespace pion
///
/// admin_rights: obtains administrative rights for the process
///
class PION_API admin_rights {
public:
/**
* constructs object, obtaining administrative rights; will block
* if another thread has already obtained rights
*
* @param use_log if false, then no logging will be performed
*/
admin_rights(bool use_log = true);
/// destructor releases administrative rights
virtual ~admin_rights() { release(); }
/// releases administrative rights
void release(void);
/// calculates the user id based upon the user configuration parameter
static long run_as_user(const std::string& user_name);
/// calculates the group id based upon the group configuration parameter
static long run_as_group(const std::string& group_name);
private:
/**
* finds an identifier within a system credentials file (users or groups)
*
* @param name descriptive name to lookup (user or group name, may be id)
* @param file system credentials file to look within
*
* @return boost::int32_t identifier found, or -1 if none found
*/
static long find_system_id(const std::string& name, const std::string& file);
/// adminisitrator or root user identifier
static const boost::int16_t ADMIN_USER_ID;
/// mutex used to prevent multiple threads from corrupting user id
static boost::mutex m_mutex;
/// primary logging interface used by this class
logger m_logger;
/// lock used to prevent multiple threads from corrupting user id
boost::unique_lock<boost::mutex> m_lock;
/// saved user identifier before upgrading to administrator
boost::int16_t m_user_id;
/// true if the class currently holds administrative rights
bool m_has_rights;
/// if false, then no logging will be performed
bool m_use_log;
};
} // end namespace pion
#endif
|