lib/vsprintf.c

   1 /*
   2  *  linux/lib/vsprintf.c
   3  *
   4  *  Copyright (C) 1991, 1992  Linus Torvalds
   5  */
   6
   7 /* vsprintf.c -- Lars Wirzenius & Linus Torvalds. */
   8 /*
   9  * Wirzenius wrote this portably, Torvalds fucked it up :-)
  10  *
  11  * from hush: simple_itoa() was lifted from boa-0.93.15
  12  */
  13
  14 #include <common.h>
  15 #include <charset.h>
  16 #include <efi_loader.h>
  17 #include <div64.h>
  18 #include <hexdump.h>
  19 #include <uuid.h>
  20 #include <stdarg.h>
  21 #include <linux/ctype.h>
  22 #include <linux/err.h>
  23 #include <linux/types.h>
  24 #include <linux/string.h>
  25
  26 #define noinline __attribute__((noinline))
  27
  28 /* we use this so that we can do without the ctype library */
  29 #define is_digit(c)     ((c) >= '0' && (c) <= '9')
  30
  31 static int skip_atoi(const char **s)
  32 {
  33         int i = 0;
  34
  35         while (is_digit(**s))
  36                 i = i * 10 + *((*s)++) - '0';
  37
  38         return i;
  39 }
  40
  41 /* Decimal conversion is by far the most typical, and is used
  42  * for /proc and /sys data. This directly impacts e.g. top performance
  43  * with many processes running. We optimize it for speed
  44  * using code from
  45  * http://www.cs.uiowa.edu/~jones/bcd/decimal.html
  46  * (with permission from the author, Douglas W. Jones). */
  47
  48 /* Formats correctly any integer in [0,99999].
  49  * Outputs from one to five digits depending on input.
  50  * On i386 gcc 4.1.2 -O2: ~250 bytes of code. */
  51 static char *put_dec_trunc(char *buf, unsigned q)
  52 {
  53         unsigned d3, d2, d1, d0;
  54         d1 = (q>>4) & 0xf;
  55         d2 = (q>>8) & 0xf;
  56         d3 = (q>>12);
  57
  58         d0 = 6*(d3 + d2 + d1) + (q & 0xf);
  59         q = (d0 * 0xcd) >> 11;
  60         d0 = d0 - 10*q;
  61         *buf++ = d0 + '0'; /* least significant digit */
  62         d1 = q + 9*d3 + 5*d2 + d1;
  63         if (d1 != 0) {
  64                 q = (d1 * 0xcd) >> 11;
  65                 d1 = d1 - 10*q;
  66                 *buf++ = d1 + '0'; /* next digit */
  67
  68                 d2 = q + 2*d2;
  69                 if ((d2 != 0) || (d3 != 0)) {
  70                         q = (d2 * 0xd) >> 7;
  71                         d2 = d2 - 10*q;
  72                         *buf++ = d2 + '0'; /* next digit */
  73
  74                         d3 = q + 4*d3;
  75                         if (d3 != 0) {
  76                                 q = (d3 * 0xcd) >> 11;
  77                                 d3 = d3 - 10*q;
  78                                 *buf++ = d3 + '0';  /* next digit */
  79                                 if (q != 0)
  80                                         *buf++ = q + '0'; /* most sign. digit */
  81                         }
  82                 }
  83         }
  84         return buf;
  85 }
  86 /* Same with if's removed. Always emits five digits */
  87 static char *put_dec_full(char *buf, unsigned q)
  88 {
  89         /* BTW, if q is in [0,9999], 8-bit ints will be enough, */
  90         /* but anyway, gcc produces better code with full-sized ints */
  91         unsigned d3, d2, d1, d0;
  92         d1 = (q>>4) & 0xf;
  93         d2 = (q>>8) & 0xf;
  94         d3 = (q>>12);
  95
  96         /*
  97          * Possible ways to approx. divide by 10
  98          * gcc -O2 replaces multiply with shifts and adds
  99          * (x * 0xcd) >> 11: 11001101 - shorter code than * 0x67 (on i386)
 100          * (x * 0x67) >> 10:  1100111
 101          * (x * 0x34) >> 9:    110100 - same
 102          * (x * 0x1a) >> 8:     11010 - same
 103          * (x * 0x0d) >> 7:      1101 - same, shortest code (on i386)
 104          */
 105
 106         d0 = 6*(d3 + d2 + d1) + (q & 0xf);
 107         q = (d0 * 0xcd) >> 11;
 108         d0 = d0 - 10*q;
 109         *buf++ = d0 + '0';
 110         d1 = q + 9*d3 + 5*d2 + d1;
 111                 q = (d1 * 0xcd) >> 11;
 112                 d1 = d1 - 10*q;
 113                 *buf++ = d1 + '0';
 114
 115                 d2 = q + 2*d2;
 116                         q = (d2 * 0xd) >> 7;
 117                         d2 = d2 - 10*q;
 118                         *buf++ = d2 + '0';
 119
 120                         d3 = q + 4*d3;
 121                                 q = (d3 * 0xcd) >> 11; /* - shorter code */
 122                                 /* q = (d3 * 0x67) >> 10; - would also work */
 123                                 d3 = d3 - 10*q;
 124                                 *buf++ = d3 + '0';
 125                                         *buf++ = q + '0';
 126         return buf;
 127 }
 128 /* No inlining helps gcc to use registers better */
 129 static noinline char *put_dec(char *buf, uint64_t num)
 130 {
 131         while (1) {
 132                 unsigned rem;
 133                 if (num < 100000)
 134                         return put_dec_trunc(buf, num);
 135                 rem = do_div(num, 100000);
 136                 buf = put_dec_full(buf, rem);
 137         }
 138 }
 139
 140 #define ZEROPAD 1               /* pad with zero */
 141 #define SIGN    2               /* unsigned/signed long */
 142 #define PLUS    4               /* show plus */
 143 #define SPACE   8               /* space if plus */
 144 #define LEFT    16              /* left justified */
 145 #define SMALL   32              /* Must be 32 == 0x20 */
 146 #define SPECIAL 64              /* 0x */
 147
 148 /*
 149  * Macro to add a new character to our output string, but only if it will
 150  * fit. The macro moves to the next character position in the output string.
 151  */
 152 #define ADDCH(str, ch) do { \
 153         if ((str) < end) \
 154                 *(str) = (ch); \
 155         ++str; \
 156         } while (0)
 157
 158 static char *number(char *buf, char *end, u64 num,
 159                 int base, int size, int precision, int type)
 160 {
 161         /* we are called with base 8, 10 or 16, only, thus don't need "G..."  */
 162         static const char digits[16] = "0123456789ABCDEF";
 163
 164         char tmp[66];
 165         char sign;
 166         char locase;
 167         int need_pfx = ((type & SPECIAL) && base != 10);
 168         int i;
 169
 170         /* locase = 0 or 0x20. ORing digits or letters with 'locase'
 171          * produces same digits or (maybe lowercased) letters */
 172         locase = (type & SMALL);
 173         if (type & LEFT)
 174                 type &= ~ZEROPAD;
 175         sign = 0;
 176         if (type & SIGN) {
 177                 if ((s64) num < 0) {
 178                         sign = '-';
 179                         num = -(s64) num;
 180                         size--;
 181                 } else if (type & PLUS) {
 182                         sign = '+';
 183                         size--;
 184                 } else if (type & SPACE) {
 185                         sign = ' ';
 186                         size--;
 187                 }
 188         }
 189         if (need_pfx) {
 190                 size--;
 191                 if (base == 16)
 192                         size--;
 193         }
 194
 195         /* generate full string in tmp[], in reverse order */
 196         i = 0;
 197         if (num == 0)
 198                 tmp[i++] = '0';
 199         /* Generic code, for any base:
 200         else do {
 201                 tmp[i++] = (digits[do_div(num,base)] | locase);
 202         } while (num != 0);
 203         */
 204         else if (base != 10) { /* 8 or 16 */
 205                 int mask = base - 1;
 206                 int shift = 3;
 207
 208                 if (base == 16)
 209                         shift = 4;
 210
 211                 do {
 212                         tmp[i++] = (digits[((unsigned char)num) & mask]
 213                                         | locase);
 214                         num >>= shift;
 215                 } while (num);
 216         } else { /* base 10 */
 217                 i = put_dec(tmp, num) - tmp;
 218         }
 219
 220         /* printing 100 using %2d gives "100", not "00" */
 221         if (i > precision)
 222                 precision = i;
 223         /* leading space padding */
 224         size -= precision;
 225         if (!(type & (ZEROPAD + LEFT))) {
 226                 while (--size >= 0)
 227                         ADDCH(buf, ' ');
 228         }
 229         /* sign */
 230         if (sign)
 231                 ADDCH(buf, sign);
 232         /* "0x" / "0" prefix */
 233         if (need_pfx) {
 234                 ADDCH(buf, '0');
 235                 if (base == 16)
 236                         ADDCH(buf, 'X' | locase);
 237         }
 238         /* zero or space padding */
 239         if (!(type & LEFT)) {
 240                 char c = (type & ZEROPAD) ? '0' : ' ';
 241
 242                 while (--size >= 0)
 243                         ADDCH(buf, c);
 244         }
 245         /* hmm even more zero padding? */
 246         while (i <= --precision)
 247                 ADDCH(buf, '0');
 248         /* actual digits of result */
 249         while (--i >= 0)
 250                 ADDCH(buf, tmp[i]);
 251         /* trailing space padding */
 252         while (--size >= 0)
 253                 ADDCH(buf, ' ');
 254         return buf;
 255 }
 256
 257 static char *string(char *buf, char *end, char *s, int field_width,
 258                 int precision, int flags)
 259 {
 260         int len, i;
 261
 262         if (s == NULL)
 263                 s = "<NULL>";
 264
 265         len = strnlen(s, precision);
 266
 267         if (!(flags & LEFT))
 268                 while (len < field_width--)
 269                         ADDCH(buf, ' ');
 270         for (i = 0; i < len; ++i)
 271                 ADDCH(buf, *s++);
 272         while (len < field_width--)
 273                 ADDCH(buf, ' ');
 274         return buf;
 275 }
 276
 277 /* U-Boot uses UTF-16 strings in the EFI context only. */
 278 #if CONFIG_IS_ENABLED(EFI_LOADER) && !defined(API_BUILD)
 279 static char *string16(char *buf, char *end, u16 *s, int field_width,
 280                 int precision, int flags)
 281 {
 282         const u16 *str = s ? s : L"<NULL>";
 283         ssize_t i, len = utf16_strnlen(str, precision);
 284
 285         if (!(flags & LEFT))
 286                 for (; len < field_width; --field_width)
 287                         ADDCH(buf, ' ');
 288         for (i = 0; i < len && buf + utf16_utf8_strnlen(str, 1) <= end; ++i) {
 289                 s32 s = utf16_get(&str);
 290
 291                 utf8_put(s, &buf);
 292         }
 293         for (; len < field_width; --field_width)
 294                 ADDCH(buf, ' ');
 295         return buf;
 296 }
 297
 298 static char *device_path_string(char *buf, char *end, void *dp, int field_width,
 299                                 int precision, int flags)
 300 {
 301         u16 *str;
 302
 303         /* If dp == NULL output the string '<NULL>' */
 304         if (!dp)
 305                 return string16(buf, end, dp, field_width, precision, flags);
 306
 307         str = efi_dp_str((struct efi_device_path *)dp);
 308         if (!str)
 309                 return ERR_PTR(-ENOMEM);
 310
 311         buf = string16(buf, end, str, field_width, precision, flags);
 312         efi_free_pool(str);
 313         return buf;
 314 }
 315 #endif
 316
 317 #ifdef CONFIG_CMD_NET
 318 static char *mac_address_string(char *buf, char *end, u8 *addr, int field_width,
 319                                 int precision, int flags)
 320 {
 321         /* (6 * 2 hex digits), 5 colons and trailing zero */
 322         char mac_addr[6 * 3];
 323         char *p = mac_addr;
 324         int i;
 325
 326         for (i = 0; i < 6; i++) {
 327                 p = hex_byte_pack(p, addr[i]);
 328                 if (!(flags & SPECIAL) && i != 5)
 329                         *p++ = ':';
 330         }
 331         *p = '\0';
 332
 333         return string(buf, end, mac_addr, field_width, precision,
 334                       flags & ~SPECIAL);
 335 }
 336
 337 static char *ip6_addr_string(char *buf, char *end, u8 *addr, int field_width,
 338                          int precision, int flags)
 339 {
 340         /* (8 * 4 hex digits), 7 colons and trailing zero */
 341         char ip6_addr[8 * 5];
 342         char *p = ip6_addr;
 343         int i;
 344
 345         for (i = 0; i < 8; i++) {
 346                 p = hex_byte_pack(p, addr[2 * i]);
 347                 p = hex_byte_pack(p, addr[2 * i + 1]);
 348                 if (!(flags & SPECIAL) && i != 7)
 349                         *p++ = ':';
 350         }
 351         *p = '\0';
 352
 353         return string(buf, end, ip6_addr, field_width, precision,
 354                       flags & ~SPECIAL);
 355 }
 356
 357 static char *ip4_addr_string(char *buf, char *end, u8 *addr, int field_width,
 358                          int precision, int flags)
 359 {
 360         /* (4 * 3 decimal digits), 3 dots and trailing zero */
 361         char ip4_addr[4 * 4];
 362         char temp[3];   /* hold each IP quad in reverse order */
 363         char *p = ip4_addr;
 364         int i, digits;
 365
 366         for (i = 0; i < 4; i++) {
 367                 digits = put_dec_trunc(temp, addr[i]) - temp;
 368                 /* reverse the digits in the quad */
 369                 while (digits--)
 370                         *p++ = temp[digits];
 371                 if (i != 3)
 372                         *p++ = '.';
 373         }
 374         *p = '\0';
 375
 376         return string(buf, end, ip4_addr, field_width, precision,
 377                       flags & ~SPECIAL);
 378 }
 379 #endif
 380
 381 #ifdef CONFIG_LIB_UUID
 382 /*
 383  * This works (roughly) the same way as linux's, but we currently always
 384  * print lower-case (ie. we just keep %pUB and %pUL for compat with linux),
 385  * mostly just because that is what uuid_bin_to_str() supports.
 386  *
 387  *   %pUb:   01020304-0506-0708-090a-0b0c0d0e0f10
 388  *   %pUl:   04030201-0605-0807-090a-0b0c0d0e0f10
 389  */
 390 static char *uuid_string(char *buf, char *end, u8 *addr, int field_width,
 391                          int precision, int flags, const char *fmt)
 392 {
 393         char uuid[UUID_STR_LEN + 1];
 394         int str_format = UUID_STR_FORMAT_STD;
 395
 396         switch (*(++fmt)) {
 397         case 'L':
 398         case 'l':
 399                 str_format = UUID_STR_FORMAT_GUID;
 400                 break;
 401         case 'B':
 402         case 'b':
 403                 /* this is the default */
 404                 break;
 405         default:
 406                 break;
 407         }
 408
 409         if (addr)
 410                 uuid_bin_to_str(addr, uuid, str_format);
 411         else
 412                 strcpy(uuid, "<NULL>");
 413
 414         return string(buf, end, uuid, field_width, precision, flags);
 415 }
 416 #endif
 417
 418 /*
 419  * Show a '%p' thing.  A kernel extension is that the '%p' is followed
 420  * by an extra set of alphanumeric characters that are extended format
 421  * specifiers.
 422  *
 423  * Right now we handle:
 424  *
 425  * - 'M' For a 6-byte MAC address, it prints the address in the
 426  *       usual colon-separated hex notation
 427  * - 'I' [46] for IPv4/IPv6 addresses printed in the usual way (dot-separated
 428  *       decimal for v4 and colon separated network-order 16 bit hex for v6)
 429  * - 'i' [46] for 'raw' IPv4/IPv6 addresses, IPv6 omits the colons, IPv4 is
 430  *       currently the same
 431  *
 432  * Note: The difference between 'S' and 'F' is that on ia64 and ppc64
 433  * function pointers are really function descriptors, which contain a
 434  * pointer to the real address.
 435  */
 436 static char *pointer(const char *fmt, char *buf, char *end, void *ptr,
 437                 int field_width, int precision, int flags)
 438 {
 439         u64 num = (uintptr_t)ptr;
 440
 441         /*
 442          * Being a boot loader, we explicitly allow pointers to
 443          * (physical) address null.
 444          */
 445 #if 0
 446         if (!ptr)
 447                 return string(buf, end, "(null)", field_width, precision,
 448                               flags);
 449 #endif
 450
 451         switch (*fmt) {
 452 /* Device paths only exist in the EFI context. */
 453 #if CONFIG_IS_ENABLED(EFI_LOADER) && !defined(API_BUILD)
 454         case 'D':
 455                 return device_path_string(buf, end, ptr, field_width,
 456                                           precision, flags);
 457 #endif
 458 #ifdef CONFIG_CMD_NET
 459         case 'a':
 460                 flags |= SPECIAL | ZEROPAD;
 461
 462                 switch (fmt[1]) {
 463                 case 'p':
 464                 default:
 465                         field_width = sizeof(phys_addr_t) * 2 + 2;
 466                         num = *(phys_addr_t *)ptr;
 467                         break;
 468                 }
 469                 break;
 470         case 'm':
 471                 flags |= SPECIAL;
 472                 /* Fallthrough */
 473         case 'M':
 474                 return mac_address_string(buf, end, ptr, field_width,
 475                                           precision, flags);
 476         case 'i':
 477                 flags |= SPECIAL;
 478                 /* Fallthrough */
 479         case 'I':
 480                 if (fmt[1] == '6')
 481                         return ip6_addr_string(buf, end, ptr, field_width,
 482                                                precision, flags);
 483                 if (fmt[1] == '4')
 484                         return ip4_addr_string(buf, end, ptr, field_width,
 485                                                precision, flags);
 486                 flags &= ~SPECIAL;
 487                 break;
 488 #endif
 489 #ifdef CONFIG_LIB_UUID
 490         case 'U':
 491                 return uuid_string(buf, end, ptr, field_width, precision,
 492                                    flags, fmt);
 493 #endif
 494         default:
 495                 break;
 496         }
 497         flags |= SMALL;
 498         if (field_width == -1) {
 499                 field_width = 2*sizeof(void *);
 500                 flags |= ZEROPAD;
 501         }
 502         return number(buf, end, num, 16, field_width, precision, flags);
 503 }
 504
 505 static int vsnprintf_internal(char *buf, size_t size, const char *fmt,
 506                               va_list args)
 507 {
 508         u64 num;
 509         int base;
 510         char *str;
 511
 512         int flags;              /* flags to number() */
 513
 514         int field_width;        /* width of output field */
 515         int precision;          /* min. # of digits for integers; max
 516                                    number of chars for from string */
 517         int qualifier;          /* 'h', 'l', or 'L' for integer fields */
 518                                 /* 'z' support added 23/7/1999 S.H.    */
 519                                 /* 'z' changed to 'Z' --davidm 1/25/99 */
 520                                 /* 't' added for ptrdiff_t */
 521         char *end = buf + size;
 522
 523         /* Make sure end is always >= buf - do we want this in U-Boot? */
 524         if (end < buf) {
 525                 end = ((void *)-1);
 526                 size = end - buf;
 527         }
 528         str = buf;
 529
 530         for (; *fmt ; ++fmt) {
 531                 if (*fmt != '%') {
 532                         ADDCH(str, *fmt);
 533                         continue;
 534                 }
 535
 536                 /* process flags */
 537                 flags = 0;
 538 repeat:
 539                         ++fmt;          /* this also skips first '%' */
 540                         switch (*fmt) {
 541                         case '-':
 542                                 flags |= LEFT;
 543                                 goto repeat;
 544                         case '+':
 545                                 flags |= PLUS;
 546                                 goto repeat;
 547                         case ' ':
 548                                 flags |= SPACE;
 549                                 goto repeat;
 550                         case '#':
 551                                 flags |= SPECIAL;
 552                                 goto repeat;
 553                         case '0':
 554                                 flags |= ZEROPAD;
 555                                 goto repeat;
 556                         }
 557
 558                 /* get field width */
 559                 field_width = -1;
 560                 if (is_digit(*fmt))
 561                         field_width = skip_atoi(&fmt);
 562                 else if (*fmt == '*') {
 563                         ++fmt;
 564                         /* it's the next argument */
 565                         field_width = va_arg(args, int);
 566                         if (field_width < 0) {
 567                                 field_width = -field_width;
 568                                 flags |= LEFT;
 569                         }
 570                 }
 571
 572                 /* get the precision */
 573                 precision = -1;
 574                 if (*fmt == '.') {
 575                         ++fmt;
 576                         if (is_digit(*fmt))
 577                                 precision = skip_atoi(&fmt);
 578                         else if (*fmt == '*') {
 579                                 ++fmt;
 580                                 /* it's the next argument */
 581                                 precision = va_arg(args, int);
 582                         }
 583                         if (precision < 0)
 584                                 precision = 0;
 585                 }
 586
 587                 /* get the conversion qualifier */
 588                 qualifier = -1;
 589                 if (*fmt == 'h' || *fmt == 'l' || *fmt == 'L' ||
 590                     *fmt == 'Z' || *fmt == 'z' || *fmt == 't') {
 591                         qualifier = *fmt;
 592                         ++fmt;
 593                         if (qualifier == 'l' && *fmt == 'l') {
 594                                 qualifier = 'L';
 595                                 ++fmt;
 596                         }
 597                 }
 598
 599                 /* default base */
 600                 base = 10;
 601
 602                 switch (*fmt) {
 603                 case 'c':
 604                         if (!(flags & LEFT)) {
 605                                 while (--field_width > 0)
 606                                         ADDCH(str, ' ');
 607                         }
 608                         ADDCH(str, (unsigned char) va_arg(args, int));
 609                         while (--field_width > 0)
 610                                 ADDCH(str, ' ');
 611                         continue;
 612
 613                 case 's':
 614 /* U-Boot uses UTF-16 strings in the EFI context only. */
 615 #if CONFIG_IS_ENABLED(EFI_LOADER) && !defined(API_BUILD)
 616                         if (qualifier == 'l') {
 617                                 str = string16(str, end, va_arg(args, u16 *),
 618                                                field_width, precision, flags);
 619                         } else
 620 #endif
 621                         {
 622                                 str = string(str, end, va_arg(args, char *),
 623                                              field_width, precision, flags);
 624                         }
 625                         continue;
 626
 627                 case 'p':
 628                         str = pointer(fmt + 1, str, end,
 629                                         va_arg(args, void *),
 630                                         field_width, precision, flags);
 631                         if (IS_ERR(str))
 632                                 return PTR_ERR(str);
 633                         /* Skip all alphanumeric pointer suffixes */
 634                         while (isalnum(fmt[1]))
 635                                 fmt++;
 636                         continue;
 637
 638                 case 'n':
 639                         if (qualifier == 'l') {
 640                                 long *ip = va_arg(args, long *);
 641                                 *ip = (str - buf);
 642                         } else {
 643                                 int *ip = va_arg(args, int *);
 644                                 *ip = (str - buf);
 645                         }
 646                         continue;
 647
 648                 case '%':
 649                         ADDCH(str, '%');
 650                         continue;
 651
 652                 /* integer number formats - set up the flags and "break" */
 653                 case 'o':
 654                         base = 8;
 655                         break;
 656
 657                 case 'x':
 658                         flags |= SMALL;
 659                 case 'X':
 660                         base = 16;
 661                         break;
 662
 663                 case 'd':
 664                 case 'i':
 665                         flags |= SIGN;
 666                 case 'u':
 667                         break;
 668
 669                 default:
 670                         ADDCH(str, '%');
 671                         if (*fmt)
 672                                 ADDCH(str, *fmt);
 673                         else
 674                                 --fmt;
 675                         continue;
 676                 }
 677                 if (qualifier == 'L')  /* "quad" for 64 bit variables */
 678                         num = va_arg(args, unsigned long long);
 679                 else if (qualifier == 'l') {
 680                         num = va_arg(args, unsigned long);
 681                         if (flags & SIGN)
 682                                 num = (signed long) num;
 683                 } else if (qualifier == 'Z' || qualifier == 'z') {
 684                         num = va_arg(args, size_t);
 685                 } else if (qualifier == 't') {
 686                         num = va_arg(args, ptrdiff_t);
 687                 } else if (qualifier == 'h') {
 688                         num = (unsigned short) va_arg(args, int);
 689                         if (flags & SIGN)
 690                                 num = (signed short) num;
 691                 } else {
 692                         num = va_arg(args, unsigned int);
 693                         if (flags & SIGN)
 694                                 num = (signed int) num;
 695                 }
 696                 str = number(str, end, num, base, field_width, precision,
 697                              flags);
 698         }
 699
 700         if (size > 0) {
 701                 ADDCH(str, '\0');
 702                 if (str > end)
 703                         end[-1] = '\0';
 704                 --str;
 705         }
 706         /* the trailing null byte doesn't count towards the total */
 707         return str - buf;
 708 }
 709
 710 int vsnprintf(char *buf, size_t size, const char *fmt,
 711                               va_list args)
 712 {
 713         return vsnprintf_internal(buf, size, fmt, args);
 714 }
 715
 716 int vscnprintf(char *buf, size_t size, const char *fmt, va_list args)
 717 {
 718         int i;
 719
 720         i = vsnprintf(buf, size, fmt, args);
 721
 722         if (likely(i < size))
 723                 return i;
 724         if (size != 0)
 725                 return size - 1;
 726         return 0;
 727 }
 728
 729 int snprintf(char *buf, size_t size, const char *fmt, ...)
 730 {
 731         va_list args;
 732         int i;
 733
 734         va_start(args, fmt);
 735         i = vsnprintf(buf, size, fmt, args);
 736         va_end(args);
 737
 738         return i;
 739 }
 740
 741 int scnprintf(char *buf, size_t size, const char *fmt, ...)
 742 {
 743         va_list args;
 744         int i;
 745
 746         va_start(args, fmt);
 747         i = vscnprintf(buf, size, fmt, args);
 748         va_end(args);
 749
 750         return i;
 751 }
 752
 753 /**
 754  * Format a string and place it in a buffer (va_list version)
 755  *
 756  * @param buf   The buffer to place the result into
 757  * @param fmt   The format string to use
 758  * @param args  Arguments for the format string
 759  *
 760  * The function returns the number of characters written
 761  * into @buf. Use vsnprintf() or vscnprintf() in order to avoid
 762  * buffer overflows.
 763  *
 764  * If you're not already dealing with a va_list consider using sprintf().
 765  */
 766 int vsprintf(char *buf, const char *fmt, va_list args)
 767 {
 768         return vsnprintf_internal(buf, INT_MAX, fmt, args);
 769 }
 770
 771 int sprintf(char *buf, const char *fmt, ...)
 772 {
 773         va_list args;
 774         int i;
 775
 776         va_start(args, fmt);
 777         i = vsprintf(buf, fmt, args);
 778         va_end(args);
 779         return i;
 780 }
 781
 782 #if CONFIG_IS_ENABLED(PRINTF)
 783 int printf(const char *fmt, ...)
 784 {
 785         va_list args;
 786         uint i;
 787         char printbuffer[CONFIG_SYS_PBSIZE];
 788
 789         va_start(args, fmt);
 790
 791         /*
 792          * For this to work, printbuffer must be larger than
 793          * anything we ever want to print.
 794          */
 795         i = vscnprintf(printbuffer, sizeof(printbuffer), fmt, args);
 796         va_end(args);
 797
 798         /* Handle error */
 799         if (i <= 0)
 800                 return i;
 801         /* Print the string */
 802         puts(printbuffer);
 803         return i;
 804 }
 805
 806 int vprintf(const char *fmt, va_list args)
 807 {
 808         uint i;
 809         char printbuffer[CONFIG_SYS_PBSIZE];
 810
 811         /*
 812          * For this to work, printbuffer must be larger than
 813          * anything we ever want to print.
 814          */
 815         i = vscnprintf(printbuffer, sizeof(printbuffer), fmt, args);
 816
 817         /* Handle error */
 818         if (i <= 0)
 819                 return i;
 820         /* Print the string */
 821         puts(printbuffer);
 822         return i;
 823 }
 824 #endif
 825
 826 char *simple_itoa(ulong i)
 827 {
 828         /* 21 digits plus null terminator, good for 64-bit or smaller ints */
 829         static char local[22];
 830         char *p = &local[21];
 831
 832         *p-- = '\0';
 833         do {
 834                 *p-- = '0' + i % 10;
 835                 i /= 10;
 836         } while (i > 0);
 837         return p + 1;
 838 }
 839
 840 /* We don't seem to have %'d in U-Boot */
 841 void print_grouped_ull(unsigned long long int_val, int digits)
 842 {
 843         char str[21], *s;
 844         int grab = 3;
 845
 846         digits = (digits + 2) / 3;
 847         sprintf(str, "%*llu", digits * 3, int_val);
 848         for (s = str; *s; s += grab) {
 849                 if (s != str)
 850                         putc(s[-1] != ' ' ? ',' : ' ');
 851                 printf("%.*s", grab, s);
 852                 grab = 3;
 853         }
 854 }
 855
 856 bool str2off(const char *p, loff_t *num)
 857 {
 858         char *endptr;
 859
 860         *num = simple_strtoull(p, &endptr, 16);
 861         return *p != '\0' && *endptr == '\0';
 862 }
 863
 864 bool str2long(const char *p, ulong *num)
 865 {
 866         char *endptr;
 867
 868         *num = simple_strtoul(p, &endptr, 16);
 869         return *p != '\0' && *endptr == '\0';
 870 }