1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
|
/*
* storage_util.h: utility functions for storage driver
*
* This library 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/>.
*/
#pragma once
#include <sys/stat.h>
#include "internal.h"
#include "vircommand.h"
#include "storage_backend.h"
/* Storage Pool Namespace options to share w/ storage_backend_fs.c and
* the virStorageBackendFileSystemMountCmd method */
typedef struct _virStoragePoolFSMountOptionsDef virStoragePoolFSMountOptionsDef;
struct _virStoragePoolFSMountOptionsDef {
size_t noptions;
char **options;
};
int
virStorageBackendNamespaceInit(int poolType,
virXMLNamespace *xmlns);
/* File creation/cloning functions used for cloning between backends */
int
virStorageBackendCreateVolUsingQemuImg(virStoragePoolObj *pool,
virStorageVolDef *vol,
virStorageVolDef *inputvol,
unsigned int flags);
virStorageBackendBuildVolFrom
virStorageBackendGetBuildVolFromFunction(virStorageVolDef *vol,
virStorageVolDef *inputvol);
int virStorageBackendVolCreateLocal(virStoragePoolObj *pool,
virStorageVolDef *vol);
int virStorageBackendVolBuildLocal(virStoragePoolObj *pool,
virStorageVolDef *vol,
unsigned int flags);
int virStorageBackendVolBuildFromLocal(virStoragePoolObj *pool,
virStorageVolDef *vol,
virStorageVolDef *inputvol,
unsigned int flags);
int virStorageBackendVolDeleteLocal(virStoragePoolObj *pool,
virStorageVolDef *vol,
unsigned int flags);
int virStorageBackendVolRefreshLocal(virStoragePoolObj *pool,
virStorageVolDef *vol);
int virStorageBackendVolResizeLocal(virStoragePoolObj *pool,
virStorageVolDef *vol,
unsigned long long capacity,
unsigned int flags);
int virStorageBackendVolUploadLocal(virStoragePoolObj *pool,
virStorageVolDef *vol,
virStreamPtr stream,
unsigned long long offset,
unsigned long long len,
unsigned int flags);
int virStorageBackendVolDownloadLocal(virStoragePoolObj *pool,
virStorageVolDef *vol,
virStreamPtr stream,
unsigned long long offset,
unsigned long long len,
unsigned int flags);
int virStorageBackendVolWipeLocal(virStoragePoolObj *pool,
virStorageVolDef *vol,
unsigned int algorithm,
unsigned int flags);
/* Local/Common Storage Pool Backend APIs */
int virStorageBackendBuildLocal(virStoragePoolObj *pool);
int virStorageBackendDeleteLocal(virStoragePoolObj *pool,
unsigned int flags);
int
virStorageBackendRefreshVolTargetUpdate(virStorageVolDef *vol);
int virStorageBackendRefreshLocal(virStoragePoolObj *pool);
int virStorageUtilGlusterExtractPoolSources(const char *host,
const char *xml,
virStoragePoolSourceList *list,
virStoragePoolType pooltype);
int virStorageBackendFindGlusterPoolSources(const char *host,
virStoragePoolType pooltype,
virStoragePoolSourceList *list,
bool report);
bool virStorageBackendDeviceIsEmpty(const char *devpath,
const char *format,
bool writelabel);
/* VolOpenCheckMode flags */
enum {
VIR_STORAGE_VOL_OPEN_NOERROR = 1 << 0, /* don't error if unexpected type
* encountered, just warn */
VIR_STORAGE_VOL_OPEN_REG = 1 << 1, /* regular files okay */
VIR_STORAGE_VOL_OPEN_BLOCK = 1 << 2, /* block files okay */
VIR_STORAGE_VOL_OPEN_CHAR = 1 << 3, /* char files okay */
VIR_STORAGE_VOL_OPEN_DIR = 1 << 4, /* directories okay */
};
/* VolReadErrorMode flags
* If flag is present, then operation won't cause fatal error for
* specified operation, rather a VIR_WARN will be issued and a -2 returned
* for function call
*/
enum {
VIR_STORAGE_VOL_READ_NOERROR = 1 << 0, /* ignore *read errors */
};
#define VIR_STORAGE_VOL_OPEN_DEFAULT (VIR_STORAGE_VOL_OPEN_REG |\
VIR_STORAGE_VOL_OPEN_BLOCK)
#define VIR_STORAGE_VOL_FS_OPEN_FLAGS (VIR_STORAGE_VOL_OPEN_DEFAULT | \
VIR_STORAGE_VOL_OPEN_DIR)
#define VIR_STORAGE_VOL_FS_PROBE_FLAGS (VIR_STORAGE_VOL_FS_OPEN_FLAGS | \
VIR_STORAGE_VOL_OPEN_NOERROR)
int virStorageBackendVolOpen(const char *path, struct stat *sb,
unsigned int flags)
G_GNUC_WARN_UNUSED_RESULT
ATTRIBUTE_NONNULL(1) ATTRIBUTE_NONNULL(2);
#define VIR_STORAGE_DEFAULT_POOL_PERM_MODE 0711
#define VIR_STORAGE_DEFAULT_VOL_PERM_MODE 0600
int virStorageBackendUpdateVolInfo(virStorageVolDef *vol,
bool withBlockVolFormat,
unsigned int openflags,
unsigned int readflags);
int virStorageBackendUpdateVolTargetInfoFD(virStorageSource *target,
int fd,
struct stat *sb);
bool virStorageBackendPoolPathIsStable(const char *path);
char *virStorageBackendStablePath(virStoragePoolObj *pool,
const char *devpath,
bool loop);
typedef enum {
VIR_STORAGE_VOL_ENCRYPT_NONE = 0,
VIR_STORAGE_VOL_ENCRYPT_CREATE,
VIR_STORAGE_VOL_ENCRYPT_CONVERT,
VIR_STORAGE_VOL_ENCRYPT_DONE,
} virStorageVolEncryptConvertStep;
virCommand *
virStorageBackendCreateQemuImgCmdFromVol(virStoragePoolObj *pool,
virStorageVolDef *vol,
virStorageVolDef *inputvol,
unsigned int flags,
const char *create_tool,
const char *secretPath,
const char *inputSecretPath,
virStorageVolEncryptConvertStep convertStep);
int virStorageBackendSCSIFindLUs(virStoragePoolObj *pool,
uint32_t scanhost);
int
virStorageBackendZeroPartitionTable(const char *path,
unsigned long long size);
char *
virStorageBackendFileSystemGetPoolSource(virStoragePoolObj *pool);
virCommand *
virStorageBackendFileSystemMountCmd(const char *cmdstr,
virStoragePoolDef *def,
const char *src);
virCommand *
virStorageBackendLogicalChangeCmd(const char *cmdstr,
virStoragePoolDef *def,
bool on);
|
