1 /*#############################################################################
3 # Pakfire - The IPFire package management system #
4 # Copyright (C) 2022 Pakfire development team #
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. #
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. #
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/>. #
19 #############################################################################*/
21 #ifndef PAKFIRE_JAIL_H
22 #define PAKFIRE_JAIL_H
24 #include <pakfire/pakfire.h>
28 typedef int (*pakfire_jail_log_callback
)
29 (struct pakfire
* pakfire
, void* data
, int priority
, const char* line
, size_t length
);
31 int pakfire_jail_create(struct pakfire_jail
** jail
, struct pakfire
* pakfire
);
33 struct pakfire_jail
* pakfire_jail_ref(struct pakfire_jail
* jail
);
34 struct pakfire_jail
* pakfire_jail_unref(struct pakfire_jail
* jail
);
37 int pakfire_jail_bind(struct pakfire_jail
* jail
,
38 const char* source
, const char* target
, int flags
);
41 void pakfire_jail_set_log_callback(struct pakfire_jail
* jail
,
42 pakfire_jail_log_callback callback
, void* data
);
45 int pakfire_jail_nice(struct pakfire_jail
* jail
, int nice
);
48 int pakfire_jail_set_timeout(struct pakfire_jail
* jail
, unsigned int timeout
);
51 const char* pakfire_jail_get_env(struct pakfire_jail
* jail
, const char* key
);
52 int pakfire_jail_set_env(struct pakfire_jail
* jail
, const char* key
, const char* value
);
53 int pakfire_jail_import_env(struct pakfire_jail
* jail
, const char* env
[]);
56 typedef int (*pakfire_jail_communicate_in
)
57 (struct pakfire
* pakfire
, void* data
, int fd
);
58 typedef int (*pakfire_jail_communicate_out
)
59 (struct pakfire
* pakfire
, void* data
, int priority
, const char* line
, const size_t length
);
61 enum pakfire_jail_exec_flags
{
62 PAKFIRE_JAIL_HAS_NETWORKING
= (1 << 0),
63 PAKFIRE_JAIL_NOENT_OK
= (1 << 1),
64 PAKFIRE_JAIL_HAS_LOOP_DEVICES
= (1 << 2),
67 int pakfire_jail_exec(
68 struct pakfire_jail
* jail
,
70 pakfire_jail_communicate_in callback_in
,
71 pakfire_jail_communicate_out callback_out
,
75 #ifdef PAKFIRE_PRIVATE
77 #include <pakfire/cgroup.h>
80 int pakfire_jail_capture_stdout(struct pakfire
* pakfire
, void* data
,
81 int priority
, const char* line
, size_t length
);
84 int pakfire_jail_set_cgroup(struct pakfire_jail
* jail
, struct pakfire_cgroup
* cgroup
);
86 // Convenience functions
87 int pakfire_jail_run(struct pakfire
* pakfire
, const char* argv
[], int flags
, char** output
);
88 int pakfire_jail_run_script(struct pakfire
* pakfire
,
89 const char* script
, const size_t length
, const char* argv
[], int flags
);
91 int pakfire_jail_exec_script(struct pakfire_jail
* jail
,
95 pakfire_jail_communicate_in callback_in
,
96 pakfire_jail_communicate_out callback_out
,
99 int pakfire_jail_shell(struct pakfire_jail
* jail
);
100 int pakfire_jail_ldconfig(struct pakfire
* pakfire
);
101 int pakfire_jail_run_systemd_tmpfiles(struct pakfire
* pakfire
);
103 #endif /* PAKFIRE_PRIVATE */
105 #endif /* PAKFIRE_JAIL_H */