2011-09-16 17:47:21 +02:00
|
|
|
// Copyright 2011 The Go Authors. All rights reserved.
|
|
|
|
// Use of this source code is governed by a BSD-style
|
|
|
|
// license that can be found in the LICENSE file.
|
|
|
|
|
|
|
|
// Network interface identification
|
|
|
|
|
|
|
|
package net
|
|
|
|
|
2012-03-06 18:57:23 +01:00
|
|
|
import "errors"
|
2011-09-16 17:47:21 +02:00
|
|
|
|
2012-01-25 21:56:26 +01:00
|
|
|
var (
|
|
|
|
errInvalidInterface = errors.New("net: invalid interface")
|
|
|
|
errInvalidInterfaceIndex = errors.New("net: invalid interface index")
|
|
|
|
errInvalidInterfaceName = errors.New("net: invalid interface name")
|
|
|
|
errNoSuchInterface = errors.New("net: no such interface")
|
|
|
|
errNoSuchMulticastInterface = errors.New("net: no such multicast interface")
|
|
|
|
)
|
|
|
|
|
2011-09-16 17:47:21 +02:00
|
|
|
// Interface represents a mapping between network interface name
|
|
|
|
// and index. It also represents network interface facility
|
|
|
|
// information.
|
|
|
|
type Interface struct {
|
|
|
|
Index int // positive integer that starts at one, zero is never used
|
|
|
|
MTU int // maximum transmission unit
|
|
|
|
Name string // e.g., "en0", "lo0", "eth0.100"
|
|
|
|
HardwareAddr HardwareAddr // IEEE MAC-48, EUI-48 and EUI-64 form
|
|
|
|
Flags Flags // e.g., FlagUp, FlagLoopback, FlagMulticast
|
|
|
|
}
|
|
|
|
|
|
|
|
type Flags uint
|
|
|
|
|
|
|
|
const (
|
|
|
|
FlagUp Flags = 1 << iota // interface is up
|
|
|
|
FlagBroadcast // interface supports broadcast access capability
|
|
|
|
FlagLoopback // interface is a loopback interface
|
|
|
|
FlagPointToPoint // interface belongs to a point-to-point link
|
|
|
|
FlagMulticast // interface supports multicast access capability
|
|
|
|
)
|
|
|
|
|
|
|
|
var flagNames = []string{
|
|
|
|
"up",
|
|
|
|
"broadcast",
|
|
|
|
"loopback",
|
|
|
|
"pointtopoint",
|
|
|
|
"multicast",
|
|
|
|
}
|
|
|
|
|
|
|
|
func (f Flags) String() string {
|
|
|
|
s := ""
|
|
|
|
for i, name := range flagNames {
|
|
|
|
if f&(1<<uint(i)) != 0 {
|
|
|
|
if s != "" {
|
|
|
|
s += "|"
|
|
|
|
}
|
|
|
|
s += name
|
|
|
|
}
|
|
|
|
}
|
|
|
|
if s == "" {
|
|
|
|
s = "0"
|
|
|
|
}
|
|
|
|
return s
|
|
|
|
}
|
|
|
|
|
|
|
|
// Addrs returns interface addresses for a specific interface.
|
2011-12-03 03:17:34 +01:00
|
|
|
func (ifi *Interface) Addrs() ([]Addr, error) {
|
2011-09-16 17:47:21 +02:00
|
|
|
if ifi == nil {
|
2012-01-25 21:56:26 +01:00
|
|
|
return nil, errInvalidInterface
|
2011-09-16 17:47:21 +02:00
|
|
|
}
|
|
|
|
return interfaceAddrTable(ifi.Index)
|
|
|
|
}
|
|
|
|
|
|
|
|
// MulticastAddrs returns multicast, joined group addresses for
|
|
|
|
// a specific interface.
|
2011-12-03 03:17:34 +01:00
|
|
|
func (ifi *Interface) MulticastAddrs() ([]Addr, error) {
|
2011-09-16 17:47:21 +02:00
|
|
|
if ifi == nil {
|
2012-01-25 21:56:26 +01:00
|
|
|
return nil, errInvalidInterface
|
2011-09-16 17:47:21 +02:00
|
|
|
}
|
|
|
|
return interfaceMulticastAddrTable(ifi.Index)
|
|
|
|
}
|
|
|
|
|
|
|
|
// Interfaces returns a list of the systems's network interfaces.
|
2011-12-03 03:17:34 +01:00
|
|
|
func Interfaces() ([]Interface, error) {
|
2011-09-16 17:47:21 +02:00
|
|
|
return interfaceTable(0)
|
|
|
|
}
|
|
|
|
|
|
|
|
// InterfaceAddrs returns a list of the system's network interface
|
|
|
|
// addresses.
|
2011-12-03 03:17:34 +01:00
|
|
|
func InterfaceAddrs() ([]Addr, error) {
|
2011-09-16 17:47:21 +02:00
|
|
|
return interfaceAddrTable(0)
|
|
|
|
}
|
|
|
|
|
|
|
|
// InterfaceByIndex returns the interface specified by index.
|
2011-12-03 03:17:34 +01:00
|
|
|
func InterfaceByIndex(index int) (*Interface, error) {
|
2011-09-16 17:47:21 +02:00
|
|
|
if index <= 0 {
|
2012-01-25 21:56:26 +01:00
|
|
|
return nil, errInvalidInterfaceIndex
|
2011-09-16 17:47:21 +02:00
|
|
|
}
|
|
|
|
ift, err := interfaceTable(index)
|
|
|
|
if err != nil {
|
|
|
|
return nil, err
|
|
|
|
}
|
|
|
|
for _, ifi := range ift {
|
|
|
|
return &ifi, nil
|
|
|
|
}
|
2012-01-25 21:56:26 +01:00
|
|
|
return nil, errNoSuchInterface
|
2011-09-16 17:47:21 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
// InterfaceByName returns the interface specified by name.
|
2011-12-03 03:17:34 +01:00
|
|
|
func InterfaceByName(name string) (*Interface, error) {
|
2011-09-16 17:47:21 +02:00
|
|
|
if name == "" {
|
2012-01-25 21:56:26 +01:00
|
|
|
return nil, errInvalidInterfaceName
|
2011-09-16 17:47:21 +02:00
|
|
|
}
|
|
|
|
ift, err := interfaceTable(0)
|
|
|
|
if err != nil {
|
|
|
|
return nil, err
|
|
|
|
}
|
|
|
|
for _, ifi := range ift {
|
|
|
|
if name == ifi.Name {
|
|
|
|
return &ifi, nil
|
|
|
|
}
|
|
|
|
}
|
2012-01-25 21:56:26 +01:00
|
|
|
return nil, errNoSuchInterface
|
2011-09-16 17:47:21 +02:00
|
|
|
}
|