blob: c8bdafffd2f02f7e0d5533ae06603024f01704da [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
30ssize_t __must_check strscpy(char *, const char *, size_t);
31#endif
Linus Torvalds1da177e2005-04-16 15:20:36 -070032#ifndef __HAVE_ARCH_STRCAT
33extern char * strcat(char *, const char *);
34#endif
35#ifndef __HAVE_ARCH_STRNCAT
36extern char * strncat(char *, const char *, __kernel_size_t);
37#endif
38#ifndef __HAVE_ARCH_STRLCAT
39extern size_t strlcat(char *, const char *, __kernel_size_t);
40#endif
41#ifndef __HAVE_ARCH_STRCMP
42extern int strcmp(const char *,const char *);
43#endif
44#ifndef __HAVE_ARCH_STRNCMP
45extern int strncmp(const char *,const char *,__kernel_size_t);
46#endif
David S. Millerded220b2007-03-29 01:18:42 -070047#ifndef __HAVE_ARCH_STRCASECMP
48extern int strcasecmp(const char *s1, const char *s2);
49#endif
50#ifndef __HAVE_ARCH_STRNCASECMP
51extern int strncasecmp(const char *s1, const char *s2, size_t n);
52#endif
Linus Torvalds1da177e2005-04-16 15:20:36 -070053#ifndef __HAVE_ARCH_STRCHR
54extern char * strchr(const char *,int);
55#endif
Grant Likely11d200e2014-03-14 17:00:14 +000056#ifndef __HAVE_ARCH_STRCHRNUL
57extern char * strchrnul(const char *,int);
58#endif
Linus Torvalds1da177e2005-04-16 15:20:36 -070059#ifndef __HAVE_ARCH_STRNCHR
60extern char * strnchr(const char *, size_t, int);
61#endif
62#ifndef __HAVE_ARCH_STRRCHR
63extern char * strrchr(const char *,int);
64#endif
André Goddard Rosaf6533982009-12-14 18:01:04 -080065extern char * __must_check skip_spaces(const char *);
KOSAKI Motohiroca54cb82009-12-14 18:01:15 -080066
67extern char *strim(char *);
68
69static inline __must_check char *strstrip(char *str)
70{
71 return strim(str);
72}
73
Linus Torvalds1da177e2005-04-16 15:20:36 -070074#ifndef __HAVE_ARCH_STRSTR
Li Zefand5f1fb52010-01-14 10:53:55 +080075extern char * strstr(const char *, const char *);
76#endif
77#ifndef __HAVE_ARCH_STRNSTR
78extern char * strnstr(const char *, const char *, size_t);
Linus Torvalds1da177e2005-04-16 15:20:36 -070079#endif
80#ifndef __HAVE_ARCH_STRLEN
81extern __kernel_size_t strlen(const char *);
82#endif
83#ifndef __HAVE_ARCH_STRNLEN
84extern __kernel_size_t strnlen(const char *,__kernel_size_t);
85#endif
Kyle McMartin8833d322006-04-10 22:53:57 -070086#ifndef __HAVE_ARCH_STRPBRK
87extern char * strpbrk(const char *,const char *);
88#endif
89#ifndef __HAVE_ARCH_STRSEP
90extern char * strsep(char **,const char *);
91#endif
92#ifndef __HAVE_ARCH_STRSPN
93extern __kernel_size_t strspn(const char *,const char *);
94#endif
95#ifndef __HAVE_ARCH_STRCSPN
96extern __kernel_size_t strcspn(const char *,const char *);
97#endif
Linus Torvalds1da177e2005-04-16 15:20:36 -070098
99#ifndef __HAVE_ARCH_MEMSET
100extern void * memset(void *,int,__kernel_size_t);
101#endif
Matthew Wilcox3b3c4ba2017-09-08 16:13:48 -0700102
103#ifndef __HAVE_ARCH_MEMSET16
104extern void *memset16(uint16_t *, uint16_t, __kernel_size_t);
105#endif
106
107#ifndef __HAVE_ARCH_MEMSET32
108extern void *memset32(uint32_t *, uint32_t, __kernel_size_t);
109#endif
110
111#ifndef __HAVE_ARCH_MEMSET64
112extern void *memset64(uint64_t *, uint64_t, __kernel_size_t);
113#endif
114
115static inline void *memset_l(unsigned long *p, unsigned long v,
116 __kernel_size_t n)
117{
118 if (BITS_PER_LONG == 32)
119 return memset32((uint32_t *)p, v, n);
120 else
121 return memset64((uint64_t *)p, v, n);
122}
123
124static inline void *memset_p(void **p, void *v, __kernel_size_t n)
125{
126 if (BITS_PER_LONG == 32)
127 return memset32((uint32_t *)p, (uintptr_t)v, n);
128 else
129 return memset64((uint64_t *)p, (uintptr_t)v, n);
130}
131
Linus Torvalds1da177e2005-04-16 15:20:36 -0700132#ifndef __HAVE_ARCH_MEMCPY
133extern void * memcpy(void *,const void *,__kernel_size_t);
134#endif
135#ifndef __HAVE_ARCH_MEMMOVE
136extern void * memmove(void *,const void *,__kernel_size_t);
137#endif
138#ifndef __HAVE_ARCH_MEMSCAN
139extern void * memscan(void *,int,__kernel_size_t);
140#endif
141#ifndef __HAVE_ARCH_MEMCMP
142extern int memcmp(const void *,const void *,__kernel_size_t);
143#endif
144#ifndef __HAVE_ARCH_MEMCHR
145extern void * memchr(const void *,int,__kernel_size_t);
146#endif
Dan Williams6abccd12017-01-13 14:14:23 -0800147#ifndef __HAVE_ARCH_MEMCPY_MCSAFE
148static inline __must_check int memcpy_mcsafe(void *dst, const void *src,
149 size_t cnt)
150{
151 memcpy(dst, src, cnt);
152 return 0;
153}
154#endif
Dan Williams0aed55a2017-05-29 12:22:50 -0700155#ifndef __HAVE_ARCH_MEMCPY_FLUSHCACHE
156static inline void memcpy_flushcache(void *dst, const void *src, size_t cnt)
157{
158 memcpy(dst, src, cnt);
159}
160#endif
Akinobu Mita798248202011-10-31 17:08:07 -0700161void *memchr_inv(const void *s, int c, size_t n);
Rasmus Villemoes94df2902015-06-25 15:02:22 -0700162char *strreplace(char *s, char old, char new);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700163
Andrzej Hajdaa4bb1e42015-02-13 14:36:24 -0800164extern void kfree_const(const void *x);
165
Rasmus Villemoes48a27052016-05-19 17:10:55 -0700166extern char *kstrdup(const char *s, gfp_t gfp) __malloc;
Andrzej Hajdaa4bb1e42015-02-13 14:36:24 -0800167extern const char *kstrdup_const(const char *s, gfp_t gfp);
Jeremy Fitzhardinge1e66df32007-07-17 18:37:02 -0700168extern char *kstrndup(const char *s, size_t len, gfp_t gfp);
Alexey Dobriyan1a2f67b2006-09-30 23:27:20 -0700169extern void *kmemdup(const void *src, size_t len, gfp_t gfp);
David Howellsf3515742017-07-04 17:25:02 +0100170extern char *kmemdup_nul(const char *s, size_t len, gfp_t gfp);
Paulo Marques543537b2005-06-23 00:09:02 -0700171
Jeremy Fitzhardinged84d1cc2007-07-17 18:37:02 -0700172extern char **argv_split(gfp_t gfp, const char *str, int *argcp);
173extern void argv_free(char **argv);
174
David Brownell34990cf2008-05-01 04:34:42 -0700175extern bool sysfs_streq(const char *s1, const char *s2);
Kees Cookef951592016-03-17 14:22:50 -0700176extern int kstrtobool(const char *s, bool *res);
177static inline int strtobool(const char *s, bool *res)
178{
179 return kstrtobool(s, res);
180}
David Brownell34990cf2008-05-01 04:34:42 -0700181
Andy Shevchenko56b06082016-03-17 14:22:14 -0700182int match_string(const char * const *array, size_t n, const char *string);
Heikki Krogeruse1fe7b62017-03-21 13:56:46 +0200183int __sysfs_match_string(const char * const *array, size_t n, const char *s);
184
185/**
186 * sysfs_match_string - matches given string in an array
187 * @_a: array of strings
188 * @_s: string to match with
189 *
190 * Helper for __sysfs_match_string(). Calculates the size of @a automatically.
191 */
192#define sysfs_match_string(_a, _s) __sysfs_match_string(_a, ARRAY_SIZE(_a), _s)
Andy Shevchenko56b06082016-03-17 14:22:14 -0700193
Lai Jiangshan4370aa42009-03-06 17:21:46 +0100194#ifdef CONFIG_BINARY_PRINTF
195int vbin_printf(u32 *bin_buf, size_t size, const char *fmt, va_list args);
196int bstr_printf(char *buf, size_t size, const char *fmt, const u32 *bin_buf);
197int bprintf(u32 *bin_buf, size_t size, const char *fmt, ...) __printf(3, 4);
198#endif
199
Akinobu Mitae108526e2008-07-23 21:26:44 -0700200extern ssize_t memory_read_from_buffer(void *to, size_t count, loff_t *ppos,
Daniel Borkmannd4c5efd2014-08-26 23:16:35 -0400201 const void *from, size_t available);
Akinobu Mitae108526e2008-07-23 21:26:44 -0700202
Rusty Russell66f92cf2009-03-31 13:05:36 -0600203/**
204 * strstarts - does @str start with @prefix?
205 * @str: string to examine
206 * @prefix: prefix to look for.
207 */
208static inline bool strstarts(const char *str, const char *prefix)
209{
210 return strncmp(str, prefix, strlen(prefix)) == 0;
211}
Akinobu Mita639b9e32012-07-30 14:40:55 -0700212
Daniel Borkmannd4c5efd2014-08-26 23:16:35 -0400213size_t memweight(const void *ptr, size_t bytes);
214void memzero_explicit(void *s, size_t count);
Akinobu Mita639b9e32012-07-30 14:40:55 -0700215
Andy Shevchenkob18888a2012-12-17 16:01:18 -0800216/**
217 * kbasename - return the last part of a pathname.
218 *
219 * @path: path to extract the filename from.
220 */
221static inline const char *kbasename(const char *path)
222{
223 const char *tail = strrchr(path, '/');
224 return tail ? tail + 1 : path;
225}
226
Daniel Micay6974f0c2017-07-12 14:36:10 -0700227#define __FORTIFY_INLINE extern __always_inline __attribute__((gnu_inline))
228#define __RENAME(x) __asm__(#x)
229
230void fortify_panic(const char *name) __noreturn __cold;
231void __read_overflow(void) __compiletime_error("detected read beyond size of object passed as 1st parameter");
232void __read_overflow2(void) __compiletime_error("detected read beyond size of object passed as 2nd parameter");
233void __write_overflow(void) __compiletime_error("detected write beyond size of object passed as 1st parameter");
234
235#if !defined(__NO_FORTIFY) && defined(__OPTIMIZE__) && defined(CONFIG_FORTIFY_SOURCE)
Daniel Micay6974f0c2017-07-12 14:36:10 -0700236__FORTIFY_INLINE char *strncpy(char *p, const char *q, __kernel_size_t size)
237{
238 size_t p_size = __builtin_object_size(p, 0);
239 if (__builtin_constant_p(size) && p_size < size)
240 __write_overflow();
241 if (p_size < size)
242 fortify_panic(__func__);
243 return __builtin_strncpy(p, q, size);
244}
245
246__FORTIFY_INLINE char *strcat(char *p, const char *q)
247{
248 size_t p_size = __builtin_object_size(p, 0);
249 if (p_size == (size_t)-1)
250 return __builtin_strcat(p, q);
251 if (strlcat(p, q, p_size) >= p_size)
252 fortify_panic(__func__);
253 return p;
254}
255
256__FORTIFY_INLINE __kernel_size_t strlen(const char *p)
257{
258 __kernel_size_t ret;
259 size_t p_size = __builtin_object_size(p, 0);
260 if (p_size == (size_t)-1)
261 return __builtin_strlen(p);
262 ret = strnlen(p, p_size);
263 if (p_size <= ret)
264 fortify_panic(__func__);
265 return ret;
266}
267
268extern __kernel_size_t __real_strnlen(const char *, __kernel_size_t) __RENAME(strnlen);
269__FORTIFY_INLINE __kernel_size_t strnlen(const char *p, __kernel_size_t maxlen)
270{
271 size_t p_size = __builtin_object_size(p, 0);
272 __kernel_size_t ret = __real_strnlen(p, maxlen < p_size ? maxlen : p_size);
273 if (p_size <= ret && maxlen != ret)
274 fortify_panic(__func__);
275 return ret;
276}
277
278/* defined after fortified strlen to reuse it */
279extern size_t __real_strlcpy(char *, const char *, size_t) __RENAME(strlcpy);
280__FORTIFY_INLINE size_t strlcpy(char *p, const char *q, size_t size)
281{
282 size_t ret;
283 size_t p_size = __builtin_object_size(p, 0);
284 size_t q_size = __builtin_object_size(q, 0);
285 if (p_size == (size_t)-1 && q_size == (size_t)-1)
286 return __real_strlcpy(p, q, size);
287 ret = strlen(q);
288 if (size) {
289 size_t len = (ret >= size) ? size - 1 : ret;
290 if (__builtin_constant_p(len) && len >= p_size)
291 __write_overflow();
292 if (len >= p_size)
293 fortify_panic(__func__);
294 __builtin_memcpy(p, q, len);
295 p[len] = '\0';
296 }
297 return ret;
298}
299
300/* defined after fortified strlen and strnlen to reuse them */
301__FORTIFY_INLINE char *strncat(char *p, const char *q, __kernel_size_t count)
302{
303 size_t p_len, copy_len;
304 size_t p_size = __builtin_object_size(p, 0);
305 size_t q_size = __builtin_object_size(q, 0);
306 if (p_size == (size_t)-1 && q_size == (size_t)-1)
307 return __builtin_strncat(p, q, count);
308 p_len = strlen(p);
309 copy_len = strnlen(q, count);
310 if (p_size < p_len + copy_len + 1)
311 fortify_panic(__func__);
312 __builtin_memcpy(p + p_len, q, copy_len);
313 p[p_len + copy_len] = '\0';
314 return p;
315}
316
317__FORTIFY_INLINE void *memset(void *p, int c, __kernel_size_t size)
318{
319 size_t p_size = __builtin_object_size(p, 0);
320 if (__builtin_constant_p(size) && p_size < size)
321 __write_overflow();
322 if (p_size < size)
323 fortify_panic(__func__);
324 return __builtin_memset(p, c, size);
325}
326
327__FORTIFY_INLINE void *memcpy(void *p, const void *q, __kernel_size_t size)
328{
329 size_t p_size = __builtin_object_size(p, 0);
330 size_t q_size = __builtin_object_size(q, 0);
331 if (__builtin_constant_p(size)) {
332 if (p_size < size)
333 __write_overflow();
334 if (q_size < size)
335 __read_overflow2();
336 }
337 if (p_size < size || q_size < size)
338 fortify_panic(__func__);
339 return __builtin_memcpy(p, q, size);
340}
341
342__FORTIFY_INLINE void *memmove(void *p, const void *q, __kernel_size_t size)
343{
344 size_t p_size = __builtin_object_size(p, 0);
345 size_t q_size = __builtin_object_size(q, 0);
346 if (__builtin_constant_p(size)) {
347 if (p_size < size)
348 __write_overflow();
349 if (q_size < size)
350 __read_overflow2();
351 }
352 if (p_size < size || q_size < size)
353 fortify_panic(__func__);
354 return __builtin_memmove(p, q, size);
355}
356
357extern void *__real_memscan(void *, int, __kernel_size_t) __RENAME(memscan);
358__FORTIFY_INLINE void *memscan(void *p, int c, __kernel_size_t size)
359{
360 size_t p_size = __builtin_object_size(p, 0);
361 if (__builtin_constant_p(size) && p_size < size)
362 __read_overflow();
363 if (p_size < size)
364 fortify_panic(__func__);
365 return __real_memscan(p, c, size);
366}
367
368__FORTIFY_INLINE int memcmp(const void *p, const void *q, __kernel_size_t size)
369{
370 size_t p_size = __builtin_object_size(p, 0);
371 size_t q_size = __builtin_object_size(q, 0);
372 if (__builtin_constant_p(size)) {
373 if (p_size < size)
374 __read_overflow();
375 if (q_size < size)
376 __read_overflow2();
377 }
378 if (p_size < size || q_size < size)
379 fortify_panic(__func__);
380 return __builtin_memcmp(p, q, size);
381}
382
383__FORTIFY_INLINE void *memchr(const void *p, int c, __kernel_size_t size)
384{
385 size_t p_size = __builtin_object_size(p, 0);
386 if (__builtin_constant_p(size) && p_size < size)
387 __read_overflow();
388 if (p_size < size)
389 fortify_panic(__func__);
390 return __builtin_memchr(p, c, size);
391}
392
393void *__real_memchr_inv(const void *s, int c, size_t n) __RENAME(memchr_inv);
394__FORTIFY_INLINE void *memchr_inv(const void *p, int c, size_t size)
395{
396 size_t p_size = __builtin_object_size(p, 0);
397 if (__builtin_constant_p(size) && p_size < size)
398 __read_overflow();
399 if (p_size < size)
400 fortify_panic(__func__);
401 return __real_memchr_inv(p, c, size);
402}
403
404extern void *__real_kmemdup(const void *src, size_t len, gfp_t gfp) __RENAME(kmemdup);
405__FORTIFY_INLINE void *kmemdup(const void *p, size_t size, gfp_t gfp)
406{
407 size_t p_size = __builtin_object_size(p, 0);
408 if (__builtin_constant_p(size) && p_size < size)
409 __read_overflow();
410 if (p_size < size)
411 fortify_panic(__func__);
412 return __real_kmemdup(p, size, gfp);
413}
Daniel Micay077d2ba2017-07-14 17:28:12 -0400414
415/* defined after fortified strlen and memcpy to reuse them */
416__FORTIFY_INLINE char *strcpy(char *p, const char *q)
417{
418 size_t p_size = __builtin_object_size(p, 0);
419 size_t q_size = __builtin_object_size(q, 0);
420 if (p_size == (size_t)-1 && q_size == (size_t)-1)
421 return __builtin_strcpy(p, q);
422 memcpy(p, q, strlen(q) + 1);
423 return p;
424}
425
Daniel Micay6974f0c2017-07-12 14:36:10 -0700426#endif
427
Linus Torvalds1da177e2005-04-16 15:20:36 -0700428#endif /* _LINUX_STRING_H_ */