src/basic/capability-util.h

   1 /* SPDX-License-Identifier: LGPL-2.1+ */
   2 #pragma once
   3
   4 /***
   5   Copyright 2010 Lennart Poettering
   6 ***/
   7
   8 #include <stdbool.h>
   9 #include <stdint.h>
  10 #include <sys/capability.h>
  11 #include <sys/types.h>
  12
  13 #include "macro.h"
  14 #include "util.h"
  15
  16 #define CAP_ALL (uint64_t) -1
  17
  18 unsigned long cap_last_cap(void);
  19 int have_effective_cap(int value);
  20 int capability_bounding_set_drop(uint64_t keep, bool right_now);
  21 int capability_bounding_set_drop_usermode(uint64_t keep);
  22
  23 int capability_ambient_set_apply(uint64_t set, bool also_inherit);
  24 int capability_update_inherited_set(cap_t caps, uint64_t ambient_set);
  25
  26 int drop_privileges(uid_t uid, gid_t gid, uint64_t keep_capabilities);
  27
  28 int drop_capability(cap_value_t cv);
  29
  30 DEFINE_TRIVIAL_CLEANUP_FUNC(cap_t, cap_free);
  31 #define _cleanup_cap_free_ _cleanup_(cap_freep)
  32
  33 static inline void cap_free_charpp(char **p) {
  34         if (*p)
  35                 cap_free(*p);
  36 }
  37 #define _cleanup_cap_free_charp_ _cleanup_(cap_free_charpp)
  38
  39 static inline bool cap_test_all(uint64_t caps) {
  40         uint64_t m;
  41         m = (UINT64_C(1) << (cap_last_cap() + 1)) - 1;
  42         return FLAGS_SET(caps, m);
  43 }
  44
  45 bool ambient_capabilities_supported(void);