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 enum pakfire_jail_flags
{
29 PAKFIRE_JAIL_NONE
= 0,
32 int pakfire_jail_create(struct pakfire_jail
** jail
, struct pakfire
* pakfire
, int flags
);
34 struct pakfire_jail
* pakfire_jail_ref(struct pakfire_jail
* jail
);
35 struct pakfire_jail
* pakfire_jail_unref(struct pakfire_jail
* jail
);
38 int pakfire_jail_bind(struct pakfire_jail
* jail
,
39 const char* source
, const char* target
, int flags
);
42 int pakfire_jail_nice(struct pakfire_jail
* jail
, int nice
);
45 int pakfire_jail_set_timeout(struct pakfire_jail
* jail
, unsigned int timeout
);
48 const char* pakfire_jail_get_env(struct pakfire_jail
* jail
, const char* key
);
49 int pakfire_jail_set_env(struct pakfire_jail
* jail
, const char* key
, const char* value
);
50 int pakfire_jail_import_env(struct pakfire_jail
* jail
, const char* env
[]);
53 typedef int (*pakfire_jail_communicate_in
)
54 (struct pakfire
* pakfire
, void* data
, int fd
);
55 typedef int (*pakfire_jail_communicate_out
)
56 (struct pakfire
* pakfire
, void* data
, int priority
, const char* line
, const size_t length
);
58 int pakfire_jail_exec(
59 struct pakfire_jail
* jail
,
61 pakfire_jail_communicate_in callback_in
,
62 pakfire_jail_communicate_out callback_out
,
65 #ifdef PAKFIRE_PRIVATE
67 #include <pakfire/cgroup.h>
70 int pakfire_jail_capture_stdout(struct pakfire
* pakfire
, void* data
,
71 int priority
, const char* line
, size_t length
);
74 int pakfire_jail_set_cgroup(struct pakfire_jail
* jail
, struct pakfire_cgroup
* cgroup
);
76 // Convenience functions
77 int pakfire_jail_run(struct pakfire
* pakfire
, const char* argv
[], int flags
, char** output
);
78 int pakfire_jail_run_script(struct pakfire
* pakfire
,
79 const char* script
, const size_t length
, const char* argv
[], int flags
);
81 int pakfire_jail_exec_script(struct pakfire_jail
* jail
,
85 pakfire_jail_communicate_in callback_in
,
86 pakfire_jail_communicate_out callback_out
,
89 int pakfire_jail_shell(struct pakfire_jail
* jail
);
90 int pakfire_jail_ldconfig(struct pakfire
* pakfire
);
92 #endif /* PAKFIRE_PRIVATE */
94 #endif /* PAKFIRE_JAIL_H */