build: Create a jail for each build

[pakfire.git] / src / libpakfire / include / pakfire / jail.h

/*#############################################################################
#                                                                             #
# Pakfire - The IPFire package management system                              #
# Copyright (C) 2022 Pakfire development team                                 #
#                                                                             #
# This program is free software: you can redistribute it and/or modify        #
# it under the terms of the GNU General Public License as published by        #
# the Free Software Foundation, either version 3 of the License, or           #
# (at your option) any later version.                                         #
#                                                                             #
# 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, see <http://www.gnu.org/licenses/>.       #
#                                                                             #
#############################################################################*/

#ifndef PAKFIRE_JAIL_H
#define PAKFIRE_JAIL_H

#include <pakfire/pakfire.h>

struct pakfire_jail;

enum {
	PAKFIRE_JAIL_NONE			= 0,
	PAKFIRE_JAIL_INTERACTIVE	= (1 << 0),
};

typedef int (*pakfire_jail_log_callback)(struct pakfire* pakfire, void* data,
	int priority, const char* line, size_t length);

int pakfire_jail_create(struct pakfire_jail** jail, struct pakfire* pakfire, int flags);

struct pakfire_jail* pakfire_jail_ref(struct pakfire_jail* jail);
struct pakfire_jail* pakfire_jail_unref(struct pakfire_jail* jail);

// Logging
int pakfire_jail_set_log_callback(struct pakfire_jail* jail,
	pakfire_jail_log_callback callback, void* data);

// Resource Limits
int pakfire_jail_nice(struct pakfire_jail* jail, int nice);

// Environment
const char* pakfire_jail_get_env(struct pakfire_jail* jail, const char* key);
int pakfire_jail_set_env(struct pakfire_jail* jail, const char* key, const char* value);
int pakfire_jail_import_env(struct pakfire_jail* jail, const char* env[]);

// Execute
int pakfire_jail_exec(struct pakfire_jail* jail, const char* argv[], char*** output);
int pakfire_jail_exec_script(struct pakfire_jail* jail,
	const char* script, const size_t size, const char* args[], char*** output);

// Utility functions
char* pakfire_jail_concat_output(struct pakfire_jail* jail,
	const char** input, size_t* length);

#ifdef PAKFIRE_PRIVATE

// Convenience functions
int pakfire_jail_run(struct pakfire* pakfire, const char* argv[], int flags, char*** output);
int pakfire_jail_run_script(struct pakfire* pakfire,
	const char* script, const size_t length, const char* argv[], int flags, char*** output);

int pakfire_jail_shell(struct pakfire* pakfire);
int pakfire_jail_ldconfig(struct pakfire* pakfire);

#endif /* PAKFIRE_PRIVATE */

#endif /* PAKFIRE_JAIL_H */