/* * 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 . * * Authors: * Alexander Larsson */ #ifndef __FLATPAK_RUN_H__ #define __FLATPAK_RUN_H__ #include "libglnx/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_GROUP_INSTANCE "Instance" #define FLATPAK_METADATA_KEY_INSTANCE_PATH "instance-path" #define FLATPAK_METADATA_KEY_INSTANCE_ID "instance-id" #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_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" gboolean flatpak_run_add_extension_args (FlatpakBwrap *bwrap, GKeyFile *metakey, const char *full_ref, gboolean use_ld_so_cache, char **extensions_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, 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); GFile *flatpak_ensure_data_dir (const char *app_id, 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, GVariant *app_deploy_data, const char *app_extensions, GFile *runtime_files, GVariant *runtime_deploy_data, const char *runtime_extensions, const char *app_id, const char *app_branch, const char *runtime_ref, GFile *app_id_dir, FlatpakContext *final_app_context, FlatpakContext *cmdline_context, gboolean sandbox, gboolean build, gboolean devel, char **app_info_path_out, char **host_instance_id_host_dir_out, GError **error); gboolean flatpak_run_app (const char *app_ref, FlatpakDeploy *app_deploy, FlatpakContext *extra_context, const char *custom_runtime, const char *custom_runtime_version, const char *custom_runtime_commit, FlatpakRunFlags flags, const char *cwd, const char *custom_command, char *args[], int n_args, char **instance_dir_out, GCancellable *cancellable, GError **error); #endif /* __FLATPAK_RUN_H__ */