NS-3 based Named Data Networking (NDN) simulator
ndnSIM 2.5: NDN, CCN, CCNx, content centric networks
API Documentation
privilege-helper.hpp
Go to the documentation of this file.
1 /* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
2 /*
3  * Copyright (c) 2014-2019, Regents of the University of California,
4  * Arizona Board of Regents,
5  * Colorado State University,
6  * University Pierre & Marie Curie, Sorbonne University,
7  * Washington University in St. Louis,
8  * Beijing Institute of Technology,
9  * The University of Memphis.
10  *
11  * This file is part of NFD (Named Data Networking Forwarding Daemon).
12  * See AUTHORS.md for complete list of NFD authors and contributors.
13  *
14  * NFD is free software: you can redistribute it and/or modify it under the terms
15  * of the GNU General Public License as published by the Free Software Foundation,
16  * either version 3 of the License, or (at your option) any later version.
17  *
18  * NFD is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
19  * without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
20  * PURPOSE. See the GNU General Public License for more details.
21  *
22  * You should have received a copy of the GNU General Public License along with
23  * NFD, e.g., in COPYING.md file. If not, see <http://www.gnu.org/licenses/>.
24  */
25 
26 #ifndef NFD_DAEMON_COMMON_PRIVILEGE_HELPER_HPP
27 #define NFD_DAEMON_COMMON_PRIVILEGE_HELPER_HPP
28 
29 #include "core/common.hpp"
30 
31 #include <unistd.h>
32 
33 namespace nfd {
34 
36 {
37 public:
43  class Error
44  {
45  public:
46  explicit
47  Error(const std::string& what)
48  : m_whatMessage(what)
49  {
50  }
51 
52  const char*
53  what() const
54  {
55  return m_whatMessage.data();
56  }
57 
58  private:
59  const std::string m_whatMessage;
60  };
61 
62  static void
63  initialize(const std::string& userName, const std::string& groupName);
64 
65  static void
66  drop();
67 
68  template<class F>
69  static void
70  runElevated(F&& f)
71  {
72  raise();
73  try {
74  f();
75  }
76  catch (...) {
77  drop();
78  throw;
79  }
80  drop();
81  }
82 
84  static void
85  raise();
86 
88 #ifdef HAVE_PRIVILEGE_DROP_AND_ELEVATE
89  static uid_t s_normalUid;
90  static gid_t s_normalGid;
91 
92  static uid_t s_privilegedUid;
93  static gid_t s_privilegedGid;
94 #endif // HAVE_PRIVILEGE_DROP_AND_ELEVATE
95 };
96 
97 } // namespace nfd
98 
99 #endif // NFD_DAEMON_COMMON_PRIVILEGE_HELPER_HPP
PUBLIC_WITH_TESTS_ELSE_PRIVATE
#define PUBLIC_WITH_TESTS_ELSE_PRIVATE
Definition: common.hpp:41
nfd::PrivilegeHelper::Error
represents a serious seteuid/gid failure
Definition: privilege-helper.hpp:44
nfd::PrivilegeHelper::initialize
static void initialize(const std::string &userName, const std::string &groupName)
Definition: privilege-helper.cpp:45
nfd::PrivilegeHelper
Definition: privilege-helper.hpp:36
common.hpp
nfd
Copyright (c) 2011-2015 Regents of the University of California.
Definition: ndn-common.hpp:40
nfd::PrivilegeHelper::drop
static void drop()
Definition: privilege-helper.cpp:122
nfd::PrivilegeHelper::runElevated
static void runElevated(F &&f)
Definition: privilege-helper.hpp:70
nfd::PrivilegeHelper::Error::what
const char * what() const
Definition: privilege-helper.hpp:53
nfd::PrivilegeHelper::Error::Error
Error(const std::string &what)
Definition: privilege-helper.hpp:47