This file is indexed.

/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