b2d31f00f845ec0bde89a6975a25608368bf75a3
[libvscmgmt.git] / utils / uuid.c
1 /*
2  * uuid.c: Utilities for Virtualized Super Computer Management
3  *
4  * Copyright (C) 2009 Matthias Bolte <matthias.bolte@googlemail.com>
5  *
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.
10  *
11  * This library is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
14  * Lesser General Public License for more details.
15  *
16  * You should have received a copy of the GNU Lesser General Public
17  * License along with this library; if not, write to the Free Software
18  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307  USA
19  */
20
21 #include "utils.h"
22
23 #include <uuid.h>
24
25 /*
26  * UUID
27  */
28
29 /**
30  * Appends a duplicate of the given UUID to the list.
31  *
32  * Always returns a pointer to the first UUID item in the list, so that this
33  * function can be used for initialization and for appending.
34  */
35 struct VscMgmtUuid * /* uuid_list */
36 vsc_mgmt_uuid_list_append (struct VscMgmtError *error,
37                            struct VscMgmtUuid *uuid_list,
38                            const struct VscMgmtUuid *uuid)
39 {
40         struct VscMgmtUuid *uuid_duplicate = NULL;
41
42         VSC_MGMT__ASSERT (error != NULL);
43         VSC_MGMT__ASSERT (! error->occured);
44
45         uuid_duplicate = vsc_mgmt_memdup (error, uuid, sizeof (struct VscMgmtUuid));
46
47         if (error->occured) {
48                 VSC_MGMT__APPEND_ERROR0 (error, VSC_MGMT__CODE__TRACE);
49                 return NULL;
50         }
51
52         uuid_duplicate->next = NULL;
53
54         return (struct VscMgmtUuid *) vsc_mgmt_list_append ((struct VscMgmtList *) uuid_list,
55                                                             (struct VscMgmtList *) uuid_duplicate);
56 }
57
58 /**
59  * Recursively frees the given UUID list.
60  */
61 void
62 vsc_mgmt_uuid_list_free (struct VscMgmtUuid *uuid_list)
63 {
64         vsc_mgmt_list_free ((struct VscMgmtList *) uuid_list);
65 }
66
67 /**
68  * Parses a UUID from string representation.
69  */
70 void
71 vsc_mgmt_uuid_parse (struct VscMgmtError *error, const char *uuid_string,
72                      struct VscMgmtUuid *uuid)
73 {
74         VSC_MGMT__ASSERT (error != NULL);
75         VSC_MGMT__ASSERT (! error->occured);
76
77         if (uuid_parse (uuid_string, uuid->bytes) < 0) {
78                 VSC_MGMT__ERROR2 (error, VSC_MGMT__CODE__INVALID_UUID_STRING,
79                                   "'%s'", uuid_string);
80         }
81 }
82
83 /**
84  * Formats a UUID to string representation.
85  */
86 void
87 vsc_mgmt_uuid_format (const struct VscMgmtUuid *uuid, char *uuid_string)
88 {
89         uuid_unparse_lower (uuid->bytes, uuid_string);
90 }