HALF ECHO LEARN / REFERENCE COLLECTION

v262.2

src/shared/storage-util.h

2,535 bytesGit mode 100644Download original fileLGPL-2.1-or-later

Git blob: fe78112d24b8277552d623ac16d9d6b5559494bb

Lines 1–72 of 72

/* SPDX-License-Identifier: LGPL-2.1-or-later */
#pragma once
 
#include "sd-json.h"
 
#include "string-util.h"
 
/* This closely follows the kernel's inode type naming, i.e. is supposed to be a subset of what
 * inode_type_from_string() parses. */
typedef enum VolumeType {
        VOLUME_BLK,
        VOLUME_REG,
        VOLUME_DIR,
        _VOLUME_TYPE_MAX,
        _VOLUME_TYPE_INVALID = -EINVAL,
} VolumeType;
 
typedef enum CreateMode {
        CREATE_ANY,
        CREATE_NEW,
        CREATE_OPEN,
        _CREATE_MODE_MAX,
        _CREATE_MODE_INVALID = -EINVAL,
} CreateMode;
 
DECLARE_STRING_TABLE_LOOKUP(volume_type, VolumeType);
DECLARE_STRING_TABLE_LOOKUP(create_mode, CreateMode);
 
int json_dispatch_volume_type(const char *name, sd_json_variant *variant, sd_json_dispatch_flags_t flags, void *userdata);
int json_dispatch_create_mode(const char *name, sd_json_variant *variant, sd_json_dispatch_flags_t flags, void *userdata);
 
static inline bool storage_volume_name_is_valid(const char *n) {
        return string_is_safe(n, /* flags= */ 0);
}
 
static inline bool storage_template_name_is_valid(const char *n) {
        return string_is_safe(n, /* flags= */ 0);
}
 
static inline bool storage_provider_name_is_valid(const char *n) {
        return string_is_safe(n, STRING_FILENAME);
}
 
typedef struct StorageAcquireReply {
        int fd;
        VolumeType type;
        int read_only;
        uid_t base_uid;
        gid_t base_gid;
} StorageAcquireReply;
 
#define STORAGE_ACQUIRE_REPLY_INIT                                              \
        (StorageAcquireReply) {                                                 \
                .fd        = -EBADF,                                            \
                .type      = _VOLUME_TYPE_INVALID,                              \
                .read_only = -1,                                                \
                .base_uid  = UID_INVALID,                                       \
                .base_gid  = GID_INVALID,                                       \
        }
 
void storage_acquire_reply_done(StorageAcquireReply *reply);
 
/* On varlink failure, reterr_error_id (if non-NULL) is set to the io.systemd.StorageProvider.*
 * error name. The reply is untouched on any error. */
typedef struct BindVolume BindVolume;
int storage_acquire_volume(
                RuntimeScope scope,
                const BindVolume *bv,
                bool allow_interactive_auth,
                char **reterr_error_id,
                StorageAcquireReply *ret);