blob: 50a0f2d099248e25ad96b739a7d8b39c528a0bab [file] [log] [blame]
Matthias Andreas Benkard832a54e2019-01-29 09:27:38 +01001// 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
5package uuid
6
7import (
8 "encoding/binary"
9 "fmt"
10 "os"
11)
12
13// A Domain represents a Version 2 domain
14type Domain byte
15
16// Domain constants for DCE Security (Version 2) UUIDs.
17const (
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.
32func 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()))
46func 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()))
54func NewDCEGroup() UUID {
55 return NewDCESecurity(Group, uint32(os.Getgid()))
56}
57
58// Domain returns the domain for a Version 2 UUID or false.
59func (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.
67func (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
74func (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}