# These files are not related to driver APIs. Simply generic
# helper APIs for various purposes
UTIL_SOURCES = \
- util/buf.c util/buf.h \
util/command.c util/command.h \
util/conf.c util/conf.h \
util/event.c util/event.h \
util/virauth.c util/virauth.h \
util/virauthconfig.c util/virauthconfig.h \
util/virbitmap.c util/virbitmap.h \
+ util/virbuffer.c util/virbuffer.h \
util/virfile.c util/virfile.h \
util/virnodesuspend.c util/virnodesuspend.h \
util/virobject.c util/virobject.h \
#include <strings.h>
#include "capabilities.h"
-#include "buf.h"
+#include "virbuffer.h"
#include "memory.h"
#include "util.h"
#include "uuid.h"
# define __VIR_CAPABILITIES_H
# include "internal.h"
-# include "buf.h"
+# include "virbuffer.h"
# include "cpu_conf.h"
# include "virarch.h"
# include "virmacaddr.h"
#include "virterror_internal.h"
#include "memory.h"
#include "util.h"
-#include "buf.h"
+#include "virbuffer.h"
#include "cpu_conf.h"
#include "domain_conf.h"
# define __VIR_CPU_CONF_H__
# include "util.h"
-# include "buf.h"
+# include "virbuffer.h"
# include "xml.h"
# include "virbitmap.h"
# include "virarch.h"
#include "xml.h"
#include "uuid.h"
#include "util.h"
-#include "buf.h"
+#include "virbuffer.h"
#include "device_conf.h"
#define VIR_FROM_THIS VIR_FROM_DEVICE
# include "internal.h"
# include "util.h"
# include "threads.h"
-# include "buf.h"
+# include "virbuffer.h"
enum virDeviceAddressPciMulti {
VIR_DEVICE_ADDRESS_PCI_MULTI_DEFAULT = 0,
#include "xml.h"
#include "uuid.h"
#include "util.h"
-#include "buf.h"
+#include "virbuffer.h"
#include "logging.h"
#include "nwfilter_conf.h"
#include "storage_file.h"
#include "xml.h"
#include "uuid.h"
#include "util.h"
-#include "buf.h"
+#include "virbuffer.h"
#define VIR_FROM_THIS VIR_FROM_INTERFACE
# include "internal.h"
# include "virnetdevbandwidth.h"
-# include "buf.h"
+# include "virbuffer.h"
# include "xml.h"
virNetDevBandwidthPtr virNetDevBandwidthParse(xmlNodePtr node,
# include "internal.h"
# include "virnetdevvlan.h"
-# include "buf.h"
+# include "virbuffer.h"
# include "xml.h"
int virNetDevVlanParse(xmlNodePtr node, xmlXPathContextPtr ctxt, virNetDevVlanPtr def);
# include "internal.h"
# include "virnetdevvportprofile.h"
-# include "buf.h"
+# include "virbuffer.h"
# include "xml.h"
typedef enum {
#include "xml.h"
#include "uuid.h"
#include "util.h"
-#include "buf.h"
+#include "virbuffer.h"
#include "c-ctype.h"
#include "virfile.h"
#include "memory.h"
#include "xml.h"
#include "util.h"
-#include "buf.h"
+#include "virbuffer.h"
#include "uuid.h"
#include "pci.h"
#include "virrandom.h"
# include "util.h"
# include "virhash.h"
# include "xml.h"
-# include "buf.h"
+# include "virbuffer.h"
# include "virsocketaddr.h"
# include "virmacaddr.h"
# define NWFILTER_PARAMS_H
# include "virhash.h"
-# include "buf.h"
+# include "virbuffer.h"
# include "virmacaddr.h"
enum virNWFilterVarValueType {
#include <config.h>
#include "internal.h"
-#include "buf.h"
+#include "virbuffer.h"
#include "datatypes.h"
#include "logging.h"
#include "memory.h"
#include "internal.h"
#include "virbitmap.h"
-#include "buf.h"
+#include "virbuffer.h"
#include "count-one-bits.h"
#include "datatypes.h"
#include "domain_conf.h"
#include "xml.h"
#include "uuid.h"
-#include "buf.h"
+#include "virbuffer.h"
#include "util.h"
#include "memory.h"
#include "virfile.h"
#include "internal.h"
-#include "buf.h"
+#include "virbuffer.h"
#include "memory.h"
#include "storage_conf.h"
#include "storage_encryption_conf.h"
# define __VIR_STORAGE_ENCRYPTION_H__
# include "internal.h"
-# include "buf.h"
+# include "virbuffer.h"
# include "util.h"
# include <libxml/tree.h>
#include "cpu.h"
#include "cpu_map.h"
-#include "buf.h"
+#include "virbuffer.h"
#define VIR_FROM_THIS VIR_FROM_CPU
#include "cpu.h"
#include "cpu_map.h"
#include "cpu_x86.h"
-#include "buf.h"
+#include "virbuffer.h"
#define VIR_FROM_THIS VIR_FROM_CPU
#include <libxml/parser.h>
#include <libxml/xpathInternals.h>
-#include "buf.h"
+#include "virbuffer.h"
#include "memory.h"
#include "logging.h"
#include "util.h"
#include <config.h>
-#include "buf.h"
+#include "virbuffer.h"
#include "memory.h"
#include "logging.h"
#include "uuid.h"
#include <libxml/parser.h>
#include <libxml/xpathInternals.h>
-#include "buf.h"
+#include "virbuffer.h"
#include "datatypes.h"
#include "memory.h"
#include "logging.h"
#ifndef __ESX_VI_TYPES_H__
# define __ESX_VI_TYPES_H__
-# include "buf.h"
+# include "virbuffer.h"
typedef enum _esxVI_Type esxVI_Type;
typedef struct _esxVI_Object esxVI_Object;
#include "memory.h"
#include "util.h"
#include "uuid.h"
-#include "buf.h"
+#include "virbuffer.h"
#include "hyperv_private.h"
#include "hyperv_wmi.h"
#ifndef __HYPERV_WMI_H__
# define __HYPERV_WMI_H__
-# include "buf.h"
+# include "virbuffer.h"
# include "hyperv_private.h"
# include "hyperv_wmi_classes.h"
# include "openwsman.h"
#include "virterror_internal.h"
#include "logging.h"
#include "virfile.h"
-#include "buf.h"
+#include "virbuffer.h"
#define VIR_FROM_THIS VIR_FROM_LXC
#include "network_conf.h"
#include "device_conf.h"
#include "driver.h"
-#include "buf.h"
+#include "virbuffer.h"
#include "virpidfile.h"
#include "util.h"
#include "command.h"
#include "memory.h"
#include "uuid.h"
#include "util.h"
-#include "buf.h"
+#include "virbuffer.h"
#include "pci.h"
#define VIR_FROM_THIS VIR_FROM_NODEDEV
#include "internal.h"
-#include "buf.h"
+#include "virbuffer.h"
#include "memory.h"
#include "logging.h"
#include "virterror_internal.h"
#include "internal.h"
#include "intprops.h"
-#include "buf.h"
+#include "virbuffer.h"
#include "memory.h"
#include "logging.h"
#include "datatypes.h"
#include "openvz_conf.h"
#include "openvz_util.h"
#include "uuid.h"
-#include "buf.h"
+#include "virbuffer.h"
#include "memory.h"
#include "util.h"
#include "nodeinfo.h"
#include "datatypes.h"
#include "openvz_driver.h"
#include "openvz_util.h"
-#include "buf.h"
+#include "virbuffer.h"
#include "util.h"
#include "openvz_conf.h"
#include "nodeinfo.h"
#include "virauth.h"
#include "util.h"
#include "datatypes.h"
-#include "buf.h"
+#include "virbuffer.h"
#include "memory.h"
#include "logging.h"
#include "driver.h"
#include "qemu_capabilities.h"
#include "qemu_bridge_filter.h"
#include "uuid.h"
-#include "buf.h"
+#include "virbuffer.h"
#include "conf.h"
#include "util.h"
#include "memory.h"
#include "virterror_internal.h"
#include "logging.h"
#include "datatypes.h"
-#include "buf.h"
+#include "virbuffer.h"
#include "util.h"
#include "nodeinfo.h"
#include "stats_linux.h"
#include "driver.h"
#include "datatypes.h"
#include "virterror_internal.h"
-#include "buf.h"
+#include "virbuffer.h"
#ifdef WITH_DTRACE_PROBES
# include "libvirt_qemu_probes.h"
#include "datatypes.h"
#include "domain_event.h"
#include "driver.h"
-#include "buf.h"
+#include "virbuffer.h"
#include "remote_driver.h"
#include "remote_protocol.h"
#include "qemu_protocol.h"
#include "virnetsshsession.h"
#include "internal.h"
-#include "buf.h"
+#include "virbuffer.h"
#include "memory.h"
#include "logging.h"
#include "configmake.h"
#include <locale.h>
#include "internal.h"
-#include "buf.h"
+#include "virbuffer.h"
#include "util.h"
#include "memory.h"
#include "command.h"
#include "virterror_internal.h"
#include "datatypes.h"
#include "test_driver.h"
-#include "buf.h"
+#include "virbuffer.h"
#include "util.h"
#include "uuid.h"
#include "capabilities.h"
#include "uml_conf.h"
#include "uuid.h"
-#include "buf.h"
+#include "virbuffer.h"
#include "conf.h"
#include "util.h"
#include "memory.h"
#include "uml_driver.h"
#include "uml_conf.h"
-#include "buf.h"
+#include "virbuffer.h"
#include "util.h"
#include "nodeinfo.h"
#include "stats_linux.h"
+++ /dev/null
-/*
- * buf.c: buffers for libvirt
- *
- * Copyright (C) 2005-2008, 2010-2012 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/>.
- *
- * Daniel Veillard <veillard@redhat.com>
- */
-
-#include <config.h>
-
-#include <stdio.h>
-#include <stdlib.h>
-#include <string.h>
-#include <stdarg.h>
-#include "c-ctype.h"
-
-#define __VIR_BUFFER_C__
-
-#include "buf.h"
-#include "memory.h"
-
-
-/* If adding more fields, ensure to edit buf.h to match
- the number of fields */
-struct _virBuffer {
- unsigned int size;
- unsigned int use;
- unsigned int error; /* errno value, or -1 for usage error */
- int indent;
- char *content;
-};
-
-/**
- * virBufferFail
- * @buf: the buffer
- * @error: which error occurred (errno value, or -1 for usage)
- *
- * Mark the buffer as failed, free the content and set the error flag.
- */
-static void
-virBufferSetError(virBufferPtr buf, int error)
-{
- VIR_FREE(buf->content);
- buf->size = 0;
- buf->use = 0;
- buf->indent = 0;
- buf->error = error;
-}
-
-/**
- * virBufferAdjustIndent:
- * @buf: the buffer
- * @indent: adjustment to make
- *
- * Alter the auto-indent value by adding indent (positive to increase,
- * negative to decrease). Automatic indentation is performed by all
- * additive functions when the existing buffer is empty or ends with a
- * newline (however, note that no indentation is added after newlines
- * embedded in an appended string). If @indent would cause overflow,
- * the buffer error indicator is set.
- */
-void
-virBufferAdjustIndent(virBufferPtr buf, int indent)
-{
- if (!buf || buf->error)
- return;
- if (indent > 0 ? INT_MAX - indent < buf->indent
- : buf->indent < -indent) {
- virBufferSetError(buf, -1);
- return;
- }
- buf->indent += indent;
-}
-
-/**
- * virBufferGetIndent:
- * @buf: the buffer
- * @dynamic: if false, return set value; if true, return 0 unless next
- * append would be affected by auto-indent
- *
- * Return the current auto-indent value, or -1 if there has been an error.
- */
-int
-virBufferGetIndent(const virBufferPtr buf, bool dynamic)
-{
- if (!buf || buf->error)
- return -1;
- if (dynamic && buf->use && buf->content[buf->use - 1] != '\n')
- return 0;
- return buf->indent;
-}
-
-/**
- * virBufferGrow:
- * @buf: the buffer
- * @len: the minimum free size to allocate on top of existing used space
- *
- * Grow the available space of a buffer to at least @len bytes.
- *
- * Returns zero on success or -1 on error
- */
-static int
-virBufferGrow(virBufferPtr buf, unsigned int len)
-{
- int size;
-
- if (buf->error)
- return -1;
-
- if ((len + buf->use) < buf->size)
- return 0;
-
- size = buf->use + len + 1000;
-
- if (VIR_REALLOC_N(buf->content, size) < 0) {
- virBufferSetError(buf, errno);
- return -1;
- }
- buf->size = size;
- return 0;
-}
-
-/**
- * virBufferAdd:
- * @buf: the buffer to append to
- * @str: the string
- * @len: the number of bytes to add, or -1
- *
- * Add a string range to an XML buffer. If @len == -1, the length of
- * str is recomputed to the full string. Auto indentation may be applied.
- *
- */
-void
-virBufferAdd(virBufferPtr buf, const char *str, int len)
-{
- unsigned int needSize;
- int indent;
-
- if (!str || !buf || (len == 0 && buf->indent == 0))
- return;
-
- if (buf->error)
- return;
-
- indent = virBufferGetIndent(buf, true);
-
- if (len < 0)
- len = strlen(str);
-
- needSize = buf->use + indent + len + 2;
- if (needSize > buf->size &&
- virBufferGrow(buf, needSize - buf->use) < 0)
- return;
-
- memset(&buf->content[buf->use], ' ', indent);
- memcpy(&buf->content[buf->use + indent], str, len);
- buf->use += indent + len;
- buf->content[buf->use] = '\0';
-}
-
-/**
- * virBufferAddChar:
- * @buf: the buffer to append to
- * @c: the character to add
- *
- * Add a single character 'c' to a buffer. Auto indentation may be applied.
- *
- */
-void
-virBufferAddChar(virBufferPtr buf, char c)
-{
- virBufferAdd(buf, &c, 1);
-}
-
-/**
- * virBufferCurrentContent:
- * @buf: Buffer
- *
- * Get the current content from the buffer. The content is only valid
- * until the next operation on @buf, and an empty string is returned if
- * no content is present yet.
- *
- * Returns the buffer content or NULL in case of error.
- */
-const char *
-virBufferCurrentContent(virBufferPtr buf)
-{
- if (!buf || buf->error)
- return NULL;
- return buf->use ? buf->content : "";
-}
-
-/**
- * virBufferContentAndReset:
- * @buf: Buffer
- *
- * Get the content from the buffer and free (only) the buffer structure.
- * The caller owns the returned string & should free it when no longer
- * required. The buffer object is reset to its initial state. This
- * interface intentionally returns NULL instead of an empty string if
- * there is no content.
- *
- * Returns the buffer content or NULL in case of error.
- */
-char *
-virBufferContentAndReset(virBufferPtr buf)
-{
- char *str;
- if (buf == NULL)
- return NULL;
-
- if (buf->error) {
- memset(buf, 0, sizeof(*buf));
- return NULL;
- }
-
- str = buf->content;
- memset(buf, 0, sizeof(*buf));
- return str;
-}
-
-/**
- * virBufferFreeAndReset:
- * @buf: the buffer to free and reset
- *
- * Frees the buffer content and resets the buffer structure.
- */
-void virBufferFreeAndReset(virBufferPtr buf)
-{
- char *str = virBufferContentAndReset(buf);
-
- VIR_FREE(str);
-}
-
-/**
- * virBufferError:
- * @buf: the buffer
- *
- * Check to see if the buffer is in an error state due
- * to failed memory allocation or usage error
- *
- * Return positive errno value or -1 on usage error, 0 if normal
- */
-int
-virBufferError(const virBufferPtr buf)
-{
- if (buf == NULL)
- return -1;
-
- return buf->error;
-}
-
-/**
- * virBufferUse:
- * @buf: the usage of the string in the buffer
- *
- * Return the string usage in bytes
- */
-unsigned int
-virBufferUse(const virBufferPtr buf)
-{
- if (buf == NULL)
- return 0;
-
- return buf->use;
-}
-
-/**
- * virBufferAsprintf:
- * @buf: the buffer to append to
- * @format: the format
- * @...: the variable list of arguments
- *
- * Do a formatted print to an XML buffer. Auto indentation may be applied.
- */
-void
-virBufferAsprintf(virBufferPtr buf, const char *format, ...)
-{
- va_list argptr;
- va_start(argptr, format);
- virBufferVasprintf(buf, format, argptr);
- va_end(argptr);
-}
-
-/**
- * virBufferVasprintf:
- * @buf: the buffer to append to
- * @format: the format
- * @argptr: the variable list of arguments
- *
- * Do a formatted print to an XML buffer. Auto indentation may be applied.
- */
-void
-virBufferVasprintf(virBufferPtr buf, const char *format, va_list argptr)
-{
- int size, count, grow_size;
- va_list copy;
-
- if ((format == NULL) || (buf == NULL))
- return;
-
- if (buf->error)
- return;
-
- virBufferAddLit(buf, ""); /* auto-indent */
-
- if (buf->size == 0 &&
- virBufferGrow(buf, 100) < 0)
- return;
-
- va_copy(copy, argptr);
-
- size = buf->size - buf->use;
- if ((count = vsnprintf(&buf->content[buf->use],
- size, format, copy)) < 0) {
- virBufferSetError(buf, errno);
- va_end(copy);
- return;
- }
- va_end(copy);
-
- /* Grow buffer if necessary and retry */
- if (count >= size) {
- buf->content[buf->use] = 0;
-
- grow_size = (count + 1 > 1000) ? count + 1 : 1000;
- if (virBufferGrow(buf, grow_size) < 0) {
- return;
- }
-
- size = buf->size - buf->use;
- if ((count = vsnprintf(&buf->content[buf->use],
- size, format, argptr)) < 0) {
- virBufferSetError(buf, errno);
- return;
- }
- }
- buf->use += count;
-}
-
-/**
- * virBufferEscapeString:
- * @buf: the buffer to append to
- * @format: a printf like format string but with only one %s parameter
- * @str: the string argument which needs to be escaped
- *
- * Do a formatted print with a single string to an XML buffer. The
- * string is escaped for use in XML. If @str is NULL, nothing is
- * added (not even the rest of @format). Auto indentation may be
- * applied.
- */
-void
-virBufferEscapeString(virBufferPtr buf, const char *format, const char *str)
-{
- int len;
- char *escaped, *out;
- const char *cur;
-
- if ((format == NULL) || (buf == NULL) || (str == NULL))
- return;
-
- if (buf->error)
- return;
-
- len = strlen(str);
- if (strcspn(str, "<>&'\"") == len) {
- virBufferAsprintf(buf, format, str);
- return;
- }
-
- if (xalloc_oversized(6, len) ||
- VIR_ALLOC_N(escaped, 6 * len + 1) < 0) {
- virBufferSetError(buf, errno);
- return;
- }
-
- cur = str;
- out = escaped;
- while (*cur != 0) {
- if (*cur == '<') {
- *out++ = '&';
- *out++ = 'l';
- *out++ = 't';
- *out++ = ';';
- } else if (*cur == '>') {
- *out++ = '&';
- *out++ = 'g';
- *out++ = 't';
- *out++ = ';';
- } else if (*cur == '&') {
- *out++ = '&';
- *out++ = 'a';
- *out++ = 'm';
- *out++ = 'p';
- *out++ = ';';
- } else if (*cur == '"') {
- *out++ = '&';
- *out++ = 'q';
- *out++ = 'u';
- *out++ = 'o';
- *out++ = 't';
- *out++ = ';';
- } else if (*cur == '\'') {
- *out++ = '&';
- *out++ = 'a';
- *out++ = 'p';
- *out++ = 'o';
- *out++ = 's';
- *out++ = ';';
- } else if (((unsigned char)*cur >= 0x20) || (*cur == '\n') || (*cur == '\t') ||
- (*cur == '\r')) {
- /*
- * default case, just copy !
- * Note that character over 0x80 are likely to give problem
- * with UTF-8 XML, but since our string don't have an encoding
- * it's hard to handle properly we have to assume it's UTF-8 too
- */
- *out++ = *cur;
- }
- cur++;
- }
- *out = 0;
-
- virBufferAsprintf(buf, format, escaped);
- VIR_FREE(escaped);
-}
-
-/**
- * virBufferEscapeSexpr:
- * @buf: the buffer to append to
- * @format: a printf like format string but with only one %s parameter
- * @str: the string argument which needs to be escaped
- *
- * Do a formatted print with a single string to an sexpr buffer. The
- * string is escaped to avoid generating a sexpr that xen will choke
- * on. This doesn't fully escape the sexpr, just enough for our code
- * to work. Auto indentation may be applied.
- */
-void
-virBufferEscapeSexpr(virBufferPtr buf,
- const char *format,
- const char *str)
-{
- virBufferEscape(buf, '\\', "\\'", format, str);
-}
-
-/* Work around spurious strchr() diagnostics given by -Wlogical-op
- * for gcc < 4.6. Doing it via a local pragma keeps the damage
- * smaller than disabling it on the package level. Unfortunately, the
- * affected GCCs don't allow diagnostic push/pop which would have
- * further reduced the impact. */
-#if BROKEN_GCC_WLOGICALOP
-# pragma GCC diagnostic ignored "-Wlogical-op"
-#endif
-
-/**
- * virBufferEscape:
- * @buf: the buffer to append to
- * @escape: the escape character to inject
- * @toescape: NUL-terminated list of characters to escape
- * @format: a printf like format string but with only one %s parameter
- * @str: the string argument which needs to be escaped
- *
- * Do a formatted print with a single string to a buffer. Any characters
- * in the provided list are escaped with the given escape. Auto indentation
- * may be applied.
- */
-void
-virBufferEscape(virBufferPtr buf, char escape, const char *toescape,
- const char *format, const char *str)
-{
- int len;
- char *escaped, *out;
- const char *cur;
-
- if ((format == NULL) || (buf == NULL) || (str == NULL))
- return;
-
- if (buf->error)
- return;
-
- len = strlen(str);
- if (strcspn(str, toescape) == len) {
- virBufferAsprintf(buf, format, str);
- return;
- }
-
- if (xalloc_oversized(2, len) ||
- VIR_ALLOC_N(escaped, 2 * len + 1) < 0) {
- virBufferSetError(buf, errno);
- return;
- }
-
- cur = str;
- out = escaped;
- while (*cur != 0) {
- if (strchr(toescape, *cur))
- *out++ = escape;
- *out++ = *cur;
- cur++;
- }
- *out = 0;
-
- virBufferAsprintf(buf, format, escaped);
- VIR_FREE(escaped);
-}
-
-/**
- * virBufferURIEncodeString:
- * @buf: the buffer to append to
- * @str: the string argument which will be URI-encoded
- *
- * Append the string to the buffer. The string will be URI-encoded
- * during the append (ie any non alpha-numeric characters are replaced
- * with '%xx' hex sequences). Auto indentation may be applied.
- */
-void
-virBufferURIEncodeString(virBufferPtr buf, const char *str)
-{
- int grow_size = 0;
- const char *p;
- unsigned char uc;
- const char *hex = "0123456789abcdef";
-
- if ((buf == NULL) || (str == NULL))
- return;
-
- if (buf->error)
- return;
-
- virBufferAddLit(buf, ""); /* auto-indent */
-
- for (p = str; *p; ++p) {
- if (c_isalnum(*p))
- grow_size++;
- else
- grow_size += 3; /* %ab */
- }
-
- if (virBufferGrow(buf, grow_size) < 0)
- return;
-
- for (p = str; *p; ++p) {
- if (c_isalnum(*p))
- buf->content[buf->use++] = *p;
- else {
- uc = (unsigned char) *p;
- buf->content[buf->use++] = '%';
- buf->content[buf->use++] = hex[uc >> 4];
- buf->content[buf->use++] = hex[uc & 0xf];
- }
- }
-
- buf->content[buf->use] = '\0';
-}
-
-/**
- * virBufferEscapeShell:
- * @buf: the buffer to append to
- * @str: an unquoted string
- *
- * Quotes a string so that the shell (/bin/sh) will interpret the
- * quoted string to mean str. Auto indentation may be applied.
- */
-void
-virBufferEscapeShell(virBufferPtr buf, const char *str)
-{
- int len;
- char *escaped, *out;
- const char *cur;
-
- if ((buf == NULL) || (str == NULL))
- return;
-
- if (buf->error)
- return;
-
- /* Only quote if str includes shell metacharacters. */
- if (*str && !strpbrk(str, "\r\t\n !\"#$&'()*;<>?[\\]^`{|}~")) {
- virBufferAdd(buf, str, -1);
- return;
- }
-
- if (*str) {
- len = strlen(str);
- if (xalloc_oversized(4, len) ||
- VIR_ALLOC_N(escaped, 4 * len + 3) < 0) {
- virBufferSetError(buf, errno);
- return;
- }
- } else {
- virBufferAddLit(buf, "''");
- return;
- }
-
- cur = str;
- out = escaped;
-
- *out++ = '\'';
- while (*cur != 0) {
- if (*cur == '\'') {
- *out++ = '\'';
- /* Replace literal ' with a close ', a \', and a open ' */
- *out++ = '\\';
- *out++ = '\'';
- }
- *out++ = *cur++;
- }
- *out++ = '\'';
- *out = 0;
-
- virBufferAdd(buf, escaped, -1);
- VIR_FREE(escaped);
-}
-
-/**
- * virBufferStrcat:
- * @buf: the buffer to append to
- * @...: the variable list of strings, the last argument must be NULL
- *
- * Concatenate strings to an XML buffer. Auto indentation may be applied
- * after each string argument.
- */
-void
-virBufferStrcat(virBufferPtr buf, ...)
-{
- va_list ap;
- char *str;
-
- if (buf->error)
- return;
-
- va_start(ap, buf);
- while ((str = va_arg(ap, char *)) != NULL)
- virBufferAdd(buf, str, -1);
- va_end(ap);
-}
-
-/**
- * virBufferTrim:
- * @buf: the buffer to trim
- * @str: the optional string, to force an exact trim
- * @len: the number of bytes to trim, or -1 to use @str
- *
- * Trim the tail of a buffer. If @str is provided, the trim only occurs
- * if the current tail of the buffer matches @str; a non-negative @len
- * further limits how much of the tail is trimmed. If @str is NULL, then
- * @len must be non-negative.
- *
- * Returns -1 if @buf has previously encountered an error or if @len is
- * invalid, 0 if there was nothing to trim (@buf was too short or @str
- * didn't match), and 1 if the trim was successful.
- */
-int
-virBufferTrim(virBufferPtr buf, const char *str, int len)
-{
- size_t len2 = 0;
-
- if (!buf || buf->error || (!str && len < 0))
- return -1;
-
- if (len > 0 && len > buf->use)
- return 0;
- if (str) {
- len2 = strlen(str);
- if (len2 > buf->use ||
- memcmp(&buf->content[buf->use - len2], str, len2) != 0)
- return 0;
- }
- buf->use -= len < 0 ? len2 : len;
- buf->content[buf->use] = '\0';
- return 1;
-}
+++ /dev/null
-/*
- * buf.h: buffers for libvirt
- *
- * Copyright (C) 2005-2008, 2011, 2012 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/>.
- *
- * Daniel Veillard <veillard@redhat.com>
- */
-
-#ifndef __VIR_BUFFER_H__
-# define __VIR_BUFFER_H__
-
-# include "internal.h"
-
-# include <stdarg.h>
-
-/**
- * virBuffer:
- *
- * A buffer structure.
- */
-typedef struct _virBuffer virBuffer;
-typedef virBuffer *virBufferPtr;
-
-# ifndef __VIR_BUFFER_C__
-# define VIR_BUFFER_INITIALIZER { 0, 0, 0, 0, NULL }
-
-/* This struct must be kept in sync with the real struct
- in the buf.c impl file */
-struct _virBuffer {
- unsigned int a;
- unsigned int b;
- unsigned int c;
- int d;
- char *e;
-};
-# endif
-
-const char *virBufferCurrentContent(virBufferPtr buf);
-char *virBufferContentAndReset(virBufferPtr buf);
-void virBufferFreeAndReset(virBufferPtr buf);
-int virBufferError(const virBufferPtr buf);
-unsigned int virBufferUse(const virBufferPtr buf);
-void virBufferAdd(virBufferPtr buf, const char *str, int len);
-void virBufferAddChar(virBufferPtr buf, char c);
-void virBufferAsprintf(virBufferPtr buf, const char *format, ...)
- ATTRIBUTE_FMT_PRINTF(2, 3);
-void virBufferVasprintf(virBufferPtr buf, const char *format, va_list ap)
- ATTRIBUTE_FMT_PRINTF(2, 0);
-void virBufferStrcat(virBufferPtr buf, ...)
- ATTRIBUTE_SENTINEL;
-void virBufferEscape(virBufferPtr buf, char escape, const char *toescape,
- const char *format, const char *str);
-void virBufferEscapeString(virBufferPtr buf, const char *format,
- const char *str);
-void virBufferEscapeSexpr(virBufferPtr buf, const char *format,
- const char *str);
-void virBufferEscapeShell(virBufferPtr buf, const char *str);
-void virBufferURIEncodeString(virBufferPtr buf, const char *str);
-
-# define virBufferAddLit(buf_, literal_string_) \
- virBufferAdd(buf_, "" literal_string_ "", sizeof(literal_string_) - 1)
-
-void virBufferAdjustIndent(virBufferPtr buf, int indent);
-int virBufferGetIndent(const virBufferPtr buf, bool dynamic);
-
-int virBufferTrim(virBufferPtr buf, const char *trim, int len);
-
-#endif /* __VIR_BUFFER_H__ */
#include "virfile.h"
#include "virpidfile.h"
#include "virprocess.h"
-#include "buf.h"
+#include "virbuffer.h"
#define VIR_FROM_THIS VIR_FROM_NONE
# include "internal.h"
# include "util.h"
-# include "buf.h"
+# include "virbuffer.h"
typedef struct _virCommand virCommand;
typedef virCommand *virCommandPtr;
#include <fcntl.h>
#include "virterror_internal.h"
-#include "buf.h"
+#include "virbuffer.h"
#include "conf.h"
#include "util.h"
#include "c-ctype.h"
#include "logging.h"
#include "memory.h"
#include "util.h"
-#include "buf.h"
+#include "virbuffer.h"
#include "threads.h"
#include "virfile.h"
#include "virtime.h"
# define __VIRTLOG_H_
# include "internal.h"
-# include "buf.h"
+# include "virbuffer.h"
/*
* To be made public
# define _LIBVIR_SEXPR_H_
# include "internal.h"
-# include "buf.h"
+# include "virbuffer.h"
enum sexpr_type {
SEXPR_NIL,
# include "internal.h"
# include "util.h"
-# include "buf.h"
+# include "virbuffer.h"
enum virSysinfoType {
VIR_SYSINFO_SMBIOS,
#include "dirname.h"
#include "virterror_internal.h"
#include "logging.h"
-#include "buf.h"
+#include "virbuffer.h"
#include "util.h"
#include "storage_file.h"
#include "memory.h"
#include "virbitmap.h"
#include "memory.h"
-#include "buf.h"
+#include "virbuffer.h"
#include "util.h"
#include "c-ctype.h"
#include "count-one-bits.h"
--- /dev/null
+/*
+ * virbuffer.c: buffers for libvirt
+ *
+ * Copyright (C) 2005-2008, 2010-2012 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/>.
+ *
+ * Daniel Veillard <veillard@redhat.com>
+ */
+
+#include <config.h>
+
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include <stdarg.h>
+#include "c-ctype.h"
+
+#define __VIR_BUFFER_C__
+
+#include "virbuffer.h"
+#include "memory.h"
+
+
+/* If adding more fields, ensure to edit buf.h to match
+ the number of fields */
+struct _virBuffer {
+ unsigned int size;
+ unsigned int use;
+ unsigned int error; /* errno value, or -1 for usage error */
+ int indent;
+ char *content;
+};
+
+/**
+ * virBufferFail
+ * @buf: the buffer
+ * @error: which error occurred (errno value, or -1 for usage)
+ *
+ * Mark the buffer as failed, free the content and set the error flag.
+ */
+static void
+virBufferSetError(virBufferPtr buf, int error)
+{
+ VIR_FREE(buf->content);
+ buf->size = 0;
+ buf->use = 0;
+ buf->indent = 0;
+ buf->error = error;
+}
+
+/**
+ * virBufferAdjustIndent:
+ * @buf: the buffer
+ * @indent: adjustment to make
+ *
+ * Alter the auto-indent value by adding indent (positive to increase,
+ * negative to decrease). Automatic indentation is performed by all
+ * additive functions when the existing buffer is empty or ends with a
+ * newline (however, note that no indentation is added after newlines
+ * embedded in an appended string). If @indent would cause overflow,
+ * the buffer error indicator is set.
+ */
+void
+virBufferAdjustIndent(virBufferPtr buf, int indent)
+{
+ if (!buf || buf->error)
+ return;
+ if (indent > 0 ? INT_MAX - indent < buf->indent
+ : buf->indent < -indent) {
+ virBufferSetError(buf, -1);
+ return;
+ }
+ buf->indent += indent;
+}
+
+/**
+ * virBufferGetIndent:
+ * @buf: the buffer
+ * @dynamic: if false, return set value; if true, return 0 unless next
+ * append would be affected by auto-indent
+ *
+ * Return the current auto-indent value, or -1 if there has been an error.
+ */
+int
+virBufferGetIndent(const virBufferPtr buf, bool dynamic)
+{
+ if (!buf || buf->error)
+ return -1;
+ if (dynamic && buf->use && buf->content[buf->use - 1] != '\n')
+ return 0;
+ return buf->indent;
+}
+
+/**
+ * virBufferGrow:
+ * @buf: the buffer
+ * @len: the minimum free size to allocate on top of existing used space
+ *
+ * Grow the available space of a buffer to at least @len bytes.
+ *
+ * Returns zero on success or -1 on error
+ */
+static int
+virBufferGrow(virBufferPtr buf, unsigned int len)
+{
+ int size;
+
+ if (buf->error)
+ return -1;
+
+ if ((len + buf->use) < buf->size)
+ return 0;
+
+ size = buf->use + len + 1000;
+
+ if (VIR_REALLOC_N(buf->content, size) < 0) {
+ virBufferSetError(buf, errno);
+ return -1;
+ }
+ buf->size = size;
+ return 0;
+}
+
+/**
+ * virBufferAdd:
+ * @buf: the buffer to append to
+ * @str: the string
+ * @len: the number of bytes to add, or -1
+ *
+ * Add a string range to an XML buffer. If @len == -1, the length of
+ * str is recomputed to the full string. Auto indentation may be applied.
+ *
+ */
+void
+virBufferAdd(virBufferPtr buf, const char *str, int len)
+{
+ unsigned int needSize;
+ int indent;
+
+ if (!str || !buf || (len == 0 && buf->indent == 0))
+ return;
+
+ if (buf->error)
+ return;
+
+ indent = virBufferGetIndent(buf, true);
+
+ if (len < 0)
+ len = strlen(str);
+
+ needSize = buf->use + indent + len + 2;
+ if (needSize > buf->size &&
+ virBufferGrow(buf, needSize - buf->use) < 0)
+ return;
+
+ memset(&buf->content[buf->use], ' ', indent);
+ memcpy(&buf->content[buf->use + indent], str, len);
+ buf->use += indent + len;
+ buf->content[buf->use] = '\0';
+}
+
+/**
+ * virBufferAddChar:
+ * @buf: the buffer to append to
+ * @c: the character to add
+ *
+ * Add a single character 'c' to a buffer. Auto indentation may be applied.
+ *
+ */
+void
+virBufferAddChar(virBufferPtr buf, char c)
+{
+ virBufferAdd(buf, &c, 1);
+}
+
+/**
+ * virBufferCurrentContent:
+ * @buf: Buffer
+ *
+ * Get the current content from the buffer. The content is only valid
+ * until the next operation on @buf, and an empty string is returned if
+ * no content is present yet.
+ *
+ * Returns the buffer content or NULL in case of error.
+ */
+const char *
+virBufferCurrentContent(virBufferPtr buf)
+{
+ if (!buf || buf->error)
+ return NULL;
+ return buf->use ? buf->content : "";
+}
+
+/**
+ * virBufferContentAndReset:
+ * @buf: Buffer
+ *
+ * Get the content from the buffer and free (only) the buffer structure.
+ * The caller owns the returned string & should free it when no longer
+ * required. The buffer object is reset to its initial state. This
+ * interface intentionally returns NULL instead of an empty string if
+ * there is no content.
+ *
+ * Returns the buffer content or NULL in case of error.
+ */
+char *
+virBufferContentAndReset(virBufferPtr buf)
+{
+ char *str;
+ if (buf == NULL)
+ return NULL;
+
+ if (buf->error) {
+ memset(buf, 0, sizeof(*buf));
+ return NULL;
+ }
+
+ str = buf->content;
+ memset(buf, 0, sizeof(*buf));
+ return str;
+}
+
+/**
+ * virBufferFreeAndReset:
+ * @buf: the buffer to free and reset
+ *
+ * Frees the buffer content and resets the buffer structure.
+ */
+void virBufferFreeAndReset(virBufferPtr buf)
+{
+ char *str = virBufferContentAndReset(buf);
+
+ VIR_FREE(str);
+}
+
+/**
+ * virBufferError:
+ * @buf: the buffer
+ *
+ * Check to see if the buffer is in an error state due
+ * to failed memory allocation or usage error
+ *
+ * Return positive errno value or -1 on usage error, 0 if normal
+ */
+int
+virBufferError(const virBufferPtr buf)
+{
+ if (buf == NULL)
+ return -1;
+
+ return buf->error;
+}
+
+/**
+ * virBufferUse:
+ * @buf: the usage of the string in the buffer
+ *
+ * Return the string usage in bytes
+ */
+unsigned int
+virBufferUse(const virBufferPtr buf)
+{
+ if (buf == NULL)
+ return 0;
+
+ return buf->use;
+}
+
+/**
+ * virBufferAsprintf:
+ * @buf: the buffer to append to
+ * @format: the format
+ * @...: the variable list of arguments
+ *
+ * Do a formatted print to an XML buffer. Auto indentation may be applied.
+ */
+void
+virBufferAsprintf(virBufferPtr buf, const char *format, ...)
+{
+ va_list argptr;
+ va_start(argptr, format);
+ virBufferVasprintf(buf, format, argptr);
+ va_end(argptr);
+}
+
+/**
+ * virBufferVasprintf:
+ * @buf: the buffer to append to
+ * @format: the format
+ * @argptr: the variable list of arguments
+ *
+ * Do a formatted print to an XML buffer. Auto indentation may be applied.
+ */
+void
+virBufferVasprintf(virBufferPtr buf, const char *format, va_list argptr)
+{
+ int size, count, grow_size;
+ va_list copy;
+
+ if ((format == NULL) || (buf == NULL))
+ return;
+
+ if (buf->error)
+ return;
+
+ virBufferAddLit(buf, ""); /* auto-indent */
+
+ if (buf->size == 0 &&
+ virBufferGrow(buf, 100) < 0)
+ return;
+
+ va_copy(copy, argptr);
+
+ size = buf->size - buf->use;
+ if ((count = vsnprintf(&buf->content[buf->use],
+ size, format, copy)) < 0) {
+ virBufferSetError(buf, errno);
+ va_end(copy);
+ return;
+ }
+ va_end(copy);
+
+ /* Grow buffer if necessary and retry */
+ if (count >= size) {
+ buf->content[buf->use] = 0;
+
+ grow_size = (count + 1 > 1000) ? count + 1 : 1000;
+ if (virBufferGrow(buf, grow_size) < 0) {
+ return;
+ }
+
+ size = buf->size - buf->use;
+ if ((count = vsnprintf(&buf->content[buf->use],
+ size, format, argptr)) < 0) {
+ virBufferSetError(buf, errno);
+ return;
+ }
+ }
+ buf->use += count;
+}
+
+/**
+ * virBufferEscapeString:
+ * @buf: the buffer to append to
+ * @format: a printf like format string but with only one %s parameter
+ * @str: the string argument which needs to be escaped
+ *
+ * Do a formatted print with a single string to an XML buffer. The
+ * string is escaped for use in XML. If @str is NULL, nothing is
+ * added (not even the rest of @format). Auto indentation may be
+ * applied.
+ */
+void
+virBufferEscapeString(virBufferPtr buf, const char *format, const char *str)
+{
+ int len;
+ char *escaped, *out;
+ const char *cur;
+
+ if ((format == NULL) || (buf == NULL) || (str == NULL))
+ return;
+
+ if (buf->error)
+ return;
+
+ len = strlen(str);
+ if (strcspn(str, "<>&'\"") == len) {
+ virBufferAsprintf(buf, format, str);
+ return;
+ }
+
+ if (xalloc_oversized(6, len) ||
+ VIR_ALLOC_N(escaped, 6 * len + 1) < 0) {
+ virBufferSetError(buf, errno);
+ return;
+ }
+
+ cur = str;
+ out = escaped;
+ while (*cur != 0) {
+ if (*cur == '<') {
+ *out++ = '&';
+ *out++ = 'l';
+ *out++ = 't';
+ *out++ = ';';
+ } else if (*cur == '>') {
+ *out++ = '&';
+ *out++ = 'g';
+ *out++ = 't';
+ *out++ = ';';
+ } else if (*cur == '&') {
+ *out++ = '&';
+ *out++ = 'a';
+ *out++ = 'm';
+ *out++ = 'p';
+ *out++ = ';';
+ } else if (*cur == '"') {
+ *out++ = '&';
+ *out++ = 'q';
+ *out++ = 'u';
+ *out++ = 'o';
+ *out++ = 't';
+ *out++ = ';';
+ } else if (*cur == '\'') {
+ *out++ = '&';
+ *out++ = 'a';
+ *out++ = 'p';
+ *out++ = 'o';
+ *out++ = 's';
+ *out++ = ';';
+ } else if (((unsigned char)*cur >= 0x20) || (*cur == '\n') || (*cur == '\t') ||
+ (*cur == '\r')) {
+ /*
+ * default case, just copy !
+ * Note that character over 0x80 are likely to give problem
+ * with UTF-8 XML, but since our string don't have an encoding
+ * it's hard to handle properly we have to assume it's UTF-8 too
+ */
+ *out++ = *cur;
+ }
+ cur++;
+ }
+ *out = 0;
+
+ virBufferAsprintf(buf, format, escaped);
+ VIR_FREE(escaped);
+}
+
+/**
+ * virBufferEscapeSexpr:
+ * @buf: the buffer to append to
+ * @format: a printf like format string but with only one %s parameter
+ * @str: the string argument which needs to be escaped
+ *
+ * Do a formatted print with a single string to an sexpr buffer. The
+ * string is escaped to avoid generating a sexpr that xen will choke
+ * on. This doesn't fully escape the sexpr, just enough for our code
+ * to work. Auto indentation may be applied.
+ */
+void
+virBufferEscapeSexpr(virBufferPtr buf,
+ const char *format,
+ const char *str)
+{
+ virBufferEscape(buf, '\\', "\\'", format, str);
+}
+
+/* Work around spurious strchr() diagnostics given by -Wlogical-op
+ * for gcc < 4.6. Doing it via a local pragma keeps the damage
+ * smaller than disabling it on the package level. Unfortunately, the
+ * affected GCCs don't allow diagnostic push/pop which would have
+ * further reduced the impact. */
+#if BROKEN_GCC_WLOGICALOP
+# pragma GCC diagnostic ignored "-Wlogical-op"
+#endif
+
+/**
+ * virBufferEscape:
+ * @buf: the buffer to append to
+ * @escape: the escape character to inject
+ * @toescape: NUL-terminated list of characters to escape
+ * @format: a printf like format string but with only one %s parameter
+ * @str: the string argument which needs to be escaped
+ *
+ * Do a formatted print with a single string to a buffer. Any characters
+ * in the provided list are escaped with the given escape. Auto indentation
+ * may be applied.
+ */
+void
+virBufferEscape(virBufferPtr buf, char escape, const char *toescape,
+ const char *format, const char *str)
+{
+ int len;
+ char *escaped, *out;
+ const char *cur;
+
+ if ((format == NULL) || (buf == NULL) || (str == NULL))
+ return;
+
+ if (buf->error)
+ return;
+
+ len = strlen(str);
+ if (strcspn(str, toescape) == len) {
+ virBufferAsprintf(buf, format, str);
+ return;
+ }
+
+ if (xalloc_oversized(2, len) ||
+ VIR_ALLOC_N(escaped, 2 * len + 1) < 0) {
+ virBufferSetError(buf, errno);
+ return;
+ }
+
+ cur = str;
+ out = escaped;
+ while (*cur != 0) {
+ if (strchr(toescape, *cur))
+ *out++ = escape;
+ *out++ = *cur;
+ cur++;
+ }
+ *out = 0;
+
+ virBufferAsprintf(buf, format, escaped);
+ VIR_FREE(escaped);
+}
+
+/**
+ * virBufferURIEncodeString:
+ * @buf: the buffer to append to
+ * @str: the string argument which will be URI-encoded
+ *
+ * Append the string to the buffer. The string will be URI-encoded
+ * during the append (ie any non alpha-numeric characters are replaced
+ * with '%xx' hex sequences). Auto indentation may be applied.
+ */
+void
+virBufferURIEncodeString(virBufferPtr buf, const char *str)
+{
+ int grow_size = 0;
+ const char *p;
+ unsigned char uc;
+ const char *hex = "0123456789abcdef";
+
+ if ((buf == NULL) || (str == NULL))
+ return;
+
+ if (buf->error)
+ return;
+
+ virBufferAddLit(buf, ""); /* auto-indent */
+
+ for (p = str; *p; ++p) {
+ if (c_isalnum(*p))
+ grow_size++;
+ else
+ grow_size += 3; /* %ab */
+ }
+
+ if (virBufferGrow(buf, grow_size) < 0)
+ return;
+
+ for (p = str; *p; ++p) {
+ if (c_isalnum(*p))
+ buf->content[buf->use++] = *p;
+ else {
+ uc = (unsigned char) *p;
+ buf->content[buf->use++] = '%';
+ buf->content[buf->use++] = hex[uc >> 4];
+ buf->content[buf->use++] = hex[uc & 0xf];
+ }
+ }
+
+ buf->content[buf->use] = '\0';
+}
+
+/**
+ * virBufferEscapeShell:
+ * @buf: the buffer to append to
+ * @str: an unquoted string
+ *
+ * Quotes a string so that the shell (/bin/sh) will interpret the
+ * quoted string to mean str. Auto indentation may be applied.
+ */
+void
+virBufferEscapeShell(virBufferPtr buf, const char *str)
+{
+ int len;
+ char *escaped, *out;
+ const char *cur;
+
+ if ((buf == NULL) || (str == NULL))
+ return;
+
+ if (buf->error)
+ return;
+
+ /* Only quote if str includes shell metacharacters. */
+ if (*str && !strpbrk(str, "\r\t\n !\"#$&'()*;<>?[\\]^`{|}~")) {
+ virBufferAdd(buf, str, -1);
+ return;
+ }
+
+ if (*str) {
+ len = strlen(str);
+ if (xalloc_oversized(4, len) ||
+ VIR_ALLOC_N(escaped, 4 * len + 3) < 0) {
+ virBufferSetError(buf, errno);
+ return;
+ }
+ } else {
+ virBufferAddLit(buf, "''");
+ return;
+ }
+
+ cur = str;
+ out = escaped;
+
+ *out++ = '\'';
+ while (*cur != 0) {
+ if (*cur == '\'') {
+ *out++ = '\'';
+ /* Replace literal ' with a close ', a \', and a open ' */
+ *out++ = '\\';
+ *out++ = '\'';
+ }
+ *out++ = *cur++;
+ }
+ *out++ = '\'';
+ *out = 0;
+
+ virBufferAdd(buf, escaped, -1);
+ VIR_FREE(escaped);
+}
+
+/**
+ * virBufferStrcat:
+ * @buf: the buffer to append to
+ * @...: the variable list of strings, the last argument must be NULL
+ *
+ * Concatenate strings to an XML buffer. Auto indentation may be applied
+ * after each string argument.
+ */
+void
+virBufferStrcat(virBufferPtr buf, ...)
+{
+ va_list ap;
+ char *str;
+
+ if (buf->error)
+ return;
+
+ va_start(ap, buf);
+ while ((str = va_arg(ap, char *)) != NULL)
+ virBufferAdd(buf, str, -1);
+ va_end(ap);
+}
+
+/**
+ * virBufferTrim:
+ * @buf: the buffer to trim
+ * @str: the optional string, to force an exact trim
+ * @len: the number of bytes to trim, or -1 to use @str
+ *
+ * Trim the tail of a buffer. If @str is provided, the trim only occurs
+ * if the current tail of the buffer matches @str; a non-negative @len
+ * further limits how much of the tail is trimmed. If @str is NULL, then
+ * @len must be non-negative.
+ *
+ * Returns -1 if @buf has previously encountered an error or if @len is
+ * invalid, 0 if there was nothing to trim (@buf was too short or @str
+ * didn't match), and 1 if the trim was successful.
+ */
+int
+virBufferTrim(virBufferPtr buf, const char *str, int len)
+{
+ size_t len2 = 0;
+
+ if (!buf || buf->error || (!str && len < 0))
+ return -1;
+
+ if (len > 0 && len > buf->use)
+ return 0;
+ if (str) {
+ len2 = strlen(str);
+ if (len2 > buf->use ||
+ memcmp(&buf->content[buf->use - len2], str, len2) != 0)
+ return 0;
+ }
+ buf->use -= len < 0 ? len2 : len;
+ buf->content[buf->use] = '\0';
+ return 1;
+}
--- /dev/null
+/*
+ * virbuffer.h: buffers for libvirt
+ *
+ * Copyright (C) 2005-2008, 2011, 2012 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/>.
+ *
+ * Daniel Veillard <veillard@redhat.com>
+ */
+
+#ifndef __VIR_BUFFER_H__
+# define __VIR_BUFFER_H__
+
+# include "internal.h"
+
+# include <stdarg.h>
+
+/**
+ * virBuffer:
+ *
+ * A buffer structure.
+ */
+typedef struct _virBuffer virBuffer;
+typedef virBuffer *virBufferPtr;
+
+# ifndef __VIR_BUFFER_C__
+# define VIR_BUFFER_INITIALIZER { 0, 0, 0, 0, NULL }
+
+/* This struct must be kept in sync with the real struct
+ in the buf.c impl file */
+struct _virBuffer {
+ unsigned int a;
+ unsigned int b;
+ unsigned int c;
+ int d;
+ char *e;
+};
+# endif
+
+const char *virBufferCurrentContent(virBufferPtr buf);
+char *virBufferContentAndReset(virBufferPtr buf);
+void virBufferFreeAndReset(virBufferPtr buf);
+int virBufferError(const virBufferPtr buf);
+unsigned int virBufferUse(const virBufferPtr buf);
+void virBufferAdd(virBufferPtr buf, const char *str, int len);
+void virBufferAddChar(virBufferPtr buf, char c);
+void virBufferAsprintf(virBufferPtr buf, const char *format, ...)
+ ATTRIBUTE_FMT_PRINTF(2, 3);
+void virBufferVasprintf(virBufferPtr buf, const char *format, va_list ap)
+ ATTRIBUTE_FMT_PRINTF(2, 0);
+void virBufferStrcat(virBufferPtr buf, ...)
+ ATTRIBUTE_SENTINEL;
+void virBufferEscape(virBufferPtr buf, char escape, const char *toescape,
+ const char *format, const char *str);
+void virBufferEscapeString(virBufferPtr buf, const char *format,
+ const char *str);
+void virBufferEscapeSexpr(virBufferPtr buf, const char *format,
+ const char *str);
+void virBufferEscapeShell(virBufferPtr buf, const char *str);
+void virBufferURIEncodeString(virBufferPtr buf, const char *str);
+
+# define virBufferAddLit(buf_, literal_string_) \
+ virBufferAdd(buf_, "" literal_string_ "", sizeof(literal_string_) - 1)
+
+void virBufferAdjustIndent(virBufferPtr buf, int indent);
+int virBufferGetIndent(const virBufferPtr buf, bool dynamic);
+
+int virBufferTrim(virBufferPtr buf, const char *trim, int len);
+
+#endif /* __VIR_BUFFER_H__ */
#include "virstring.h"
#include "memory.h"
-#include "buf.h"
+#include "virbuffer.h"
#include "virterror_internal.h"
#define VIR_FROM_THIS VIR_FROM_NONE
#include "memory.h"
#include "util.h"
#include "virterror_internal.h"
-#include "buf.h"
+#include "virbuffer.h"
#define VIR_FROM_THIS VIR_FROM_URI
#include "virterror_internal.h"
#include "xml.h"
-#include "buf.h"
+#include "virbuffer.h"
#include "util.h"
#include "memory.h"
#include "virfile.h"
#include "stats_linux.h"
#include "block_stats.h"
#include "xend_internal.h"
-#include "buf.h"
+#include "virbuffer.h"
#include "capabilities.h"
#include "memory.h"
#include "threads.h"
#include "util.h"
#include "sexpr.h"
#include "xen_sxpr.h"
-#include "buf.h"
+#include "virbuffer.h"
#include "uuid.h"
#include "xen_driver.h"
#include "xen_hypervisor.h"
# include "capabilities.h"
# include "domain_conf.h"
# include "driver.h"
-# include "buf.h"
+# include "virbuffer.h"
# include "viruri.h"
int
#include "xen_sxpr.h"
#include "xen_xm.h"
#include "virhash.h"
-#include "buf.h"
+#include "virbuffer.h"
#include "uuid.h"
#include "util.h"
#include "memory.h"
#include "util.h"
#include "uuid.h"
#include "memory.h"
-#include "buf.h"
+#include "virbuffer.h"
#include "viruri.h"
#include "xenapi_driver.h"
#include "xenapi_driver_private.h"
#include "util.h"
#include "uuid.h"
#include "memory.h"
-#include "buf.h"
+#include "virbuffer.h"
#include "logging.h"
#include "viruri.h"
#include "xenapi_driver_private.h"
#include "internal.h"
#include "xml.h"
#include "memory.h"
-#include "buf.h"
+#include "virbuffer.h"
#include "testutils.h"
#include "cpu_conf.h"
#include "cpu/cpu.h"
#include "internal.h"
-#include "buf.h"
+#include "virbuffer.h"
#include "sysinfo.h"
#include "testutils.h"
#include "util.h"
#include "util.h"
#include "threads.h"
#include "virterror_internal.h"
-#include "buf.h"
+#include "virbuffer.h"
#include "logging.h"
#include "command.h"
#include "virrandom.h"
#include "internal.h"
#include "util.h"
#include "testutils.h"
-#include "buf.h"
+#include "virbuffer.h"
#include "memory.h"
#define TEST_ERROR(...) \
#include "internal.h"
#include "virbitmap.h"
-#include "buf.h"
+#include "virbuffer.h"
#include "c-ctype.h"
#include "conf/domain_conf.h"
#include "console.h"
#include <libxml/xmlsave.h>
#include "internal.h"
-#include "buf.h"
+#include "virbuffer.h"
#include "memory.h"
#include "util.h"
#include "virsh-domain.h"
#include <libxml/xmlsave.h>
#include "internal.h"
-#include "buf.h"
+#include "virbuffer.h"
#include "memory.h"
#include "util.h"
#include "xml.h"
#include <libxml/xmlsave.h>
#include "internal.h"
-#include "buf.h"
+#include "virbuffer.h"
#include "memory.h"
#include "util.h"
#include "xml.h"
#include <libxml/xmlsave.h>
#include "internal.h"
-#include "buf.h"
+#include "virbuffer.h"
#include "memory.h"
#include "util.h"
#include "xml.h"
#include <libxml/xmlsave.h>
#include "internal.h"
-#include "buf.h"
+#include "virbuffer.h"
#include "memory.h"
#include "util.h"
#include "xml.h"
#include <libxml/xmlsave.h>
#include "internal.h"
-#include "buf.h"
+#include "virbuffer.h"
#include "memory.h"
#include "util.h"
#include "xml.h"
#include "internal.h"
#include "base64.h"
-#include "buf.h"
+#include "virbuffer.h"
#include "memory.h"
#include "util.h"
#include "xml.h"
#include <libxml/xmlsave.h>
#include "internal.h"
-#include "buf.h"
+#include "virbuffer.h"
#include "memory.h"
#include "util.h"
#include "virsh-domain.h"
#include <libxml/xmlsave.h>
#include "internal.h"
-#include "buf.h"
+#include "virbuffer.h"
#include "memory.h"
#include "util.h"
#include "virfile.h"
#include "internal.h"
#include "virterror_internal.h"
#include "base64.h"
-#include "buf.h"
+#include "virbuffer.h"
#include "console.h"
#include "util.h"
#include "memory.h"
projects / libvirt.git / commitdiff