2009-09-01 15:27:46 +00:00
|
|
|
/*
|
|
|
|
* secret_conf.h: internal <secret> XML handling API
|
|
|
|
*
|
2010-03-01 23:38:28 +00:00
|
|
|
* Copyright (C) 2009-2010 Red Hat, Inc.
|
2009-09-01 15:27:46 +00:00
|
|
|
*
|
|
|
|
* 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
|
2012-09-20 22:30:55 +00:00
|
|
|
* License along with this library. If not, see
|
2012-07-21 10:06:23 +00:00
|
|
|
* <http://www.gnu.org/licenses/>.
|
2009-09-01 15:27:46 +00:00
|
|
|
*
|
|
|
|
* Red Hat Author: Miloslav Trmač <mitr@redhat.com>
|
|
|
|
*/
|
|
|
|
|
|
|
|
#ifndef __VIR_SECRET_CONF_H__
|
2010-03-09 18:22:22 +00:00
|
|
|
# define __VIR_SECRET_CONF_H__
|
2009-09-01 15:27:46 +00:00
|
|
|
|
2010-03-09 18:22:22 +00:00
|
|
|
# include "internal.h"
|
2012-12-13 17:44:57 +00:00
|
|
|
# include "virutil.h"
|
2009-09-01 15:27:46 +00:00
|
|
|
|
|
|
|
VIR_ENUM_DECL(virSecretUsageType)
|
|
|
|
|
|
|
|
typedef struct _virSecretDef virSecretDef;
|
|
|
|
typedef virSecretDef *virSecretDefPtr;
|
|
|
|
struct _virSecretDef {
|
|
|
|
unsigned ephemeral : 1;
|
|
|
|
unsigned private : 1;
|
Fix UUID handling in secrets/storage encryption APIs
Convert all the secret/storage encryption APIs / wire format to
handle UUIDs in raw format instead of non-canonical printable
format. Guarentees data format correctness.
* docs/schemas/storageencryption.rng: Make UUID mandatory for a secret
and validate fully
* docs/schemas/secret.rng: Fully validate UUID
* include/libvirt/libvirt.h, include/libvirt/libvirt.h.in, Add
virSecretLookupByUUID and virSecretGetUUID. Make
virSecretGetUUIDString follow normal API design pattern
* python/generator.py: Skip generation of virSecretGetUUID,
virSecretGetUUIDString and virSecretLookupByUUID
* python/libvir.c, python/libvirt-python-api.xml: Manual impl
of virSecretGetUUID,virSecretGetUUIDString and virSecretLookupByUUID
* qemud/remote.c: s/virSecretLookupByUUIDString/virSecretLookupByUUID/
Fix get_nonnull_secret/make_nonnull_secret to use unsigned char
* qemud/remote_protocol.x: Fix remote_nonnull_secret to use a
remote_uuid instead of remote_nonnull_string for UUID field.
Rename REMOTE_PROC_SECRET_LOOKUP_BY_UUID_STRING to
REMOTE_PROC_SECRET_LOOKUP_BY_UUID_STRING and make it take an
remote_uuid value
* qemud/remote_dispatch_args.h, qemud/remote_dispatch_prototypes.h,
qemud/remote_dispatch_ret.h, qemud/remote_dispatch_table.h,
qemud/remote_protocol.c, qemud/remote_protocol.h: Re-generate
* src/datatypes.h, src/datatypes.c: Store UUID in raw format instead
of printable. Change virGetSecret to use raw format UUID
* src/driver.h: Rename virDrvSecretLookupByUUIDString to
virDrvSecretLookupByUUID and use raw format UUID
* src/libvirt.c: Add virSecretLookupByUUID and virSecretGetUUID
and re-implement virSecretLookupByUUIDString and
virSecretGetUUIDString in terms of those
* src/libvirt_public.syms: Add virSecretLookupByUUID and
virSecretGetUUID
* src/remote_internal.c: Rename remoteSecretLookupByUUIDString
to remoteSecretLookupByUUID. Fix typo in args for
remoteSecretDefineXML impl. Use raw UUID format for
get_nonnull_secret and make_nonnull_secret
* src/storage_encryption_conf.c, src/storage_encryption_conf.h:
Storage UUID in raw format, and require it to be present in
XML. Use UUID parser to validate.
* secret_conf.h, secret_conf.c: Generate a UUID if none is provided.
Storage UUID in raw format.
* src/secret_driver.c: Adjust to deal with raw UUIDs. Save secrets
in a filed with printable UUID, instead of base64 UUID.
* src/virsh.c: Adjust for changed public API contract of
virSecretGetUUIDString.
* src/storage_Backend.c: DOn't undefine secret we just generated
upon successful volume creation. Fix to handle raw UUIDs. Generate
a non-clashing UUID
* src/qemu_driver.c: Change to use lookupByUUID instead of
lookupByUUIDString
2009-09-10 16:44:12 +00:00
|
|
|
unsigned char uuid[VIR_UUID_BUFLEN];
|
2009-09-01 15:27:46 +00:00
|
|
|
char *description; /* May be NULL */
|
|
|
|
int usage_type;
|
|
|
|
union {
|
|
|
|
char *volume; /* May be NULL */
|
2011-10-28 17:30:45 +00:00
|
|
|
char *ceph;
|
2009-09-01 15:27:46 +00:00
|
|
|
} usage;
|
|
|
|
};
|
|
|
|
|
|
|
|
void virSecretDefFree(virSecretDefPtr def);
|
2010-02-10 12:33:34 +00:00
|
|
|
virSecretDefPtr virSecretDefParseString(const char *xml);
|
|
|
|
virSecretDefPtr virSecretDefParseFile(const char *filename);
|
|
|
|
char *virSecretDefFormat(const virSecretDefPtr def);
|
2009-09-01 15:27:46 +00:00
|
|
|
|
2012-09-14 08:38:50 +00:00
|
|
|
# define VIR_CONNECT_LIST_SECRETS_FILTERS_EPHEMERAL \
|
|
|
|
(VIR_CONNECT_LIST_SECRETS_EPHEMERAL | \
|
|
|
|
VIR_CONNECT_LIST_SECRETS_NO_EPHEMERAL)
|
|
|
|
|
|
|
|
# define VIR_CONNECT_LIST_SECRETS_FILTERS_PRIVATE \
|
|
|
|
(VIR_CONNECT_LIST_SECRETS_PRIVATE | \
|
|
|
|
VIR_CONNECT_LIST_SECRETS_NO_PRIVATE)
|
|
|
|
|
|
|
|
# define VIR_CONNECT_LIST_SECRETS_FILTERS_ALL \
|
|
|
|
(VIR_CONNECT_LIST_SECRETS_FILTERS_EPHEMERAL | \
|
|
|
|
VIR_CONNECT_LIST_SECRETS_FILTERS_PRIVATE)
|
|
|
|
|
2009-09-01 15:27:46 +00:00
|
|
|
#endif
|