uuid.h

Go to the documentation of this file.

/*
 * Copyright (C) 2018 Freie Universität Berlin
 * Copyright (C) 2018 Inria
 *
 * This file is subject to the terms and conditions of the GNU Lesser
 * General Public License v2.1. See the file LICENSE in the top level
 * directory for more details.
 */
 
#pragma once
 
#include <stdbool.h>
#include <stdint.h>
#include <stdlib.h>
#include <string.h>
#include "byteorder.h"
 
#ifdef __cplusplus
extern "C" {
#endif
 
#define UUID_NODE_LEN    (6U)   
#define UUID_STR_LEN     (36U)  
#define UUID_V1         (0x01)  
#define UUID_V2         (0x02)  
#define UUID_V3         (0x03)  
#define UUID_V4         (0x04)  
#define UUID_V5         (0x05)  
#define UUID_VERSION_MASK   (0xF000)
 
typedef struct __attribute__((packed)) {
    network_uint32_t time_low;      
    network_uint16_t time_mid;      
    network_uint16_t time_hi;       
    uint8_t clk_seq_hi_res;         
    uint8_t clk_seq_low;            
    uint8_t node[UUID_NODE_LEN];    
} uuid_t;
 
extern const uuid_t uuid_namespace_dns;     
extern const uuid_t uuid_namespace_url;     
extern const uuid_t uuid_namespace_iso;     
extern const uuid_t uuid_namespace_x500;    
void uuid_v3(uuid_t *uuid, const uuid_t *ns, const uint8_t *name, size_t len);
 
void uuid_v4(uuid_t *uuid);
 
void uuid_v5(uuid_t *uuid, const uuid_t *ns, const uint8_t *name, size_t len);
 
static inline unsigned uuid_version(const uuid_t *uuid)
{
    uint16_t time_hi_vers = byteorder_ntohs(uuid->time_hi);
 
    return (time_hi_vers & 0xF000) >> 12;
}
 
static inline bool uuid_equal(const uuid_t *uuid1, const uuid_t *uuid2)
{
    return (memcmp(uuid1, uuid2, sizeof(uuid_t)) == 0);
}
 
void uuid_to_string(const uuid_t *uuid, char *str);
 
int uuid_from_string(uuid_t *uuid, const char *str);
 
#ifdef __cplusplus
}
#endif