HALF ECHO LEARN / REFERENCE COLLECTION

v262.2

src/sysupdate/sysupdate-resource.h

3,436 bytesGit mode 100644Download original fileLGPL-2.1-or-later

Git blob: 1c6d4cb0f7336a5eee17fc05ee8990fe3fb4be3e

Lines 1–102 of 102

/* SPDX-License-Identifier: LGPL-2.1-or-later */
#pragma once
 
#include "gpt.h"
#include "sysupdate-forward.h"
 
typedef enum ResourceType {
        RESOURCE_URL_FILE,
        RESOURCE_URL_TAR,
        RESOURCE_TAR,
        RESOURCE_PARTITION,
        RESOURCE_REGULAR_FILE,
        RESOURCE_DIRECTORY,
        RESOURCE_SUBVOLUME,
        _RESOURCE_TYPE_MAX,
        _RESOURCE_TYPE_INVALID = -EINVAL,
} ResourceType;
 
static inline bool RESOURCE_IS_SOURCE(ResourceType t) {
        return IN_SET(t,
                      RESOURCE_URL_FILE,
                      RESOURCE_URL_TAR,
                      RESOURCE_TAR,
                      RESOURCE_REGULAR_FILE,
                      RESOURCE_DIRECTORY,
                      RESOURCE_SUBVOLUME);
}
 
static inline bool RESOURCE_IS_TARGET(ResourceType t) {
        return IN_SET(t,
                      RESOURCE_PARTITION,
                      RESOURCE_REGULAR_FILE,
                      RESOURCE_DIRECTORY,
                      RESOURCE_SUBVOLUME);
}
 
/* Returns true for all resources that deal with file system objects, i.e. where we operate on top of the
 * file system layer, instead of below. */
static inline bool RESOURCE_IS_FILESYSTEM(ResourceType t) {
        return IN_SET(t,
                      RESOURCE_TAR,
                      RESOURCE_REGULAR_FILE,
                      RESOURCE_DIRECTORY,
                      RESOURCE_SUBVOLUME);
}
 
static inline bool RESOURCE_IS_TAR(ResourceType t) {
        return IN_SET(t,
                      RESOURCE_TAR,
                      RESOURCE_URL_TAR);
}
 
static inline bool RESOURCE_IS_URL(ResourceType t) {
        return IN_SET(t,
                      RESOURCE_URL_TAR,
                      RESOURCE_URL_FILE);
}
 
typedef enum PathRelativeTo {
        /* Please make sure to follow the naming of the corresponding PartitionDesignator enum values,
         * where this makes sense, like for the following three. */
        PATH_RELATIVE_TO_ROOT,
        PATH_RELATIVE_TO_ESP,
        PATH_RELATIVE_TO_XBOOTLDR,
        PATH_RELATIVE_TO_BOOT, /* Refers to $BOOT from the BLS. No direct counterpart in PartitionDesignator */
        PATH_RELATIVE_TO_EXPLICIT,
        _PATH_RELATIVE_TO_MAX,
        _PATH_RELATIVE_TO_INVALID = -EINVAL,
} PathRelativeTo;
 
typedef struct Resource {
        ResourceType type;
 
        /* Where to look for instances, and what to match precisely */
        char *path;
        bool path_auto; /* automatically find root path (only available if target resource, not source resource) */
        PathRelativeTo path_relative_to;
        char **patterns;
        GptPartitionType partition_type;
        bool partition_type_set;
 
        /* All instances of this resource we found */
        Instance **instances;
        size_t n_instances;
 
        /* If this is a partition resource (RESOURCE_PARTITION), then how many partition slots are currently unassigned, that we can use */
        size_t n_empty;
} Resource;
 
void resource_destroy(Resource *rr);
 
bool resource_has_glob_directory_pattern(Resource *rr);
 
int resource_load_instances(Resource *rr, bool verify, Hashmap **web_cache);
 
Instance* resource_find_instance(Resource *rr, const char *version);
 
int resource_resolve_path(Resource *rr, const char *root, const char *relative_to_directory, const char *node);
 
DECLARE_STRING_TABLE_LOOKUP(resource_type, ResourceType);
DECLARE_STRING_TABLE_LOOKUP(path_relative_to, PathRelativeTo);