src/libpakfire/include/pakfire/jail.h

   1 /*#############################################################################
   2 #                                                                             #
   3 # Pakfire - The IPFire package management system                              #
   4 # Copyright (C) 2022 Pakfire development team                                 #
   5 #                                                                             #
   6 # This program is free software: you can redistribute it and/or modify        #
   7 # it under the terms of the GNU General Public License as published by        #
   8 # the Free Software Foundation, either version 3 of the License, or           #
   9 # (at your option) any later version.                                         #
  10 #                                                                             #
  11 # This program is distributed in the hope that it will be useful,             #
  12 # but WITHOUT ANY WARRANTY; without even the implied warranty of              #
  13 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the               #
  14 # GNU General Public License for more details.                                #
  15 #                                                                             #
  16 # You should have received a copy of the GNU General Public License           #
  17 # along with this program.  If not, see <http://www.gnu.org/licenses/>.       #
  18 #                                                                             #
  19 #############################################################################*/
  20
  21 #ifndef PAKFIRE_JAIL_H
  22 #define PAKFIRE_JAIL_H
  23
  24 #include <pakfire/pakfire.h>
  25
  26 struct pakfire_jail;
  27
  28 enum {
  29         PAKFIRE_JAIL_NONE                       = 0,
  30         PAKFIRE_JAIL_INTERACTIVE        = (1 << 0),
  31 };
  32
  33 typedef int (*pakfire_jail_log_callback)(struct pakfire* pakfire, void* data,
  34         int priority, const char* line, size_t length);
  35
  36 int pakfire_jail_create(struct pakfire_jail** jail, struct pakfire* pakfire, int flags);
  37
  38 struct pakfire_jail* pakfire_jail_ref(struct pakfire_jail* jail);
  39 struct pakfire_jail* pakfire_jail_unref(struct pakfire_jail* jail);
  40
  41 // Logging
  42 int pakfire_jail_set_log_callback(struct pakfire_jail* jail,
  43         pakfire_jail_log_callback callback, void* data);
  44
  45 // Resource Limits
  46 int pakfire_jail_nice(struct pakfire_jail* jail, int nice);
  47
  48 // Environment
  49 const char* pakfire_jail_get_env(struct pakfire_jail* jail, const char* key);
  50 int pakfire_jail_set_env(struct pakfire_jail* jail, const char* key, const char* value);
  51 int pakfire_jail_import_env(struct pakfire_jail* jail, const char* env[]);
  52
  53 // Execute
  54 int pakfire_jail_exec(struct pakfire_jail* jail, const char* argv[], char*** output);
  55 int pakfire_jail_exec_script(struct pakfire_jail* jail,
  56         const char* script, const size_t size, const char* args[], char*** output);
  57
  58 // Utility functions
  59 char* pakfire_jail_concat_output(struct pakfire_jail* jail,
  60         const char** input, size_t* length);
  61
  62 #ifdef PAKFIRE_PRIVATE
  63
  64 #include <pakfire/cgroup.h>
  65
  66 // Resource limits
  67 int pakfire_jail_set_cgroup(struct pakfire_jail* jail, struct pakfire_cgroup* cgroup);
  68
  69 // Convenience functions
  70 int pakfire_jail_run(struct pakfire* pakfire, const char* argv[], int flags, char*** output);
  71 int pakfire_jail_run_script(struct pakfire* pakfire,
  72         const char* script, const size_t length, const char* argv[], int flags, char*** output);
  73
  74 int pakfire_jail_shell(struct pakfire* pakfire);
  75 int pakfire_jail_ldconfig(struct pakfire* pakfire);
  76
  77 #endif /* PAKFIRE_PRIVATE */
  78
  79 #endif /* PAKFIRE_JAIL_H */