xref: /dpdk/lib/cmdline/cmdline_parse_string.h (revision d5d13ef979c83d33518c70727b5a4ef091bd8134)
1 /* SPDX-License-Identifier: BSD-3-Clause
2  * Copyright(c) 2010-2014 Intel Corporation.
3  * Copyright (c) 2009, Olivier MATZ <zer0@droids-corp.org>
4  * All rights reserved.
5  */
6 
7 #ifndef _PARSE_STRING_H_
8 #define _PARSE_STRING_H_
9 
10 #include <cmdline_parse.h>
11 
12 #ifdef __cplusplus
13 extern "C" {
14 #endif
15 
16 /* size of a parsed string */
17 #define STR_TOKEN_SIZE 128
18 
19 /* size of a parsed multi string */
20 #define STR_MULTI_TOKEN_SIZE 4096
21 
22 typedef char cmdline_fixed_string_t[STR_TOKEN_SIZE];
23 
24 typedef char cmdline_multi_string_t[STR_MULTI_TOKEN_SIZE];
25 
26 struct cmdline_token_string_data {
27 	const char *str;
28 };
29 
30 struct cmdline_token_string {
31 	struct cmdline_token_hdr hdr;
32 	struct cmdline_token_string_data string_data;
33 };
34 typedef struct cmdline_token_string cmdline_parse_token_string_t;
35 
36 extern struct cmdline_token_ops cmdline_token_string_ops;
37 
38 int cmdline_parse_string(cmdline_parse_token_hdr_t *tk, const char *srcbuf,
39 	void *res, unsigned ressize);
40 int cmdline_complete_get_nb_string(cmdline_parse_token_hdr_t *tk);
41 int cmdline_complete_get_elt_string(cmdline_parse_token_hdr_t *tk, int idx,
42 				    char *dstbuf, unsigned int size);
43 int cmdline_get_help_string(cmdline_parse_token_hdr_t *tk, char *dstbuf,
44 			    unsigned int size);
45 
46 /**
47  * Token marked as TOKEN_STRING_MULTI takes entire parsing string
48  * until “#” sign appear. Everything after “#” sign is treated as a comment.
49  *
50  * Note:
51  * In this case second parameter of TOKEN_STRING_INITIALIZER
52  * must be a type of cmdline_multi_string_t.
53  */
54 #define TOKEN_STRING_MULTI ""
55 
56 #define TOKEN_STRING_INITIALIZER(structure, field, string)  \
57 {                                                           \
58 	/* hdr */                                               \
59 	{                                                       \
60 		&cmdline_token_string_ops,      /* ops */           \
61 		offsetof(structure, field),     /* offset */        \
62 	},                                                      \
63 	/* string_data */                                       \
64 	{                                                       \
65 		string,                         /* str */           \
66 	},                                                      \
67 }
68 
69 #ifdef __cplusplus
70 }
71 #endif
72 
73 #endif /* _PARSE_STRING_H_ */
74