blob: f2a3dedccfe8bc108a47bbcca6804b364220c3a0 [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001#ifndef _LINUX_STRING_H_
2#define _LINUX_STRING_H_
3
Linus Torvalds1da177e2005-04-16 15:20:36 -07004
5#include <linux/compiler.h> /* for inline */
6#include <linux/types.h> /* for size_t */
7#include <linux/stddef.h> /* for NULL */
Lai Jiangshan4370aa42009-03-06 17:21:46 +01008#include <stdarg.h>
David Howells607ca462012-10-13 10:46:48 +01009#include <uapi/linux/string.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070010
Davi Arnaut96840aa2006-03-24 03:18:42 -080011extern char *strndup_user(const char __user *, long);
Li Zefan610a77e2009-03-31 15:23:16 -070012extern void *memdup_user(const void __user *, size_t);
Al Viroe9d408e2015-12-24 00:06:05 -050013extern void *memdup_user_nul(const void __user *, size_t);
Davi Arnaut96840aa2006-03-24 03:18:42 -080014
Linus Torvalds1da177e2005-04-16 15:20:36 -070015/*
16 * Include machine specific inline routines
17 */
18#include <asm/string.h>
19
20#ifndef __HAVE_ARCH_STRCPY
21extern char * strcpy(char *,const char *);
22#endif
23#ifndef __HAVE_ARCH_STRNCPY
24extern char * strncpy(char *,const char *, __kernel_size_t);
25#endif
26#ifndef __HAVE_ARCH_STRLCPY
27size_t strlcpy(char *, const char *, size_t);
28#endif
Chris Metcalf30035e42015-04-29 12:52:04 -040029#ifndef __HAVE_ARCH_STRSCPY
Tejun Heo5c067892018-01-09 07:21:15 -080030ssize_t strscpy(char *, const char *, size_t);
Chris Metcalf30035e42015-04-29 12:52:04 -040031#endif
Tobin C. Harding316c6cc2019-04-05 12:58:58 +110032
33/* Wraps calls to strscpy()/memset(), no arch specific code required */
34ssize_t strscpy_pad(char *dest, const char *src, size_t count);
35
Linus Torvalds1da177e2005-04-16 15:20:36 -070036#ifndef __HAVE_ARCH_STRCAT
37extern char * strcat(char *, const char *);
38#endif
39#ifndef __HAVE_ARCH_STRNCAT
40extern char * strncat(char *, const char *, __kernel_size_t);
41#endif
42#ifndef __HAVE_ARCH_STRLCAT
43extern size_t strlcat(char *, const char *, __kernel_size_t);
44#endif
45#ifndef __HAVE_ARCH_STRCMP
46extern int strcmp(const char *,const char *);
47#endif
48#ifndef __HAVE_ARCH_STRNCMP
49extern int strncmp(const char *,const char *,__kernel_size_t);
50#endif
David S. Millerded220b2007-03-29 01:18:42 -070051#ifndef __HAVE_ARCH_STRCASECMP
52extern int strcasecmp(const char *s1, const char *s2);
53#endif
54#ifndef __HAVE_ARCH_STRNCASECMP
55extern int strncasecmp(const char *s1, const char *s2, size_t n);
56#endif
Linus Torvalds1da177e2005-04-16 15:20:36 -070057#ifndef __HAVE_ARCH_STRCHR
58extern char * strchr(const char *,int);
59#endif
Grant Likely11d200e2014-03-14 17:00:14 +000060#ifndef __HAVE_ARCH_STRCHRNUL
61extern char * strchrnul(const char *,int);
62#endif
Linus Torvalds1da177e2005-04-16 15:20:36 -070063#ifndef __HAVE_ARCH_STRNCHR
64extern char * strnchr(const char *, size_t, int);
65#endif
66#ifndef __HAVE_ARCH_STRRCHR
67extern char * strrchr(const char *,int);
68#endif
André Goddard Rosaf6533982009-12-14 18:01:04 -080069extern char * __must_check skip_spaces(const char *);
KOSAKI Motohiroca54cb82009-12-14 18:01:15 -080070
71extern char *strim(char *);
72
73static inline __must_check char *strstrip(char *str)
74{
75 return strim(str);
76}
77
Linus Torvalds1da177e2005-04-16 15:20:36 -070078#ifndef __HAVE_ARCH_STRSTR
Li Zefand5f1fb52010-01-14 10:53:55 +080079extern char * strstr(const char *, const char *);
80#endif
81#ifndef __HAVE_ARCH_STRNSTR
82extern char * strnstr(const char *, const char *, size_t);
Linus Torvalds1da177e2005-04-16 15:20:36 -070083#endif
84#ifndef __HAVE_ARCH_STRLEN
85extern __kernel_size_t strlen(const char *);
86#endif
87#ifndef __HAVE_ARCH_STRNLEN
88extern __kernel_size_t strnlen(const char *,__kernel_size_t);
89#endif
Kyle McMartin8833d322006-04-10 22:53:57 -070090#ifndef __HAVE_ARCH_STRPBRK
91extern char * strpbrk(const char *,const char *);
92#endif
93#ifndef __HAVE_ARCH_STRSEP
94extern char * strsep(char **,const char *);
95#endif
96#ifndef __HAVE_ARCH_STRSPN
97extern __kernel_size_t strspn(const char *,const char *);
98#endif
99#ifndef __HAVE_ARCH_STRCSPN
100extern __kernel_size_t strcspn(const char *,const char *);
101#endif
Linus Torvalds1da177e2005-04-16 15:20:36 -0700102
103#ifndef __HAVE_ARCH_MEMSET
104extern void * memset(void *,int,__kernel_size_t);
105#endif
Matthew Wilcoxfe0bc3f2017-09-08 16:13:48 -0700106
107#ifndef __HAVE_ARCH_MEMSET16
108extern void *memset16(uint16_t *, uint16_t, __kernel_size_t);
109#endif
110
111#ifndef __HAVE_ARCH_MEMSET32
112extern void *memset32(uint32_t *, uint32_t, __kernel_size_t);
113#endif
114
115#ifndef __HAVE_ARCH_MEMSET64
116extern void *memset64(uint64_t *, uint64_t, __kernel_size_t);
117#endif
118
119static inline void *memset_l(unsigned long *p, unsigned long v,
120 __kernel_size_t n)
121{
122 if (BITS_PER_LONG == 32)
123 return memset32((uint32_t *)p, v, n);
124 else
125 return memset64((uint64_t *)p, v, n);
126}
127
128static inline void *memset_p(void **p, void *v, __kernel_size_t n)
129{
130 if (BITS_PER_LONG == 32)
131 return memset32((uint32_t *)p, (uintptr_t)v, n);
132 else
133 return memset64((uint64_t *)p, (uintptr_t)v, n);
134}
135
Linus Torvalds1da177e2005-04-16 15:20:36 -0700136#ifndef __HAVE_ARCH_MEMCPY
137extern void * memcpy(void *,const void *,__kernel_size_t);
138#endif
139#ifndef __HAVE_ARCH_MEMMOVE
140extern void * memmove(void *,const void *,__kernel_size_t);
141#endif
142#ifndef __HAVE_ARCH_MEMSCAN
143extern void * memscan(void *,int,__kernel_size_t);
144#endif
145#ifndef __HAVE_ARCH_MEMCMP
146extern int memcmp(const void *,const void *,__kernel_size_t);
147#endif
Nick Desaulniers7eceaf52019-04-05 18:38:45 -0700148#ifndef __HAVE_ARCH_BCMP
149extern int bcmp(const void *,const void *,__kernel_size_t);
150#endif
Linus Torvalds1da177e2005-04-16 15:20:36 -0700151#ifndef __HAVE_ARCH_MEMCHR
152extern void * memchr(const void *,int,__kernel_size_t);
153#endif
Akinobu Mita798248202011-10-31 17:08:07 -0700154void *memchr_inv(const void *s, int c, size_t n);
Rasmus Villemoes94df2902015-06-25 15:02:22 -0700155char *strreplace(char *s, char old, char new);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700156
Andrzej Hajdaa4bb1e42015-02-13 14:36:24 -0800157extern void kfree_const(const void *x);
158
Rasmus Villemoes48a27052016-05-19 17:10:55 -0700159extern char *kstrdup(const char *s, gfp_t gfp) __malloc;
Andrzej Hajdaa4bb1e42015-02-13 14:36:24 -0800160extern const char *kstrdup_const(const char *s, gfp_t gfp);
Jeremy Fitzhardinge1e66df32007-07-17 18:37:02 -0700161extern char *kstrndup(const char *s, size_t len, gfp_t gfp);
Alexey Dobriyan1a2f67b2006-09-30 23:27:20 -0700162extern void *kmemdup(const void *src, size_t len, gfp_t gfp);
David Howells5cab144f2017-07-04 17:25:02 +0100163extern char *kmemdup_nul(const char *s, size_t len, gfp_t gfp);
Paulo Marques543537b2005-06-23 00:09:02 -0700164
Jeremy Fitzhardinged84d1cc2007-07-17 18:37:02 -0700165extern char **argv_split(gfp_t gfp, const char *str, int *argcp);
166extern void argv_free(char **argv);
167
David Brownell34990cf2008-05-01 04:34:42 -0700168extern bool sysfs_streq(const char *s1, const char *s2);
Kees Cookef951592016-03-17 14:22:50 -0700169extern int kstrtobool(const char *s, bool *res);
170static inline int strtobool(const char *s, bool *res)
171{
172 return kstrtobool(s, res);
173}
David Brownell34990cf2008-05-01 04:34:42 -0700174
Andy Shevchenko56b06082016-03-17 14:22:14 -0700175int match_string(const char * const *array, size_t n, const char *string);
176
Lai Jiangshan4370aa42009-03-06 17:21:46 +0100177#ifdef CONFIG_BINARY_PRINTF
178int vbin_printf(u32 *bin_buf, size_t size, const char *fmt, va_list args);
179int bstr_printf(char *buf, size_t size, const char *fmt, const u32 *bin_buf);
180int bprintf(u32 *bin_buf, size_t size, const char *fmt, ...) __printf(3, 4);
181#endif
182
Akinobu Mitae108526e2008-07-23 21:26:44 -0700183extern ssize_t memory_read_from_buffer(void *to, size_t count, loff_t *ppos,
Daniel Borkmannd4c5efd2014-08-26 23:16:35 -0400184 const void *from, size_t available);
Akinobu Mitae108526e2008-07-23 21:26:44 -0700185
Rusty Russell66f92cf2009-03-31 13:05:36 -0600186/**
187 * strstarts - does @str start with @prefix?
188 * @str: string to examine
189 * @prefix: prefix to look for.
190 */
191static inline bool strstarts(const char *str, const char *prefix)
192{
193 return strncmp(str, prefix, strlen(prefix)) == 0;
194}
Akinobu Mita639b9e32012-07-30 14:40:55 -0700195
Daniel Borkmannd4c5efd2014-08-26 23:16:35 -0400196size_t memweight(const void *ptr, size_t bytes);
197void memzero_explicit(void *s, size_t count);
Akinobu Mita639b9e32012-07-30 14:40:55 -0700198
Andy Shevchenkob18888a2012-12-17 16:01:18 -0800199/**
200 * kbasename - return the last part of a pathname.
201 *
202 * @path: path to extract the filename from.
203 */
204static inline const char *kbasename(const char *path)
205{
206 const char *tail = strrchr(path, '/');
207 return tail ? tail + 1 : path;
208}
209
Daniel Micay0f513102017-07-12 14:36:10 -0700210#define __FORTIFY_INLINE extern __always_inline __attribute__((gnu_inline))
211#define __RENAME(x) __asm__(#x)
212
213void fortify_panic(const char *name) __noreturn __cold;
Channagoud Kadabi724ed8f2017-12-01 15:08:41 -0800214
215#ifdef CONFIG_FORTIFY_COMPILE_CHECK
Daniel Micay0f513102017-07-12 14:36:10 -0700216void __read_overflow(void) __compiletime_error("detected read beyond size of object passed as 1st parameter");
217void __read_overflow2(void) __compiletime_error("detected read beyond size of object passed as 2nd parameter");
218void __write_overflow(void) __compiletime_error("detected write beyond size of object passed as 1st parameter");
Channagoud Kadabi724ed8f2017-12-01 15:08:41 -0800219#else
220#define __read_overflow(void) do { } while (0)
221#define __read_overflow2(void) do { } while (0)
222#define __write_overflow(void) do { } while (0)
223#endif
Daniel Micay0f513102017-07-12 14:36:10 -0700224
225#if !defined(__NO_FORTIFY) && defined(__OPTIMIZE__) && defined(CONFIG_FORTIFY_SOURCE)
Daniel Micay0f513102017-07-12 14:36:10 -0700226__FORTIFY_INLINE char *strncpy(char *p, const char *q, __kernel_size_t size)
227{
228 size_t p_size = __builtin_object_size(p, 0);
229 if (__builtin_constant_p(size) && p_size < size)
230 __write_overflow();
231 if (p_size < size)
232 fortify_panic(__func__);
233 return __builtin_strncpy(p, q, size);
234}
235
236__FORTIFY_INLINE char *strcat(char *p, const char *q)
237{
238 size_t p_size = __builtin_object_size(p, 0);
239 if (p_size == (size_t)-1)
240 return __builtin_strcat(p, q);
241 if (strlcat(p, q, p_size) >= p_size)
242 fortify_panic(__func__);
243 return p;
244}
245
246__FORTIFY_INLINE __kernel_size_t strlen(const char *p)
247{
248 __kernel_size_t ret;
249 size_t p_size = __builtin_object_size(p, 0);
250 if (p_size == (size_t)-1)
251 return __builtin_strlen(p);
252 ret = strnlen(p, p_size);
253 if (p_size <= ret)
254 fortify_panic(__func__);
255 return ret;
256}
257
258extern __kernel_size_t __real_strnlen(const char *, __kernel_size_t) __RENAME(strnlen);
259__FORTIFY_INLINE __kernel_size_t strnlen(const char *p, __kernel_size_t maxlen)
260{
261 size_t p_size = __builtin_object_size(p, 0);
262 __kernel_size_t ret = __real_strnlen(p, maxlen < p_size ? maxlen : p_size);
263 if (p_size <= ret && maxlen != ret)
264 fortify_panic(__func__);
265 return ret;
266}
267
268/* defined after fortified strlen to reuse it */
269extern size_t __real_strlcpy(char *, const char *, size_t) __RENAME(strlcpy);
270__FORTIFY_INLINE size_t strlcpy(char *p, const char *q, size_t size)
271{
272 size_t ret;
273 size_t p_size = __builtin_object_size(p, 0);
274 size_t q_size = __builtin_object_size(q, 0);
275 if (p_size == (size_t)-1 && q_size == (size_t)-1)
276 return __real_strlcpy(p, q, size);
277 ret = strlen(q);
278 if (size) {
279 size_t len = (ret >= size) ? size - 1 : ret;
280 if (__builtin_constant_p(len) && len >= p_size)
281 __write_overflow();
282 if (len >= p_size)
283 fortify_panic(__func__);
284 __builtin_memcpy(p, q, len);
285 p[len] = '\0';
286 }
287 return ret;
288}
289
290/* defined after fortified strlen and strnlen to reuse them */
291__FORTIFY_INLINE char *strncat(char *p, const char *q, __kernel_size_t count)
292{
293 size_t p_len, copy_len;
294 size_t p_size = __builtin_object_size(p, 0);
295 size_t q_size = __builtin_object_size(q, 0);
296 if (p_size == (size_t)-1 && q_size == (size_t)-1)
297 return __builtin_strncat(p, q, count);
298 p_len = strlen(p);
299 copy_len = strnlen(q, count);
300 if (p_size < p_len + copy_len + 1)
301 fortify_panic(__func__);
302 __builtin_memcpy(p + p_len, q, copy_len);
303 p[p_len + copy_len] = '\0';
304 return p;
305}
306
307__FORTIFY_INLINE void *memset(void *p, int c, __kernel_size_t size)
308{
309 size_t p_size = __builtin_object_size(p, 0);
310 if (__builtin_constant_p(size) && p_size < size)
311 __write_overflow();
312 if (p_size < size)
313 fortify_panic(__func__);
314 return __builtin_memset(p, c, size);
315}
316
317__FORTIFY_INLINE void *memcpy(void *p, const void *q, __kernel_size_t size)
318{
319 size_t p_size = __builtin_object_size(p, 0);
320 size_t q_size = __builtin_object_size(q, 0);
321 if (__builtin_constant_p(size)) {
322 if (p_size < size)
323 __write_overflow();
324 if (q_size < size)
325 __read_overflow2();
326 }
327 if (p_size < size || q_size < size)
328 fortify_panic(__func__);
329 return __builtin_memcpy(p, q, size);
330}
331
332__FORTIFY_INLINE void *memmove(void *p, const void *q, __kernel_size_t size)
333{
334 size_t p_size = __builtin_object_size(p, 0);
335 size_t q_size = __builtin_object_size(q, 0);
336 if (__builtin_constant_p(size)) {
337 if (p_size < size)
338 __write_overflow();
339 if (q_size < size)
340 __read_overflow2();
341 }
342 if (p_size < size || q_size < size)
343 fortify_panic(__func__);
344 return __builtin_memmove(p, q, size);
345}
346
347extern void *__real_memscan(void *, int, __kernel_size_t) __RENAME(memscan);
348__FORTIFY_INLINE void *memscan(void *p, int c, __kernel_size_t size)
349{
350 size_t p_size = __builtin_object_size(p, 0);
351 if (__builtin_constant_p(size) && p_size < size)
352 __read_overflow();
353 if (p_size < size)
354 fortify_panic(__func__);
355 return __real_memscan(p, c, size);
356}
357
358__FORTIFY_INLINE int memcmp(const void *p, const void *q, __kernel_size_t size)
359{
360 size_t p_size = __builtin_object_size(p, 0);
361 size_t q_size = __builtin_object_size(q, 0);
362 if (__builtin_constant_p(size)) {
363 if (p_size < size)
364 __read_overflow();
365 if (q_size < size)
366 __read_overflow2();
367 }
368 if (p_size < size || q_size < size)
369 fortify_panic(__func__);
370 return __builtin_memcmp(p, q, size);
371}
372
373__FORTIFY_INLINE void *memchr(const void *p, int c, __kernel_size_t size)
374{
375 size_t p_size = __builtin_object_size(p, 0);
376 if (__builtin_constant_p(size) && p_size < size)
377 __read_overflow();
378 if (p_size < size)
379 fortify_panic(__func__);
380 return __builtin_memchr(p, c, size);
381}
382
383void *__real_memchr_inv(const void *s, int c, size_t n) __RENAME(memchr_inv);
384__FORTIFY_INLINE void *memchr_inv(const void *p, int c, size_t size)
385{
386 size_t p_size = __builtin_object_size(p, 0);
387 if (__builtin_constant_p(size) && p_size < size)
388 __read_overflow();
389 if (p_size < size)
390 fortify_panic(__func__);
391 return __real_memchr_inv(p, c, size);
392}
393
394extern void *__real_kmemdup(const void *src, size_t len, gfp_t gfp) __RENAME(kmemdup);
395__FORTIFY_INLINE void *kmemdup(const void *p, size_t size, gfp_t gfp)
396{
397 size_t p_size = __builtin_object_size(p, 0);
398 if (__builtin_constant_p(size) && p_size < size)
399 __read_overflow();
400 if (p_size < size)
401 fortify_panic(__func__);
402 return __real_kmemdup(p, size, gfp);
403}
Daniel Micay3d2f47b2017-09-14 13:12:54 -0700404
405/* defined after fortified strlen and memcpy to reuse them */
406__FORTIFY_INLINE char *strcpy(char *p, const char *q)
407{
408 size_t p_size = __builtin_object_size(p, 0);
409 size_t q_size = __builtin_object_size(q, 0);
410 if (p_size == (size_t)-1 && q_size == (size_t)-1)
411 return __builtin_strcpy(p, q);
412 memcpy(p, q, strlen(q) + 1);
413 return p;
414}
415
Daniel Micay0f513102017-07-12 14:36:10 -0700416#endif
417
Linus Torvalds1da177e2005-04-16 15:20:36 -0700418#endif /* _LINUX_STRING_H_ */