qemu

FORK: QEMU emulator
git clone https://git.neptards.moe/neptards/qemu.git
Log | Files | Refs | Submodules | LICENSE

cutils.c (29534B)


      1 /*
      2  * Simple C functions to supplement the C library
      3  *
      4  * Copyright (c) 2006 Fabrice Bellard
      5  *
      6  * Permission is hereby granted, free of charge, to any person obtaining a copy
      7  * of this software and associated documentation files (the "Software"), to deal
      8  * in the Software without restriction, including without limitation the rights
      9  * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
     10  * copies of the Software, and to permit persons to whom the Software is
     11  * furnished to do so, subject to the following conditions:
     12  *
     13  * The above copyright notice and this permission notice shall be included in
     14  * all copies or substantial portions of the Software.
     15  *
     16  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
     17  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
     18  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
     19  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
     20  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
     21  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
     22  * THE SOFTWARE.
     23  */
     24 
     25 #include "qemu/osdep.h"
     26 #include "qemu/host-utils.h"
     27 #include <math.h>
     28 
     29 #ifdef __FreeBSD__
     30 #include <sys/sysctl.h>
     31 #include <sys/user.h>
     32 #endif
     33 
     34 #ifdef __NetBSD__
     35 #include <sys/sysctl.h>
     36 #endif
     37 
     38 #ifdef __HAIKU__
     39 #include <kernel/image.h>
     40 #endif
     41 
     42 #ifdef __APPLE__
     43 #include <mach-o/dyld.h>
     44 #endif
     45 
     46 #ifdef G_OS_WIN32
     47 #include <pathcch.h>
     48 #include <wchar.h>
     49 #endif
     50 
     51 #include "qemu/ctype.h"
     52 #include "qemu/cutils.h"
     53 #include "qemu/error-report.h"
     54 
     55 void strpadcpy(char *buf, int buf_size, const char *str, char pad)
     56 {
     57     int len = qemu_strnlen(str, buf_size);
     58     memcpy(buf, str, len);
     59     memset(buf + len, pad, buf_size - len);
     60 }
     61 
     62 void pstrcpy(char *buf, int buf_size, const char *str)
     63 {
     64     int c;
     65     char *q = buf;
     66 
     67     if (buf_size <= 0)
     68         return;
     69 
     70     for(;;) {
     71         c = *str++;
     72         if (c == 0 || q >= buf + buf_size - 1)
     73             break;
     74         *q++ = c;
     75     }
     76     *q = '\0';
     77 }
     78 
     79 /* strcat and truncate. */
     80 char *pstrcat(char *buf, int buf_size, const char *s)
     81 {
     82     int len;
     83     len = strlen(buf);
     84     if (len < buf_size)
     85         pstrcpy(buf + len, buf_size - len, s);
     86     return buf;
     87 }
     88 
     89 int strstart(const char *str, const char *val, const char **ptr)
     90 {
     91     const char *p, *q;
     92     p = str;
     93     q = val;
     94     while (*q != '\0') {
     95         if (*p != *q)
     96             return 0;
     97         p++;
     98         q++;
     99     }
    100     if (ptr)
    101         *ptr = p;
    102     return 1;
    103 }
    104 
    105 int stristart(const char *str, const char *val, const char **ptr)
    106 {
    107     const char *p, *q;
    108     p = str;
    109     q = val;
    110     while (*q != '\0') {
    111         if (qemu_toupper(*p) != qemu_toupper(*q))
    112             return 0;
    113         p++;
    114         q++;
    115     }
    116     if (ptr)
    117         *ptr = p;
    118     return 1;
    119 }
    120 
    121 /* XXX: use host strnlen if available ? */
    122 int qemu_strnlen(const char *s, int max_len)
    123 {
    124     int i;
    125 
    126     for(i = 0; i < max_len; i++) {
    127         if (s[i] == '\0') {
    128             break;
    129         }
    130     }
    131     return i;
    132 }
    133 
    134 char *qemu_strsep(char **input, const char *delim)
    135 {
    136     char *result = *input;
    137     if (result != NULL) {
    138         char *p;
    139 
    140         for (p = result; *p != '\0'; p++) {
    141             if (strchr(delim, *p)) {
    142                 break;
    143             }
    144         }
    145         if (*p == '\0') {
    146             *input = NULL;
    147         } else {
    148             *p = '\0';
    149             *input = p + 1;
    150         }
    151     }
    152     return result;
    153 }
    154 
    155 time_t mktimegm(struct tm *tm)
    156 {
    157     time_t t;
    158     int y = tm->tm_year + 1900, m = tm->tm_mon + 1, d = tm->tm_mday;
    159     if (m < 3) {
    160         m += 12;
    161         y--;
    162     }
    163     t = 86400ULL * (d + (153 * m - 457) / 5 + 365 * y + y / 4 - y / 100 + 
    164                  y / 400 - 719469);
    165     t += 3600 * tm->tm_hour + 60 * tm->tm_min + tm->tm_sec;
    166     return t;
    167 }
    168 
    169 static int64_t suffix_mul(char suffix, int64_t unit)
    170 {
    171     switch (qemu_toupper(suffix)) {
    172     case 'B':
    173         return 1;
    174     case 'K':
    175         return unit;
    176     case 'M':
    177         return unit * unit;
    178     case 'G':
    179         return unit * unit * unit;
    180     case 'T':
    181         return unit * unit * unit * unit;
    182     case 'P':
    183         return unit * unit * unit * unit * unit;
    184     case 'E':
    185         return unit * unit * unit * unit * unit * unit;
    186     }
    187     return -1;
    188 }
    189 
    190 /*
    191  * Convert size string to bytes.
    192  *
    193  * The size parsing supports the following syntaxes
    194  * - 12345 - decimal, scale determined by @default_suffix and @unit
    195  * - 12345{bBkKmMgGtTpPeE} - decimal, scale determined by suffix and @unit
    196  * - 12345.678{kKmMgGtTpPeE} - decimal, scale determined by suffix, and
    197  *   fractional portion is truncated to byte
    198  * - 0x7fEE - hexadecimal, unit determined by @default_suffix
    199  *
    200  * The following cause a deprecation warning, and may be removed in the future
    201  * - 0xabc{kKmMgGtTpP} - hex with scaling suffix
    202  *
    203  * The following are intentionally not supported
    204  * - octal, such as 08
    205  * - fractional hex, such as 0x1.8
    206  * - floating point exponents, such as 1e3
    207  *
    208  * The end pointer will be returned in *end, if not NULL.  If there is
    209  * no fraction, the input can be decimal or hexadecimal; if there is a
    210  * fraction, then the input must be decimal and there must be a suffix
    211  * (possibly by @default_suffix) larger than Byte, and the fractional
    212  * portion may suffer from precision loss or rounding.  The input must
    213  * be positive.
    214  *
    215  * Return -ERANGE on overflow (with *@end advanced), and -EINVAL on
    216  * other error (with *@end left unchanged).
    217  */
    218 static int do_strtosz(const char *nptr, const char **end,
    219                       const char default_suffix, int64_t unit,
    220                       uint64_t *result)
    221 {
    222     int retval;
    223     const char *endptr, *f;
    224     unsigned char c;
    225     bool hex = false;
    226     uint64_t val, valf = 0;
    227     int64_t mul;
    228 
    229     /* Parse integral portion as decimal. */
    230     retval = qemu_strtou64(nptr, &endptr, 10, &val);
    231     if (retval) {
    232         goto out;
    233     }
    234     if (memchr(nptr, '-', endptr - nptr) != NULL) {
    235         endptr = nptr;
    236         retval = -EINVAL;
    237         goto out;
    238     }
    239     if (val == 0 && (*endptr == 'x' || *endptr == 'X')) {
    240         /* Input looks like hex, reparse, and insist on no fraction. */
    241         retval = qemu_strtou64(nptr, &endptr, 16, &val);
    242         if (retval) {
    243             goto out;
    244         }
    245         if (*endptr == '.') {
    246             endptr = nptr;
    247             retval = -EINVAL;
    248             goto out;
    249         }
    250         hex = true;
    251     } else if (*endptr == '.') {
    252         /*
    253          * Input looks like a fraction.  Make sure even 1.k works
    254          * without fractional digits.  If we see an exponent, treat
    255          * the entire input as invalid instead.
    256          */
    257         double fraction;
    258 
    259         f = endptr;
    260         retval = qemu_strtod_finite(f, &endptr, &fraction);
    261         if (retval) {
    262             endptr++;
    263         } else if (memchr(f, 'e', endptr - f) || memchr(f, 'E', endptr - f)) {
    264             endptr = nptr;
    265             retval = -EINVAL;
    266             goto out;
    267         } else {
    268             /* Extract into a 64-bit fixed-point fraction. */
    269             valf = (uint64_t)(fraction * 0x1p64);
    270         }
    271     }
    272     c = *endptr;
    273     mul = suffix_mul(c, unit);
    274     if (mul > 0) {
    275         if (hex) {
    276             warn_report("Using a multiplier suffix on hex numbers "
    277                         "is deprecated: %s", nptr);
    278         }
    279         endptr++;
    280     } else {
    281         mul = suffix_mul(default_suffix, unit);
    282         assert(mul > 0);
    283     }
    284     if (mul == 1) {
    285         /* When a fraction is present, a scale is required. */
    286         if (valf != 0) {
    287             endptr = nptr;
    288             retval = -EINVAL;
    289             goto out;
    290         }
    291     } else {
    292         uint64_t valh, tmp;
    293 
    294         /* Compute exact result: 64.64 x 64.0 -> 128.64 fixed point */
    295         mulu64(&val, &valh, val, mul);
    296         mulu64(&valf, &tmp, valf, mul);
    297         val += tmp;
    298         valh += val < tmp;
    299 
    300         /* Round 0.5 upward. */
    301         tmp = valf >> 63;
    302         val += tmp;
    303         valh += val < tmp;
    304 
    305         /* Report overflow. */
    306         if (valh != 0) {
    307             retval = -ERANGE;
    308             goto out;
    309         }
    310     }
    311 
    312     retval = 0;
    313 
    314 out:
    315     if (end) {
    316         *end = endptr;
    317     } else if (*endptr) {
    318         retval = -EINVAL;
    319     }
    320     if (retval == 0) {
    321         *result = val;
    322     }
    323 
    324     return retval;
    325 }
    326 
    327 int qemu_strtosz(const char *nptr, const char **end, uint64_t *result)
    328 {
    329     return do_strtosz(nptr, end, 'B', 1024, result);
    330 }
    331 
    332 int qemu_strtosz_MiB(const char *nptr, const char **end, uint64_t *result)
    333 {
    334     return do_strtosz(nptr, end, 'M', 1024, result);
    335 }
    336 
    337 int qemu_strtosz_metric(const char *nptr, const char **end, uint64_t *result)
    338 {
    339     return do_strtosz(nptr, end, 'B', 1000, result);
    340 }
    341 
    342 /**
    343  * Helper function for error checking after strtol() and the like
    344  */
    345 static int check_strtox_error(const char *nptr, char *ep,
    346                               const char **endptr, bool check_zero,
    347                               int libc_errno)
    348 {
    349     assert(ep >= nptr);
    350 
    351     /* Windows has a bug in that it fails to parse 0 from "0x" in base 16 */
    352     if (check_zero && ep == nptr && libc_errno == 0) {
    353         char *tmp;
    354 
    355         errno = 0;
    356         if (strtol(nptr, &tmp, 10) == 0 && errno == 0 &&
    357             (*tmp == 'x' || *tmp == 'X')) {
    358             ep = tmp;
    359         }
    360     }
    361 
    362     if (endptr) {
    363         *endptr = ep;
    364     }
    365 
    366     /* Turn "no conversion" into an error */
    367     if (libc_errno == 0 && ep == nptr) {
    368         return -EINVAL;
    369     }
    370 
    371     /* Fail when we're expected to consume the string, but didn't */
    372     if (!endptr && *ep) {
    373         return -EINVAL;
    374     }
    375 
    376     return -libc_errno;
    377 }
    378 
    379 /**
    380  * Convert string @nptr to an integer, and store it in @result.
    381  *
    382  * This is a wrapper around strtol() that is harder to misuse.
    383  * Semantics of @nptr, @endptr, @base match strtol() with differences
    384  * noted below.
    385  *
    386  * @nptr may be null, and no conversion is performed then.
    387  *
    388  * If no conversion is performed, store @nptr in *@endptr and return
    389  * -EINVAL.
    390  *
    391  * If @endptr is null, and the string isn't fully converted, return
    392  * -EINVAL.  This is the case when the pointer that would be stored in
    393  * a non-null @endptr points to a character other than '\0'.
    394  *
    395  * If the conversion overflows @result, store INT_MAX in @result,
    396  * and return -ERANGE.
    397  *
    398  * If the conversion underflows @result, store INT_MIN in @result,
    399  * and return -ERANGE.
    400  *
    401  * Else store the converted value in @result, and return zero.
    402  */
    403 int qemu_strtoi(const char *nptr, const char **endptr, int base,
    404                 int *result)
    405 {
    406     char *ep;
    407     long long lresult;
    408 
    409     assert((unsigned) base <= 36 && base != 1);
    410     if (!nptr) {
    411         if (endptr) {
    412             *endptr = nptr;
    413         }
    414         return -EINVAL;
    415     }
    416 
    417     errno = 0;
    418     lresult = strtoll(nptr, &ep, base);
    419     if (lresult < INT_MIN) {
    420         *result = INT_MIN;
    421         errno = ERANGE;
    422     } else if (lresult > INT_MAX) {
    423         *result = INT_MAX;
    424         errno = ERANGE;
    425     } else {
    426         *result = lresult;
    427     }
    428     return check_strtox_error(nptr, ep, endptr, lresult == 0, errno);
    429 }
    430 
    431 /**
    432  * Convert string @nptr to an unsigned integer, and store it in @result.
    433  *
    434  * This is a wrapper around strtoul() that is harder to misuse.
    435  * Semantics of @nptr, @endptr, @base match strtoul() with differences
    436  * noted below.
    437  *
    438  * @nptr may be null, and no conversion is performed then.
    439  *
    440  * If no conversion is performed, store @nptr in *@endptr and return
    441  * -EINVAL.
    442  *
    443  * If @endptr is null, and the string isn't fully converted, return
    444  * -EINVAL.  This is the case when the pointer that would be stored in
    445  * a non-null @endptr points to a character other than '\0'.
    446  *
    447  * If the conversion overflows @result, store UINT_MAX in @result,
    448  * and return -ERANGE.
    449  *
    450  * Else store the converted value in @result, and return zero.
    451  *
    452  * Note that a number with a leading minus sign gets converted without
    453  * the minus sign, checked for overflow (see above), then negated (in
    454  * @result's type).  This is exactly how strtoul() works.
    455  */
    456 int qemu_strtoui(const char *nptr, const char **endptr, int base,
    457                  unsigned int *result)
    458 {
    459     char *ep;
    460     long long lresult;
    461 
    462     assert((unsigned) base <= 36 && base != 1);
    463     if (!nptr) {
    464         if (endptr) {
    465             *endptr = nptr;
    466         }
    467         return -EINVAL;
    468     }
    469 
    470     errno = 0;
    471     lresult = strtoull(nptr, &ep, base);
    472 
    473     /* Windows returns 1 for negative out-of-range values.  */
    474     if (errno == ERANGE) {
    475         *result = -1;
    476     } else {
    477         if (lresult > UINT_MAX) {
    478             *result = UINT_MAX;
    479             errno = ERANGE;
    480         } else if (lresult < INT_MIN) {
    481             *result = UINT_MAX;
    482             errno = ERANGE;
    483         } else {
    484             *result = lresult;
    485         }
    486     }
    487     return check_strtox_error(nptr, ep, endptr, lresult == 0, errno);
    488 }
    489 
    490 /**
    491  * Convert string @nptr to a long integer, and store it in @result.
    492  *
    493  * This is a wrapper around strtol() that is harder to misuse.
    494  * Semantics of @nptr, @endptr, @base match strtol() with differences
    495  * noted below.
    496  *
    497  * @nptr may be null, and no conversion is performed then.
    498  *
    499  * If no conversion is performed, store @nptr in *@endptr and return
    500  * -EINVAL.
    501  *
    502  * If @endptr is null, and the string isn't fully converted, return
    503  * -EINVAL.  This is the case when the pointer that would be stored in
    504  * a non-null @endptr points to a character other than '\0'.
    505  *
    506  * If the conversion overflows @result, store LONG_MAX in @result,
    507  * and return -ERANGE.
    508  *
    509  * If the conversion underflows @result, store LONG_MIN in @result,
    510  * and return -ERANGE.
    511  *
    512  * Else store the converted value in @result, and return zero.
    513  */
    514 int qemu_strtol(const char *nptr, const char **endptr, int base,
    515                 long *result)
    516 {
    517     char *ep;
    518 
    519     assert((unsigned) base <= 36 && base != 1);
    520     if (!nptr) {
    521         if (endptr) {
    522             *endptr = nptr;
    523         }
    524         return -EINVAL;
    525     }
    526 
    527     errno = 0;
    528     *result = strtol(nptr, &ep, base);
    529     return check_strtox_error(nptr, ep, endptr, *result == 0, errno);
    530 }
    531 
    532 /**
    533  * Convert string @nptr to an unsigned long, and store it in @result.
    534  *
    535  * This is a wrapper around strtoul() that is harder to misuse.
    536  * Semantics of @nptr, @endptr, @base match strtoul() with differences
    537  * noted below.
    538  *
    539  * @nptr may be null, and no conversion is performed then.
    540  *
    541  * If no conversion is performed, store @nptr in *@endptr and return
    542  * -EINVAL.
    543  *
    544  * If @endptr is null, and the string isn't fully converted, return
    545  * -EINVAL.  This is the case when the pointer that would be stored in
    546  * a non-null @endptr points to a character other than '\0'.
    547  *
    548  * If the conversion overflows @result, store ULONG_MAX in @result,
    549  * and return -ERANGE.
    550  *
    551  * Else store the converted value in @result, and return zero.
    552  *
    553  * Note that a number with a leading minus sign gets converted without
    554  * the minus sign, checked for overflow (see above), then negated (in
    555  * @result's type).  This is exactly how strtoul() works.
    556  */
    557 int qemu_strtoul(const char *nptr, const char **endptr, int base,
    558                  unsigned long *result)
    559 {
    560     char *ep;
    561 
    562     assert((unsigned) base <= 36 && base != 1);
    563     if (!nptr) {
    564         if (endptr) {
    565             *endptr = nptr;
    566         }
    567         return -EINVAL;
    568     }
    569 
    570     errno = 0;
    571     *result = strtoul(nptr, &ep, base);
    572     /* Windows returns 1 for negative out-of-range values.  */
    573     if (errno == ERANGE) {
    574         *result = -1;
    575     }
    576     return check_strtox_error(nptr, ep, endptr, *result == 0, errno);
    577 }
    578 
    579 /**
    580  * Convert string @nptr to an int64_t.
    581  *
    582  * Works like qemu_strtol(), except it stores INT64_MAX on overflow,
    583  * and INT64_MIN on underflow.
    584  */
    585 int qemu_strtoi64(const char *nptr, const char **endptr, int base,
    586                  int64_t *result)
    587 {
    588     char *ep;
    589 
    590     assert((unsigned) base <= 36 && base != 1);
    591     if (!nptr) {
    592         if (endptr) {
    593             *endptr = nptr;
    594         }
    595         return -EINVAL;
    596     }
    597 
    598     /* This assumes int64_t is long long TODO relax */
    599     QEMU_BUILD_BUG_ON(sizeof(int64_t) != sizeof(long long));
    600     errno = 0;
    601     *result = strtoll(nptr, &ep, base);
    602     return check_strtox_error(nptr, ep, endptr, *result == 0, errno);
    603 }
    604 
    605 /**
    606  * Convert string @nptr to an uint64_t.
    607  *
    608  * Works like qemu_strtoul(), except it stores UINT64_MAX on overflow.
    609  */
    610 int qemu_strtou64(const char *nptr, const char **endptr, int base,
    611                   uint64_t *result)
    612 {
    613     char *ep;
    614 
    615     assert((unsigned) base <= 36 && base != 1);
    616     if (!nptr) {
    617         if (endptr) {
    618             *endptr = nptr;
    619         }
    620         return -EINVAL;
    621     }
    622 
    623     /* This assumes uint64_t is unsigned long long TODO relax */
    624     QEMU_BUILD_BUG_ON(sizeof(uint64_t) != sizeof(unsigned long long));
    625     errno = 0;
    626     *result = strtoull(nptr, &ep, base);
    627     /* Windows returns 1 for negative out-of-range values.  */
    628     if (errno == ERANGE) {
    629         *result = -1;
    630     }
    631     return check_strtox_error(nptr, ep, endptr, *result == 0, errno);
    632 }
    633 
    634 /**
    635  * Convert string @nptr to a double.
    636   *
    637  * This is a wrapper around strtod() that is harder to misuse.
    638  * Semantics of @nptr and @endptr match strtod() with differences
    639  * noted below.
    640  *
    641  * @nptr may be null, and no conversion is performed then.
    642  *
    643  * If no conversion is performed, store @nptr in *@endptr and return
    644  * -EINVAL.
    645  *
    646  * If @endptr is null, and the string isn't fully converted, return
    647  * -EINVAL. This is the case when the pointer that would be stored in
    648  * a non-null @endptr points to a character other than '\0'.
    649  *
    650  * If the conversion overflows, store +/-HUGE_VAL in @result, depending
    651  * on the sign, and return -ERANGE.
    652  *
    653  * If the conversion underflows, store +/-0.0 in @result, depending on the
    654  * sign, and return -ERANGE.
    655  *
    656  * Else store the converted value in @result, and return zero.
    657  */
    658 int qemu_strtod(const char *nptr, const char **endptr, double *result)
    659 {
    660     char *ep;
    661 
    662     if (!nptr) {
    663         if (endptr) {
    664             *endptr = nptr;
    665         }
    666         return -EINVAL;
    667     }
    668 
    669     errno = 0;
    670     *result = strtod(nptr, &ep);
    671     return check_strtox_error(nptr, ep, endptr, false, errno);
    672 }
    673 
    674 /**
    675  * Convert string @nptr to a finite double.
    676  *
    677  * Works like qemu_strtod(), except that "NaN" and "inf" are rejected
    678  * with -EINVAL and no conversion is performed.
    679  */
    680 int qemu_strtod_finite(const char *nptr, const char **endptr, double *result)
    681 {
    682     double tmp;
    683     int ret;
    684 
    685     ret = qemu_strtod(nptr, endptr, &tmp);
    686     if (!ret && !isfinite(tmp)) {
    687         if (endptr) {
    688             *endptr = nptr;
    689         }
    690         ret = -EINVAL;
    691     }
    692 
    693     if (ret != -EINVAL) {
    694         *result = tmp;
    695     }
    696     return ret;
    697 }
    698 
    699 /**
    700  * Searches for the first occurrence of 'c' in 's', and returns a pointer
    701  * to the trailing null byte if none was found.
    702  */
    703 #ifndef HAVE_STRCHRNUL
    704 const char *qemu_strchrnul(const char *s, int c)
    705 {
    706     const char *e = strchr(s, c);
    707     if (!e) {
    708         e = s + strlen(s);
    709     }
    710     return e;
    711 }
    712 #endif
    713 
    714 /**
    715  * parse_uint:
    716  *
    717  * @s: String to parse
    718  * @value: Destination for parsed integer value
    719  * @endptr: Destination for pointer to first character not consumed
    720  * @base: integer base, between 2 and 36 inclusive, or 0
    721  *
    722  * Parse unsigned integer
    723  *
    724  * Parsed syntax is like strtoull()'s: arbitrary whitespace, a single optional
    725  * '+' or '-', an optional "0x" if @base is 0 or 16, one or more digits.
    726  *
    727  * If @s is null, or @base is invalid, or @s doesn't start with an
    728  * integer in the syntax above, set *@value to 0, *@endptr to @s, and
    729  * return -EINVAL.
    730  *
    731  * Set *@endptr to point right beyond the parsed integer (even if the integer
    732  * overflows or is negative, all digits will be parsed and *@endptr will
    733  * point right beyond them).
    734  *
    735  * If the integer is negative, set *@value to 0, and return -ERANGE.
    736  *
    737  * If the integer overflows unsigned long long, set *@value to
    738  * ULLONG_MAX, and return -ERANGE.
    739  *
    740  * Else, set *@value to the parsed integer, and return 0.
    741  */
    742 int parse_uint(const char *s, unsigned long long *value, char **endptr,
    743                int base)
    744 {
    745     int r = 0;
    746     char *endp = (char *)s;
    747     unsigned long long val = 0;
    748 
    749     assert((unsigned) base <= 36 && base != 1);
    750     if (!s) {
    751         r = -EINVAL;
    752         goto out;
    753     }
    754 
    755     errno = 0;
    756     val = strtoull(s, &endp, base);
    757     if (errno) {
    758         r = -errno;
    759         goto out;
    760     }
    761 
    762     if (endp == s) {
    763         r = -EINVAL;
    764         goto out;
    765     }
    766 
    767     /* make sure we reject negative numbers: */
    768     while (qemu_isspace(*s)) {
    769         s++;
    770     }
    771     if (*s == '-') {
    772         val = 0;
    773         r = -ERANGE;
    774         goto out;
    775     }
    776 
    777 out:
    778     *value = val;
    779     *endptr = endp;
    780     return r;
    781 }
    782 
    783 /**
    784  * parse_uint_full:
    785  *
    786  * @s: String to parse
    787  * @value: Destination for parsed integer value
    788  * @base: integer base, between 2 and 36 inclusive, or 0
    789  *
    790  * Parse unsigned integer from entire string
    791  *
    792  * Have the same behavior of parse_uint(), but with an additional check
    793  * for additional data after the parsed number. If extra characters are present
    794  * after the parsed number, the function will return -EINVAL, and *@v will
    795  * be set to 0.
    796  */
    797 int parse_uint_full(const char *s, unsigned long long *value, int base)
    798 {
    799     char *endp;
    800     int r;
    801 
    802     r = parse_uint(s, value, &endp, base);
    803     if (r < 0) {
    804         return r;
    805     }
    806     if (*endp) {
    807         *value = 0;
    808         return -EINVAL;
    809     }
    810 
    811     return 0;
    812 }
    813 
    814 int qemu_parse_fd(const char *param)
    815 {
    816     long fd;
    817     char *endptr;
    818 
    819     errno = 0;
    820     fd = strtol(param, &endptr, 10);
    821     if (param == endptr /* no conversion performed */                    ||
    822         errno != 0      /* not representable as long; possibly others */ ||
    823         *endptr != '\0' /* final string not empty */                     ||
    824         fd < 0          /* invalid as file descriptor */                 ||
    825         fd > INT_MAX    /* not representable as int */) {
    826         return -1;
    827     }
    828     return fd;
    829 }
    830 
    831 /*
    832  * Implementation of  ULEB128 (http://en.wikipedia.org/wiki/LEB128)
    833  * Input is limited to 14-bit numbers
    834  */
    835 int uleb128_encode_small(uint8_t *out, uint32_t n)
    836 {
    837     g_assert(n <= 0x3fff);
    838     if (n < 0x80) {
    839         *out = n;
    840         return 1;
    841     } else {
    842         *out++ = (n & 0x7f) | 0x80;
    843         *out = n >> 7;
    844         return 2;
    845     }
    846 }
    847 
    848 int uleb128_decode_small(const uint8_t *in, uint32_t *n)
    849 {
    850     if (!(*in & 0x80)) {
    851         *n = *in;
    852         return 1;
    853     } else {
    854         *n = *in++ & 0x7f;
    855         /* we exceed 14 bit number */
    856         if (*in & 0x80) {
    857             return -1;
    858         }
    859         *n |= *in << 7;
    860         return 2;
    861     }
    862 }
    863 
    864 /*
    865  * helper to parse debug environment variables
    866  */
    867 int parse_debug_env(const char *name, int max, int initial)
    868 {
    869     char *debug_env = getenv(name);
    870     char *inv = NULL;
    871     long debug;
    872 
    873     if (!debug_env) {
    874         return initial;
    875     }
    876     errno = 0;
    877     debug = strtol(debug_env, &inv, 10);
    878     if (inv == debug_env) {
    879         return initial;
    880     }
    881     if (debug < 0 || debug > max || errno != 0) {
    882         warn_report("%s not in [0, %d]", name, max);
    883         return initial;
    884     }
    885     return debug;
    886 }
    887 
    888 const char *si_prefix(unsigned int exp10)
    889 {
    890     static const char *prefixes[] = {
    891         "a", "f", "p", "n", "u", "m", "", "K", "M", "G", "T", "P", "E"
    892     };
    893 
    894     exp10 += 18;
    895     assert(exp10 % 3 == 0 && exp10 / 3 < ARRAY_SIZE(prefixes));
    896     return prefixes[exp10 / 3];
    897 }
    898 
    899 const char *iec_binary_prefix(unsigned int exp2)
    900 {
    901     static const char *prefixes[] = { "", "Ki", "Mi", "Gi", "Ti", "Pi", "Ei" };
    902 
    903     assert(exp2 % 10 == 0 && exp2 / 10 < ARRAY_SIZE(prefixes));
    904     return prefixes[exp2 / 10];
    905 }
    906 
    907 /*
    908  * Return human readable string for size @val.
    909  * @val can be anything that uint64_t allows (no more than "16 EiB").
    910  * Use IEC binary units like KiB, MiB, and so forth.
    911  * Caller is responsible for passing it to g_free().
    912  */
    913 char *size_to_str(uint64_t val)
    914 {
    915     uint64_t div;
    916     int i;
    917 
    918     /*
    919      * The exponent (returned in i) minus one gives us
    920      * floor(log2(val * 1024 / 1000).  The correction makes us
    921      * switch to the higher power when the integer part is >= 1000.
    922      * (see e41b509d68afb1f for more info)
    923      */
    924     frexp(val / (1000.0 / 1024.0), &i);
    925     i = (i - 1) / 10 * 10;
    926     div = 1ULL << i;
    927 
    928     return g_strdup_printf("%0.3g %sB", (double)val / div, iec_binary_prefix(i));
    929 }
    930 
    931 char *freq_to_str(uint64_t freq_hz)
    932 {
    933     double freq = freq_hz;
    934     size_t exp10 = 0;
    935 
    936     while (freq >= 1000.0) {
    937         freq /= 1000.0;
    938         exp10 += 3;
    939     }
    940 
    941     return g_strdup_printf("%0.3g %sHz", freq, si_prefix(exp10));
    942 }
    943 
    944 int qemu_pstrcmp0(const char **str1, const char **str2)
    945 {
    946     return g_strcmp0(*str1, *str2);
    947 }
    948 
    949 static inline bool starts_with_prefix(const char *dir)
    950 {
    951     size_t prefix_len = strlen(CONFIG_PREFIX);
    952     return !memcmp(dir, CONFIG_PREFIX, prefix_len) &&
    953         (!dir[prefix_len] || G_IS_DIR_SEPARATOR(dir[prefix_len]));
    954 }
    955 
    956 /* Return the next path component in dir, and store its length in *p_len.  */
    957 static inline const char *next_component(const char *dir, int *p_len)
    958 {
    959     int len;
    960     while ((*dir && G_IS_DIR_SEPARATOR(*dir)) ||
    961            (*dir == '.' && (G_IS_DIR_SEPARATOR(dir[1]) || dir[1] == '\0'))) {
    962         dir++;
    963     }
    964     len = 0;
    965     while (dir[len] && !G_IS_DIR_SEPARATOR(dir[len])) {
    966         len++;
    967     }
    968     *p_len = len;
    969     return dir;
    970 }
    971 
    972 static const char *exec_dir;
    973 
    974 void qemu_init_exec_dir(const char *argv0)
    975 {
    976 #ifdef G_OS_WIN32
    977     char *p;
    978     char buf[MAX_PATH];
    979     DWORD len;
    980 
    981     if (exec_dir) {
    982         return;
    983     }
    984 
    985     len = GetModuleFileName(NULL, buf, sizeof(buf) - 1);
    986     if (len == 0) {
    987         return;
    988     }
    989 
    990     buf[len] = 0;
    991     p = buf + len - 1;
    992     while (p != buf && *p != '\\') {
    993         p--;
    994     }
    995     *p = 0;
    996     if (access(buf, R_OK) == 0) {
    997         exec_dir = g_strdup(buf);
    998     } else {
    999         exec_dir = CONFIG_BINDIR;
   1000     }
   1001 #else
   1002     char *p = NULL;
   1003     char buf[PATH_MAX];
   1004 
   1005     if (exec_dir) {
   1006         return;
   1007     }
   1008 
   1009 #if defined(__linux__)
   1010     {
   1011         int len;
   1012         len = readlink("/proc/self/exe", buf, sizeof(buf) - 1);
   1013         if (len > 0) {
   1014             buf[len] = 0;
   1015             p = buf;
   1016         }
   1017     }
   1018 #elif defined(__FreeBSD__) \
   1019       || (defined(__NetBSD__) && defined(KERN_PROC_PATHNAME))
   1020     {
   1021 #if defined(__FreeBSD__)
   1022         static int mib[4] = {CTL_KERN, KERN_PROC, KERN_PROC_PATHNAME, -1};
   1023 #else
   1024         static int mib[4] = {CTL_KERN, KERN_PROC_ARGS, -1, KERN_PROC_PATHNAME};
   1025 #endif
   1026         size_t len = sizeof(buf) - 1;
   1027 
   1028         *buf = '\0';
   1029         if (!sysctl(mib, ARRAY_SIZE(mib), buf, &len, NULL, 0) &&
   1030             *buf) {
   1031             buf[sizeof(buf) - 1] = '\0';
   1032             p = buf;
   1033         }
   1034     }
   1035 #elif defined(__APPLE__)
   1036     {
   1037         char fpath[PATH_MAX];
   1038         uint32_t len = sizeof(fpath);
   1039         if (_NSGetExecutablePath(fpath, &len) == 0) {
   1040             p = realpath(fpath, buf);
   1041             if (!p) {
   1042                 return;
   1043             }
   1044         }
   1045     }
   1046 #elif defined(__HAIKU__)
   1047     {
   1048         image_info ii;
   1049         int32_t c = 0;
   1050 
   1051         *buf = '\0';
   1052         while (get_next_image_info(0, &c, &ii) == B_OK) {
   1053             if (ii.type == B_APP_IMAGE) {
   1054                 strncpy(buf, ii.name, sizeof(buf));
   1055                 buf[sizeof(buf) - 1] = 0;
   1056                 p = buf;
   1057                 break;
   1058             }
   1059         }
   1060     }
   1061 #endif
   1062     /* If we don't have any way of figuring out the actual executable
   1063        location then try argv[0].  */
   1064     if (!p && argv0) {
   1065         p = realpath(argv0, buf);
   1066     }
   1067     if (p) {
   1068         exec_dir = g_path_get_dirname(p);
   1069     } else {
   1070         exec_dir = CONFIG_BINDIR;
   1071     }
   1072 #endif
   1073 }
   1074 
   1075 const char *qemu_get_exec_dir(void)
   1076 {
   1077     return exec_dir;
   1078 }
   1079 
   1080 char *get_relocated_path(const char *dir)
   1081 {
   1082     size_t prefix_len = strlen(CONFIG_PREFIX);
   1083     const char *bindir = CONFIG_BINDIR;
   1084     const char *exec_dir = qemu_get_exec_dir();
   1085     GString *result;
   1086     int len_dir, len_bindir;
   1087 
   1088     /* Fail if qemu_init_exec_dir was not called.  */
   1089     assert(exec_dir[0]);
   1090 
   1091     result = g_string_new(exec_dir);
   1092     g_string_append(result, "/qemu-bundle");
   1093     if (access(result->str, R_OK) == 0) {
   1094 #ifdef G_OS_WIN32
   1095         size_t size = mbsrtowcs(NULL, &dir, 0, &(mbstate_t){0}) + 1;
   1096         PWSTR wdir = g_new(WCHAR, size);
   1097         mbsrtowcs(wdir, &dir, size, &(mbstate_t){0});
   1098 
   1099         PCWSTR wdir_skipped_root;
   1100         PathCchSkipRoot(wdir, &wdir_skipped_root);
   1101 
   1102         size = wcsrtombs(NULL, &wdir_skipped_root, 0, &(mbstate_t){0});
   1103         char *cursor = result->str + result->len;
   1104         g_string_set_size(result, result->len + size);
   1105         wcsrtombs(cursor, &wdir_skipped_root, size + 1, &(mbstate_t){0});
   1106         g_free(wdir);
   1107 #else
   1108         g_string_append(result, dir);
   1109 #endif
   1110     } else if (!starts_with_prefix(dir) || !starts_with_prefix(bindir)) {
   1111         g_string_assign(result, dir);
   1112     } else {
   1113         g_string_assign(result, exec_dir);
   1114 
   1115         /* Advance over common components.  */
   1116         len_dir = len_bindir = prefix_len;
   1117         do {
   1118             dir += len_dir;
   1119             bindir += len_bindir;
   1120             dir = next_component(dir, &len_dir);
   1121             bindir = next_component(bindir, &len_bindir);
   1122         } while (len_dir && len_dir == len_bindir && !memcmp(dir, bindir, len_dir));
   1123 
   1124         /* Ascend from bindir to the common prefix with dir.  */
   1125         while (len_bindir) {
   1126             bindir += len_bindir;
   1127             g_string_append(result, "/..");
   1128             bindir = next_component(bindir, &len_bindir);
   1129         }
   1130 
   1131         if (*dir) {
   1132             assert(G_IS_DIR_SEPARATOR(dir[-1]));
   1133             g_string_append(result, dir - 1);
   1134         }
   1135     }
   1136 
   1137     return g_string_free(result, false);
   1138 }