[libvirt] [PATCH 3/5] util: virbuffer: introduce virBufferEscapeN
Pavel Hrdina
phrdina at redhat.com
Thu Feb 23 16:51:21 UTC 2017
On Thu, Feb 23, 2017 at 04:32:32PM +0000, Daniel P. Berrange wrote:
> On Thu, Feb 23, 2017 at 04:26:58PM +0100, Pavel Hrdina wrote:
> > Signed-off-by: Pavel Hrdina <phrdina at redhat.com>
> > ---
> > src/libvirt_private.syms | 1 +
> > src/util/virbuffer.c | 104 +++++++++++++++++++++++++++++++++++++++++++++++
> > src/util/virbuffer.h | 2 +
> > tests/virbuftest.c | 41 +++++++++++++++++++
> > 4 files changed, 148 insertions(+)
> >
> > diff --git a/src/libvirt_private.syms b/src/libvirt_private.syms
> > index e9c4d73779..6ce32f1101 100644
> > --- a/src/libvirt_private.syms
> > +++ b/src/libvirt_private.syms
> > @@ -1286,6 +1286,7 @@ virBufferContentAndReset;
> > virBufferCurrentContent;
> > virBufferError;
> > virBufferEscape;
> > +virBufferEscapeN;
> > virBufferEscapeSexpr;
> > virBufferEscapeShell;
> > virBufferEscapeString;
> > diff --git a/src/util/virbuffer.c b/src/util/virbuffer.c
> > index d582e7dbec..ad6b29951e 100644
> > --- a/src/util/virbuffer.c
> > +++ b/src/util/virbuffer.c
> > @@ -33,6 +33,7 @@
> > #include "virbuffer.h"
> > #include "viralloc.h"
> > #include "virerror.h"
> > +#include "virstring.h"
> >
> >
> > /* If adding more fields, ensure to edit buf.h to match
> > @@ -588,6 +589,109 @@ virBufferEscape(virBufferPtr buf, char escape, const char *toescape,
> > VIR_FREE(escaped);
> > }
> >
> > +
> > +struct _virBufferEscapePair {
> > + char escape;
> > + char *toescape;
> > +};
> > +
> > +
> > +/**
> > + * virBufferEscapeN:
> > + * @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
> > + * @...: the variable list of arguments composed
> > + *
> > + * The variable list of arguments @... must be composed of
> > + * 'char escape, char *toescape' pairs followed by NULL.
>
> So most of the complexity you have here is to deal with the ability
> to turn a single character into a string of escaped characters. Unless
> I'm missing something, you don't actually use that ability in practice.
> If we make it more restrictive so you just have a 1-1 mapping we can
> simplify the API & implementation. eg
>
> virBufferEscapeN(virBufferPtr buf,
> const char *format,
> const char *str,
> const char *forbidden,
> const char *replacements)
>
> with strlen(forbidden) == strlen(replacements);
The idea was that a group of characters can be escaped with one character,
so far the usage seems to be really simple. Currently this would work and
it would be really simple:
virBufferEscapeN(buf, "%s", str, ",=", ",\\");
but imagine this scenario:
virBufferEscapeN(buf, "%s", str, ",=%&*()", ",\\\\\\\\\\\\");
virBufferEscapeN(buf, "%s", str, ',', ",", '\\', "=%&*()", NULL);
I think that the second approach is better and easier for user of
virBufferEscapeN.
> > + *
> > + * This has the same functionality as virBufferEscape with the extension
> > + * that allows to specify multiple pairs of chars that needs to be escaped.
> > + */
> > +void
> > +virBufferEscapeN(virBufferPtr buf,
> > + const char *format,
> > + const char *str,
> > + ...)
> > +{
> > + int len;
> > + size_t i;
> > + char escape;
> > + char *toescape;
> > + char *toescapeall = NULL;
> > + char *escaped = NULL;
> > + char *out;
> > + const char *cur;
> > + struct _virBufferEscapePair escapeItem;
> > + struct _virBufferEscapePair *escapeList = NULL;
> > + size_t nescapeList = 0;
> > + va_list ap;
> > +
> > + if ((format == NULL) || (buf == NULL) || (str == NULL))
> > + return;
> > +
> > + if (buf->error)
> > + return;
> > +
> > + va_start(ap, str);
> > +
> > + while ((escape = va_arg(ap, int))) {
> > + if (!(toescape = va_arg(ap, char *))) {
> > + virBufferSetError(buf, errno);
> > + goto cleanup;
> > + }
> > +
> > + escapeItem.escape = escape;
> > + escapeItem.toescape = toescape;
> > +
> > + if (VIR_STRCAT_QUIET(toescapeall, toescape) < 0) {
> > + virBufferSetError(buf, errno);
> > + goto cleanup;
> > + }
> > +
> > + if (VIR_APPEND_ELEMENT_QUIET(escapeList, nescapeList, escapeItem) < 0) {
> > + virBufferSetError(buf, errno);
> > + goto cleanup;
> > + }
> > + }
>
> This whole loop would go away with the simpler API contract, which
> nicely avoids doing allocations in the loop body.
>
>
> > + len = strlen(str);
> > + if (strcspn(str, toescapeall) == len) {
> > + virBufferAsprintf(buf, format, str);
> > + goto cleanup;
> > + }
> > +
> > + if (xalloc_oversized(2, len) ||
> > + VIR_ALLOC_N_QUIET(escaped, 2 * len + 1) < 0) {
> > + virBufferSetError(buf, errno);
> > + goto cleanup;
> > + }
> > +
> > + cur = str;
> > + out = escaped;
> > + while (*cur != 0) {
> > + for (i = 0; i < nescapeList; i++) {
> > + if (strchr(escapeList[i].toescape, *cur)) {
> > + *out++ = escapeList[i].escape;
> > + break;
> > + }
> > + }
> > + *out++ = *cur;
> > + cur++;
> > + }
> > + *out = 0;
> > +
> > + virBufferAsprintf(buf, format, escaped);
> > +
> > + cleanup:
> > + va_end(ap);
> > + VIR_FREE(toescapeall);
> > + VIR_FREE(escapeList);
> > + VIR_FREE(escaped);
> > +}
>
> Regards,
> Daniel
> --
> |: http://berrange.com -o- http://www.flickr.com/photos/dberrange/ :|
> |: http://libvirt.org -o- http://virt-manager.org :|
> |: http://entangle-photo.org -o- http://search.cpan.org/~danberr/ :|
>
> --
> libvir-list mailing list
> libvir-list at redhat.com
> https://www.redhat.com/mailman/listinfo/libvir-list
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 833 bytes
Desc: Digital signature
URL: <http://listman.redhat.com/archives/libvir-list/attachments/20170223/a602c06f/attachment-0001.sig>
More information about the libvir-list
mailing list