oui

Documentation

Overview

Updated version of https://github.com/dutchcoders/go-ouitools Package go-oui provides functions to work with MAC and OUI's

Index

• Variables
• func CIDRMask(ones, bits int) []byte
• type AddressBlock
  • func (b *AddressBlock) Contains(address HardwareAddr) bool
• type HardwareAddr
  • func ParseOUI(s string, size int) (hw HardwareAddr, err error)
  • func (address HardwareAddr) Mask(mask []byte) []byte
• type OuiDb
  • func New(reader io.Reader) *OuiDb
  • func (m *OuiDb) Load(file io.Reader) error
  • func (m *OuiDb) Lookup(address HardwareAddr) *AddressBlock
  • func (m *OuiDb) LookupString(s string) (*AddressBlock, error)
  • func (m *OuiDb) VendorLookup(s string) (string, error)

Variables

var ErrInvalidMACAddress = errors.New("invalid MAC address")

Functions

func CIDRMask

func CIDRMask(ones, bits int) []byte

Types

type AddressBlock

type AddressBlock struct {
	Organization string
	Oui          HardwareAddr
	Mask         int
}

oui, mask, organization

func (*AddressBlock) Contains

func (b *AddressBlock) Contains(address HardwareAddr) bool

Contains reports whether the mac address belongs to the OUI

type HardwareAddr

type HardwareAddr net.HardwareAddr

func ParseOUI

func ParseOUI(s string, size int) (hw HardwareAddr, err error)

ParseMAC parses s as an IEEE 802 MAC-48, EUI-48, or EUI-64 using one of the following formats:

01:23:45:67:89:ab
01:23:45:67:89:ab:cd:ef
01-23-45-67-89-ab
01-23-45-67-89-ab-cd-ef
0123.4567.89ab
0123.4567.89ab.cdef

func (HardwareAddr) Mask

func (address HardwareAddr) Mask(mask []byte) []byte

Mask returns the result of masking the address with mask.

type OuiDb

type OuiDb struct {
	Blocks []AddressBlock
}

func New

func New(reader io.Reader) *OuiDb

New returns a new OUI database loaded from the specified file.

func (*OuiDb) Load

func (m *OuiDb) Load(file io.Reader) error

func (*OuiDb) Lookup

func (m *OuiDb) Lookup(address HardwareAddr) *AddressBlock

Lookup finds the OUI the address belongs to

func (*OuiDb) LookupString

func (m *OuiDb) LookupString(s string) (*AddressBlock, error)

VendorLookup obtains the vendor organization name from the MAC address s.

func (*OuiDb) VendorLookup

func (m *OuiDb) VendorLookup(s string) (string, error)

VendorLookup obtains the vendor organization name from the MAC address s.