[mirror_frr.git] / lib / printfrr.h

// SPDX-License-Identifier: ISC
/*
 * Copyright (c) 2019  David Lamparter, for NetDEF, Inc.
 */

#ifndef _FRR_PRINTFRR_H
#define _FRR_PRINTFRR_H

#include <stddef.h>
#include <stdarg.h>
#include <stdint.h>

#include "compiler.h"
#include "memory.h"

#ifdef __cplusplus
extern "C" {
#endif

struct fmt_outpos {
	unsigned int off_start, off_end;
};

struct fbuf {
	char *buf;
	char *pos;
	size_t len;

	struct fmt_outpos *outpos;
	size_t outpos_n, outpos_i;
};

#define at(a, b) PRINTFRR(a, b)
#define atn(a, b) \
	at(a, b) __attribute__((nonnull(1) _RET_NONNULL))
#define atm(a, b) \
	atn(a, b) __attribute__((malloc))

/* return value is length needed for the full string (excluding \0) in all
 * cases.  The functions write as much as they can, but continue regardless,
 * so the return value is independent of buffer length.  Both bprintfrr and
 * snprintf also accept NULL as output buffer.
 */

/* bprintfrr does NOT null terminate! use sparingly (only provided since it's
 * the most direct interface) - useful for incrementally building long text
 * (call bprintfrr repeatedly with the same buffer)
 */
ssize_t vbprintfrr(struct fbuf *out, const char *fmt, va_list) at(2, 0);
ssize_t  bprintfrr(struct fbuf *out, const char *fmt, ...)     at(2, 3);

/* these do null terminate like their snprintf cousins */
ssize_t vsnprintfrr(char *out, size_t sz, const char *fmt, va_list) at(3, 0);
ssize_t  snprintfrr(char *out, size_t sz, const char *fmt, ...)     at(3, 4);

/* c = continue / concatenate (append at the end of the string)
 * return value is would-be string length (regardless of buffer length),
 * i.e. includes already written chars */
ssize_t vcsnprintfrr(char *out, size_t sz, const char *fmt, va_list) at(3, 0);
ssize_t  csnprintfrr(char *out, size_t sz, const char *fmt, ...)     at(3, 4);

/* memory allocations don't fail in FRR, so you always get something here.
 * (in case of error, returns a strdup of the format string) */
char *vasprintfrr(struct memtype *mt, const char *fmt, va_list) atm(2, 0);
char  *asprintfrr(struct memtype *mt, const char *fmt, ...)     atm(2, 3);

/* try to use provided buffer (presumably from stack), allocate if it's too
 * short.  Must call XFREE(mt, return value) if return value != out.
 */
char *vasnprintfrr(struct memtype *mt, char *out, size_t sz,
		   const char *fmt, va_list) atn(4, 0);
char  *asnprintfrr(struct memtype *mt, char *out, size_t sz,
		   const char *fmt, ...)     atn(4, 5);

#define printfrr(fmt, ...)                                                     \
	do {                                                                   \
		char buf[256], *out;                                           \
		out = asnprintfrr(MTYPE_TMP, buf, sizeof(buf), fmt,            \
				  ##__VA_ARGS__);                              \
		fputs(out, stdout);                                            \
		if (out != buf)                                                \
			XFREE(MTYPE_TMP, out);                                 \
	} while (0)

#undef at
#undef atm
#undef atn

/* extension specs must start with a capital letter (this is a restriction
 * for both performance's and human understanding's sake.)
 *
 * Note that the entire thing mostly works because a letter directly following
 * a %p print specifier is extremely unlikely to occur (why would you want to
 * print "0x12345678HELLO"?)  Normally, you'd expect spacing or punctuation
 * after a placeholder.  That also means that neither of those works well for
 * extension purposes, e.g. "%p{foo}" is reasonable to see actually used.
 *
 * TODO: would be nice to support a "%pF%dF" specifier that consumes 2
 * arguments, e.g. to pass an integer + a list of known values...  can be
 * done, but a bit tricky.
 */
#define printfrr_ext_char(ch) ((ch) >= 'A' && (ch) <= 'Z')

struct printfrr_eargs;

struct printfrr_ext {
	/* embedded string to minimize cache line pollution */
	char match[8];

	/* both can be given, if not the code continues searching
	 * (you can do %pX and %dX in 2 different entries)
	 *
	 * return value: number of bytes that would be printed if the buffer
	 * was large enough.  be careful about not under-reporting this;
	 * otherwise asnprintf() & co. will get broken.  Returning -1 means
	 * something went wrong & default %p/%d handling should be executed.
	 *
	 * to consume extra input flags after %pXY, increment *fmt.  It points
	 * at the first character after %pXY at entry.  Convention is to make
	 * those flags lowercase letters or numbers.
	 */
	ssize_t (*print_ptr)(struct fbuf *buf, struct printfrr_eargs *info,
			     const void *);
	ssize_t (*print_int)(struct fbuf *buf, struct printfrr_eargs *info,
			     uintmax_t);
};

/* additional information passed to extended formatters */

struct printfrr_eargs {
	/* position in the format string.  Points to directly after the
	 * extension specifier.  Increment when consuming extra "flag
	 * characters".
	 */
	const char *fmt;

	/* %.1234x / %.*x
	 * not POSIX compatible when used with %p, will cause warnings from
	 * GCC & clang.  Usable with %d.  Not used by the printfrr() itself
	 * for extension specifiers, so essentially available as a "free"
	 * parameter.  -1 if not specified.  Value in the format string
	 * cannot be negative, but negative values can be passed with %.*x
	 */
	int precision;

	/* %1234x / %*x
	 * regular width specification.  Internally handled by printfrr(), set
	 * to 0 if consumed by the extension in order to suppress standard
	 * width/padding behavior.  0 if not specified.
	 *
	 * NB: always positive, even if a negative value is passed in with
	 * %*x.  (The sign is used for the - flag.)
	 */
	int width;

	/* %#x
	 * "alternate representation" flag, not POSIX compatible when used
	 * with %p or %d, will cause warnings from GCC & clang.  Not used by
	 * printfrr() itself for extension specifiers.
	 */
	bool alt_repr;

	/* %-x
	 * left-pad flag.  Internally handled by printfrr() if width is
	 * nonzero.  Only use if the extension sets width to 0.
	 */
	bool leftadj;
};

/* for any extension that needs a buffer length */

static inline ssize_t printfrr_ext_len(struct printfrr_eargs *ea)
{
	ssize_t rv;

	if (ea->precision >= 0)
		rv = ea->precision;
	else if (ea->width >= 0) {
		rv = ea->width;
		ea->width = -1;
	} else
		rv = -1;

	return rv;
}

/* no locking - must be called when single threaded (e.g. at startup.)
 * this restriction hopefully won't be a huge bother considering normal usage
 * scenarios...
 */
void printfrr_ext_reg(const struct printfrr_ext *);

#define printfrr_ext_autoreg_p(matchs, print_fn)                               \
	static ssize_t print_fn(struct fbuf *, struct printfrr_eargs *,        \
				const void *);                                 \
	static const struct printfrr_ext _printext_##print_fn = {              \
		.match = matchs,                                               \
		.print_ptr = print_fn,                                         \
	};                                                                     \
	static void _printreg_##print_fn(void) __attribute__((constructor));   \
	static void _printreg_##print_fn(void)                                 \
	{                                                                      \
		printfrr_ext_reg(&_printext_##print_fn);                       \
	}                                                                      \
	MACRO_REQUIRE_SEMICOLON()

#define printfrr_ext_autoreg_i(matchs, print_fn)                               \
	static ssize_t print_fn(struct fbuf *, struct printfrr_eargs *,        \
				uintmax_t);                                    \
	static const struct printfrr_ext _printext_##print_fn = {              \
		.match = matchs,                                               \
		.print_int = print_fn,                                         \
	};                                                                     \
	static void _printreg_##print_fn(void) __attribute__((constructor));   \
	static void _printreg_##print_fn(void)                                 \
	{                                                                      \
		printfrr_ext_reg(&_printext_##print_fn);                       \
	}                                                                      \
	MACRO_REQUIRE_SEMICOLON()

/* fbuf helper functions - note all 3 of these return the length that would
 * be written regardless of how much space was available in the buffer, as
 * needed for implementing printfrr extensions.  (They also accept NULL buf
 * for that.)
 */

static inline ssize_t bputs(struct fbuf *buf, const char *str)
{
	size_t len = strlen(str);
	size_t ncopy;

	if (!buf)
		return len;

	ncopy = MIN(len, (size_t)(buf->buf + buf->len - buf->pos));
	memcpy(buf->pos, str, ncopy);
	buf->pos += ncopy;

	return len;
}

static inline ssize_t bputch(struct fbuf *buf, char ch)
{
	if (buf && buf->pos < buf->buf + buf->len)
		*buf->pos++ = ch;
	return 1;
}

static inline ssize_t bputhex(struct fbuf *buf, uint8_t val)
{
	static const char hexch[] = "0123456789abcdef";

	if (buf && buf->pos < buf->buf + buf->len)
		*buf->pos++ = hexch[(val >> 4) & 0xf];
	if (buf && buf->pos < buf->buf + buf->len)
		*buf->pos++ = hexch[val & 0xf];
	return 2;
}

/* %pVA extension, equivalent to Linux kernel %pV */

struct va_format {
	const char *fmt;
	va_list *va;
};

#ifdef _FRR_ATTRIBUTE_PRINTFRR
#pragma FRR printfrr_ext "%pFB" (struct fbuf *)
#pragma FRR printfrr_ext "%pVA" (struct va_format *)

#pragma FRR printfrr_ext "%pHX" (signed char *)
#pragma FRR printfrr_ext "%pHX" (unsigned char *)
#pragma FRR printfrr_ext "%pHX" (void *)
#pragma FRR printfrr_ext "%pHS" (signed char *)
#pragma FRR printfrr_ext "%pHS" (unsigned char *)
#pragma FRR printfrr_ext "%pHS" (void *)

#pragma FRR printfrr_ext "%pSE" (char *)
#pragma FRR printfrr_ext "%pSQ" (char *)

#pragma FRR printfrr_ext "%pTS" (struct timespec *)
#pragma FRR printfrr_ext "%pTV" (struct timeval *)
#pragma FRR printfrr_ext "%pTT" (time_t *)
#endif

/* when using non-ISO-C compatible extension specifiers... */

#ifdef _FRR_ATTRIBUTE_PRINTFRR
#define FMT_NSTD_BEGIN
#define FMT_NSTD_END
#else /* !_FRR_ATTRIBUTE_PRINTFRR */
#define FMT_NSTD_BEGIN \
	_Pragma("GCC diagnostic push")                                         \
	_Pragma("GCC diagnostic ignored \"-Wformat\"")                         \
	/* end */
#define FMT_NSTD_END \
	_Pragma("GCC diagnostic pop")                                          \
	/* end */
#endif

#define FMT_NSTD(expr)                                                         \
	({                                                                     \
		FMT_NSTD_BEGIN                                                 \
		typeof(expr) _v;                                               \
		_v = expr;                                                     \
		FMT_NSTD_END                                                   \
		_v;                                                            \
	})                                                                     \
	/* end */

#ifdef __cplusplus
}
#endif

#endif
Commit	Line	Data
acddc0ed	1	// SPDX-License-Identifier: ISC
5c25bd87 DL	2	/*
5c25bd87 DL	3	* Copyright (c) 2019 David Lamparter, for NetDEF, Inc.
5c25bd87 DL	4	*/
	5
	6	#ifndef _FRR_PRINTFRR_H
	7	#define _FRR_PRINTFRR_H
	8
	9	#include <stddef.h>
	10	#include <stdarg.h>
bf4d3d80	11	#include <stdint.h>
5c25bd87 DL	12
	13	#include "compiler.h"
	14	#include "memory.h"
	15
17e38209 RW	16	#ifdef __cplusplus
	17	extern "C" {
	18	#endif
	19
487eefcf DL	20	struct fmt_outpos {
	21	unsigned int off_start, off_end;
	22	};
	23
5c25bd87 DL	24	struct fbuf {
	25	char *buf;
	26	char *pos;
	27	size_t len;
487eefcf DL	28
	29	struct fmt_outpos *outpos;
	30	size_t outpos_n, outpos_i;
5c25bd87 DL	31	};
5c25bd87 DL	32
fb84c629	33	#define at(a, b) PRINTFRR(a, b)
5c25bd87 DL	34	#define atn(a, b) \
	35	at(a, b) __attribute__((nonnull(1) _RET_NONNULL))
	36	#define atm(a, b) \
	37	atn(a, b) __attribute__((malloc))
	38
	39	/* return value is length needed for the full string (excluding \0) in all
	40	* cases. The functions write as much as they can, but continue regardless,
	41	* so the return value is independent of buffer length. Both bprintfrr and
	42	* snprintf also accept NULL as output buffer.
	43	*/
	44
	45	/* bprintfrr does NOT null terminate! use sparingly (only provided since it's
	46	* the most direct interface) - useful for incrementally building long text
	47	* (call bprintfrr repeatedly with the same buffer)
	48	*/
	49	ssize_t vbprintfrr(struct fbuf out, const char fmt, va_list) at(2, 0);
	50	ssize_t bprintfrr(struct fbuf out, const char fmt, ...) at(2, 3);
	51
	52	/* these do null terminate like their snprintf cousins */
	53	ssize_t vsnprintfrr(char out, size_t sz, const char fmt, va_list) at(3, 0);
	54	ssize_t snprintfrr(char out, size_t sz, const char fmt, ...) at(3, 4);
	55
	56	/* c = continue / concatenate (append at the end of the string)
	57	* return value is would-be string length (regardless of buffer length),
	58	* i.e. includes already written chars */
	59	ssize_t vcsnprintfrr(char out, size_t sz, const char fmt, va_list) at(3, 0);
	60	ssize_t csnprintfrr(char out, size_t sz, const char fmt, ...) at(3, 4);
	61
	62	/* memory allocations don't fail in FRR, so you always get something here.
	63	* (in case of error, returns a strdup of the format string) */
	64	char vasprintfrr(struct memtype mt, const char *fmt, va_list) atm(2, 0);
	65	char asprintfrr(struct memtype mt, const char *fmt, ...) atm(2, 3);
	66
	67	/* try to use provided buffer (presumably from stack), allocate if it's too
	68	* short. Must call XFREE(mt, return value) if return value != out.
	69	*/
	70	char vasnprintfrr(struct memtype mt, char *out, size_t sz,
	71	const char *fmt, va_list) atn(4, 0);
	72	char asnprintfrr(struct memtype mt, char *out, size_t sz,
	73	const char *fmt, ...) atn(4, 5);
	74
fb84c629 DL	75	#define printfrr(fmt, ...) \
	76	do { \
	77	char buf[256], *out; \
	78	out = asnprintfrr(MTYPE_TMP, buf, sizeof(buf), fmt, \
	79	##__VA_ARGS__); \
	80	fputs(out, stdout); \
	81	if (out != buf) \
	82	XFREE(MTYPE_TMP, out); \
	83	} while (0)
	84
5c25bd87 DL	85	#undef at
5c25bd87 DL	86	#undef atm
07ef3e34	87	#undef atn
5c25bd87	88
bf4d3d80 DL	89	/* extension specs must start with a capital letter (this is a restriction
	90	* for both performance's and human understanding's sake.)
	91	*
	92	* Note that the entire thing mostly works because a letter directly following
	93	* a %p print specifier is extremely unlikely to occur (why would you want to
	94	* print "0x12345678HELLO"?) Normally, you'd expect spacing or punctuation
	95	* after a placeholder. That also means that neither of those works well for
	96	* extension purposes, e.g. "%p{foo}" is reasonable to see actually used.
	97	*
	98	* TODO: would be nice to support a "%pF%dF" specifier that consumes 2
	99	* arguments, e.g. to pass an integer + a list of known values... can be
	100	* done, but a bit tricky.
	101	*/
	102	#define printfrr_ext_char(ch) ((ch) >= 'A' && (ch) <= 'Z')
5c25bd87	103
3ea79430 DL	104	struct printfrr_eargs;
3ea79430 DL	105
bf4d3d80 DL	106	struct printfrr_ext {
	107	/* embedded string to minimize cache line pollution */
	108	char match[8];
	109
	110	/* both can be given, if not the code continues searching
	111	* (you can do %pX and %dX in 2 different entries)
	112	*
212e04e5 DL	113	* return value: number of bytes that would be printed if the buffer
	114	* was large enough. be careful about not under-reporting this;
	115	* otherwise asnprintf() & co. will get broken. Returning -1 means
	116	* something went wrong & default %p/%d handling should be executed.
bf4d3d80	117	*
212e04e5 DL	118	* to consume extra input flags after %pXY, increment *fmt. It points
	119	* at the first character after %pXY at entry. Convention is to make
	120	* those flags lowercase letters or numbers.
3ea79430 DL	121	*/
	122	ssize_t (print_ptr)(struct fbuf buf, struct printfrr_eargs *info,
	123	const void *);
	124	ssize_t (print_int)(struct fbuf buf, struct printfrr_eargs *info,
	125	uintmax_t);
	126	};
	127
	128	/* additional information passed to extended formatters */
	129
	130	struct printfrr_eargs {
	131	/* position in the format string. Points to directly after the
	132	* extension specifier. Increment when consuming extra "flag
	133	* characters".
	134	*/
	135	const char *fmt;
	136
	137	/* %.1234x / %.*x
	138	* not POSIX compatible when used with %p, will cause warnings from
	139	* GCC & clang. Usable with %d. Not used by the printfrr() itself
	140	* for extension specifiers, so essentially available as a "free"
	141	* parameter. -1 if not specified. Value in the format string
	142	* cannot be negative, but negative values can be passed with %.*x
	143	*/
	144	int precision;
	145
	146	/* %1234x / %*x
	147	* regular width specification. Internally handled by printfrr(), set
	148	* to 0 if consumed by the extension in order to suppress standard
	149	* width/padding behavior. 0 if not specified.
bf4d3d80	150	*
3ea79430 DL	151	* NB: always positive, even if a negative value is passed in with
	152	* %*x. (The sign is used for the - flag.)
	153	*/
	154	int width;
	155
	156	/* %#x
	157	* "alternate representation" flag, not POSIX compatible when used
	158	* with %p or %d, will cause warnings from GCC & clang. Not used by
	159	* printfrr() itself for extension specifiers.
	160	*/
	161	bool alt_repr;
	162
	163	/* %-x
	164	* left-pad flag. Internally handled by printfrr() if width is
	165	* nonzero. Only use if the extension sets width to 0.
bf4d3d80	166	*/
3ea79430	167	bool leftadj;
5c25bd87 DL	168	};
5c25bd87 DL	169
2d9a4e29 DL	170	/* for any extension that needs a buffer length */
	171
	172	static inline ssize_t printfrr_ext_len(struct printfrr_eargs *ea)
	173	{
	174	ssize_t rv;
	175
	176	if (ea->precision >= 0)
	177	rv = ea->precision;
	178	else if (ea->width >= 0) {
	179	rv = ea->width;
	180	ea->width = -1;
	181	} else
	182	rv = -1;
	183
	184	return rv;
	185	}
	186
bf4d3d80 DL	187	/* no locking - must be called when single threaded (e.g. at startup.)
	188	* this restriction hopefully won't be a huge bother considering normal usage
	189	* scenarios...
	190	*/
5c25bd87	191	void printfrr_ext_reg(const struct printfrr_ext *);
bf4d3d80 DL	192
bf4d3d80 DL	193	#define printfrr_ext_autoreg_p(matchs, print_fn) \
3ea79430	194	static ssize_t print_fn(struct fbuf , struct printfrr_eargs , \
bf4d3d80	195	const void *); \
2b64873d	196	static const struct printfrr_ext _printext_##print_fn = { \
bf4d3d80 DL	197	.match = matchs, \
	198	.print_ptr = print_fn, \
	199	}; \
	200	static void _printreg_##print_fn(void) __attribute__((constructor)); \
54929fd3 DL	201	static void _printreg_##print_fn(void) \
54929fd3 DL	202	{ \
bf4d3d80 DL	203	printfrr_ext_reg(&_printext_##print_fn); \
bf4d3d80 DL	204	} \
54929fd3	205	MACRO_REQUIRE_SEMICOLON()
bf4d3d80 DL	206
bf4d3d80 DL	207	#define printfrr_ext_autoreg_i(matchs, print_fn) \
3ea79430 DL	208	static ssize_t print_fn(struct fbuf , struct printfrr_eargs , \
3ea79430 DL	209	uintmax_t); \
2b64873d	210	static const struct printfrr_ext _printext_##print_fn = { \
bf4d3d80 DL	211	.match = matchs, \
	212	.print_int = print_fn, \
	213	}; \
	214	static void _printreg_##print_fn(void) __attribute__((constructor)); \
54929fd3 DL	215	static void _printreg_##print_fn(void) \
54929fd3 DL	216	{ \
bf4d3d80 DL	217	printfrr_ext_reg(&_printext_##print_fn); \
bf4d3d80 DL	218	} \
54929fd3	219	MACRO_REQUIRE_SEMICOLON()
5c25bd87	220
a4cb97a6 DL	221	/* fbuf helper functions - note all 3 of these return the length that would
	222	* be written regardless of how much space was available in the buffer, as
	223	* needed for implementing printfrr extensions. (They also accept NULL buf
	224	* for that.)
	225	*/
e6b3732e DL	226
	227	static inline ssize_t bputs(struct fbuf buf, const char str)
	228	{
	229	size_t len = strlen(str);
	230	size_t ncopy;
	231
	232	if (!buf)
	233	return len;
	234
	235	ncopy = MIN(len, (size_t)(buf->buf + buf->len - buf->pos));
	236	memcpy(buf->pos, str, ncopy);
	237	buf->pos += ncopy;
	238
	239	return len;
	240	}
	241
	242	static inline ssize_t bputch(struct fbuf *buf, char ch)
	243	{
	244	if (buf && buf->pos < buf->buf + buf->len)
	245	*buf->pos++ = ch;
	246	return 1;
	247	}
	248
a4cb97a6 DL	249	static inline ssize_t bputhex(struct fbuf *buf, uint8_t val)
	250	{
	251	static const char hexch[] = "0123456789abcdef";
	252
	253	if (buf && buf->pos < buf->buf + buf->len)
	254	*buf->pos++ = hexch[(val >> 4) & 0xf];
	255	if (buf && buf->pos < buf->buf + buf->len)
	256	*buf->pos++ = hexch[val & 0xf];
	257	return 2;
	258	}
	259
9c4380da DL	260	/* %pVA extension, equivalent to Linux kernel %pV */
	261
	262	struct va_format {
	263	const char *fmt;
	264	va_list *va;
	265	};
	266
	267	#ifdef _FRR_ATTRIBUTE_PRINTFRR
bb12115e	268	#pragma FRR printfrr_ext "%pFB" (struct fbuf *)
9c4380da	269	#pragma FRR printfrr_ext "%pVA" (struct va_format *)
a4cb97a6 DL	270
	271	#pragma FRR printfrr_ext "%pHX" (signed char *)
	272	#pragma FRR printfrr_ext "%pHX" (unsigned char *)
	273	#pragma FRR printfrr_ext "%pHX" (void *)
	274	#pragma FRR printfrr_ext "%pHS" (signed char *)
	275	#pragma FRR printfrr_ext "%pHS" (unsigned char *)
	276	#pragma FRR printfrr_ext "%pHS" (void *)
7798203f DL	277
	278	#pragma FRR printfrr_ext "%pSE" (char *)
	279	#pragma FRR printfrr_ext "%pSQ" (char *)
2c76ba43 DL	280
	281	#pragma FRR printfrr_ext "%pTS" (struct timespec *)
	282	#pragma FRR printfrr_ext "%pTV" (struct timeval *)
	283	#pragma FRR printfrr_ext "%pTT" (time_t *)
9c4380da DL	284	#endif
9c4380da DL	285
cb4928ce DL	286	/* when using non-ISO-C compatible extension specifiers... */
	287
	288	#ifdef _FRR_ATTRIBUTE_PRINTFRR
	289	#define FMT_NSTD_BEGIN
	290	#define FMT_NSTD_END
	291	#else /* !_FRR_ATTRIBUTE_PRINTFRR */
	292	#define FMT_NSTD_BEGIN \
	293	_Pragma("GCC diagnostic push") \
	294	_Pragma("GCC diagnostic ignored \"-Wformat\"") \
	295	/* end */
	296	#define FMT_NSTD_END \
	297	_Pragma("GCC diagnostic pop") \
	298	/* end */
	299	#endif
	300
	301	#define FMT_NSTD(expr) \
	302	({ \
cb4928ce	303	FMT_NSTD_BEGIN \
faaa9431	304	typeof(expr) _v; \
cb4928ce DL	305	_v = expr; \
	306	FMT_NSTD_END \
	307	_v; \
	308	}) \
	309	/* end */
	310
17e38209 RW	311	#ifdef __cplusplus
	312	}
	313	#endif
	314
5c25bd87	315	#endif