1 /*-
2 * Copyright (c) 2012, 2013 Spectra Logic Corporation
3 * All rights reserved.
4 *
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
7 * are met:
8 * 1. Redistributions of source code must retain the above copyright
9 * notice, this list of conditions, and the following disclaimer,
10 * without modification.
11 * 2. Redistributions in binary form must reproduce at minimum a disclaimer
12 * substantially similar to the "NO WARRANTY" disclaimer below
13 * ("Disclaimer") and any redistribution must be conditioned upon
14 * including a substantially similar Disclaimer requirement for further
15 * binary redistribution.
16 *
17 * NO WARRANTY
18 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
19 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
20 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
21 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
22 * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
23 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
24 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
25 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
26 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
27 * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
28 * POSSIBILITY OF SUCH DAMAGES.
29 *
30 * Authors: Alan Somers (Spectra Logic Corporation)
31 *
32 * $FreeBSD$
33 */
34
35 /**
36 * \file devdctl_guid.h
37 *
38 * Definition of the Guid class.
39 */
40 #ifndef _DEVDCTL_GUID_H_
41 #define _DEVDCTL_GUID_H_
42
43 /*============================ Namespace Control =============================*/
44 namespace DevdCtl
45 {
46
47 /*============================= Class Definitions ============================*/
48 /*----------------------------------- Guid -----------------------------------*/
49 /**
50 * \brief Object that represents guids.
51 *
52 * It can generally be manipulated as a uint64_t, but with a special
53 * value INVALID_GUID that does not equal any valid guid.
54 *
55 * As of this writing, this class is only used to represent ZFS
56 * guids in events and spa_generate_guid() in spa_misc.c explicitly
57 * refuses to return a guid of 0. So this class uses 0 as the value
58 * for INVALID_GUID. In the future, if 0 is allowed to be a valid
59 * guid, the implementation of this class must change.
60 */
61 class Guid
62 {
63 public:
64 /* Constructors */
65 /* Default constructor: an Invalid guid */
66 Guid();
67 /* Construct a guid from a provided integer */
68 Guid(uint64_t guid);
69 /* Construct a guid from a string in base 8, 10, or 16 */
70 Guid(const std::string &guid);
71 static Guid InvalidGuid();
72
73 /* Assignment */
74 Guid& operator=(const Guid& rhs);
75
76 /* Test the validity of this guid. */
77 bool IsValid() const;
78
79 /* Comparison to other Guid operators */
80 bool operator==(const Guid& rhs) const;
81 bool operator!=(const Guid& rhs) const;
82
83 /* Integer conversion operators */
84 operator uint64_t() const;
85 operator bool() const;
86
87 protected:
88 static const uint64_t INVALID_GUID = 0;
89
90 /* The integer value of the GUID. */
91 uint64_t m_GUID;
92 };
93
94 //- Guid Inline Public Methods ------------------------------------------------
95 inline
Guid()96 Guid::Guid()
97 : m_GUID(INVALID_GUID)
98 {
99 }
100
101 inline
Guid(uint64_t guid)102 Guid::Guid(uint64_t guid)
103 : m_GUID(guid)
104 {
105 }
106
107 inline Guid
InvalidGuid()108 Guid::InvalidGuid()
109 {
110 return (Guid(INVALID_GUID));
111 }
112
113 inline Guid&
114 Guid::operator=(const Guid &rhs)
115 {
116 m_GUID = rhs.m_GUID;
117 return (*this);
118 }
119
120 inline bool
IsValid()121 Guid::IsValid() const
122 {
123 return (m_GUID != INVALID_GUID);
124 }
125
126 inline bool
127 Guid::operator==(const Guid& rhs) const
128 {
129 return (m_GUID == rhs.m_GUID);
130 }
131
132 inline bool
133 Guid::operator!=(const Guid& rhs) const
134 {
135 return (m_GUID != rhs.m_GUID);
136 }
137
138 inline
uint64_t()139 Guid::operator uint64_t() const
140 {
141 return (m_GUID);
142 }
143
144 inline
145 Guid::operator bool() const
146 {
147 return (m_GUID != INVALID_GUID);
148 }
149
150 /** Convert the GUID into its string representation */
151 std::ostream& operator<< (std::ostream& out, Guid g);
152
153 } // namespace DevdCtl
154 #endif /* _DEVDCTL_GUID_H_ */
155