xref: /qemu/include/qemu/uuid.h (revision 6402cbbb)
1 /*
2  *  QEMU UUID functions
3  *
4  *  Copyright 2016 Red Hat, Inc.
5  *
6  *  Authors:
7  *   Fam Zheng <famz@redhat.com>
8  *
9  * This program is free software; you can redistribute it and/or modify it
10  * under the terms of the GNU General Public License as published by the Free
11  * Software Foundation; either version 2 of the License, or (at your option)
12  * any later version.
13  *
14  */
15 
16 #ifndef QEMU_UUID_H
17 #define QEMU_UUID_H
18 
19 #include "qemu-common.h"
20 
21 /* Version 4 UUID (pseudo random numbers), RFC4122 4.4. */
22 
23 typedef struct {
24     union {
25         unsigned char data[16];
26         struct {
27             /* Generated in BE endian, can be swapped with qemu_uuid_bswap. */
28             uint32_t time_low;
29             uint16_t time_mid;
30             uint16_t time_high_and_version;
31             uint8_t  clock_seq_and_reserved;
32             uint8_t  clock_seq_low;
33             uint8_t  node[6];
34         } fields;
35     };
36 } QemuUUID;
37 
38 #define UUID_FMT "%02hhx%02hhx%02hhx%02hhx-" \
39                  "%02hhx%02hhx-%02hhx%02hhx-" \
40                  "%02hhx%02hhx-" \
41                  "%02hhx%02hhx%02hhx%02hhx%02hhx%02hhx"
42 
43 #define UUID_FMT_LEN 36
44 
45 #define UUID_NONE "00000000-0000-0000-0000-000000000000"
46 
47 void qemu_uuid_generate(QemuUUID *out);
48 
49 int qemu_uuid_is_null(const QemuUUID *uu);
50 
51 void qemu_uuid_unparse(const QemuUUID *uuid, char *out);
52 
53 char *qemu_uuid_unparse_strdup(const QemuUUID *uuid);
54 
55 int qemu_uuid_parse(const char *str, QemuUUID *uuid);
56 
57 void qemu_uuid_bswap(QemuUUID *uuid);
58 
59 #endif
60