socket

Documentation

Overview

Package socket provides functions that return fd and net.Addr based on given the protocol and address with a SO_REUSEPORT option set to the socket.

Index

• func GetTCPSockAddr(proto, addr string) (sa unix.Sockaddr, family int, tcpAddr *net.TCPAddr, ipv6only bool, err error)
• func GetUDPSockAddr(proto, addr string) (sa unix.Sockaddr, family int, udpAddr *net.UDPAddr, ipv6only bool, err error)
• func GetUnixSockAddr(proto, addr string) (sa unix.Sockaddr, family int, unixAddr *net.UnixAddr, err error)
• func SetIPv4MulticastMembership(fd int, mcast net.IP, ifIndex int) error
• func SetIPv6MulticastMembership(fd int, mcast net.IP, ifIndex int) error
• func SetIPv6Only(fd, ipv6only int) error
• func SetKeepAlivePeriod(fd, secs int) error
• func SetLinger(fd, sec int) error
• func SetMulticastMembership(proto string, udpAddr *net.UDPAddr) func(int, int) error
• func SetNoDelay(fd, noDelay int) error
• func SetRecvBuffer(fd, size int) error
• func SetReuseAddr(fd, reuseAddr int) error
• func SetReuseport(fd, reusePort int) error
• func SetSendBuffer(fd, size int) error
• func SockaddrToTCPOrUnixAddr(sa unix.Sockaddr) net.Addr
• func SockaddrToUDPAddr(sa unix.Sockaddr) net.Addr
• func TCPSocket(proto, addr string, passive bool, sockOpts ...Option) (int, net.Addr, error)
• func UDPSocket(proto, addr string, connect bool, sockOpts ...Option) (int, net.Addr, error)
• func UnixSocket(proto, addr string, passive bool, sockOpts ...Option) (int, net.Addr, error)
• type Option

Functions

func GetTCPSockAddr

func GetTCPSockAddr(proto, addr string) (sa unix.Sockaddr, family int, tcpAddr *net.TCPAddr, ipv6only bool, err error)

GetTCPSockAddr the structured addresses based on the protocol and raw address.

func GetUDPSockAddr

func GetUDPSockAddr(proto, addr string) (sa unix.Sockaddr, family int, udpAddr *net.UDPAddr, ipv6only bool, err error)

GetUDPSockAddr the structured addresses based on the protocol and raw address.

func GetUnixSockAddr

func GetUnixSockAddr(proto, addr string) (sa unix.Sockaddr, family int, unixAddr *net.UnixAddr, err error)

GetUnixSockAddr the structured addresses based on the protocol and raw address.

func SetIPv4MulticastMembership

func SetIPv4MulticastMembership(fd int, mcast net.IP, ifIndex int) error

SetIPv4MulticastMembership joins fd to the specified multicast IPv4 address. ifIndex is the index of the interface where the multicast datagrams will be received. If ifIndex is 0 then the operating system will choose the default, it is usually needed when the host has multiple network interfaces configured.

func SetIPv6MulticastMembership

func SetIPv6MulticastMembership(fd int, mcast net.IP, ifIndex int) error

SetIPv6MulticastMembership joins fd to the specified multicast IPv6 address. ifIndex is the index of the interface where the multicast datagrams will be received. If ifIndex is 0 then the operating system will choose the default, it is usually needed when the host has multiple network interfaces configured.

func SetIPv6Only

func SetIPv6Only(fd, ipv6only int) error

SetIPv6Only restricts a IPv6 socket to only process IPv6 requests or both IPv4 and IPv6 requests.

func SetKeepAlivePeriod

func SetKeepAlivePeriod(fd, secs int) error

SetKeepAlivePeriod sets whether the operating system should send keep-alive messages on the connection and sets period between TCP keep-alive probes.

func SetLinger

func SetLinger(fd, sec int) error

SetLinger sets the behavior of Close on a connection which still has data waiting to be sent or to be acknowledged.

If sec < 0 (the default), the operating system finishes sending the data in the background.

If sec == 0, the operating system discards any unsent or unacknowledged data.

If sec > 0, the data is sent in the background as with sec < 0. On some operating systems after sec seconds have elapsed any remaining unsent data may be discarded.

func SetMulticastMembership

func SetMulticastMembership(proto string, udpAddr *net.UDPAddr) func(int, int) error

SetMulticastMembership returns with a socket option function based on the IP version. Returns nil when multicast membership cannot be applied.

func SetNoDelay

func SetNoDelay(fd, noDelay int) error

SetNoDelay controls whether the operating system should delay packet transmission in hopes of sending fewer packets (Nagle's algorithm).

The default is true (no delay), meaning that data is sent as soon as possible after a Write.

func SetRecvBuffer

func SetRecvBuffer(fd, size int) error

SetRecvBuffer sets the size of the operating system's receive buffer associated with the connection.

func SetReuseAddr

func SetReuseAddr(fd, reuseAddr int) error

SetReuseAddr enables SO_REUSEADDR option on socket.

func SetReuseport

func SetReuseport(fd, reusePort int) error

SetReuseport enables SO_REUSEPORT option on socket.

func SetSendBuffer

func SetSendBuffer(fd, size int) error

SetSendBuffer sets the size of the operating system's transmit buffer associated with the connection.

func SockaddrToTCPOrUnixAddr

func SockaddrToTCPOrUnixAddr(sa unix.Sockaddr) net.Addr

SockaddrToTCPOrUnixAddr converts a Sockaddr to a net.TCPAddr or net.UnixAddr. Returns nil if conversion fails.

func SockaddrToUDPAddr

func SockaddrToUDPAddr(sa unix.Sockaddr) net.Addr

SockaddrToUDPAddr converts a Sockaddr to a net.UDPAddr Returns nil if conversion fails.

func TCPSocket

func TCPSocket(proto, addr string, passive bool, sockOpts ...Option) (int, net.Addr, error)

TCPSocket calls the internal tcpSocket.

func UDPSocket

func UDPSocket(proto, addr string, connect bool, sockOpts ...Option) (int, net.Addr, error)

UDPSocket calls the internal udpSocket.

func UnixSocket

func UnixSocket(proto, addr string, passive bool, sockOpts ...Option) (int, net.Addr, error)

UnixSocket calls the internal udsSocket.

Types

type Option

type Option struct {
	SetSockOpt func(int, int) error
	Opt        int
}

Option is used for setting an option on socket.