mirror of https://gitee.com/openkylin/libvirt.git
Move virStoragePool/Vol related APIs out of libvirt.h.in
Create a new libvirt-storage.h file to hold the public API definitions for the virStorage/Vol type. This header file is not self-contained, so applications will not directly include it. They will continue to #include <libvirt/libvirt.h>
This commit is contained in:
Daniel P. Berrange
parent
2805ddb29a
commit
c9456e1a7f
|
|
@ -28,6 +28,7 @@ included_files = {
|
||||||
"libvirt-nodedev.h": "header with general libvirt API definitions",
|
"libvirt-nodedev.h": "header with general libvirt API definitions",
|
||||||
"libvirt-nwfilter.h": "header with general libvirt API definitions",
|
"libvirt-nwfilter.h": "header with general libvirt API definitions",
|
||||||
"libvirt-secret.h": "header with general libvirt API definitions",
|
"libvirt-secret.h": "header with general libvirt API definitions",
|
||||||
|
"libvirt-storage.h": "header with general libvirt API definitions",
|
||||||
"libvirt-stream.h": "header with general libvirt API definitions",
|
"libvirt-stream.h": "header with general libvirt API definitions",
|
||||||
"virterror.h": "header with error specific API definitions",
|
"virterror.h": "header with error specific API definitions",
|
||||||
"libvirt.c": "Main interfaces for the libvirt library",
|
"libvirt.c": "Main interfaces for the libvirt library",
|
||||||
|
|
|
||||||
|
|
@ -25,6 +25,7 @@ virinc_HEADERS = libvirt.h \
|
||||||
libvirt-nodedev.h \
|
libvirt-nodedev.h \
|
||||||
libvirt-nwfilter.h \
|
libvirt-nwfilter.h \
|
||||||
libvirt-secret.h \
|
libvirt-secret.h \
|
||||||
|
libvirt-storage.h \
|
||||||
libvirt-stream.h \
|
libvirt-stream.h \
|
||||||
libvirt-lxc.h \
|
libvirt-lxc.h \
|
||||||
libvirt-qemu.h \
|
libvirt-qemu.h \
|
||||||
|
|
|
||||||
|
|
@ -0,0 +1,359 @@
|
||||||
|
/*
|
||||||
|
* libvirt-storage.h
|
||||||
|
* Summary: APIs for management of storages
|
||||||
|
* Description: Provides APIs for the management of storages
|
||||||
|
* Author: Daniel Veillard <veillard@redhat.com>
|
||||||
|
*
|
||||||
|
* Copyright (C) 2006-2014 Red Hat, Inc.
|
||||||
|
*
|
||||||
|
* 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/>.
|
||||||
|
*/
|
||||||
|
|
||||||
|
#ifndef __VIR_LIBVIRT_STORAGE_H__
|
||||||
|
# define __VIR_LIBVIRT_STORAGE_H__
|
||||||
|
|
||||||
|
# ifndef __VIR_LIBVIRT_H_INCLUDES__
|
||||||
|
# error "Don't include this file directly, only use libvirt/libvirt.h"
|
||||||
|
# endif
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* virStoragePool:
|
||||||
|
*
|
||||||
|
* a virStoragePool is a private structure representing a storage pool
|
||||||
|
*/
|
||||||
|
typedef struct _virStoragePool virStoragePool;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* virStoragePoolPtr:
|
||||||
|
*
|
||||||
|
* a virStoragePoolPtr is pointer to a virStoragePool private structure, this is the
|
||||||
|
* type used to reference a storage pool in the API.
|
||||||
|
*/
|
||||||
|
typedef virStoragePool *virStoragePoolPtr;
|
||||||
|
|
||||||
|
|
||||||
|
typedef enum {
|
||||||
|
VIR_STORAGE_POOL_INACTIVE = 0, /* Not running */
|
||||||
|
VIR_STORAGE_POOL_BUILDING = 1, /* Initializing pool, not available */
|
||||||
|
VIR_STORAGE_POOL_RUNNING = 2, /* Running normally */
|
||||||
|
VIR_STORAGE_POOL_DEGRADED = 3, /* Running degraded */
|
||||||
|
VIR_STORAGE_POOL_INACCESSIBLE = 4, /* Running, but not accessible */
|
||||||
|
|
||||||
|
# ifdef VIR_ENUM_SENTINELS
|
||||||
|
VIR_STORAGE_POOL_STATE_LAST
|
||||||
|
# endif
|
||||||
|
} virStoragePoolState;
|
||||||
|
|
||||||
|
|
||||||
|
typedef enum {
|
||||||
|
VIR_STORAGE_POOL_BUILD_NEW = 0, /* Regular build from scratch */
|
||||||
|
VIR_STORAGE_POOL_BUILD_REPAIR = (1 << 0), /* Repair / reinitialize */
|
||||||
|
VIR_STORAGE_POOL_BUILD_RESIZE = (1 << 1), /* Extend existing pool */
|
||||||
|
VIR_STORAGE_POOL_BUILD_NO_OVERWRITE = (1 << 2), /* Do not overwrite existing pool */
|
||||||
|
VIR_STORAGE_POOL_BUILD_OVERWRITE = (1 << 3), /* Overwrite data */
|
||||||
|
} virStoragePoolBuildFlags;
|
||||||
|
|
||||||
|
typedef enum {
|
||||||
|
VIR_STORAGE_POOL_DELETE_NORMAL = 0, /* Delete metadata only (fast) */
|
||||||
|
VIR_STORAGE_POOL_DELETE_ZEROED = 1 << 0, /* Clear all data to zeros (slow) */
|
||||||
|
} virStoragePoolDeleteFlags;
|
||||||
|
|
||||||
|
typedef struct _virStoragePoolInfo virStoragePoolInfo;
|
||||||
|
|
||||||
|
struct _virStoragePoolInfo {
|
||||||
|
int state; /* virStoragePoolState flags */
|
||||||
|
unsigned long long capacity; /* Logical size bytes */
|
||||||
|
unsigned long long allocation; /* Current allocation bytes */
|
||||||
|
unsigned long long available; /* Remaining free space bytes */
|
||||||
|
};
|
||||||
|
|
||||||
|
typedef virStoragePoolInfo *virStoragePoolInfoPtr;
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* virStorageVol:
|
||||||
|
*
|
||||||
|
* a virStorageVol is a private structure representing a storage volume
|
||||||
|
*/
|
||||||
|
typedef struct _virStorageVol virStorageVol;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* virStorageVolPtr:
|
||||||
|
*
|
||||||
|
* a virStorageVolPtr is pointer to a virStorageVol private structure, this is the
|
||||||
|
* type used to reference a storage volume in the API.
|
||||||
|
*/
|
||||||
|
typedef virStorageVol *virStorageVolPtr;
|
||||||
|
|
||||||
|
|
||||||
|
typedef enum {
|
||||||
|
VIR_STORAGE_VOL_FILE = 0, /* Regular file based volumes */
|
||||||
|
VIR_STORAGE_VOL_BLOCK = 1, /* Block based volumes */
|
||||||
|
VIR_STORAGE_VOL_DIR = 2, /* Directory-passthrough based volume */
|
||||||
|
VIR_STORAGE_VOL_NETWORK = 3, /* Network volumes like RBD (RADOS Block Device) */
|
||||||
|
VIR_STORAGE_VOL_NETDIR = 4, /* Network accessible directory that can
|
||||||
|
* contain other network volumes */
|
||||||
|
|
||||||
|
# ifdef VIR_ENUM_SENTINELS
|
||||||
|
VIR_STORAGE_VOL_LAST
|
||||||
|
# endif
|
||||||
|
} virStorageVolType;
|
||||||
|
|
||||||
|
typedef enum {
|
||||||
|
VIR_STORAGE_VOL_DELETE_NORMAL = 0, /* Delete metadata only (fast) */
|
||||||
|
VIR_STORAGE_VOL_DELETE_ZEROED = 1 << 0, /* Clear all data to zeros (slow) */
|
||||||
|
} virStorageVolDeleteFlags;
|
||||||
|
|
||||||
|
typedef enum {
|
||||||
|
VIR_STORAGE_VOL_WIPE_ALG_ZERO = 0, /* 1-pass, all zeroes */
|
||||||
|
VIR_STORAGE_VOL_WIPE_ALG_NNSA = 1, /* 4-pass NNSA Policy Letter
|
||||||
|
NAP-14.1-C (XVI-8) */
|
||||||
|
VIR_STORAGE_VOL_WIPE_ALG_DOD = 2, /* 4-pass DoD 5220.22-M section
|
||||||
|
8-306 procedure */
|
||||||
|
VIR_STORAGE_VOL_WIPE_ALG_BSI = 3, /* 9-pass method recommended by the
|
||||||
|
German Center of Security in
|
||||||
|
Information Technologies */
|
||||||
|
VIR_STORAGE_VOL_WIPE_ALG_GUTMANN = 4, /* The canonical 35-pass sequence */
|
||||||
|
VIR_STORAGE_VOL_WIPE_ALG_SCHNEIER = 5, /* 7-pass method described by
|
||||||
|
Bruce Schneier in "Applied
|
||||||
|
Cryptography" (1996) */
|
||||||
|
VIR_STORAGE_VOL_WIPE_ALG_PFITZNER7 = 6, /* 7-pass random */
|
||||||
|
|
||||||
|
VIR_STORAGE_VOL_WIPE_ALG_PFITZNER33 = 7, /* 33-pass random */
|
||||||
|
|
||||||
|
VIR_STORAGE_VOL_WIPE_ALG_RANDOM = 8, /* 1-pass random */
|
||||||
|
|
||||||
|
# ifdef VIR_ENUM_SENTINELS
|
||||||
|
VIR_STORAGE_VOL_WIPE_ALG_LAST
|
||||||
|
/*
|
||||||
|
* NB: this enum value will increase over time as new algorithms are
|
||||||
|
* added to the libvirt API. It reflects the last algorithm supported
|
||||||
|
* by this version of the libvirt API.
|
||||||
|
*/
|
||||||
|
# endif
|
||||||
|
} virStorageVolWipeAlgorithm;
|
||||||
|
|
||||||
|
typedef struct _virStorageVolInfo virStorageVolInfo;
|
||||||
|
|
||||||
|
struct _virStorageVolInfo {
|
||||||
|
int type; /* virStorageVolType flags */
|
||||||
|
unsigned long long capacity; /* Logical size bytes */
|
||||||
|
unsigned long long allocation; /* Current allocation bytes */
|
||||||
|
};
|
||||||
|
|
||||||
|
typedef virStorageVolInfo *virStorageVolInfoPtr;
|
||||||
|
|
||||||
|
typedef enum {
|
||||||
|
VIR_STORAGE_XML_INACTIVE = (1 << 0), /* dump inactive pool/volume information */
|
||||||
|
} virStorageXMLFlags;
|
||||||
|
|
||||||
|
/*
|
||||||
|
* Get connection from pool.
|
||||||
|
*/
|
||||||
|
virConnectPtr virStoragePoolGetConnect (virStoragePoolPtr pool);
|
||||||
|
|
||||||
|
/*
|
||||||
|
* List active storage pools
|
||||||
|
*/
|
||||||
|
int virConnectNumOfStoragePools (virConnectPtr conn);
|
||||||
|
int virConnectListStoragePools (virConnectPtr conn,
|
||||||
|
char **const names,
|
||||||
|
int maxnames);
|
||||||
|
|
||||||
|
/*
|
||||||
|
* List inactive storage pools
|
||||||
|
*/
|
||||||
|
int virConnectNumOfDefinedStoragePools(virConnectPtr conn);
|
||||||
|
int virConnectListDefinedStoragePools(virConnectPtr conn,
|
||||||
|
char **const names,
|
||||||
|
int maxnames);
|
||||||
|
|
||||||
|
/*
|
||||||
|
* virConnectListAllStoragePoolsFlags:
|
||||||
|
*
|
||||||
|
* Flags used to tune pools returned by virConnectListAllStoragePools().
|
||||||
|
* Note that these flags come in groups; if all bits from a group are 0,
|
||||||
|
* then that group is not used to filter results.
|
||||||
|
*/
|
||||||
|
typedef enum {
|
||||||
|
VIR_CONNECT_LIST_STORAGE_POOLS_INACTIVE = 1 << 0,
|
||||||
|
VIR_CONNECT_LIST_STORAGE_POOLS_ACTIVE = 1 << 1,
|
||||||
|
|
||||||
|
VIR_CONNECT_LIST_STORAGE_POOLS_PERSISTENT = 1 << 2,
|
||||||
|
VIR_CONNECT_LIST_STORAGE_POOLS_TRANSIENT = 1 << 3,
|
||||||
|
|
||||||
|
VIR_CONNECT_LIST_STORAGE_POOLS_AUTOSTART = 1 << 4,
|
||||||
|
VIR_CONNECT_LIST_STORAGE_POOLS_NO_AUTOSTART = 1 << 5,
|
||||||
|
|
||||||
|
/* List pools by type */
|
||||||
|
VIR_CONNECT_LIST_STORAGE_POOLS_DIR = 1 << 6,
|
||||||
|
VIR_CONNECT_LIST_STORAGE_POOLS_FS = 1 << 7,
|
||||||
|
VIR_CONNECT_LIST_STORAGE_POOLS_NETFS = 1 << 8,
|
||||||
|
VIR_CONNECT_LIST_STORAGE_POOLS_LOGICAL = 1 << 9,
|
||||||
|
VIR_CONNECT_LIST_STORAGE_POOLS_DISK = 1 << 10,
|
||||||
|
VIR_CONNECT_LIST_STORAGE_POOLS_ISCSI = 1 << 11,
|
||||||
|
VIR_CONNECT_LIST_STORAGE_POOLS_SCSI = 1 << 12,
|
||||||
|
VIR_CONNECT_LIST_STORAGE_POOLS_MPATH = 1 << 13,
|
||||||
|
VIR_CONNECT_LIST_STORAGE_POOLS_RBD = 1 << 14,
|
||||||
|
VIR_CONNECT_LIST_STORAGE_POOLS_SHEEPDOG = 1 << 15,
|
||||||
|
VIR_CONNECT_LIST_STORAGE_POOLS_GLUSTER = 1 << 16,
|
||||||
|
VIR_CONNECT_LIST_STORAGE_POOLS_ZFS = 1 << 17,
|
||||||
|
} virConnectListAllStoragePoolsFlags;
|
||||||
|
|
||||||
|
int virConnectListAllStoragePools(virConnectPtr conn,
|
||||||
|
virStoragePoolPtr **pools,
|
||||||
|
unsigned int flags);
|
||||||
|
/*
|
||||||
|
* Query a host for storage pools of a particular type
|
||||||
|
*/
|
||||||
|
char * virConnectFindStoragePoolSources(virConnectPtr conn,
|
||||||
|
const char *type,
|
||||||
|
const char *srcSpec,
|
||||||
|
unsigned int flags);
|
||||||
|
|
||||||
|
/*
|
||||||
|
* Lookup pool by name or uuid
|
||||||
|
*/
|
||||||
|
virStoragePoolPtr virStoragePoolLookupByName (virConnectPtr conn,
|
||||||
|
const char *name);
|
||||||
|
virStoragePoolPtr virStoragePoolLookupByUUID (virConnectPtr conn,
|
||||||
|
const unsigned char *uuid);
|
||||||
|
virStoragePoolPtr virStoragePoolLookupByUUIDString(virConnectPtr conn,
|
||||||
|
const char *uuid);
|
||||||
|
virStoragePoolPtr virStoragePoolLookupByVolume (virStorageVolPtr vol);
|
||||||
|
|
||||||
|
/*
|
||||||
|
* Creating/destroying pools
|
||||||
|
*/
|
||||||
|
virStoragePoolPtr virStoragePoolCreateXML (virConnectPtr conn,
|
||||||
|
const char *xmlDesc,
|
||||||
|
unsigned int flags);
|
||||||
|
virStoragePoolPtr virStoragePoolDefineXML (virConnectPtr conn,
|
||||||
|
const char *xmlDesc,
|
||||||
|
unsigned int flags);
|
||||||
|
int virStoragePoolBuild (virStoragePoolPtr pool,
|
||||||
|
unsigned int flags);
|
||||||
|
int virStoragePoolUndefine (virStoragePoolPtr pool);
|
||||||
|
int virStoragePoolCreate (virStoragePoolPtr pool,
|
||||||
|
unsigned int flags);
|
||||||
|
int virStoragePoolDestroy (virStoragePoolPtr pool);
|
||||||
|
int virStoragePoolDelete (virStoragePoolPtr pool,
|
||||||
|
unsigned int flags);
|
||||||
|
int virStoragePoolRef (virStoragePoolPtr pool);
|
||||||
|
int virStoragePoolFree (virStoragePoolPtr pool);
|
||||||
|
int virStoragePoolRefresh (virStoragePoolPtr pool,
|
||||||
|
unsigned int flags);
|
||||||
|
|
||||||
|
/*
|
||||||
|
* StoragePool information
|
||||||
|
*/
|
||||||
|
const char* virStoragePoolGetName (virStoragePoolPtr pool);
|
||||||
|
int virStoragePoolGetUUID (virStoragePoolPtr pool,
|
||||||
|
unsigned char *uuid);
|
||||||
|
int virStoragePoolGetUUIDString (virStoragePoolPtr pool,
|
||||||
|
char *buf);
|
||||||
|
|
||||||
|
int virStoragePoolGetInfo (virStoragePoolPtr vol,
|
||||||
|
virStoragePoolInfoPtr info);
|
||||||
|
|
||||||
|
char * virStoragePoolGetXMLDesc (virStoragePoolPtr pool,
|
||||||
|
unsigned int flags);
|
||||||
|
|
||||||
|
int virStoragePoolGetAutostart (virStoragePoolPtr pool,
|
||||||
|
int *autostart);
|
||||||
|
int virStoragePoolSetAutostart (virStoragePoolPtr pool,
|
||||||
|
int autostart);
|
||||||
|
|
||||||
|
/*
|
||||||
|
* List/lookup storage volumes within a pool
|
||||||
|
*/
|
||||||
|
int virStoragePoolNumOfVolumes (virStoragePoolPtr pool);
|
||||||
|
int virStoragePoolListVolumes (virStoragePoolPtr pool,
|
||||||
|
char **const names,
|
||||||
|
int maxnames);
|
||||||
|
int virStoragePoolListAllVolumes (virStoragePoolPtr pool,
|
||||||
|
virStorageVolPtr **vols,
|
||||||
|
unsigned int flags);
|
||||||
|
|
||||||
|
virConnectPtr virStorageVolGetConnect (virStorageVolPtr vol);
|
||||||
|
|
||||||
|
/*
|
||||||
|
* Lookup volumes based on various attributes
|
||||||
|
*/
|
||||||
|
virStorageVolPtr virStorageVolLookupByName (virStoragePoolPtr pool,
|
||||||
|
const char *name);
|
||||||
|
virStorageVolPtr virStorageVolLookupByKey (virConnectPtr conn,
|
||||||
|
const char *key);
|
||||||
|
virStorageVolPtr virStorageVolLookupByPath (virConnectPtr conn,
|
||||||
|
const char *path);
|
||||||
|
|
||||||
|
|
||||||
|
const char* virStorageVolGetName (virStorageVolPtr vol);
|
||||||
|
const char* virStorageVolGetKey (virStorageVolPtr vol);
|
||||||
|
|
||||||
|
typedef enum {
|
||||||
|
VIR_STORAGE_VOL_CREATE_PREALLOC_METADATA = 1 << 0,
|
||||||
|
} virStorageVolCreateFlags;
|
||||||
|
|
||||||
|
virStorageVolPtr virStorageVolCreateXML (virStoragePoolPtr pool,
|
||||||
|
const char *xmldesc,
|
||||||
|
unsigned int flags);
|
||||||
|
virStorageVolPtr virStorageVolCreateXMLFrom (virStoragePoolPtr pool,
|
||||||
|
const char *xmldesc,
|
||||||
|
virStorageVolPtr clonevol,
|
||||||
|
unsigned int flags);
|
||||||
|
int virStorageVolDownload (virStorageVolPtr vol,
|
||||||
|
virStreamPtr stream,
|
||||||
|
unsigned long long offset,
|
||||||
|
unsigned long long length,
|
||||||
|
unsigned int flags);
|
||||||
|
int virStorageVolUpload (virStorageVolPtr vol,
|
||||||
|
virStreamPtr stream,
|
||||||
|
unsigned long long offset,
|
||||||
|
unsigned long long length,
|
||||||
|
unsigned int flags);
|
||||||
|
int virStorageVolDelete (virStorageVolPtr vol,
|
||||||
|
unsigned int flags);
|
||||||
|
int virStorageVolWipe (virStorageVolPtr vol,
|
||||||
|
unsigned int flags);
|
||||||
|
int virStorageVolWipePattern (virStorageVolPtr vol,
|
||||||
|
unsigned int algorithm,
|
||||||
|
unsigned int flags);
|
||||||
|
int virStorageVolRef (virStorageVolPtr vol);
|
||||||
|
int virStorageVolFree (virStorageVolPtr vol);
|
||||||
|
|
||||||
|
int virStorageVolGetInfo (virStorageVolPtr vol,
|
||||||
|
virStorageVolInfoPtr info);
|
||||||
|
char * virStorageVolGetXMLDesc (virStorageVolPtr pool,
|
||||||
|
unsigned int flags);
|
||||||
|
|
||||||
|
char * virStorageVolGetPath (virStorageVolPtr vol);
|
||||||
|
|
||||||
|
typedef enum {
|
||||||
|
VIR_STORAGE_VOL_RESIZE_ALLOCATE = 1 << 0, /* force allocation of new size */
|
||||||
|
VIR_STORAGE_VOL_RESIZE_DELTA = 1 << 1, /* size is relative to current */
|
||||||
|
VIR_STORAGE_VOL_RESIZE_SHRINK = 1 << 2, /* allow decrease in capacity */
|
||||||
|
} virStorageVolResizeFlags;
|
||||||
|
|
||||||
|
int virStorageVolResize (virStorageVolPtr vol,
|
||||||
|
unsigned long long capacity,
|
||||||
|
unsigned int flags);
|
||||||
|
|
||||||
|
int virStoragePoolIsActive(virStoragePoolPtr pool);
|
||||||
|
int virStoragePoolIsPersistent(virStoragePoolPtr pool);
|
||||||
|
|
||||||
|
|
||||||
|
#endif /* __VIR_LIBVIRT_STORAGE_H__ */
|
||||||
|
|
@ -2857,329 +2857,6 @@ int virNodeGetCellsFreeMemory(virConnectPtr conn,
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
/**
|
|
||||||
* virStoragePool:
|
|
||||||
*
|
|
||||||
* a virStoragePool is a private structure representing a storage pool
|
|
||||||
*/
|
|
||||||
typedef struct _virStoragePool virStoragePool;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* virStoragePoolPtr:
|
|
||||||
*
|
|
||||||
* a virStoragePoolPtr is pointer to a virStoragePool private structure, this is the
|
|
||||||
* type used to reference a storage pool in the API.
|
|
||||||
*/
|
|
||||||
typedef virStoragePool *virStoragePoolPtr;
|
|
||||||
|
|
||||||
|
|
||||||
typedef enum {
|
|
||||||
VIR_STORAGE_POOL_INACTIVE = 0, /* Not running */
|
|
||||||
VIR_STORAGE_POOL_BUILDING = 1, /* Initializing pool, not available */
|
|
||||||
VIR_STORAGE_POOL_RUNNING = 2, /* Running normally */
|
|
||||||
VIR_STORAGE_POOL_DEGRADED = 3, /* Running degraded */
|
|
||||||
VIR_STORAGE_POOL_INACCESSIBLE = 4, /* Running, but not accessible */
|
|
||||||
|
|
||||||
#ifdef VIR_ENUM_SENTINELS
|
|
||||||
VIR_STORAGE_POOL_STATE_LAST
|
|
||||||
#endif
|
|
||||||
} virStoragePoolState;
|
|
||||||
|
|
||||||
|
|
||||||
typedef enum {
|
|
||||||
VIR_STORAGE_POOL_BUILD_NEW = 0, /* Regular build from scratch */
|
|
||||||
VIR_STORAGE_POOL_BUILD_REPAIR = (1 << 0), /* Repair / reinitialize */
|
|
||||||
VIR_STORAGE_POOL_BUILD_RESIZE = (1 << 1), /* Extend existing pool */
|
|
||||||
VIR_STORAGE_POOL_BUILD_NO_OVERWRITE = (1 << 2), /* Do not overwrite existing pool */
|
|
||||||
VIR_STORAGE_POOL_BUILD_OVERWRITE = (1 << 3), /* Overwrite data */
|
|
||||||
} virStoragePoolBuildFlags;
|
|
||||||
|
|
||||||
typedef enum {
|
|
||||||
VIR_STORAGE_POOL_DELETE_NORMAL = 0, /* Delete metadata only (fast) */
|
|
||||||
VIR_STORAGE_POOL_DELETE_ZEROED = 1 << 0, /* Clear all data to zeros (slow) */
|
|
||||||
} virStoragePoolDeleteFlags;
|
|
||||||
|
|
||||||
typedef struct _virStoragePoolInfo virStoragePoolInfo;
|
|
||||||
|
|
||||||
struct _virStoragePoolInfo {
|
|
||||||
int state; /* virStoragePoolState flags */
|
|
||||||
unsigned long long capacity; /* Logical size bytes */
|
|
||||||
unsigned long long allocation; /* Current allocation bytes */
|
|
||||||
unsigned long long available; /* Remaining free space bytes */
|
|
||||||
};
|
|
||||||
|
|
||||||
typedef virStoragePoolInfo *virStoragePoolInfoPtr;
|
|
||||||
|
|
||||||
|
|
||||||
/**
|
|
||||||
* virStorageVol:
|
|
||||||
*
|
|
||||||
* a virStorageVol is a private structure representing a storage volume
|
|
||||||
*/
|
|
||||||
typedef struct _virStorageVol virStorageVol;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* virStorageVolPtr:
|
|
||||||
*
|
|
||||||
* a virStorageVolPtr is pointer to a virStorageVol private structure, this is the
|
|
||||||
* type used to reference a storage volume in the API.
|
|
||||||
*/
|
|
||||||
typedef virStorageVol *virStorageVolPtr;
|
|
||||||
|
|
||||||
|
|
||||||
typedef enum {
|
|
||||||
VIR_STORAGE_VOL_FILE = 0, /* Regular file based volumes */
|
|
||||||
VIR_STORAGE_VOL_BLOCK = 1, /* Block based volumes */
|
|
||||||
VIR_STORAGE_VOL_DIR = 2, /* Directory-passthrough based volume */
|
|
||||||
VIR_STORAGE_VOL_NETWORK = 3, /* Network volumes like RBD (RADOS Block Device) */
|
|
||||||
VIR_STORAGE_VOL_NETDIR = 4, /* Network accessible directory that can
|
|
||||||
* contain other network volumes */
|
|
||||||
|
|
||||||
#ifdef VIR_ENUM_SENTINELS
|
|
||||||
VIR_STORAGE_VOL_LAST
|
|
||||||
#endif
|
|
||||||
} virStorageVolType;
|
|
||||||
|
|
||||||
typedef enum {
|
|
||||||
VIR_STORAGE_VOL_DELETE_NORMAL = 0, /* Delete metadata only (fast) */
|
|
||||||
VIR_STORAGE_VOL_DELETE_ZEROED = 1 << 0, /* Clear all data to zeros (slow) */
|
|
||||||
} virStorageVolDeleteFlags;
|
|
||||||
|
|
||||||
typedef enum {
|
|
||||||
VIR_STORAGE_VOL_WIPE_ALG_ZERO = 0, /* 1-pass, all zeroes */
|
|
||||||
VIR_STORAGE_VOL_WIPE_ALG_NNSA = 1, /* 4-pass NNSA Policy Letter
|
|
||||||
NAP-14.1-C (XVI-8) */
|
|
||||||
VIR_STORAGE_VOL_WIPE_ALG_DOD = 2, /* 4-pass DoD 5220.22-M section
|
|
||||||
8-306 procedure */
|
|
||||||
VIR_STORAGE_VOL_WIPE_ALG_BSI = 3, /* 9-pass method recommended by the
|
|
||||||
German Center of Security in
|
|
||||||
Information Technologies */
|
|
||||||
VIR_STORAGE_VOL_WIPE_ALG_GUTMANN = 4, /* The canonical 35-pass sequence */
|
|
||||||
VIR_STORAGE_VOL_WIPE_ALG_SCHNEIER = 5, /* 7-pass method described by
|
|
||||||
Bruce Schneier in "Applied
|
|
||||||
Cryptography" (1996) */
|
|
||||||
VIR_STORAGE_VOL_WIPE_ALG_PFITZNER7 = 6, /* 7-pass random */
|
|
||||||
|
|
||||||
VIR_STORAGE_VOL_WIPE_ALG_PFITZNER33 = 7, /* 33-pass random */
|
|
||||||
|
|
||||||
VIR_STORAGE_VOL_WIPE_ALG_RANDOM = 8, /* 1-pass random */
|
|
||||||
|
|
||||||
#ifdef VIR_ENUM_SENTINELS
|
|
||||||
VIR_STORAGE_VOL_WIPE_ALG_LAST
|
|
||||||
/*
|
|
||||||
* NB: this enum value will increase over time as new algorithms are
|
|
||||||
* added to the libvirt API. It reflects the last algorithm supported
|
|
||||||
* by this version of the libvirt API.
|
|
||||||
*/
|
|
||||||
#endif
|
|
||||||
} virStorageVolWipeAlgorithm;
|
|
||||||
|
|
||||||
typedef struct _virStorageVolInfo virStorageVolInfo;
|
|
||||||
|
|
||||||
struct _virStorageVolInfo {
|
|
||||||
int type; /* virStorageVolType flags */
|
|
||||||
unsigned long long capacity; /* Logical size bytes */
|
|
||||||
unsigned long long allocation; /* Current allocation bytes */
|
|
||||||
};
|
|
||||||
|
|
||||||
typedef virStorageVolInfo *virStorageVolInfoPtr;
|
|
||||||
|
|
||||||
typedef enum {
|
|
||||||
VIR_STORAGE_XML_INACTIVE = (1 << 0), /* dump inactive pool/volume information */
|
|
||||||
} virStorageXMLFlags;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* Get connection from pool.
|
|
||||||
*/
|
|
||||||
virConnectPtr virStoragePoolGetConnect (virStoragePoolPtr pool);
|
|
||||||
|
|
||||||
/*
|
|
||||||
* List active storage pools
|
|
||||||
*/
|
|
||||||
int virConnectNumOfStoragePools (virConnectPtr conn);
|
|
||||||
int virConnectListStoragePools (virConnectPtr conn,
|
|
||||||
char **const names,
|
|
||||||
int maxnames);
|
|
||||||
|
|
||||||
/*
|
|
||||||
* List inactive storage pools
|
|
||||||
*/
|
|
||||||
int virConnectNumOfDefinedStoragePools(virConnectPtr conn);
|
|
||||||
int virConnectListDefinedStoragePools(virConnectPtr conn,
|
|
||||||
char **const names,
|
|
||||||
int maxnames);
|
|
||||||
|
|
||||||
/*
|
|
||||||
* virConnectListAllStoragePoolsFlags:
|
|
||||||
*
|
|
||||||
* Flags used to tune pools returned by virConnectListAllStoragePools().
|
|
||||||
* Note that these flags come in groups; if all bits from a group are 0,
|
|
||||||
* then that group is not used to filter results.
|
|
||||||
*/
|
|
||||||
typedef enum {
|
|
||||||
VIR_CONNECT_LIST_STORAGE_POOLS_INACTIVE = 1 << 0,
|
|
||||||
VIR_CONNECT_LIST_STORAGE_POOLS_ACTIVE = 1 << 1,
|
|
||||||
|
|
||||||
VIR_CONNECT_LIST_STORAGE_POOLS_PERSISTENT = 1 << 2,
|
|
||||||
VIR_CONNECT_LIST_STORAGE_POOLS_TRANSIENT = 1 << 3,
|
|
||||||
|
|
||||||
VIR_CONNECT_LIST_STORAGE_POOLS_AUTOSTART = 1 << 4,
|
|
||||||
VIR_CONNECT_LIST_STORAGE_POOLS_NO_AUTOSTART = 1 << 5,
|
|
||||||
|
|
||||||
/* List pools by type */
|
|
||||||
VIR_CONNECT_LIST_STORAGE_POOLS_DIR = 1 << 6,
|
|
||||||
VIR_CONNECT_LIST_STORAGE_POOLS_FS = 1 << 7,
|
|
||||||
VIR_CONNECT_LIST_STORAGE_POOLS_NETFS = 1 << 8,
|
|
||||||
VIR_CONNECT_LIST_STORAGE_POOLS_LOGICAL = 1 << 9,
|
|
||||||
VIR_CONNECT_LIST_STORAGE_POOLS_DISK = 1 << 10,
|
|
||||||
VIR_CONNECT_LIST_STORAGE_POOLS_ISCSI = 1 << 11,
|
|
||||||
VIR_CONNECT_LIST_STORAGE_POOLS_SCSI = 1 << 12,
|
|
||||||
VIR_CONNECT_LIST_STORAGE_POOLS_MPATH = 1 << 13,
|
|
||||||
VIR_CONNECT_LIST_STORAGE_POOLS_RBD = 1 << 14,
|
|
||||||
VIR_CONNECT_LIST_STORAGE_POOLS_SHEEPDOG = 1 << 15,
|
|
||||||
VIR_CONNECT_LIST_STORAGE_POOLS_GLUSTER = 1 << 16,
|
|
||||||
VIR_CONNECT_LIST_STORAGE_POOLS_ZFS = 1 << 17,
|
|
||||||
} virConnectListAllStoragePoolsFlags;
|
|
||||||
|
|
||||||
int virConnectListAllStoragePools(virConnectPtr conn,
|
|
||||||
virStoragePoolPtr **pools,
|
|
||||||
unsigned int flags);
|
|
||||||
/*
|
|
||||||
* Query a host for storage pools of a particular type
|
|
||||||
*/
|
|
||||||
char * virConnectFindStoragePoolSources(virConnectPtr conn,
|
|
||||||
const char *type,
|
|
||||||
const char *srcSpec,
|
|
||||||
unsigned int flags);
|
|
||||||
|
|
||||||
/*
|
|
||||||
* Lookup pool by name or uuid
|
|
||||||
*/
|
|
||||||
virStoragePoolPtr virStoragePoolLookupByName (virConnectPtr conn,
|
|
||||||
const char *name);
|
|
||||||
virStoragePoolPtr virStoragePoolLookupByUUID (virConnectPtr conn,
|
|
||||||
const unsigned char *uuid);
|
|
||||||
virStoragePoolPtr virStoragePoolLookupByUUIDString(virConnectPtr conn,
|
|
||||||
const char *uuid);
|
|
||||||
virStoragePoolPtr virStoragePoolLookupByVolume (virStorageVolPtr vol);
|
|
||||||
|
|
||||||
/*
|
|
||||||
* Creating/destroying pools
|
|
||||||
*/
|
|
||||||
virStoragePoolPtr virStoragePoolCreateXML (virConnectPtr conn,
|
|
||||||
const char *xmlDesc,
|
|
||||||
unsigned int flags);
|
|
||||||
virStoragePoolPtr virStoragePoolDefineXML (virConnectPtr conn,
|
|
||||||
const char *xmlDesc,
|
|
||||||
unsigned int flags);
|
|
||||||
int virStoragePoolBuild (virStoragePoolPtr pool,
|
|
||||||
unsigned int flags);
|
|
||||||
int virStoragePoolUndefine (virStoragePoolPtr pool);
|
|
||||||
int virStoragePoolCreate (virStoragePoolPtr pool,
|
|
||||||
unsigned int flags);
|
|
||||||
int virStoragePoolDestroy (virStoragePoolPtr pool);
|
|
||||||
int virStoragePoolDelete (virStoragePoolPtr pool,
|
|
||||||
unsigned int flags);
|
|
||||||
int virStoragePoolRef (virStoragePoolPtr pool);
|
|
||||||
int virStoragePoolFree (virStoragePoolPtr pool);
|
|
||||||
int virStoragePoolRefresh (virStoragePoolPtr pool,
|
|
||||||
unsigned int flags);
|
|
||||||
|
|
||||||
/*
|
|
||||||
* StoragePool information
|
|
||||||
*/
|
|
||||||
const char* virStoragePoolGetName (virStoragePoolPtr pool);
|
|
||||||
int virStoragePoolGetUUID (virStoragePoolPtr pool,
|
|
||||||
unsigned char *uuid);
|
|
||||||
int virStoragePoolGetUUIDString (virStoragePoolPtr pool,
|
|
||||||
char *buf);
|
|
||||||
|
|
||||||
int virStoragePoolGetInfo (virStoragePoolPtr vol,
|
|
||||||
virStoragePoolInfoPtr info);
|
|
||||||
|
|
||||||
char * virStoragePoolGetXMLDesc (virStoragePoolPtr pool,
|
|
||||||
unsigned int flags);
|
|
||||||
|
|
||||||
int virStoragePoolGetAutostart (virStoragePoolPtr pool,
|
|
||||||
int *autostart);
|
|
||||||
int virStoragePoolSetAutostart (virStoragePoolPtr pool,
|
|
||||||
int autostart);
|
|
||||||
|
|
||||||
/*
|
|
||||||
* List/lookup storage volumes within a pool
|
|
||||||
*/
|
|
||||||
int virStoragePoolNumOfVolumes (virStoragePoolPtr pool);
|
|
||||||
int virStoragePoolListVolumes (virStoragePoolPtr pool,
|
|
||||||
char **const names,
|
|
||||||
int maxnames);
|
|
||||||
int virStoragePoolListAllVolumes (virStoragePoolPtr pool,
|
|
||||||
virStorageVolPtr **vols,
|
|
||||||
unsigned int flags);
|
|
||||||
|
|
||||||
virConnectPtr virStorageVolGetConnect (virStorageVolPtr vol);
|
|
||||||
|
|
||||||
/*
|
|
||||||
* Lookup volumes based on various attributes
|
|
||||||
*/
|
|
||||||
virStorageVolPtr virStorageVolLookupByName (virStoragePoolPtr pool,
|
|
||||||
const char *name);
|
|
||||||
virStorageVolPtr virStorageVolLookupByKey (virConnectPtr conn,
|
|
||||||
const char *key);
|
|
||||||
virStorageVolPtr virStorageVolLookupByPath (virConnectPtr conn,
|
|
||||||
const char *path);
|
|
||||||
|
|
||||||
|
|
||||||
const char* virStorageVolGetName (virStorageVolPtr vol);
|
|
||||||
const char* virStorageVolGetKey (virStorageVolPtr vol);
|
|
||||||
|
|
||||||
typedef enum {
|
|
||||||
VIR_STORAGE_VOL_CREATE_PREALLOC_METADATA = 1 << 0,
|
|
||||||
} virStorageVolCreateFlags;
|
|
||||||
|
|
||||||
virStorageVolPtr virStorageVolCreateXML (virStoragePoolPtr pool,
|
|
||||||
const char *xmldesc,
|
|
||||||
unsigned int flags);
|
|
||||||
virStorageVolPtr virStorageVolCreateXMLFrom (virStoragePoolPtr pool,
|
|
||||||
const char *xmldesc,
|
|
||||||
virStorageVolPtr clonevol,
|
|
||||||
unsigned int flags);
|
|
||||||
int virStorageVolDownload (virStorageVolPtr vol,
|
|
||||||
virStreamPtr stream,
|
|
||||||
unsigned long long offset,
|
|
||||||
unsigned long long length,
|
|
||||||
unsigned int flags);
|
|
||||||
int virStorageVolUpload (virStorageVolPtr vol,
|
|
||||||
virStreamPtr stream,
|
|
||||||
unsigned long long offset,
|
|
||||||
unsigned long long length,
|
|
||||||
unsigned int flags);
|
|
||||||
int virStorageVolDelete (virStorageVolPtr vol,
|
|
||||||
unsigned int flags);
|
|
||||||
int virStorageVolWipe (virStorageVolPtr vol,
|
|
||||||
unsigned int flags);
|
|
||||||
int virStorageVolWipePattern (virStorageVolPtr vol,
|
|
||||||
unsigned int algorithm,
|
|
||||||
unsigned int flags);
|
|
||||||
int virStorageVolRef (virStorageVolPtr vol);
|
|
||||||
int virStorageVolFree (virStorageVolPtr vol);
|
|
||||||
|
|
||||||
int virStorageVolGetInfo (virStorageVolPtr vol,
|
|
||||||
virStorageVolInfoPtr info);
|
|
||||||
char * virStorageVolGetXMLDesc (virStorageVolPtr pool,
|
|
||||||
unsigned int flags);
|
|
||||||
|
|
||||||
char * virStorageVolGetPath (virStorageVolPtr vol);
|
|
||||||
|
|
||||||
typedef enum {
|
|
||||||
VIR_STORAGE_VOL_RESIZE_ALLOCATE = 1 << 0, /* force allocation of new size */
|
|
||||||
VIR_STORAGE_VOL_RESIZE_DELTA = 1 << 1, /* size is relative to current */
|
|
||||||
VIR_STORAGE_VOL_RESIZE_SHRINK = 1 << 2, /* allow decrease in capacity */
|
|
||||||
} virStorageVolResizeFlags;
|
|
||||||
|
|
||||||
int virStorageVolResize (virStorageVolPtr vol,
|
|
||||||
unsigned long long capacity,
|
|
||||||
unsigned int flags);
|
|
||||||
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* virKeycodeSet:
|
* virKeycodeSet:
|
||||||
|
|
@ -3678,9 +3355,6 @@ int virDomainIsActive(virDomainPtr dom);
|
||||||
int virDomainIsPersistent(virDomainPtr dom);
|
int virDomainIsPersistent(virDomainPtr dom);
|
||||||
int virDomainIsUpdated(virDomainPtr dom);
|
int virDomainIsUpdated(virDomainPtr dom);
|
||||||
|
|
||||||
int virStoragePoolIsActive(virStoragePoolPtr pool);
|
|
||||||
int virStoragePoolIsPersistent(virStoragePoolPtr pool);
|
|
||||||
|
|
||||||
|
|
||||||
int virConnectIsEncrypted(virConnectPtr conn);
|
int virConnectIsEncrypted(virConnectPtr conn);
|
||||||
int virConnectIsSecure(virConnectPtr conn);
|
int virConnectIsSecure(virConnectPtr conn);
|
||||||
|
|
@ -4906,6 +4580,7 @@ typedef virMemoryParameter *virMemoryParameterPtr;
|
||||||
#include <libvirt/libvirt-nodedev.h>
|
#include <libvirt/libvirt-nodedev.h>
|
||||||
#include <libvirt/libvirt-nwfilter.h>
|
#include <libvirt/libvirt-nwfilter.h>
|
||||||
#include <libvirt/libvirt-secret.h>
|
#include <libvirt/libvirt-secret.h>
|
||||||
|
#include <libvirt/libvirt-storage.h>
|
||||||
#include <libvirt/libvirt-stream.h>
|
#include <libvirt/libvirt-stream.h>
|
||||||
#undef __VIR_LIBVIRT_H_INCLUDES__
|
#undef __VIR_LIBVIRT_H_INCLUDES__
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -2257,6 +2257,7 @@ exit 0
|
||||||
%{_includedir}/libvirt/libvirt-nodedev.h
|
%{_includedir}/libvirt/libvirt-nodedev.h
|
||||||
%{_includedir}/libvirt/libvirt-nwfilter.h
|
%{_includedir}/libvirt/libvirt-nwfilter.h
|
||||||
%{_includedir}/libvirt/libvirt-secret.h
|
%{_includedir}/libvirt/libvirt-secret.h
|
||||||
|
%{_includedir}/libvirt/libvirt-storage.h
|
||||||
%{_includedir}/libvirt/libvirt-stream.h
|
%{_includedir}/libvirt/libvirt-stream.h
|
||||||
%{_includedir}/libvirt/libvirt-qemu.h
|
%{_includedir}/libvirt/libvirt-qemu.h
|
||||||
%{_includedir}/libvirt/libvirt-lxc.h
|
%{_includedir}/libvirt/libvirt-lxc.h
|
||||||
|
|
|
||||||
|
|
@ -235,6 +235,7 @@ rm -rf $RPM_BUILD_ROOT%{mingw64_libexecdir}/libvirt-guests.sh
|
||||||
%{mingw32_includedir}/libvirt/libvirt-nodedev.h
|
%{mingw32_includedir}/libvirt/libvirt-nodedev.h
|
||||||
%{mingw32_includedir}/libvirt/libvirt-nwfilter.h
|
%{mingw32_includedir}/libvirt/libvirt-nwfilter.h
|
||||||
%{mingw32_includedir}/libvirt/libvirt-secret.h
|
%{mingw32_includedir}/libvirt/libvirt-secret.h
|
||||||
|
%{mingw32_includedir}/libvirt/libvirt-storage.h
|
||||||
%{mingw32_includedir}/libvirt/libvirt-stream.h
|
%{mingw32_includedir}/libvirt/libvirt-stream.h
|
||||||
%{mingw32_includedir}/libvirt/virterror.h
|
%{mingw32_includedir}/libvirt/virterror.h
|
||||||
%{mingw32_includedir}/libvirt/libvirt-lxc.h
|
%{mingw32_includedir}/libvirt/libvirt-lxc.h
|
||||||
|
|
@ -305,6 +306,7 @@ rm -rf $RPM_BUILD_ROOT%{mingw64_libexecdir}/libvirt-guests.sh
|
||||||
%{mingw64_includedir}/libvirt/libvirt-nodedev.h
|
%{mingw64_includedir}/libvirt/libvirt-nodedev.h
|
||||||
%{mingw64_includedir}/libvirt/libvirt-nwfilter.h
|
%{mingw64_includedir}/libvirt/libvirt-nwfilter.h
|
||||||
%{mingw64_includedir}/libvirt/libvirt-secret.h
|
%{mingw64_includedir}/libvirt/libvirt-secret.h
|
||||||
|
%{mingw64_includedir}/libvirt/libvirt-storage.h
|
||||||
%{mingw64_includedir}/libvirt/libvirt-stream.h
|
%{mingw64_includedir}/libvirt/libvirt-stream.h
|
||||||
%{mingw64_includedir}/libvirt/virterror.h
|
%{mingw64_includedir}/libvirt/virterror.h
|
||||||
%{mingw64_includedir}/libvirt/libvirt-lxc.h
|
%{mingw64_includedir}/libvirt/libvirt-lxc.h
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue