net

Documentation

Index

• Variables
• func Pids() ([]int32, error)
• func PidsWithContext(ctx context.Context) ([]int32, error)
• func Reverse(s []byte) []byte
• func ReverseWithContext(ctx context.Context, s []byte) []byte
• type Addr
  • func (a Addr) String() string
• type ConnectionStat
  • func Connections(kind string) ([]ConnectionStat, error)
  • func ConnectionsMax(kind string, max int) ([]ConnectionStat, error)
  • func ConnectionsMaxWithContext(ctx context.Context, kind string, max int) ([]ConnectionStat, error)
  • func ConnectionsPid(kind string, pid int32) ([]ConnectionStat, error)
  • func ConnectionsPidMax(kind string, pid int32, max int) ([]ConnectionStat, error)
  • func ConnectionsPidMaxWithContext(ctx context.Context, kind string, pid int32, max int) ([]ConnectionStat, error)
  • func ConnectionsPidWithContext(ctx context.Context, kind string, pid int32) ([]ConnectionStat, error)
  • func ConnectionsWithContext(ctx context.Context, kind string) ([]ConnectionStat, error)
  • func (n ConnectionStat) String() string
• type FilterStat
  • func FilterCounters() ([]FilterStat, error)
  • func FilterCountersWithContext(ctx context.Context) ([]FilterStat, error)
• type IOCountersStat
  • func IOCounters(pernic bool) ([]IOCountersStat, error)
  • func IOCountersByFile(pernic bool, filename string) ([]IOCountersStat, error)
  • func IOCountersByFileWithContext(ctx context.Context, pernic bool, filename string) ([]IOCountersStat, error)
  • func IOCountersWithContext(ctx context.Context, pernic bool) ([]IOCountersStat, error)
  • func (n IOCountersStat) String() string
• type InterfaceAddr
  • func (n InterfaceAddr) String() string
• type InterfaceStat
  • func Interfaces() ([]InterfaceStat, error)
  • func InterfacesWithContext(ctx context.Context) ([]InterfaceStat, error)
  • func (n InterfaceStat) String() string
• type ProtoCountersStat
  • func ProtoCounters(protocols []string) ([]ProtoCountersStat, error)
  • func ProtoCountersWithContext(ctx context.Context, protocols []string) ([]ProtoCountersStat, error)
  • func (n ProtoCountersStat) String() string

Variables

var TCPStatuses = map[string]string{
	"01": "ESTABLISHED",
	"02": "SYN_SENT",
	"03": "SYN_RECV",
	"04": "FIN_WAIT1",
	"05": "FIN_WAIT2",
	"06": "TIME_WAIT",
	"07": "CLOSE",
	"08": "CLOSE_WAIT",
	"09": "LAST_ACK",
	"0A": "LISTEN",
	"0B": "CLOSING",
}

http://students.mimuw.edu.pl/lxr/source/include/net/tcp_states.h

Functions

func Pids

func Pids() ([]int32, error)

Pids retunres all pids. Note: this is a copy of process_linux.Pids() FIXME: Import process occures import cycle. move to common made other platform breaking. Need consider.

func PidsWithContext

func PidsWithContext(ctx context.Context) ([]int32, error)

func Reverse

func Reverse(s []byte) []byte

Reverse reverses array of bytes.

func ReverseWithContext

func ReverseWithContext(ctx context.Context, s []byte) []byte

Types

type Addr

type Addr struct {
	IP   string `json:"ip"`
	Port uint32 `json:"port"`
}

Addr is implemented compatibility to psutil

func (Addr) String

func (a Addr) String() string

type ConnectionStat

type ConnectionStat struct {
	Fd     uint32  `json:"fd"`
	Family uint32  `json:"family"`
	Type   uint32  `json:"type"`
	Laddr  Addr    `json:"localaddr"`
	Raddr  Addr    `json:"remoteaddr"`
	Status string  `json:"status"`
	Uids   []int32 `json:"uids"`
	Pid    int32   `json:"pid"`
}

func Connections

func Connections(kind string) ([]ConnectionStat, error)

Return a list of network connections opened.

func ConnectionsMax

func ConnectionsMax(kind string, max int) ([]ConnectionStat, error)

Return a list of network connections opened returning at most `max` connections for each running process.

func ConnectionsMaxWithContext

func ConnectionsMaxWithContext(ctx context.Context, kind string, max int) ([]ConnectionStat, error)

func ConnectionsPid

func ConnectionsPid(kind string, pid int32) ([]ConnectionStat, error)

Return a list of network connections opened by a process.

func ConnectionsPidMax

func ConnectionsPidMax(kind string, pid int32, max int) ([]ConnectionStat, error)

Return up to `max` network connections opened by a process.

func ConnectionsPidMaxWithContext

func ConnectionsPidMaxWithContext(ctx context.Context, kind string, pid int32, max int) ([]ConnectionStat, error)

func ConnectionsPidWithContext

func ConnectionsPidWithContext(ctx context.Context, kind string, pid int32) ([]ConnectionStat, error)

func ConnectionsWithContext

func ConnectionsWithContext(ctx context.Context, kind string) ([]ConnectionStat, error)

func (ConnectionStat) String

func (n ConnectionStat) String() string

type FilterStat

type FilterStat struct {
	ConnTrackCount int64 `json:"conntrackCount"`
	ConnTrackMax   int64 `json:"conntrackMax"`
}

func FilterCounters

func FilterCounters() ([]FilterStat, error)

NetFilterCounters returns iptables conntrack statistics the currently in use conntrack count and the max. If the file does not exist or is invalid it will return nil.

func FilterCountersWithContext

func FilterCountersWithContext(ctx context.Context) ([]FilterStat, error)

type IOCountersStat

type IOCountersStat struct {
	Name        string `json:"name"`        // interface name
	BytesSent   uint64 `json:"bytesSent"`   // number of bytes sent
	BytesRecv   uint64 `json:"bytesRecv"`   // number of bytes received
	PacketsSent uint64 `json:"packetsSent"` // number of packets sent
	PacketsRecv uint64 `json:"packetsRecv"` // number of packets received
	Errin       uint64 `json:"errin"`       // total number of errors while receiving
	Errout      uint64 `json:"errout"`      // total number of errors while sending
	Dropin      uint64 `json:"dropin"`      // total number of incoming packets which were dropped
	Dropout     uint64 `json:"dropout"`     // total number of outgoing packets which were dropped (always 0 on OSX and BSD)
	Fifoin      uint64 `json:"fifoin"`      // total number of FIFO buffers errors while receiving
	Fifoout     uint64 `json:"fifoout"`     // total number of FIFO buffers errors while sending

}

func IOCounters

func IOCounters(pernic bool) ([]IOCountersStat, error)

NetIOCounters returnes network I/O statistics for every network interface installed on the system. If pernic argument is false, return only sum of all information (which name is 'all'). If true, every network interface installed on the system is returned separately.

func IOCountersByFile

func IOCountersByFile(pernic bool, filename string) ([]IOCountersStat, error)

func IOCountersByFileWithContext

func IOCountersByFileWithContext(ctx context.Context, pernic bool, filename string) ([]IOCountersStat, error)

func IOCountersWithContext

func IOCountersWithContext(ctx context.Context, pernic bool) ([]IOCountersStat, error)

func (IOCountersStat) String

func (n IOCountersStat) String() string

type InterfaceAddr

type InterfaceAddr struct {
	Addr string `json:"addr"`
}

NetInterfaceAddr is designed for represent interface addresses

func (InterfaceAddr) String

func (n InterfaceAddr) String() string

type InterfaceStat

type InterfaceStat struct {
	MTU          int             `json:"mtu"`          // maximum transmission unit
	Name         string          `json:"name"`         // e.g., "en0", "lo0", "eth0.100"
	HardwareAddr string          `json:"hardwareaddr"` // IEEE MAC-48, EUI-48 and EUI-64 form
	Flags        []string        `json:"flags"`        // e.g., FlagUp, FlagLoopback, FlagMulticast
	Addrs        []InterfaceAddr `json:"addrs"`
}

func Interfaces

func Interfaces() ([]InterfaceStat, error)

func InterfacesWithContext

func InterfacesWithContext(ctx context.Context) ([]InterfaceStat, error)

func (InterfaceStat) String

func (n InterfaceStat) String() string

type ProtoCountersStat

type ProtoCountersStat struct {
	Protocol string           `json:"protocol"`
	Stats    map[string]int64 `json:"stats"`
}

System wide stats about different network protocols

func ProtoCounters

func ProtoCounters(protocols []string) ([]ProtoCountersStat, error)

NetProtoCounters returns network statistics for the entire system If protocols is empty then all protocols are returned, otherwise just the protocols in the list are returned. Available protocols:

ip,icmp,icmpmsg,tcp,udp,udplite

func ProtoCountersWithContext

func ProtoCountersWithContext(ctx context.Context, protocols []string) ([]ProtoCountersStat, error)

func (ProtoCountersStat) String

func (n ProtoCountersStat) String() string