servicediscoveryandcontrol/pnp/test/upnp/Server/ServicePoint/inc/upnpuuid.h
changeset 0 f5a58ecadc66
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/servicediscoveryandcontrol/pnp/test/upnp/Server/ServicePoint/inc/upnpuuid.h	Tue Feb 02 01:12:20 2010 +0200
@@ -0,0 +1,79 @@
+// Copyright (c) 2008-2009 Nokia Corporation and/or its subsidiary(-ies).
+// All rights reserved.
+// This component and the accompanying materials are made available
+// under the terms of "Eclipse Public License v1.0"
+// which accompanies this distribution, and is available
+// at the URL "http://www.eclipse.org/legal/epl-v10.html".
+//
+// Initial Contributors:
+// Nokia Corporation - initial contribution.
+//
+// Contributors:
+//
+// Description:
+// Simple UUID generation and formatting support
+// 
+//
+
+/**
+ @file
+ @internalComponent
+*/
+
+#ifndef __UPNPUUID_H__
+#define __UPNPUUID_H__
+
+const TInt KNodeMacOctets = 6;
+const TInt KUuidStringLen = 36;
+
+typedef TBuf<KUuidStringLen> TUuidString;
+typedef TBuf8<KUuidStringLen> TUuidString8;
+
+// Example UUID string: f81d4fae-7dec-11d0-a765-00a0c91e6bf6
+_LIT(KUuidFormatString,   "%08x-%04x-%04x-%02x%02x-%02x%02x%02x%02x%02x%02x");
+_LIT8(KUuidFormatString8, "%08x-%04x-%04x-%02x%02x-%02x%02x%02x%02x%02x%02x");
+
+/**
+ * Generally known UUID versions.
+ * NOTE. This implementation supports
+ * only version 4 (ERandomBased)
+ */
+enum TUuidVersion
+    {
+    ETimeBased      = (1 << 0), //< v1, time-based version
+    EDceSecurity    = (1 << 1), //< v2, DCE Security version
+    ENameBasedMd5   = (1 << 2), //< v3, name-based version with MD5 hashing
+    ERandomBased    = (1 << 3), //< v4, randomly or pseudo-randomly generated version
+    ENameBasedSha1  = (1 << 4)  //< v5, name-based version with SHA-1 hashing
+    };
+
+class TUpnpUuid
+/**
+ * A value type class that represents a UUID
+ */
+    {
+public:    
+    TUint32 iTimeLow;               /* bits  0-31 of time field */
+    TUint16 iTimeMid;               /* bits 32-47 of time field */
+    TUint16 iTimeHiAndVersion;      /* bits 48-59 of time field plus 4 bit version */
+    TUint8  iClockSeqHiAndReserved; /* bits  8-13 of clock sequence field plus 2 bit variant */
+    TUint8  iClockSeqLow;           /* bits  0-7  of clock sequence field */
+    TUint8  iNode[KNodeMacOctets];  /* bits  0-47 of node MAC address */
+    };
+
+class UpnpUuid
+/**
+ * A class for creating UUIDs and formatting them as strings
+ */
+    {
+public:    
+    static TInt MakeUuid(TUpnpUuid& aUuid, TUuidVersion aVersion = ERandomBased);
+    static void UuidToString(const TUpnpUuid& aUuid, TUuidString8& aUuidString);
+    static void GenerateUuidL(RBuf8& aUuid);
+    
+private:
+    static void RandomizeL(TUpnpUuid& aUuid);
+    static void Brand(TUpnpUuid& aUuid, TUuidVersion aVersion);
+    };
+
+#endif // __UPNPUUID_H__