Debian Codegraph @

src/shared/varlink-io.systemd.StorageProvider.c

raw
1 /* SPDX-License-Identifier: LGPL-2.1-or-later */
2
3 #include "bus-polkit.h"
4 #include "varlink-io.systemd.StorageProvider.h"
5
6 static SD_VARLINK_DEFINE_ENUM_TYPE(
7 VolumeType,
8 SD_VARLINK_FIELD_COMMENT("Block device storage volumes, block-addressable"),
9 SD_VARLINK_DEFINE_ENUM_VALUE(blk),
10 SD_VARLINK_FIELD_COMMENT("Regular file storage volumes, byte-addressable"),
11 SD_VARLINK_DEFINE_ENUM_VALUE(reg),
12 SD_VARLINK_FIELD_COMMENT("POSIX file system storage volumes, path/offset-addressable"),
13 SD_VARLINK_DEFINE_ENUM_VALUE(dir));
14
15 static SD_VARLINK_DEFINE_ENUM_TYPE(
16 CreateMode,
17 SD_VARLINK_FIELD_COMMENT("Open if exists already, create if missing"),
18 SD_VARLINK_DEFINE_ENUM_VALUE(any),
19 SD_VARLINK_FIELD_COMMENT("Create if missing, fail if exists already"),
20 SD_VARLINK_DEFINE_ENUM_VALUE(new),
21 SD_VARLINK_FIELD_COMMENT("Open if exists already, fail if missing"),
22 SD_VARLINK_DEFINE_ENUM_VALUE(open));
23
24 static SD_VARLINK_DEFINE_METHOD(
25 Acquire,
26 SD_VARLINK_FIELD_COMMENT("The name of the storage volume to acquire"),
27 SD_VARLINK_DEFINE_INPUT(name, SD_VARLINK_STRING, 0),
28 SD_VARLINK_FIELD_COMMENT("Determines whether to open or create a storage volume"),
29 SD_VARLINK_DEFINE_INPUT_BY_TYPE(createMode, CreateMode, SD_VARLINK_NULLABLE),
30 SD_VARLINK_FIELD_COMMENT("The template to use when creating a new storage volume"),
31 SD_VARLINK_DEFINE_INPUT(template, SD_VARLINK_STRING, SD_VARLINK_NULLABLE),
32 SD_VARLINK_FIELD_COMMENT("Controls read/write access to the storage volume. If false and the storage volume cannot be opened in writable mode the call will fail. If null, storage volume will be acquired in writable mode if possible, read-only otherwise. If true, storage volume will be opened in read-only mode (and fail if that's not possible)."),
33 SD_VARLINK_DEFINE_INPUT(readOnly, SD_VARLINK_BOOL, SD_VARLINK_NULLABLE),
34 SD_VARLINK_FIELD_COMMENT("Dictates what kind of storage volume to request. Some storage volumes can be acquired either as regular file or as block device. In all other cases if this value doesn't match the volume type, the request will fail."),
35 SD_VARLINK_DEFINE_INPUT_BY_TYPE(requestAs, VolumeType, SD_VARLINK_NULLABLE),
36 SD_VARLINK_FIELD_COMMENT("The size of the storage volume, if one is created. Has no effect if no storage volume is created."),
37 SD_VARLINK_DEFINE_INPUT(createSizeBytes, SD_VARLINK_INT, SD_VARLINK_NULLABLE),
38 VARLINK_DEFINE_POLKIT_INPUT,
39 SD_VARLINK_FIELD_COMMENT("Returns an index into the array of file descriptors associated with this reply. This may be used to get the file descriptor of the volume. The file descriptor must be properly opened, i.e. not an O_PATH file descriptor."),
40 SD_VARLINK_DEFINE_OUTPUT(fileDescriptorIndex, SD_VARLINK_INT, 0),
41 SD_VARLINK_FIELD_COMMENT("The storage volume type, i.e. ultimately the inode type of the returned file descriptor"),
42 SD_VARLINK_DEFINE_OUTPUT_BY_TYPE(type, VolumeType, 0),
43 SD_VARLINK_FIELD_COMMENT("Whether storage volume has been opened in read-only mode"),
44 SD_VARLINK_DEFINE_OUTPUT(readOnly, SD_VARLINK_BOOL, 0),
45 SD_VARLINK_FIELD_COMMENT("Base UID for the returned file descriptor (if directory). If not specified shall default to 0."),
46 SD_VARLINK_DEFINE_OUTPUT(baseUID, SD_VARLINK_INT, SD_VARLINK_NULLABLE),
47 SD_VARLINK_FIELD_COMMENT("Base GID for the returned file descriptor (if directory). If not specified shall default to 0."),
48 SD_VARLINK_DEFINE_OUTPUT(baseGID, SD_VARLINK_INT, SD_VARLINK_NULLABLE));
49
50 static SD_VARLINK_DEFINE_METHOD_FULL(
51 ListVolumes,
52 SD_VARLINK_REQUIRES_MORE,
53 SD_VARLINK_FIELD_COMMENT("Specifies a shell glob to filter enumeration by"),
54 SD_VARLINK_DEFINE_INPUT(matchName, SD_VARLINK_STRING, SD_VARLINK_NULLABLE),
55 SD_VARLINK_FIELD_COMMENT("The storage volume's primary name"),
56 SD_VARLINK_DEFINE_OUTPUT(name, SD_VARLINK_STRING, 0),
57 SD_VARLINK_FIELD_COMMENT("Additional names"),
58 SD_VARLINK_DEFINE_OUTPUT(aliases, SD_VARLINK_STRING, SD_VARLINK_NULLABLE|SD_VARLINK_ARRAY),
59 SD_VARLINK_FIELD_COMMENT("The type of the storage volume"),
60 SD_VARLINK_DEFINE_OUTPUT_BY_TYPE(type, VolumeType, 0),
61 SD_VARLINK_FIELD_COMMENT("Whether the storage volume is read-only."),
62 SD_VARLINK_DEFINE_OUTPUT(readOnly, SD_VARLINK_BOOL, SD_VARLINK_NULLABLE),
63 SD_VARLINK_FIELD_COMMENT("Size in bytes, if known"),
64 SD_VARLINK_DEFINE_OUTPUT(sizeBytes, SD_VARLINK_INT, SD_VARLINK_NULLABLE),
65 SD_VARLINK_FIELD_COMMENT("Used bytes, if known"),
66 SD_VARLINK_DEFINE_OUTPUT(usedBytes, SD_VARLINK_INT, SD_VARLINK_NULLABLE));
67
68 static SD_VARLINK_DEFINE_METHOD_FULL(
69 ListTemplates,
70 SD_VARLINK_REQUIRES_MORE,
71 SD_VARLINK_FIELD_COMMENT("Specifies a shell glob to filter enumeration by"),
72 SD_VARLINK_DEFINE_INPUT(matchName, SD_VARLINK_STRING, SD_VARLINK_NULLABLE),
73 SD_VARLINK_FIELD_COMMENT("The template's name"),
74 SD_VARLINK_DEFINE_OUTPUT(name, SD_VARLINK_STRING, 0),
75 SD_VARLINK_FIELD_COMMENT("The type of the storage volumes defined by this template"),
76 SD_VARLINK_DEFINE_OUTPUT_BY_TYPE(type, VolumeType, 0));
77
78 static SD_VARLINK_DEFINE_ERROR(NoSuchVolume);
79 static SD_VARLINK_DEFINE_ERROR(VolumeExists);
80 static SD_VARLINK_DEFINE_ERROR(NoSuchTemplate);
81 static SD_VARLINK_DEFINE_ERROR(TypeNotSupported);
82 static SD_VARLINK_DEFINE_ERROR(WrongType);
83 static SD_VARLINK_DEFINE_ERROR(CreateNotSupported);
84 static SD_VARLINK_DEFINE_ERROR(CreateSizeRequired);
85 static SD_VARLINK_DEFINE_ERROR(ReadOnlyVolume);
86 static SD_VARLINK_DEFINE_ERROR(BadTemplate);
87
88 SD_VARLINK_DEFINE_INTERFACE(
89 io_systemd_StorageProvider,
90 "io.systemd.StorageProvider",
91 SD_VARLINK_INTERFACE_COMMENT("Storage Provider API, a generic interface for acquiring access to storage volumes"),
92 SD_VARLINK_SYMBOL_COMMENT("Encodes three classes of storage volumes. This follows the kernel's nomenclature for inode types, i.e. reg, dir, blk."),
93 &vl_type_VolumeType,
94 SD_VARLINK_SYMBOL_COMMENT("Determines whether to open existing or create a new storage volume."),
95 &vl_type_CreateMode,
96 SD_VARLINK_SYMBOL_COMMENT("Acquires a file descriptor for a storage volume."),
97 &vl_method_Acquire,
98 SD_VARLINK_SYMBOL_COMMENT("Lists available storage volumes."),
99 &vl_method_ListVolumes,
100 SD_VARLINK_SYMBOL_COMMENT("Lists available templates."),
101 &vl_method_ListTemplates,
102 SD_VARLINK_SYMBOL_COMMENT("No storage volume under the specified name exists."),
103 &vl_error_NoSuchVolume,
104 SD_VARLINK_SYMBOL_COMMENT("A storage volume under the specified name already exists."),
105 &vl_error_VolumeExists,
106 SD_VARLINK_SYMBOL_COMMENT("No template under the specified name exists."),
107 &vl_error_NoSuchTemplate,
108 SD_VARLINK_SYMBOL_COMMENT("The specified volume type is not supported by this backend or system."),
109 &vl_error_TypeNotSupported,
110 SD_VARLINK_SYMBOL_COMMENT("The volume's type does not match the requested volume type."),
111 &vl_error_WrongType,
112 SD_VARLINK_SYMBOL_COMMENT("This backend does not support storage volume creation of the requested type."),
113 &vl_error_CreateNotSupported,
114 SD_VARLINK_SYMBOL_COMMENT("This backend or selected volume type requires a storage volume size to be specified if the storage volume does not exist yet and needs to be created."),
115 &vl_error_CreateSizeRequired,
116 SD_VARLINK_SYMBOL_COMMENT("A storage volume was to be acquired in writable mode, but only read-only access is permitted."),
117 &vl_error_ReadOnlyVolume,
118 SD_VARLINK_SYMBOL_COMMENT("Template not suitable for this storage volume type."),
119 &vl_error_BadTemplate);