2 * libudev - interface to udev device information
4 * Copyright (C) 2008-2011 Kay Sievers <kay.sievers@vrfy.org>
6 * This library is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2.1 of the License, or (at your option) any later version.
25 #include "libudev-private.h"
28 * SECTION:libudev-util
29 * @short_description: utils
32 ssize_t util_get_sys_core_link_value(struct udev *udev, const char *slink, const char *syspath, char *value, size_t size)
34 char path[UTIL_PATH_SIZE];
35 char target[UTIL_PATH_SIZE];
39 util_strscpyl(path, sizeof(path), syspath, "/", slink, NULL);
40 len = readlink(path, target, sizeof(target));
41 if (len <= 0 || len == (ssize_t)sizeof(target))
44 pos = strrchr(target, '/');
48 dbg(udev, "resolved link to: '%s'\n", pos);
49 return util_strscpy(value, size, pos);
52 int util_resolve_sys_link(struct udev *udev, char *syspath, size_t size)
54 char link_target[UTIL_PATH_SIZE];
61 len = readlink(syspath, link_target, sizeof(link_target));
62 if (len <= 0 || len == (ssize_t)sizeof(link_target))
64 link_target[len] = '\0';
65 dbg(udev, "path link '%s' points to '%s'\n", syspath, link_target);
67 for (back = 0; strncmp(&link_target[back * 3], "../", 3) == 0; back++)
69 dbg(udev, "base '%s', tail '%s', back %i\n", syspath, &link_target[back * 3], back);
70 for (i = 0; i <= back; i++) {
71 base = strrchr(syspath, '/');
78 dbg(udev, "after moving back '%s'\n", syspath);
79 util_strscpyl(base, size - (base - syspath), "/", &link_target[back * 3], NULL);
83 int util_log_priority(const char *priority)
88 prio = strtol(priority, &endptr, 10);
89 if (endptr[0] == '\0' || isspace(endptr[0]))
91 if (strncmp(priority, "err", 3) == 0)
93 if (strncmp(priority, "info", 4) == 0)
95 if (strncmp(priority, "debug", 5) == 0)
100 size_t util_path_encode(const char *src, char *dest, size_t size)
104 for (i = 0, j = 0; src[i] != '\0'; i++) {
110 memcpy(&dest[j], "\\x2f", 4);
112 } else if (src[i] == '\\') {
117 memcpy(&dest[j], "\\x5c", 4);
132 size_t util_path_decode(char *s)
136 for (i = 0, j = 0; s[i] != '\0'; j++) {
137 if (memcmp(&s[i], "\\x2f", 4) == 0) {
140 } else if (memcmp(&s[i], "\\x5c", 4) == 0) {
152 void util_remove_trailing_chars(char *path, char c)
159 while (len > 0 && path[len-1] == c)
164 * Concatenates strings. In any case, terminates in _all_ cases with '\0'
165 * and moves the @dest pointer forward to the added '\0'. Returns the
166 * remaining size, and 0 if the string was truncated.
168 size_t util_strpcpy(char **dest, size_t size, const char *src)
175 *dest = mempcpy(*dest, src, size-1);
180 *dest = mempcpy(*dest, src, len);
188 /* concatenates list of strings, moves dest forward */
189 size_t util_strpcpyl(char **dest, size_t size, const char *src, ...)
195 size = util_strpcpy(dest, size, src);
196 src = va_arg(va, char *);
197 } while (src != NULL);
204 size_t util_strscpy(char *dest, size_t size, const char *src)
209 return util_strpcpy(&s, size, src);
212 /* concatenates list of strings */
213 size_t util_strscpyl(char *dest, size_t size, const char *src, ...)
221 size = util_strpcpy(&s, size, src);
222 src = va_arg(va, char *);
223 } while (src != NULL);
229 /* count of characters used to encode one unicode char */
230 static int utf8_encoded_expected_len(const char *str)
232 unsigned char c = (unsigned char)str[0];
236 if ((c & 0xe0) == 0xc0)
238 if ((c & 0xf0) == 0xe0)
240 if ((c & 0xf8) == 0xf0)
242 if ((c & 0xfc) == 0xf8)
244 if ((c & 0xfe) == 0xfc)
249 /* decode one unicode char */
250 static int utf8_encoded_to_unichar(const char *str)
256 len = utf8_encoded_expected_len(str);
261 unichar = str[0] & 0x1f;
264 unichar = (int)str[0] & 0x0f;
267 unichar = (int)str[0] & 0x07;
270 unichar = (int)str[0] & 0x03;
273 unichar = (int)str[0] & 0x01;
279 for (i = 1; i < len; i++) {
280 if (((int)str[i] & 0xc0) != 0x80)
283 unichar |= (int)str[i] & 0x3f;
289 /* expected size used to encode one unicode char */
290 static int utf8_unichar_to_encoded_len(int unichar)
296 if (unichar < 0x10000)
298 if (unichar < 0x200000)
300 if (unichar < 0x4000000)
305 /* check if unicode char has a valid numeric range */
306 static int utf8_unichar_valid_range(int unichar)
308 if (unichar > 0x10ffff)
310 if ((unichar & 0xfffff800) == 0xd800)
312 if ((unichar > 0xfdcf) && (unichar < 0xfdf0))
314 if ((unichar & 0xffff) == 0xffff)
319 /* validate one encoded unicode char and return its length */
320 static int utf8_encoded_valid_unichar(const char *str)
326 len = utf8_encoded_expected_len(str);
334 /* check if expected encoded chars are available */
335 for (i = 0; i < len; i++)
336 if ((str[i] & 0x80) != 0x80)
339 unichar = utf8_encoded_to_unichar(str);
341 /* check if encoded length matches encoded value */
342 if (utf8_unichar_to_encoded_len(unichar) != len)
345 /* check if value has valid range */
346 if (!utf8_unichar_valid_range(unichar))
352 int util_replace_whitespace(const char *str, char *to, size_t len)
356 /* strip trailing whitespace */
357 len = strnlen(str, len);
358 while (len && isspace(str[len-1]))
361 /* strip leading whitespace */
363 while (isspace(str[i]) && (i < len))
368 /* substitute multiple whitespace with a single '_' */
369 if (isspace(str[i])) {
370 while (isspace(str[i]))
380 static int is_whitelisted(char c, const char *white)
382 if ((c >= '0' && c <= '9') ||
383 (c >= 'A' && c <= 'Z') ||
384 (c >= 'a' && c <= 'z') ||
385 strchr("#+-.:=@_", c) != NULL ||
386 (white != NULL && strchr(white, c) != NULL))
391 /* allow chars in whitelist, plain ascii, hex-escaping and valid utf8 */
392 int util_replace_chars(char *str, const char *white)
397 while (str[i] != '\0') {
400 if (is_whitelisted(str[i], white)) {
405 /* accept hex encoding */
406 if (str[i] == '\\' && str[i+1] == 'x') {
411 /* accept valid utf8 */
412 len = utf8_encoded_valid_unichar(&str[i]);
418 /* if space is allowed, replace whitespace with ordinary space */
419 if (isspace(str[i]) && white != NULL && strchr(white, ' ') != NULL) {
426 /* everything else is replaced with '_' */
435 * udev_util_encode_string:
436 * @str: input string to be encoded
437 * @str_enc: output string to store the encoded input string
438 * @len: maximum size of the output string, which may be
439 * four times as long as the input string
441 * Encode all potentially unsafe characters of a string to the
442 * corresponding 2 char hex value prefixed by '\x'.
444 * Returns: 0 if the entire string was copied, non-zero otherwise.
446 UDEV_EXPORT int udev_util_encode_string(const char *str, char *str_enc, size_t len)
450 if (str == NULL || str_enc == NULL)
453 for (i = 0, j = 0; str[i] != '\0'; i++) {
456 seqlen = utf8_encoded_valid_unichar(&str[i]);
458 if (len-j < (size_t)seqlen)
460 memcpy(&str_enc[j], &str[i], seqlen);
463 } else if (str[i] == '\\' || !is_whitelisted(str[i], NULL)) {
466 sprintf(&str_enc[j], "\\x%02x", (unsigned char) str[i]);
484 * http://sites.google.com/site/murmurhash/
486 * All code is released to the public domain. For business purposes,
487 * Murmurhash is under the MIT license.
490 static unsigned int murmur_hash2(const char *key, int len, unsigned int seed)
493 * 'm' and 'r' are mixing constants generated offline.
494 * They're not really 'magic', they just happen to work well.
496 const unsigned int m = 0x5bd1e995;
499 /* initialize the hash to a 'random' value */
500 unsigned int h = seed ^ len;
502 /* mix 4 bytes at a time into the hash */
503 const unsigned char * data = (const unsigned char *)key;
506 unsigned int k = *(unsigned int *)data;
518 /* handle the last few bytes of the input array */
529 /* do a few final mixes of the hash to ensure the last few bytes are well-incorporated */
537 unsigned int util_string_hash32(const char *str)
539 return murmur_hash2(str, strlen(str), 0);
542 /* get a bunch of bit numbers out of the hash, and set the bits in our bit field */
543 uint64_t util_string_bloom64(const char *str)
546 unsigned int hash = util_string_hash32(str);
548 bits |= 1LLU << (hash & 63);
549 bits |= 1LLU << ((hash >> 6) & 63);
550 bits |= 1LLU << ((hash >> 12) & 63);
551 bits |= 1LLU << ((hash >> 18) & 63);
555 #define USEC_PER_SEC 1000000ULL
556 #define NSEC_PER_USEC 1000ULL
557 unsigned long long ts_usec(const struct timespec *ts)
559 return (unsigned long long) ts->tv_sec * USEC_PER_SEC +
560 (unsigned long long) ts->tv_nsec / NSEC_PER_USEC;
563 unsigned long long now_usec(void)
567 if (clock_gettime(CLOCK_MONOTONIC, &ts) != 0)