mirror of
https://github.com/flatpak/flatpak.git
synced 2026-01-26 22:22:22 +00:00
c68f31d86a
Recent Meson versions have warnings if you add the subprojects directory as an include path, because the way Meson wants to consume subprojects is by the subproject's build system producing a Meson dependency object that encapsulates its include directory. Flatpak doesn't have a Meson build system yet, but I'm working on that. libglnx seems to be set up to have the libglnx directory be its include path instead: for example, ostree (by the author of libglnx) already uses "libglnx.h" or <libglnx.h> everywhere. Do the same here. Signed-off-by: Simon McVittie <smcv@collabora.com>
211 lines
11 KiB
C
211 lines
11 KiB
C
/*
|
|
* Copyright © 2014 Red Hat, Inc
|
|
*
|
|
* This program is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2.1 of the License, or (at your option) any later version.
|
|
*
|
|
* This library 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
|
|
* Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General Public
|
|
* License along with this library. If not, see <http://www.gnu.org/licenses/>.
|
|
*
|
|
* Authors:
|
|
* Alexander Larsson <alexl@redhat.com>
|
|
*/
|
|
|
|
#ifndef __FLATPAK_RUN_H__
|
|
#define __FLATPAK_RUN_H__
|
|
|
|
#include "libglnx.h"
|
|
#include "flatpak-common-types-private.h"
|
|
#include "flatpak-context-private.h"
|
|
#include "flatpak-bwrap-private.h"
|
|
#include "flatpak-utils-private.h"
|
|
#include "flatpak-exports-private.h"
|
|
|
|
gboolean flatpak_run_in_transient_unit (const char *app_id,
|
|
GError **error);
|
|
|
|
/* See flatpak-metadata(5) */
|
|
|
|
#define FLATPAK_METADATA_GROUP_APPLICATION "Application"
|
|
#define FLATPAK_METADATA_GROUP_RUNTIME "Runtime"
|
|
#define FLATPAK_METADATA_KEY_COMMAND "command"
|
|
#define FLATPAK_METADATA_KEY_NAME "name"
|
|
#define FLATPAK_METADATA_KEY_REQUIRED_FLATPAK "required-flatpak"
|
|
#define FLATPAK_METADATA_KEY_RUNTIME "runtime"
|
|
#define FLATPAK_METADATA_KEY_SDK "sdk"
|
|
#define FLATPAK_METADATA_KEY_TAGS "tags"
|
|
|
|
#define FLATPAK_METADATA_GROUP_CONTEXT "Context"
|
|
#define FLATPAK_METADATA_KEY_SHARED "shared"
|
|
#define FLATPAK_METADATA_KEY_SOCKETS "sockets"
|
|
#define FLATPAK_METADATA_KEY_FILESYSTEMS "filesystems"
|
|
#define FLATPAK_METADATA_KEY_PERSISTENT "persistent"
|
|
#define FLATPAK_METADATA_KEY_DEVICES "devices"
|
|
#define FLATPAK_METADATA_KEY_FEATURES "features"
|
|
#define FLATPAK_METADATA_KEY_UNSET_ENVIRONMENT "unset-environment"
|
|
|
|
#define FLATPAK_METADATA_GROUP_INSTANCE "Instance"
|
|
#define FLATPAK_METADATA_KEY_INSTANCE_PATH "instance-path"
|
|
#define FLATPAK_METADATA_KEY_INSTANCE_ID "instance-id"
|
|
#define FLATPAK_METADATA_KEY_ORIGINAL_APP_PATH "original-app-path"
|
|
#define FLATPAK_METADATA_KEY_APP_PATH "app-path"
|
|
#define FLATPAK_METADATA_KEY_APP_COMMIT "app-commit"
|
|
#define FLATPAK_METADATA_KEY_APP_EXTENSIONS "app-extensions"
|
|
#define FLATPAK_METADATA_KEY_ARCH "arch"
|
|
#define FLATPAK_METADATA_KEY_BRANCH "branch"
|
|
#define FLATPAK_METADATA_KEY_FLATPAK_VERSION "flatpak-version"
|
|
#define FLATPAK_METADATA_KEY_ORIGINAL_RUNTIME_PATH "original-runtime-path"
|
|
#define FLATPAK_METADATA_KEY_RUNTIME_PATH "runtime-path"
|
|
#define FLATPAK_METADATA_KEY_RUNTIME_COMMIT "runtime-commit"
|
|
#define FLATPAK_METADATA_KEY_RUNTIME_EXTENSIONS "runtime-extensions"
|
|
#define FLATPAK_METADATA_KEY_SESSION_BUS_PROXY "session-bus-proxy"
|
|
#define FLATPAK_METADATA_KEY_SYSTEM_BUS_PROXY "system-bus-proxy"
|
|
#define FLATPAK_METADATA_KEY_EXTRA_ARGS "extra-args"
|
|
#define FLATPAK_METADATA_KEY_SANDBOX "sandbox"
|
|
#define FLATPAK_METADATA_KEY_BUILD "build"
|
|
#define FLATPAK_METADATA_KEY_DEVEL "devel"
|
|
|
|
#define FLATPAK_METADATA_GROUP_SESSION_BUS_POLICY "Session Bus Policy"
|
|
#define FLATPAK_METADATA_GROUP_SYSTEM_BUS_POLICY "System Bus Policy"
|
|
#define FLATPAK_METADATA_GROUP_PREFIX_POLICY "Policy "
|
|
#define FLATPAK_METADATA_GROUP_ENVIRONMENT "Environment"
|
|
|
|
#define FLATPAK_METADATA_GROUP_PREFIX_EXTENSION "Extension "
|
|
#define FLATPAK_METADATA_KEY_ADD_LD_PATH "add-ld-path"
|
|
#define FLATPAK_METADATA_KEY_AUTODELETE "autodelete"
|
|
#define FLATPAK_METADATA_KEY_DIRECTORY "directory"
|
|
#define FLATPAK_METADATA_KEY_DOWNLOAD_IF "download-if"
|
|
#define FLATPAK_METADATA_KEY_ENABLE_IF "enable-if"
|
|
#define FLATPAK_METADATA_KEY_AUTOPRUNE_UNLESS "autoprune-unless"
|
|
#define FLATPAK_METADATA_KEY_MERGE_DIRS "merge-dirs"
|
|
#define FLATPAK_METADATA_KEY_NO_AUTODOWNLOAD "no-autodownload"
|
|
#define FLATPAK_METADATA_KEY_SUBDIRECTORIES "subdirectories"
|
|
#define FLATPAK_METADATA_KEY_SUBDIRECTORY_SUFFIX "subdirectory-suffix"
|
|
#define FLATPAK_METADATA_KEY_LOCALE_SUBSET "locale-subset"
|
|
#define FLATPAK_METADATA_KEY_VERSION "version"
|
|
#define FLATPAK_METADATA_KEY_VERSIONS "versions"
|
|
|
|
#define FLATPAK_METADATA_KEY_COLLECTION_ID "collection-id"
|
|
|
|
#define FLATPAK_METADATA_GROUP_EXTRA_DATA "Extra Data"
|
|
#define FLATPAK_METADATA_KEY_EXTRA_DATA_CHECKSUM "checksum"
|
|
#define FLATPAK_METADATA_KEY_EXTRA_DATA_INSTALLED_SIZE "installed-size"
|
|
#define FLATPAK_METADATA_KEY_EXTRA_DATA_NAME "name"
|
|
#define FLATPAK_METADATA_KEY_EXTRA_DATA_SIZE "size"
|
|
#define FLATPAK_METADATA_KEY_EXTRA_DATA_URI "uri"
|
|
#define FLATPAK_METADATA_KEY_NO_RUNTIME "NoRuntime"
|
|
|
|
#define FLATPAK_METADATA_GROUP_EXTENSION_OF "ExtensionOf"
|
|
#define FLATPAK_METADATA_KEY_PRIORITY "priority"
|
|
#define FLATPAK_METADATA_KEY_REF "ref"
|
|
#define FLATPAK_METADATA_KEY_TAG "tag"
|
|
|
|
#define FLATPAK_METADATA_GROUP_DCONF "X-DConf"
|
|
#define FLATPAK_METADATA_KEY_DCONF_PATHS "paths"
|
|
#define FLATPAK_METADATA_KEY_DCONF_MIGRATE_PATH "migrate-path"
|
|
|
|
void flatpak_run_extend_ld_path (FlatpakBwrap *bwrap,
|
|
const char *prepend,
|
|
const char *append);
|
|
gboolean flatpak_run_add_extension_args (FlatpakBwrap *bwrap,
|
|
GKeyFile *metakey,
|
|
FlatpakDecomposed *ref,
|
|
gboolean use_ld_so_cache,
|
|
const char *target_path,
|
|
char **extensions_out,
|
|
char **ld_path_out,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
gboolean flatpak_run_add_environment_args (FlatpakBwrap *bwrap,
|
|
const char *app_info_path,
|
|
FlatpakRunFlags flags,
|
|
const char *app_id,
|
|
FlatpakContext *context,
|
|
GFile *app_id_dir,
|
|
GPtrArray *previous_app_id_dirs,
|
|
int per_app_dir_lock_fd,
|
|
FlatpakExports **exports_out,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
char ** flatpak_run_get_minimal_env (gboolean devel,
|
|
gboolean use_ld_so_cache);
|
|
void flatpak_run_apply_env_default (FlatpakBwrap *bwrap,
|
|
gboolean use_ld_so_cache);
|
|
void flatpak_run_apply_env_appid (FlatpakBwrap *bwrap,
|
|
GFile *app_dir);
|
|
void flatpak_run_apply_env_vars (FlatpakBwrap *bwrap,
|
|
FlatpakContext *context);
|
|
FlatpakContext *flatpak_app_compute_permissions (GKeyFile *app_metadata,
|
|
GKeyFile *runtime_metadata,
|
|
GError **error);
|
|
GFile *flatpak_get_data_dir (const char *app_id);
|
|
gboolean flatpak_ensure_data_dir (GFile *app_id_dir,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
gboolean flatpak_run_setup_base_argv (FlatpakBwrap *bwrap,
|
|
GFile *runtime_files,
|
|
GFile *app_id_dir,
|
|
const char *arch,
|
|
FlatpakRunFlags flags,
|
|
GError **error);
|
|
gboolean flatpak_run_add_app_info_args (FlatpakBwrap *bwrap,
|
|
GFile *app_files,
|
|
GFile *original_app_files,
|
|
GBytes *app_deploy_data,
|
|
const char *app_extensions,
|
|
GFile *runtime_files,
|
|
GFile *original_runtime_files,
|
|
GBytes *runtime_deploy_data,
|
|
const char *runtime_extensions,
|
|
const char *app_id,
|
|
const char *app_branch,
|
|
FlatpakDecomposed *runtime_ref,
|
|
GFile *app_id_dir,
|
|
FlatpakContext *final_app_context,
|
|
FlatpakContext *cmdline_context,
|
|
gboolean sandbox,
|
|
gboolean build,
|
|
gboolean devel,
|
|
char **app_info_path_out,
|
|
int instance_id_fd,
|
|
char **host_instance_id_host_dir_out,
|
|
GError **error);
|
|
|
|
gboolean flatpak_run_app (FlatpakDecomposed *app_ref,
|
|
FlatpakDeploy *app_deploy,
|
|
const char *custom_app_path,
|
|
FlatpakContext *extra_context,
|
|
const char *custom_runtime,
|
|
const char *custom_runtime_version,
|
|
const char *custom_runtime_commit,
|
|
const char *custom_usr_path,
|
|
int parent_pid,
|
|
FlatpakRunFlags flags,
|
|
const char *cwd,
|
|
const char *custom_command,
|
|
char *args[],
|
|
int n_args,
|
|
int instance_id_fd,
|
|
char **instance_dir_out,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
extern const char * const *flatpak_abs_usrmerged_dirs;
|
|
|
|
gboolean flatpak_run_parse_x11_display (const char *display,
|
|
int *family,
|
|
char **x11_socket,
|
|
char **remote_host,
|
|
char **original_display_nr,
|
|
GError **error);
|
|
|
|
#endif /* __FLATPAK_RUN_H__ */
|