qstring.c File Reference

Implement QuotedString parsing. More...

#include "orconfig.h"
#include "lib/encoding/qstring.h"
#include "lib/malloc/malloc.h"
#include "lib/log/util_bug.h"

Go to the source code of this file.


static int get_qstring_length (const char *start, size_t in_len_max, int *chars_out)
const char * decode_qstring (const char *start, size_t in_len_max, char **out, size_t *out_len)

Detailed Description

Implement QuotedString parsing.

Note that this is only used for controller authentication; do not create new users for this. Instead, prefer the cstring.c functions.

Definition in file qstring.c.

Function Documentation

◆ decode_qstring()

const char * decode_qstring ( const char *  start,
size_t  in_len_max,
char **  out,
size_t *  out_len 

Given a pointer to a string starting at start containing in_len_max characters, decode a string beginning with one double quote, containing any number of non-quote characters or characters escaped with a backslash, and ending with a final double quote. Place the resulting string (unquoted, unescaped) into a newly allocated string in *out; store its length in out_len. On success, return a pointer to the character immediately following the escaped string. On failure, return NULL.

Definition at line 64 of file qstring.c.

◆ get_qstring_length()

static int get_qstring_length ( const char *  start,
size_t  in_len_max,
int *  chars_out 

If the first in_len_max characters in start contain a QuotedString, return the length of that string (as encoded, including quotes). Otherwise return -1.

Definition at line 22 of file qstring.c.

Referenced by decode_qstring().