1 // SPDX-License-Identifier: GPL-2.0
2 /*
3 * C++ stream style string builder used in KUnit for building messages.
4 *
5 * Copyright (C) 2019, Google LLC.
6 * Author: Brendan Higgins <brendanhiggins@google.com>
7 */
8
9 #include <kunit/test.h>
10 #include <linux/list.h>
11 #include <linux/slab.h>
12
13 #include "string-stream.h"
14
15 struct string_stream_fragment_alloc_context {
16 struct kunit *test;
17 int len;
18 gfp_t gfp;
19 };
20
string_stream_fragment_init(struct kunit_resource * res,void * context)21 static int string_stream_fragment_init(struct kunit_resource *res,
22 void *context)
23 {
24 struct string_stream_fragment_alloc_context *ctx = context;
25 struct string_stream_fragment *frag;
26
27 frag = kunit_kzalloc(ctx->test, sizeof(*frag), ctx->gfp);
28 if (!frag)
29 return -ENOMEM;
30
31 frag->test = ctx->test;
32 frag->fragment = kunit_kmalloc(ctx->test, ctx->len, ctx->gfp);
33 if (!frag->fragment)
34 return -ENOMEM;
35
36 res->data = frag;
37
38 return 0;
39 }
40
string_stream_fragment_free(struct kunit_resource * res)41 static void string_stream_fragment_free(struct kunit_resource *res)
42 {
43 struct string_stream_fragment *frag = res->data;
44
45 list_del(&frag->node);
46 kunit_kfree(frag->test, frag->fragment);
47 kunit_kfree(frag->test, frag);
48 }
49
alloc_string_stream_fragment(struct kunit * test,int len,gfp_t gfp)50 static struct string_stream_fragment *alloc_string_stream_fragment(
51 struct kunit *test, int len, gfp_t gfp)
52 {
53 struct string_stream_fragment_alloc_context context = {
54 .test = test,
55 .len = len,
56 .gfp = gfp
57 };
58
59 return kunit_alloc_resource(test,
60 string_stream_fragment_init,
61 string_stream_fragment_free,
62 gfp,
63 &context);
64 }
65
string_stream_fragment_destroy(struct string_stream_fragment * frag)66 static int string_stream_fragment_destroy(struct string_stream_fragment *frag)
67 {
68 return kunit_destroy_resource(frag->test,
69 kunit_resource_instance_match,
70 frag);
71 }
72
string_stream_vadd(struct string_stream * stream,const char * fmt,va_list args)73 int string_stream_vadd(struct string_stream *stream,
74 const char *fmt,
75 va_list args)
76 {
77 struct string_stream_fragment *frag_container;
78 int len;
79 va_list args_for_counting;
80
81 /* Make a copy because `vsnprintf` could change it */
82 va_copy(args_for_counting, args);
83
84 /* Need space for null byte. */
85 len = vsnprintf(NULL, 0, fmt, args_for_counting) + 1;
86
87 va_end(args_for_counting);
88
89 frag_container = alloc_string_stream_fragment(stream->test,
90 len,
91 stream->gfp);
92 if (!frag_container)
93 return -ENOMEM;
94
95 len = vsnprintf(frag_container->fragment, len, fmt, args);
96 spin_lock(&stream->lock);
97 stream->length += len;
98 list_add_tail(&frag_container->node, &stream->fragments);
99 spin_unlock(&stream->lock);
100
101 return 0;
102 }
103
string_stream_add(struct string_stream * stream,const char * fmt,...)104 int string_stream_add(struct string_stream *stream, const char *fmt, ...)
105 {
106 va_list args;
107 int result;
108
109 va_start(args, fmt);
110 result = string_stream_vadd(stream, fmt, args);
111 va_end(args);
112
113 return result;
114 }
115
string_stream_clear(struct string_stream * stream)116 static void string_stream_clear(struct string_stream *stream)
117 {
118 struct string_stream_fragment *frag_container, *frag_container_safe;
119
120 spin_lock(&stream->lock);
121 list_for_each_entry_safe(frag_container,
122 frag_container_safe,
123 &stream->fragments,
124 node) {
125 string_stream_fragment_destroy(frag_container);
126 }
127 stream->length = 0;
128 spin_unlock(&stream->lock);
129 }
130
string_stream_get_string(struct string_stream * stream)131 char *string_stream_get_string(struct string_stream *stream)
132 {
133 struct string_stream_fragment *frag_container;
134 size_t buf_len = stream->length + 1; /* +1 for null byte. */
135 char *buf;
136
137 buf = kunit_kzalloc(stream->test, buf_len, stream->gfp);
138 if (!buf)
139 return NULL;
140
141 spin_lock(&stream->lock);
142 list_for_each_entry(frag_container, &stream->fragments, node)
143 strlcat(buf, frag_container->fragment, buf_len);
144 spin_unlock(&stream->lock);
145
146 return buf;
147 }
148
string_stream_append(struct string_stream * stream,struct string_stream * other)149 int string_stream_append(struct string_stream *stream,
150 struct string_stream *other)
151 {
152 const char *other_content;
153
154 other_content = string_stream_get_string(other);
155
156 if (!other_content)
157 return -ENOMEM;
158
159 return string_stream_add(stream, other_content);
160 }
161
string_stream_is_empty(struct string_stream * stream)162 bool string_stream_is_empty(struct string_stream *stream)
163 {
164 return list_empty(&stream->fragments);
165 }
166
167 struct string_stream_alloc_context {
168 struct kunit *test;
169 gfp_t gfp;
170 };
171
string_stream_init(struct kunit_resource * res,void * context)172 static int string_stream_init(struct kunit_resource *res, void *context)
173 {
174 struct string_stream *stream;
175 struct string_stream_alloc_context *ctx = context;
176
177 stream = kunit_kzalloc(ctx->test, sizeof(*stream), ctx->gfp);
178 if (!stream)
179 return -ENOMEM;
180
181 res->data = stream;
182 stream->gfp = ctx->gfp;
183 stream->test = ctx->test;
184 INIT_LIST_HEAD(&stream->fragments);
185 spin_lock_init(&stream->lock);
186
187 return 0;
188 }
189
string_stream_free(struct kunit_resource * res)190 static void string_stream_free(struct kunit_resource *res)
191 {
192 struct string_stream *stream = res->data;
193
194 string_stream_clear(stream);
195 }
196
alloc_string_stream(struct kunit * test,gfp_t gfp)197 struct string_stream *alloc_string_stream(struct kunit *test, gfp_t gfp)
198 {
199 struct string_stream_alloc_context context = {
200 .test = test,
201 .gfp = gfp
202 };
203
204 return kunit_alloc_resource(test,
205 string_stream_init,
206 string_stream_free,
207 gfp,
208 &context);
209 }
210
string_stream_destroy(struct string_stream * stream)211 int string_stream_destroy(struct string_stream *stream)
212 {
213 return kunit_destroy_resource(stream->test,
214 kunit_resource_instance_match,
215 stream);
216 }
217