net

package
v2.42.2 Latest Latest
Warning

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

Go to latest
Published: Mar 11, 2023 License: MIT, BSD-3-Clause Imports: 13 Imported by: 0

Documentation

Index

Constants

View Source
const (
	CT_ENTRIES = iota
	CT_SEARCHED
	CT_FOUND
	CT_NEW
	CT_INVALID
	CT_IGNORE
	CT_DELETE
	CT_DELETE_LIST
	CT_INSERT
	CT_INSERT_FAILED
	CT_DROP
	CT_EARLY_DROP
	CT_ICMP_ERROR
	CT_EXPECT_NEW
	CT_EXPECT_CREATE
	CT_EXPECT_DELETE
	CT_SEARCH_RESTART
)

Variables

View Source
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 ConnectionsMaxWithoutUidsWithContext

func ConnectionsMaxWithoutUidsWithContext(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 ConnectionsPidMaxWithoutUids

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

func ConnectionsPidMaxWithoutUidsWithContext

func ConnectionsPidMaxWithoutUidsWithContext(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 ConnectionsPidWithoutUids

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

func ConnectionsPidWithoutUidsWithContext

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

func ConnectionsWithContext

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

func ConnectionsWithoutUids

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

Return a list of network connections opened, omitting `Uids`. WithoutUids functions are reliant on implementation details. They may be altered to be an alias for Connections or be removed from the API in the future.

func ConnectionsWithoutUidsWithContext

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

func (ConnectionStat) String

func (n ConnectionStat) String() string

type ConntrackStat

type ConntrackStat struct {
	Entries       uint32 `json:"entries"`        // Number of entries in the conntrack table
	Searched      uint32 `json:"searched"`       // Number of conntrack table lookups performed
	Found         uint32 `json:"found"`          // Number of searched entries which were successful
	New           uint32 `json:"new"`            // Number of entries added which were not expected before
	Invalid       uint32 `json:"invalid"`        // Number of packets seen which can not be tracked
	Ignore        uint32 `json:"ignore"`         // Packets seen which are already connected to an entry
	Delete        uint32 `json:"delete"`         // Number of entries which were removed
	DeleteList    uint32 `json:"delete_list"`    // Number of entries which were put to dying list
	Insert        uint32 `json:"insert"`         // Number of entries inserted into the list
	InsertFailed  uint32 `json:"insert_failed"`  // # insertion attempted but failed (same entry exists)
	Drop          uint32 `json:"drop"`           // Number of packets dropped due to conntrack failure.
	EarlyDrop     uint32 `json:"early_drop"`     // Dropped entries to make room for new ones, if maxsize reached
	IcmpError     uint32 `json:"icmp_error"`     // Subset of invalid. Packets that can't be tracked d/t error
	ExpectNew     uint32 `json:"expect_new"`     // Entries added after an expectation was already present
	ExpectCreate  uint32 `json:"expect_create"`  // Expectations added
	ExpectDelete  uint32 `json:"expect_delete"`  // Expectations deleted
	SearchRestart uint32 `json:"search_restart"` // Conntrack table lookups restarted due to hashtable resizes
}

ConntrackStat has conntrack summary info

func ConntrackStats

func ConntrackStats(percpu bool) ([]ConntrackStat, error)

ConntrackStats returns more detailed info about the conntrack table

func ConntrackStatsWithContext

func ConntrackStatsWithContext(ctx context.Context, percpu bool) ([]ConntrackStat, error)

ConntrackStatsWithContext returns more detailed info about the conntrack table

func NewConntrackStat

func NewConntrackStat(e uint32, s uint32, f uint32, n uint32, inv uint32, ign uint32, del uint32, dlst uint32, ins uint32, insfail uint32, drop uint32, edrop uint32, ie uint32, en uint32, ec uint32, ed uint32, sr uint32) *ConntrackStat

func (ConntrackStat) String

func (n ConntrackStat) String() string

type ConntrackStatList

type ConntrackStatList struct {
	// contains filtered or unexported fields
}

func NewConntrackStatList

func NewConntrackStatList() *ConntrackStatList

func (*ConntrackStatList) Append

func (l *ConntrackStatList) Append(c *ConntrackStat)

func (*ConntrackStatList) Items

func (l *ConntrackStatList) Items() []ConntrackStat

func (*ConntrackStatList) Summary

func (l *ConntrackStatList) Summary() []ConntrackStat

Summary returns a single-element list with totals from all list items.

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 {
	Index        int             `json:"index"`
	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

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL