blob: c45fa85c887e25f34d39ab5a3ecddf2272b2ae37 [file] [log] [blame]
Tom Rini10e47792018-05-06 17:58:06 -04001// SPDX-License-Identifier: GPL-2.0+
Kumar Galaaed83342008-02-14 20:44:42 -06002/*
3 * Copyright 2008 Freescale Semiconductor, Inc.
Wolfgang Denkb04ae782013-03-23 23:50:34 +00004 * Copyright 2013 Wolfgang Denk <wd@denx.de>
Kumar Galaaed83342008-02-14 20:44:42 -06005 */
6
7/*
8 * This file provides a shell like 'expr' function to return.
9 */
10
Kumar Galaaed83342008-02-14 20:44:42 -060011#include <config.h>
12#include <command.h>
Roland Gaudig2c9e7c22021-07-23 12:29:21 +000013#include <ctype.h>
Simon Glass313112a2019-08-01 09:46:46 -060014#include <env.h>
Simon Glass0f2af882020-05-10 11:40:05 -060015#include <log.h>
Simon Glass580a7a52020-11-01 14:15:44 -070016#include <malloc.h>
Joe Hershberger9d3f8962015-05-11 13:53:13 -050017#include <mapmem.h>
Tom Rinidec7ea02024-05-20 13:35:03 -060018#include <vsprintf.h>
19#include <linux/errno.h>
Simon Glass580a7a52020-11-01 14:15:44 -070020#include <linux/sizes.h>
Roland Gaudig2c9e7c22021-07-23 12:29:21 +000021#include "printf.h"
22
23#define MAX_STR_LEN 128
Kumar Galaaed83342008-02-14 20:44:42 -060024
Simon Glass00547af2020-11-01 14:15:43 -070025/**
26 * struct expr_arg: Holds an argument to an expression
27 *
28 * @ival: Integer value (if width is not CMD_DATA_SIZE_STR)
Simon Glass580a7a52020-11-01 14:15:44 -070029 * @sval: String value (if width is CMD_DATA_SIZE_STR)
Simon Glass00547af2020-11-01 14:15:43 -070030 */
31struct expr_arg {
Simon Glass580a7a52020-11-01 14:15:44 -070032 union {
33 ulong ival;
34 char *sval;
35 };
Simon Glass00547af2020-11-01 14:15:43 -070036};
37
Heinrich Schuchardt6cd06542025-02-03 16:10:29 +010038/**
39 * arg_set_str() - copy string to expression argument
40 *
41 * The string is truncated to 64 KiB plus NUL terminator.
42 *
43 * @p: pointer to string
44 * @argp: pointer to expression argument
45 * Return: 0 on success, -ENOMEM if out of memory
46 */
47static int arg_set_str(void *p, struct expr_arg *argp)
48{
49 int len;
50 char *str;
51
52 /* Maximum string length of 64 KiB plus NUL terminator */
53 len = strnlen((char *)p, SZ_64K) + 1;
54 str = malloc(len);
55 if (!str) {
56 printf("Out of memory\n");
57 return -ENOMEM;
58 }
59 memcpy(str, p, len);
60 str[len - 1] = '\0';
61 argp->sval = str;
62 return 0;
63}
64
Simon Glass00547af2020-11-01 14:15:43 -070065static int get_arg(char *s, int w, struct expr_arg *argp)
Frans Meulenbroeks2347d4e2010-02-26 14:00:19 +010066{
Simon Glass00547af2020-11-01 14:15:43 -070067 struct expr_arg arg;
Heinrich Schuchardt6cd06542025-02-03 16:10:29 +010068 int ret;
Simon Glass00547af2020-11-01 14:15:43 -070069
Wolfgang Denk9a183d22010-06-23 20:50:54 +020070 /*
Joe Hershberger9d3f8962015-05-11 13:53:13 -050071 * If the parameter starts with a '*' then assume it is a pointer to
72 * the value we want.
Frans Meulenbroeks2347d4e2010-02-26 14:00:19 +010073 */
Frans Meulenbroeks2347d4e2010-02-26 14:00:19 +010074 if (s[0] == '*') {
Joe Hershberger9d3f8962015-05-11 13:53:13 -050075 ulong *p;
76 ulong addr;
77 ulong val;
78
Simon Glass3ff49ec2021-07-24 09:03:29 -060079 addr = hextoul(&s[1], NULL);
Frans Meulenbroeks2347d4e2010-02-26 14:00:19 +010080 switch (w) {
Joe Hershberger9d3f8962015-05-11 13:53:13 -050081 case 1:
82 p = map_sysmem(addr, sizeof(uchar));
83 val = (ulong)*(uchar *)p;
84 unmap_sysmem(p);
Simon Glass00547af2020-11-01 14:15:43 -070085 arg.ival = val;
86 break;
Joe Hershberger9d3f8962015-05-11 13:53:13 -050087 case 2:
88 p = map_sysmem(addr, sizeof(ushort));
89 val = (ulong)*(ushort *)p;
90 unmap_sysmem(p);
Simon Glass00547af2020-11-01 14:15:43 -070091 arg.ival = val;
92 break;
Simon Glass580a7a52020-11-01 14:15:44 -070093 case CMD_DATA_SIZE_STR:
94 p = map_sysmem(addr, SZ_64K);
Heinrich Schuchardt6cd06542025-02-03 16:10:29 +010095 ret = arg_set_str(p, &arg);
Simon Glass580a7a52020-11-01 14:15:44 -070096 unmap_sysmem(p);
Heinrich Schuchardt6cd06542025-02-03 16:10:29 +010097 if (ret)
98 return ret;
Simon Glass580a7a52020-11-01 14:15:44 -070099 break;
Frans Meulenbroeks2347d4e2010-02-26 14:00:19 +0100100 case 4:
Simon Glass7c19edf2020-11-01 14:15:37 -0700101 p = map_sysmem(addr, sizeof(u32));
102 val = *(u32 *)p;
103 unmap_sysmem(p);
Simon Glass00547af2020-11-01 14:15:43 -0700104 arg.ival = val;
105 break;
Joe Hershberger9d3f8962015-05-11 13:53:13 -0500106 default:
107 p = map_sysmem(addr, sizeof(ulong));
108 val = *p;
109 unmap_sysmem(p);
Simon Glass00547af2020-11-01 14:15:43 -0700110 arg.ival = val;
111 break;
Frans Meulenbroeks2347d4e2010-02-26 14:00:19 +0100112 }
113 } else {
Heinrich Schuchardt6cd06542025-02-03 16:10:29 +0100114 if (w == CMD_DATA_SIZE_STR) {
115 ret = arg_set_str(s, &arg);
116 if (ret)
117 return ret;
118 } else {
119 arg.ival = hextoul(s, NULL);
120 }
Frans Meulenbroeks2347d4e2010-02-26 14:00:19 +0100121 }
Simon Glass00547af2020-11-01 14:15:43 -0700122 *argp = arg;
123
124 return 0;
Frans Meulenbroeks2347d4e2010-02-26 14:00:19 +0100125}
126
Wolfgang Denkb04ae782013-03-23 23:50:34 +0000127#ifdef CONFIG_REGEX
128
129#include <slre.h>
130
Wolfgang Denkb04ae782013-03-23 23:50:34 +0000131/*
132 * memstr - Find the first substring in memory
133 * @s1: The string to be searched
134 * @s2: The string to search for
135 *
136 * Similar to and based on strstr(),
137 * but strings do not need to be NUL terminated.
138 */
139static char *memstr(const char *s1, int l1, const char *s2, int l2)
140{
141 if (!l2)
142 return (char *)s1;
143
144 while (l1 >= l2) {
145 l1--;
146 if (!memcmp(s1, s2, l2))
147 return (char *)s1;
148 s1++;
149 }
150 return NULL;
151}
152
Simon Glassb8e9f2d2020-11-01 14:15:39 -0700153/**
154 * substitute() - Substitute part of one string with another
155 *
156 * This updates @string so that the first occurrence of @old is replaced with
157 * @new
158 *
159 * @string: String buffer containing string to update at the start
160 * @slen: Pointer to current string length, updated on success
161 * @ssize: Size of string buffer
162 * @old: Old string to find in the buffer (no terminator needed)
163 * @olen: Length of @old excluding terminator
164 * @new: New string to replace @old with
165 * @nlen: Length of @new excluding terminator
Heinrich Schuchardt47b4c022022-01-19 18:05:50 +0100166 * Return: pointer to immediately after the copied @new in @string, or NULL if
Simon Glassb8e9f2d2020-11-01 14:15:39 -0700167 * no replacement took place
168 */
169static char *substitute(char *string, int *slen, int ssize,
170 const char *old, int olen, const char *new, int nlen)
Wolfgang Denkb04ae782013-03-23 23:50:34 +0000171{
172 char *p = memstr(string, *slen, old, olen);
173
174 if (p == NULL)
175 return NULL;
176
177 debug("## Match at pos %ld: match len %d, subst len %d\n",
178 (long)(p - string), olen, nlen);
179
180 /* make sure replacement matches */
181 if (*slen + nlen - olen > ssize) {
182 printf("## error: substitution buffer overflow\n");
183 return NULL;
184 }
185
186 /* move tail if needed */
187 if (olen != nlen) {
188 int tail, len;
189
190 len = (olen > nlen) ? olen : nlen;
191
192 tail = ssize - (p + len - string);
193
194 debug("## tail len %d\n", tail);
195
196 memmove(p + nlen, p + olen, tail);
197 }
198
Simon Glassb8e9f2d2020-11-01 14:15:39 -0700199 /* insert substitute */
Wolfgang Denkb04ae782013-03-23 23:50:34 +0000200 memcpy(p, new, nlen);
201
202 *slen += nlen - olen;
203
204 return p + nlen;
205}
206
Simon Glass00e44192020-11-01 14:15:40 -0700207int setexpr_regex_sub(char *data, uint data_size, char *nbuf, uint nbuf_size,
208 const char *r, const char *s, bool global)
Wolfgang Denkb04ae782013-03-23 23:50:34 +0000209{
210 struct slre slre;
Wolfgang Denkb04ae782013-03-23 23:50:34 +0000211 char *datap = data;
Wolfgang Denkb04ae782013-03-23 23:50:34 +0000212 int res, len, nlen, loop;
213
Wolfgang Denkb04ae782013-03-23 23:50:34 +0000214 if (slre_compile(&slre, r) == 0) {
215 printf("Error compiling regex: %s\n", slre.err_str);
216 return 1;
217 }
218
Simon Glassb8e9f2d2020-11-01 14:15:39 -0700219 len = strlen(data);
Wolfgang Denkb04ae782013-03-23 23:50:34 +0000220 for (loop = 0;; loop++) {
221 struct cap caps[slre.num_caps + 2];
Wolfgang Denkb04ae782013-03-23 23:50:34 +0000222 const char *old;
223 char *np;
224 int i, olen;
225
226 (void) memset(caps, 0, sizeof(caps));
227
Simon Glass7a114862020-11-01 14:15:42 -0700228 res = slre_match(&slre, datap, len - (datap - data), caps);
Wolfgang Denkb04ae782013-03-23 23:50:34 +0000229
230 debug("Result: %d\n", res);
231
Simon Glass7a114862020-11-01 14:15:42 -0700232 for (i = 0; i <= slre.num_caps; i++) {
Wolfgang Denkb04ae782013-03-23 23:50:34 +0000233 if (caps[i].len > 0) {
234 debug("Substring %d: [%.*s]\n", i,
235 caps[i].len, caps[i].ptr);
236 }
237 }
238
239 if (res == 0) {
240 if (loop == 0) {
Łukasz Stelmach848d73c2023-08-24 08:10:25 +0200241 debug("%s: No match\n", data);
Wolfgang Denkb04ae782013-03-23 23:50:34 +0000242 } else {
Massimiliano Minella847f69c2024-02-08 15:58:27 +0100243 debug("## MATCH ## %s\n", data);
Wolfgang Denkb04ae782013-03-23 23:50:34 +0000244 }
Massimiliano Minella847f69c2024-02-08 15:58:27 +0100245 break;
Wolfgang Denkb04ae782013-03-23 23:50:34 +0000246 }
247
Simon Glassb8e9f2d2020-11-01 14:15:39 -0700248 if (!s)
Wolfgang Denkb04ae782013-03-23 23:50:34 +0000249 return 1;
Wolfgang Denkb04ae782013-03-23 23:50:34 +0000250
251 old = caps[0].ptr;
252 olen = caps[0].len;
Simon Glass28ae25a2020-11-01 14:15:41 -0700253 nlen = strlen(s);
Wolfgang Denkb04ae782013-03-23 23:50:34 +0000254
Simon Glassb8e9f2d2020-11-01 14:15:39 -0700255 if (nlen + 1 >= nbuf_size) {
Wolfgang Denkb04ae782013-03-23 23:50:34 +0000256 printf("## error: pattern buffer overflow: have %d, need %d\n",
Simon Glassb8e9f2d2020-11-01 14:15:39 -0700257 nbuf_size, nlen + 1);
Wolfgang Denkb04ae782013-03-23 23:50:34 +0000258 return 1;
259 }
260 strcpy(nbuf, s);
261
262 debug("## SUBST(1) ## %s\n", nbuf);
263
264 /*
265 * Handle back references
266 *
267 * Support for \0 ... \9, where \0 is the
268 * whole matched pattern (similar to &).
269 *
270 * Implementation is a bit simpleminded as
271 * backrefs are substituted sequentially, one
272 * by one. This will lead to somewhat
273 * unexpected results if the replacement
274 * strings contain any \N strings then then
275 * may get substitued, too. We accept this
276 * restriction for the sake of simplicity.
277 */
278 for (i = 0; i < 10; ++i) {
279 char backref[2] = {
280 '\\',
281 '0',
282 };
283
284 if (caps[i].len == 0)
285 break;
286
287 backref[1] += i;
288
289 debug("## BACKREF %d: replace \"%.*s\" by \"%.*s\" in \"%s\"\n",
290 i,
291 2, backref,
292 caps[i].len, caps[i].ptr,
293 nbuf);
294
295 for (np = nbuf;;) {
296 char *p = memstr(np, nlen, backref, 2);
297
298 if (p == NULL)
299 break;
300
301 np = substitute(np, &nlen,
Simon Glass7a114862020-11-01 14:15:42 -0700302 nbuf_size - (np - nbuf),
Wolfgang Denkb04ae782013-03-23 23:50:34 +0000303 backref, 2,
304 caps[i].ptr, caps[i].len);
305
306 if (np == NULL)
307 return 1;
308 }
309 }
310 debug("## SUBST(2) ## %s\n", nbuf);
311
Simon Glass7a114862020-11-01 14:15:42 -0700312 datap = substitute(datap, &len, data_size - (datap - data),
313 old, olen, nbuf, nlen);
Wolfgang Denkb04ae782013-03-23 23:50:34 +0000314
315 if (datap == NULL)
316 return 1;
317
318 debug("## REMAINDER: %s\n", datap);
319
320 debug("## RESULT: %s\n", data);
321
322 if (!global)
323 break;
324 }
Simon Glass6a38e412017-08-03 12:22:09 -0600325 debug("## FINAL (now env_set()) : %s\n", data);
Wolfgang Denkb04ae782013-03-23 23:50:34 +0000326
Simon Glassb8e9f2d2020-11-01 14:15:39 -0700327 return 0;
328}
329
330#define SLRE_BUFSZ 16384
331#define SLRE_PATSZ 4096
332
333/*
334 * Perform regex operations on a environment variable
335 *
336 * Returns 0 if OK, 1 in case of errors.
337 */
338static int regex_sub_var(const char *name, const char *r, const char *s,
339 const char *t, int global)
340{
341 struct slre slre;
342 char data[SLRE_BUFSZ];
343 char nbuf[SLRE_PATSZ];
344 const char *value;
345 int len;
346 int ret;
347
348 if (!name)
349 return 1;
350
351 if (slre_compile(&slre, r) == 0) {
352 printf("Error compiling regex: %s\n", slre.err_str);
353 return 1;
354 }
355
356 if (!t) {
357 value = env_get(name);
358 if (!value) {
359 printf("## Error: variable \"%s\" not defined\n", name);
360 return 1;
361 }
362 t = value;
363 }
364
365 debug("REGEX on %s=%s\n", name, t);
366 debug("REGEX=\"%s\", SUBST=\"%s\", GLOBAL=%d\n", r, s ? s : "<NULL>",
367 global);
368
369 len = strlen(t);
370 if (len + 1 > SLRE_BUFSZ) {
371 printf("## error: subst buffer overflow: have %d, need %d\n",
372 SLRE_BUFSZ, len + 1);
373 return 1;
374 }
375
376 strcpy(data, t);
377
Simon Glass00e44192020-11-01 14:15:40 -0700378 ret = setexpr_regex_sub(data, SLRE_BUFSZ, nbuf, SLRE_PATSZ, r, s,
379 global);
Simon Glassb8e9f2d2020-11-01 14:15:39 -0700380 if (ret)
381 return 1;
382
Łukasz Stelmach848d73c2023-08-24 08:10:25 +0200383 debug("%s=%s\n", name, data);
Wolfgang Denkb04ae782013-03-23 23:50:34 +0000384
Simon Glass6a38e412017-08-03 12:22:09 -0600385 return env_set(name, data);
Wolfgang Denkb04ae782013-03-23 23:50:34 +0000386}
387#endif
388
Simon Glassed38aef2020-05-10 11:40:03 -0600389static int do_setexpr(struct cmd_tbl *cmdtp, int flag, int argc,
390 char *const argv[])
Kumar Galaaed83342008-02-14 20:44:42 -0600391{
Simon Glass00547af2020-11-01 14:15:43 -0700392 struct expr_arg aval, bval;
Simon Glass103789d2013-02-24 17:33:22 +0000393 ulong value;
Simon Glass580a7a52020-11-01 14:15:44 -0700394 int ret = 0;
Frans Meulenbroeks2347d4e2010-02-26 14:00:19 +0100395 int w;
Kumar Galaaed83342008-02-14 20:44:42 -0600396
Wolfgang Denkb04ae782013-03-23 23:50:34 +0000397 /*
Roland Gaudig2c9e7c22021-07-23 12:29:21 +0000398 * We take 3, 5, or 6 arguments, except fmt operation, which
399 * takes 4 to 8 arguments (limited by _maxargs):
Wolfgang Denkb04ae782013-03-23 23:50:34 +0000400 * 3 : setexpr name value
401 * 5 : setexpr name val1 op val2
402 * setexpr name [g]sub r s
403 * 6 : setexpr name [g]sub r s t
Roland Gaudig2c9e7c22021-07-23 12:29:21 +0000404 * setexpr name fmt format [val1] [val2] [val3] [val4]
Wolfgang Denkb04ae782013-03-23 23:50:34 +0000405 */
406
Roland Gaudig2c9e7c22021-07-23 12:29:21 +0000407 if (argc < 3)
Simon Glassa06dfc72011-12-10 08:44:01 +0000408 return CMD_RET_USAGE;
Kumar Galaaed83342008-02-14 20:44:42 -0600409
Frans Meulenbroeks2347d4e2010-02-26 14:00:19 +0100410 w = cmd_get_data_size(argv[0], 4);
411
Simon Glass00547af2020-11-01 14:15:43 -0700412 if (get_arg(argv[2], w, &aval))
413 return CMD_RET_FAILURE;
Joe Hershberger0e640e62012-11-01 16:21:14 +0000414
Roland Gaudig2c9e7c22021-07-23 12:29:21 +0000415 /* format string assignment: "setexpr name fmt %d value" */
416 if (strcmp(argv[2], "fmt") == 0 && IS_ENABLED(CONFIG_CMD_SETEXPR_FMT)) {
417 char str[MAX_STR_LEN];
418 int result;
419
420 if (argc == 3)
421 return CMD_RET_USAGE;
422
423 result = printf_setexpr(str, sizeof(str), argc - 3, &argv[3]);
424 if (result)
425 return result;
426
427 return env_set(argv[1], str);
428 }
429
430 if (argc == 4 || argc > 6)
431 return CMD_RET_USAGE;
432
Wolfgang Denkb2234d62013-03-23 23:50:33 +0000433 /* plain assignment: "setexpr name value" */
Simon Glass580a7a52020-11-01 14:15:44 -0700434 if (argc == 3) {
435 if (w == CMD_DATA_SIZE_STR) {
436 ret = env_set(argv[1], aval.sval);
437 free(aval.sval);
438 } else {
439 ret = env_set_hex(argv[1], aval.ival);
440 }
441
442 return ret;
443 }
Joe Hershberger0e640e62012-11-01 16:21:14 +0000444
Wolfgang Denkb04ae782013-03-23 23:50:34 +0000445 /* 5 or 6 args (6 args only with [g]sub) */
446#ifdef CONFIG_REGEX
447 /*
448 * rexep handling: "setexpr name [g]sub r s [t]"
449 * with 5 args, "t" will be NULL
450 */
451 if (strcmp(argv[2], "gsub") == 0)
Simon Glassb8e9f2d2020-11-01 14:15:39 -0700452 return regex_sub_var(argv[1], argv[3], argv[4], argv[5], 1);
Wolfgang Denkb04ae782013-03-23 23:50:34 +0000453
454 if (strcmp(argv[2], "sub") == 0)
Simon Glassb8e9f2d2020-11-01 14:15:39 -0700455 return regex_sub_var(argv[1], argv[3], argv[4], argv[5], 0);
Wolfgang Denkb04ae782013-03-23 23:50:34 +0000456#endif
457
Wolfgang Denkb2234d62013-03-23 23:50:33 +0000458 /* standard operators: "setexpr name val1 op val2" */
459 if (argc != 5)
460 return CMD_RET_USAGE;
461
462 if (strlen(argv[3]) != 1)
463 return CMD_RET_USAGE;
464
Simon Glass580a7a52020-11-01 14:15:44 -0700465 if (get_arg(argv[4], w, &bval)) {
466 if (w == CMD_DATA_SIZE_STR)
467 free(aval.sval);
Simon Glass00547af2020-11-01 14:15:43 -0700468 return CMD_RET_FAILURE;
Simon Glass580a7a52020-11-01 14:15:44 -0700469 }
Kumar Galaaed83342008-02-14 20:44:42 -0600470
Simon Glass580a7a52020-11-01 14:15:44 -0700471 if (w == CMD_DATA_SIZE_STR) {
472 int len;
473 char *str;
474
475 switch (argv[3][0]) {
476 case '+':
477 len = strlen(aval.sval) + strlen(bval.sval) + 1;
478 str = malloc(len);
479 if (!str) {
480 printf("Out of memory\n");
481 ret = CMD_RET_FAILURE;
482 } else {
483 /* These were copied out and checked earlier */
484 strcpy(str, aval.sval);
485 strcat(str, bval.sval);
486 ret = env_set(argv[1], str);
487 if (ret)
488 printf("Could not set var\n");
489 free(str);
490 }
491 break;
492 default:
493 printf("invalid op\n");
494 ret = 1;
495 }
496 } else {
Simon Glass00547af2020-11-01 14:15:43 -0700497 ulong a = aval.ival;
498 ulong b = bval.ival;
Kumar Galaaed83342008-02-14 20:44:42 -0600499
Simon Glass00547af2020-11-01 14:15:43 -0700500 switch (argv[3][0]) {
501 case '|':
502 value = a | b;
503 break;
504 case '&':
505 value = a & b;
506 break;
507 case '+':
508 value = a + b;
509 break;
510 case '^':
511 value = a ^ b;
512 break;
513 case '-':
514 value = a - b;
515 break;
516 case '*':
517 value = a * b;
518 break;
519 case '/':
520 value = a / b;
521 break;
522 case '%':
523 value = a % b;
524 break;
525 default:
526 printf("invalid op\n");
527 return 1;
528 }
529
530 env_set_hex(argv[1], value);
531 }
Kumar Galaaed83342008-02-14 20:44:42 -0600532
Simon Glass580a7a52020-11-01 14:15:44 -0700533 if (w == CMD_DATA_SIZE_STR) {
534 free(aval.sval);
535 free(bval.sval);
536 }
537
538 return ret;
Kumar Galaaed83342008-02-14 20:44:42 -0600539}
540
541U_BOOT_CMD(
Roland Gaudig2c9e7c22021-07-23 12:29:21 +0000542 setexpr, 8, 0, do_setexpr,
Peter Tyserdfb72b82009-01-27 18:03:12 -0600543 "set environment variable as the result of eval expression",
Simon Glass580a7a52020-11-01 14:15:44 -0700544 "[.b, .w, .l, .s] name [*]value1 <op> [*]value2\n"
Kumar Galaaed83342008-02-14 20:44:42 -0600545 " - set environment variable 'name' to the result of the evaluated\n"
Wolfgang Denkb04ae782013-03-23 23:50:34 +0000546 " expression specified by <op>. <op> can be &, |, ^, +, -, *, /, %\n"
Simon Glass580a7a52020-11-01 14:15:44 -0700547 " (for strings only + is supported)\n"
Joe Hershberger0e640e62012-11-01 16:21:14 +0000548 " size argument is only meaningful if value1 and/or value2 are\n"
549 " memory addresses (*)\n"
Wolfgang Denkb2234d62013-03-23 23:50:33 +0000550 "setexpr[.b, .w, .l] name [*]value\n"
551 " - load a value into a variable"
Roland Gaudig2c9e7c22021-07-23 12:29:21 +0000552#ifdef CONFIG_CMD_SETEXPR_FMT
553 "\n"
554 "setexpr name fmt <format> [value1] [value2] [value3] [value4]\n"
555 " - set environment variable 'name' to the result of the bash like\n"
556 " format string evaluation of value."
557#endif
Wolfgang Denkb04ae782013-03-23 23:50:34 +0000558#ifdef CONFIG_REGEX
559 "\n"
560 "setexpr name gsub r s [t]\n"
561 " - For each substring matching the regular expression <r> in the\n"
562 " string <t>, substitute the string <s>. The result is\n"
563 " assigned to <name>. If <t> is not supplied, use the old\n"
Massimiliano Minella847f69c2024-02-08 15:58:27 +0100564 " value of <name>. If no substring matching <r> is found in <t>,\n"
565 " assign <t> to <name>.\n"
Wolfgang Denkb04ae782013-03-23 23:50:34 +0000566 "setexpr name sub r s [t]\n"
567 " - Just like gsub(), but replace only the first matching substring"
568#endif
Kumar Galaaed83342008-02-14 20:44:42 -0600569);