hash.go 1.9 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859
  1. // Copyright 2016 Google Inc. All rights reserved.
  2. // Use of this source code is governed by a BSD-style
  3. // license that can be found in the LICENSE file.
  4. package uuid
  5. import (
  6. "crypto/md5"
  7. "crypto/sha1"
  8. "hash"
  9. )
  10. // Well known namespace IDs and UUIDs
  11. var (
  12. NameSpaceDNS = Must(Parse("6ba7b810-9dad-11d1-80b4-00c04fd430c8"))
  13. NameSpaceURL = Must(Parse("6ba7b811-9dad-11d1-80b4-00c04fd430c8"))
  14. NameSpaceOID = Must(Parse("6ba7b812-9dad-11d1-80b4-00c04fd430c8"))
  15. NameSpaceX500 = Must(Parse("6ba7b814-9dad-11d1-80b4-00c04fd430c8"))
  16. Nil UUID // empty UUID, all zeros
  17. // The Max UUID is special form of UUID that is specified to have all 128 bits set to 1.
  18. Max = UUID{
  19. 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
  20. 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
  21. }
  22. )
  23. // NewHash returns a new UUID derived from the hash of space concatenated with
  24. // data generated by h. The hash should be at least 16 byte in length. The
  25. // first 16 bytes of the hash are used to form the UUID. The version of the
  26. // UUID will be the lower 4 bits of version. NewHash is used to implement
  27. // NewMD5 and NewSHA1.
  28. func NewHash(h hash.Hash, space UUID, data []byte, version int) UUID {
  29. h.Reset()
  30. h.Write(space[:]) //nolint:errcheck
  31. h.Write(data) //nolint:errcheck
  32. s := h.Sum(nil)
  33. var uuid UUID
  34. copy(uuid[:], s)
  35. uuid[6] = (uuid[6] & 0x0f) | uint8((version&0xf)<<4)
  36. uuid[8] = (uuid[8] & 0x3f) | 0x80 // RFC 4122 variant
  37. return uuid
  38. }
  39. // NewMD5 returns a new MD5 (Version 3) UUID based on the
  40. // supplied name space and data. It is the same as calling:
  41. //
  42. // NewHash(md5.New(), space, data, 3)
  43. func NewMD5(space UUID, data []byte) UUID {
  44. return NewHash(md5.New(), space, data, 3)
  45. }
  46. // NewSHA1 returns a new SHA1 (Version 5) UUID based on the
  47. // supplied name space and data. It is the same as calling:
  48. //
  49. // NewHash(sha1.New(), space, data, 5)
  50. func NewSHA1(space UUID, data []byte) UUID {
  51. return NewHash(sha1.New(), space, data, 5)
  52. }