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.
13 // A Domain represents a Version 2 domain
16 // Domain constants for DCE Security (Version 2) UUIDs.
23 // NewDCESecurity returns a DCE Security (Version 2) UUID.
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.
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 {
35 uuid[6] = (uuid[6] & 0x0f) | 0x20 // Version 2
36 uuid[9] = byte(domain)
37 binary.BigEndian.PutUint32(uuid[0:], id)
42 // NewDCEPerson returns a DCE Security (Version 2) UUID in the person
43 // domain with the id returned by os.Getuid.
45 // NewDCEPerson(Person, uint32(os.Getuid()))
46 func NewDCEPerson() UUID {
47 return NewDCESecurity(Person, uint32(os.Getuid()))
50 // NewDCEGroup returns a DCE Security (Version 2) UUID in the group
51 // domain with the id returned by os.Getgid.
53 // NewDCEGroup(Group, uint32(os.Getgid()))
54 func NewDCEGroup() UUID {
55 return NewDCESecurity(Group, uint32(os.Getgid()))
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 {
63 return Domain(uuid[9]), true
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 {
71 return binary.BigEndian.Uint32(uuid[0:4]), true
74 func (d Domain) String() string {
83 return fmt.Sprintf("Domain%d", int(d))