uuid

package module
v1.2.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Sep 18, 2018 License: BSD-3-Clause Imports: 13 Imported by: 7,827

README

This project was automatically exported from code.google.com/p/go-uuid

uuid build status

The uuid package generates and inspects UUIDs based on RFC 4122 and DCE 1.1: Authentication and Security Services.

This package now leverages the github.com/google/uuid package (which is based off an earlier version of this package).

Install

go get github.com/pborman/uuid

Documentation

GoDoc

Full go doc style documentation for the package can be viewed online without installing this package by using the GoDoc site here: http://godoc.org/github.com/pborman/uuid

Documentation

Overview

The uuid package generates and inspects UUIDs.

UUIDs are based on RFC 4122 and DCE 1.1: Authentication and Security Services.

This package is a partial wrapper around the github.com/google/uuid package. This package represents a UUID as []byte while github.com/google/uuid represents a UUID as [16]byte.

Index

Constants

View Source 
const (
	Person = Domain(0)
	Group  = Domain(1)
	Org    = Domain(2)
)

Domain constants for DCE Security (Version 2) UUIDs.

View Source 
const (
	Invalid   = guuid.Invalid   // Invalid UUID
	RFC4122   = guuid.RFC4122   // The variant specified in RFC4122
	Reserved  = guuid.Reserved  // Reserved, NCS backward compatibility.
	Microsoft = guuid.Microsoft // Reserved, Microsoft Corporation backward compatibility.
	Future    = guuid.Future    // Reserved for future definition.
)

Constants returned by Variant.

Variables

View Source 
var (
	NameSpace_DNS  = Parse("6ba7b810-9dad-11d1-80b4-00c04fd430c8")
	NameSpace_URL  = Parse("6ba7b811-9dad-11d1-80b4-00c04fd430c8")
	NameSpace_OID  = Parse("6ba7b812-9dad-11d1-80b4-00c04fd430c8")
	NameSpace_X500 = Parse("6ba7b814-9dad-11d1-80b4-00c04fd430c8")
	NIL            = Parse("00000000-0000-0000-0000-000000000000")
)

Well known Name Space IDs and UUIDs

Functions

func ClockSequence 

func ClockSequence() int

ClockSequence returns the current clock sequence, generating one if not already set. The clock sequence is only used for Version 1 UUIDs.

The uuid package does not use global static storage for the clock sequence or the last time a UUID was generated. Unless SetClockSequence a new random clock sequence is generated the first time a clock sequence is requested by ClockSequence, GetTime, or NewUUID. (section 4.2.1.1) sequence is generated for

func Equal 

func Equal(uuid1, uuid2 UUID) bool

Equal returns true if uuid1 and uuid2 are equal.

func New 

func New() string

New returns a new random (version 4) UUID as a string. It is a convenience function for NewRandom().String().

func NodeID 

func NodeID() []byte

NodeID returns a slice of a copy of the current Node ID, setting the Node ID if not already set.

func NodeInterface 

func NodeInterface() string

NodeInterface returns the name of the interface from which the NodeID was derived. The interface "user" is returned if the NodeID was set by SetNodeID.

func SetClockSequence 

func SetClockSequence(seq int)

SetClockSeq sets the clock sequence to the lower 14 bits of seq. Setting to -1 causes a new sequence to be generated.

func SetNodeID 

func SetNodeID(id []byte) bool

SetNodeID sets the Node ID to be used for Version 1 UUIDs. The first 6 bytes of id are used. If id is less than 6 bytes then false is returned and the Node ID is not set.

func SetNodeInterface 

func SetNodeInterface(name string) bool

SetNodeInterface selects the hardware address to be used for Version 1 UUIDs. If name is "" then the first usable interface found will be used or a random Node ID will be generated. If a named interface cannot be found then false is returned.

SetNodeInterface never fails when name is "".

func SetRand 

func SetRand(r io.Reader)

SetRand sets the random number generator to r, which implements io.Reader. If r.Read returns an error when the package requests random data then a panic will be issued.

Calling SetRand with nil sets the random number generator to the default generator.

Types

type Array 

type Array [16]byte

Array is a pass-by-value UUID that can be used as an effecient key in a map.

func (Array) MarshalBinary 

func (u Array) MarshalBinary() ([]byte, error)

MarshalBinary implements encoding.BinaryMarshaler.

func (Array) MarshalText 

func (u Array) MarshalText() ([]byte, error)

MarshalText implements encoding.TextMarshaler.

func (Array) String 

func (uuid Array) String() string

String returns the string representation of uuid, xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.

func (Array) UUID 

func (uuid Array) UUID() UUID

UUID converts uuid into a slice.

func (*Array) UnmarshalBinary 

func (u *Array) UnmarshalBinary(data []byte) error

UnmarshalBinary implements encoding.BinaryUnmarshaler.

func (*Array) UnmarshalText 

func (u *Array) UnmarshalText(data []byte) error

UnmarshalText implements encoding.TextUnmarshaler.

type Domain 

type Domain byte

A Domain represents a Version 2 domain

func (Domain) String 

func (d Domain) String() string

type Time 

type Time = guuid.Time

A Time represents a time as the number of 100's of nanoseconds since 15 Oct 1582.

func GetTime 

func GetTime() (Time, uint16, error)

GetTime returns the current Time (100s of nanoseconds since 15 Oct 1582) and clock sequence as well as adjusting the clock sequence as needed. An error is returned if the current time cannot be determined.

type UUID 

type UUID []byte

A UUID is a 128 bit (16 byte) Universal Unique IDentifier as defined in RFC 4122.

func NewDCEGroup 

func NewDCEGroup() UUID

NewDCEGroup returns a DCE Security (Version 2) UUID in the group domain with the id returned by os.Getgid. 

NewDCEGroup(Group, uint32(os.Getgid()))

func NewDCEPerson 

func NewDCEPerson() UUID

NewDCEPerson returns a DCE Security (Version 2) UUID in the person domain with the id returned by os.Getuid. 

NewDCEPerson(Person, uint32(os.Getuid()))

func NewDCESecurity 

func NewDCESecurity(domain Domain, id uint32) UUID

NewDCESecurity returns a DCE Security (Version 2) UUID.

The domain should be one of Person, Group or Org. On a POSIX system the id should be the users UID for the Person domain and the users GID for the Group. The meaning of id for the domain Org or on non-POSIX systems is site defined.

For a given domain/id pair the same token may be returned for up to 7 minutes and 10 seconds.

func NewHash 

func NewHash(h hash.Hash, space UUID, data []byte, version int) UUID

NewHash returns a new UUID derived from the hash of space concatenated with data generated by h. The hash should be at least 16 byte in length. The first 16 bytes of the hash are used to form the UUID. The version of the UUID will be the lower 4 bits of version. NewHash is used to implement NewMD5 and NewSHA1.

func NewMD5 

func NewMD5(space UUID, data []byte) UUID

NewMD5 returns a new MD5 (Version 3) UUID based on the supplied name space and data. 

NewHash(md5.New(), space, data, 3)

func NewRandom 

func NewRandom() UUID

Random returns a Random (Version 4) UUID or panics.

The strength of the UUIDs is based on the strength of the crypto/rand package.

A note about uniqueness derived from the UUID Wikipedia entry: 

Randomly generated UUIDs have 122 random bits.  One's annual risk of being
hit by a meteorite is estimated to be one chance in 17 billion, that
means the probability is about 0.00000000006 (6 × 10−11),
equivalent to the odds of creating a few tens of trillions of UUIDs in a
year and having one duplicate.

func NewSHA1 

func NewSHA1(space UUID, data []byte) UUID

NewSHA1 returns a new SHA1 (Version 5) UUID based on the supplied name space and data. 

NewHash(sha1.New(), space, data, 5)

func NewUUID 

func NewUUID() UUID

NewUUID returns a Version 1 UUID based on the current NodeID and clock sequence, and the current time. If the NodeID has not been set by SetNodeID or SetNodeInterface then it will be set automatically. If the NodeID cannot be set NewUUID returns nil. If clock sequence has not been set by SetClockSequence then it will be set automatically. If GetTime fails to return the current NewUUID returns nil.

func Parse 

func Parse(s string) UUID

Parse decodes s into a UUID or returns nil. See github.com/google/uuid for the formats parsed.

func ParseBytes 

func ParseBytes(b []byte) (UUID, error)

ParseBytes is like Parse, except it parses a byte slice instead of a string.

func (UUID) Array 

func (uuid UUID) Array() Array

Array returns an array representation of uuid that can be used as a map key. Array panics if uuid is not valid.

func (UUID) ClockSequence 

func (uuid UUID) ClockSequence() (int, bool)

ClockSequence returns the clock sequence encoded in uuid. It returns false if uuid is not valid. The clock sequence is only well defined for version 1 and 2 UUIDs.

func (UUID) Domain 

func (uuid UUID) Domain() (Domain, bool)

Domain returns the domain for a Version 2 UUID or false.

func (UUID) Id 

func (uuid UUID) Id() (uint32, bool)

Id returns the id for a Version 2 UUID or false.

func (UUID) MarshalBinary 

func (u UUID) MarshalBinary() ([]byte, error)

MarshalBinary implements encoding.BinaryMarshaler.

func (UUID) MarshalText 

func (u UUID) MarshalText() ([]byte, error)

MarshalText implements encoding.TextMarshaler.

func (UUID) NodeID 

func (uuid UUID) NodeID() []byte

NodeID returns the 6 byte node id encoded in uuid. It returns nil if uuid is not valid. The NodeID is only well defined for version 1 and 2 UUIDs.

func (*UUID) Scan 

func (uuid *UUID) Scan(src interface{}) error

Scan implements sql.Scanner so UUIDs can be read from databases transparently Currently, database types that map to string and []byte are supported. Please consult database-specific driver documentation for matching types.

func (UUID) String 

func (uuid UUID) String() string

String returns the string form of uuid, xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx , or "" if uuid is invalid.

func (UUID) Time 

func (uuid UUID) Time() (Time, bool)

Time returns the time in 100s of nanoseconds since 15 Oct 1582 encoded in uuid. It returns false if uuid is not valid. The time is only well defined for version 1 and 2 UUIDs.

func (UUID) URN 

func (uuid UUID) URN() string

URN returns the RFC 2141 URN form of uuid, urn:uuid:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx, or "" if uuid is invalid.

func (*UUID) UnmarshalBinary 

func (u *UUID) UnmarshalBinary(data []byte) error

UnmarshalBinary implements encoding.BinaryUnmarshaler.

func (*UUID) UnmarshalText 

func (u *UUID) UnmarshalText(data []byte) error

UnmarshalText implements encoding.TextUnmarshaler.

func (UUID) Value 

func (uuid UUID) Value() (driver.Value, error)

Value implements sql.Valuer so that UUIDs can be written to databases transparently. Currently, UUIDs map to strings. Please consult database-specific driver documentation for matching types.

func (UUID) Variant 

func (uuid UUID) Variant() Variant

Variant returns the variant encoded in uuid. It returns Invalid if uuid is invalid.

func (UUID) Version 

func (uuid UUID) Version() (Version, bool)

Version returns the version of uuid. It returns false if uuid is not valid.

type Variant 

type Variant = guuid.Variant

A Variant represents a UUIDs variant.

type Version 

type Version = guuid.Version

A Version represents a UUIDs version.

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.