| 1 |
// Copyright 2011 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 |
|
| 5 |
package uuid |
| 6 |
|
| 7 |
import ( |
| 8 |
"encoding/binary" |
| 9 |
"fmt" |
| 10 |
"os" |
| 11 |
) |
| 12 |
|
| 13 |
// A Domain represents a Version 2 domain |
| 14 |
type Domain byte |
| 15 |
|
| 16 |
// Domain constants for DCE Security (Version 2) UUIDs. |
| 17 |
const ( |
| 18 |
Person = Domain(0) |
| 19 |
Group = Domain(1) |
| 20 |
Org = Domain(2) |
| 21 |
) |
| 22 |
|
| 23 |
// NewDCESecurity returns a DCE Security (Version 2) UUID. |
| 24 |
// |
| 25 |
// The domain should be one of Person, Group or Org. |
| 26 |
// On a POSIX system the id should be the users UID for the Person |
| 27 |
// domain and the users GID for the Group. The meaning of id for |
| 28 |
// the domain Org or on non-POSIX systems is site defined. |
| 29 |
// |
| 30 |
// For a given domain/id pair the same token may be returned for up to |
| 31 |
// 7 minutes and 10 seconds. |
| 32 |
func NewDCESecurity(domain Domain, id uint32) UUID { |
| 33 |
uuid := NewUUID() |
| 34 |
if uuid != nil { |
| 35 |
uuid[6] = (uuid[6] & 0x0f) | 0x20 // Version 2 |
| 36 |
uuid[9] = byte(domain) |
| 37 |
binary.BigEndian.PutUint32(uuid[0:], id) |
| 38 |
} |
| 39 |
return uuid |
| 40 |
} |
| 41 |
|
| 42 |
// NewDCEPerson returns a DCE Security (Version 2) UUID in the person |
| 43 |
// domain with the id returned by os.Getuid. |
| 44 |
// |
| 45 |
// NewDCEPerson(Person, uint32(os.Getuid())) |
| 46 |
func NewDCEPerson() UUID { |
| 47 |
return NewDCESecurity(Person, uint32(os.Getuid())) |
| 48 |
} |
| 49 |
|
| 50 |
// NewDCEGroup returns a DCE Security (Version 2) UUID in the group |
| 51 |
// domain with the id returned by os.Getgid. |
| 52 |
// |
| 53 |
// NewDCEGroup(Group, uint32(os.Getgid())) |
| 54 |
func NewDCEGroup() UUID { |
| 55 |
return NewDCESecurity(Group, uint32(os.Getgid())) |
| 56 |
} |
| 57 |
|
| 58 |
// Domain returns the domain for a Version 2 UUID or false. |
| 59 |
func (uuid UUID) Domain() (Domain, bool) { |
| 60 |
if v, _ := uuid.Version(); v != 2 { |
| 61 |
return 0, false |
| 62 |
} |
| 63 |
return Domain(uuid[9]), true |
| 64 |
} |
| 65 |
|
| 66 |
// Id returns the id for a Version 2 UUID or false. |
| 67 |
func (uuid UUID) Id() (uint32, bool) { |
| 68 |
if v, _ := uuid.Version(); v != 2 { |
| 69 |
return 0, false |
| 70 |
} |
| 71 |
return binary.BigEndian.Uint32(uuid[0:4]), true |
| 72 |
} |
| 73 |
|
| 74 |
func (d Domain) String() string { |
| 75 |
switch d { |
| 76 |
case Person: |
| 77 |
return "Person" |
| 78 |
case Group: |
| 79 |
return "Group" |
| 80 |
case Org: |
| 81 |
return "Org" |
| 82 |
} |
| 83 |
return fmt.Sprintf("Domain%d", int(d)) |
| 84 |
} |