rec: allow exception to proxy protocal usage for specific listen addresses

[thirdparty/pdns.git] / pdns / capabilities.hh

/*
 * This file is part of PowerDNS or dnsdist.
 * Copyright -- PowerDNS.COM B.V. and its contributors
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of version 2 of the GNU General Public License as
 * published by the Free Software Foundation.
 *
 * In addition, for the avoidance of any doubt, permission is granted to
 * link this program with OpenSSL and to (re)distribute the binaries
 * produced as the result of such linking.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
 */
#pragma once

#include <set>

/* return true on success, false if support is not available or we don't
   have enough capabilities to drop our capabilities (I know),
   and throw on more unexpected errors.
*/
bool dropCapabilities(std::set<std::string> capabilitiesToKeep = {});
/* drop capabilities on setuid()/setgid() */
bool dropCapabilitiesAfterSwitchingIDs();
/* retain capabilities on setuid()/setgid() */
bool keepCapabilitiesAfterSwitchingIDs();