Пакет net
Обзор
Пакет net предоставляет переносимый интерфейс для сетевого ввода-вывода, включая TCP/IP, UDP, разрешение доменных имён и сокеты Unix-домена.
Хотя пакет предоставляет доступ к низкоуровневым сетевым примитивам, большинству клиентов потребуется только базовый интерфейс, предоставляемый функциями Dial, Listen и Accept, а также связанными интерфейсами Conn и Listener. Пакет crypto/tls использует те же интерфейсы и аналогичные функции Dial и Listen.
Функция Dial подключается к серверу:
conn, err := net.Dial("tcp", "golang.org:80")
if err != nil {
// handle error
}
fmt.Fprintf(conn, "GET / HTTP/1.0\r\n\r\n")
status, err := bufio.NewReader(conn).ReadString('\n')
// ...
Функция Listen создаёт серверы:
ln, err := net.Listen("tcp", ":8080")
if err != nil {
// handle error
}
for {
conn, err := ln.Accept()
if err != nil {
// handle error
}
go handleConnection(conn)
}
Разрешение имён
Метод разрешения доменных имён, будь то косвенно с помощью функций, таких как Dial, или напрямую с помощью функций, таких как LookupHost и LookupAddr, варьируется в зависимости от операционной системы.
В системах Unix у решателя есть два варианта разрешения имён. Он может использовать чистый решатель Go, который отправляет запросы DNS напрямую серверам, указанным в /etc/resolv.conf, или может использовать решатель на основе cgo, который вызывает функции C-библиотеки, такие как getaddrinfo и getnameinfo.
В Unix системах чистый решатель Go предпочтительнее решателя на основе cgo, потому что заблокированный запрос DNS потребляет только горутину, а заблокированный вызов C потребляет системную нить операционной системы. Когда доступен cgo, решатель на основе cgo используется вместо него в различных условиях: в системах, которые не позволяют программам делать прямые запросы DNS (OS X), когда переменная среды LOCALDOMAIN присутствует (даже если она пуста), когда переменная среды RES_OPTIONS или HOSTALIASES не пуста, когда переменная среды ASR_CONFIG не пуста (только OpenBSD), когда /etc/resolv.conf или /etc/nsswitch.conf указывают на использование функций, которые решатель Go не реализует.
Во всех системах (кроме Plan 9), когда используется решатель на основе cgo, в этом пакете применяется ограничение на одновременные запросы cgo-поиска, чтобы предотвратить выход системы из строя из-за нехватки системных нитей. В настоящее время оно ограничено 500 одновременными поисками.
Решение решателя можно переопределить, установив значение netdns переменной среды GODEBUG (см. пакет runtime) в go или cgo, как в:
export GODEBUG=netdns=go # force pure Go resolver export GODEBUG=netdns=cgo # force native resolver (cgo, win32)
Решение также можно принудительно задать при построении дерева исходного кода Go, установив тег сборки netgo или netcgo. Тег сборки netgo полностью отключает использование родного (CGO) решателя, что означает, что решатель Go является единственным доступным. С тегом сборки netcgo родной и чистый решатель Go компилируются в исполняемый файл, но родной (CGO) решатель предпочтительнее решателя Go. С netcgo решатель Go все еще можно принудительно установить во время выполнения с помощью GODEBUG=netdns=go.
Числовое значение netdns, как в GODEBUG=netdns=1, заставляет решатель печатать отладочную информацию о своих решениях. Чтобы принудительно задать конкретный решатель, а также печатать отладочную информацию, объедините два значения знаком «плюс», как в GODEBUG=netdns=go+1.
Решатель Go будет отправлять дополнительный заголовок EDNS0 с запросом DNS, чтобы сигнализировать о готовности принять больший размер пакета DNS. Сообщается, что это может вызывать спорадические сбои у сервера DNS, работающего на некоторых модемах и маршрутизаторах. Установка GODEBUG=netedns0=0 отключит отправку дополнительного заголовка.
В macOS, если код Go, использующий пакет net, построен с помощью -buildmode=c-archive, для линковки результирующего архива в программу C необходимо передать -lresolv при линковке кода C.
В Plan 9 решатель всегда обращается к /net/cs и /net/dns.
В Windows в Go 1.18.x и ранее решатель всегда использовал функции C-библиотеки, такие как GetAddrInfo и DnsQuery.
Индекс
Примеры
Файлы пакета
addrselect.go cgo_linux.go cgo_resnew.go cgo_socknew.go cgo_unix.go cgo_unix_cgo.go cgo_unix_cgo_res.go conf.go dial.go dnsclient.go dnsclient_unix.go dnsconfig.go dnsconfig_unix.go error_posix.go error_unix.go fd_posix.go fd_unix.go file.go file_unix.go hook.go hook_unix.go hosts.go interface.go interface_linux.go ip.go iprawsock.go iprawsock_posix.go ipsock.go ipsock_posix.go lookup.go lookup_unix.go mac.go mptcpsock_linux.go net.go netcgo_off.go netgo_off.go nss.go parse.go pipe.go port.go port_unix.go rawconn.go rlimit_unix.go sendfile_linux.go sock_cloexec.go sock_linux.go sock_posix.go sockaddr_posix.go sockopt_linux.go sockopt_posix.go sockoptip_linux.go sockoptip_posix.go splice_linux.go tcpsock.go tcpsock_posix.go tcpsock_unix.go tcpsockopt_posix.go tcpsockopt_unix.go udpsock.go udpsock_posix.go unixsock.go unixsock_posix.go unixsock_readmsg_cmsg_cloexec.go writev_unix.go
Константы
Длины адресов IP (байты).
const (
IPv4len = 4
IPv6len = 16
) Переменные
Известные адреса IPv4
var (
IPv4bcast = IPv4(255, 255, 255, 255) // limited broadcast
IPv4allsys = IPv4(224, 0, 0, 1) // all systems
IPv4allrouter = IPv4(224, 0, 0, 2) // all routers
IPv4zero = IPv4(0, 0, 0, 0) // all zeros
) Известные адреса IPv6
var (
IPv6zero = IP{0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0}
IPv6unspecified = IP{0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0}
IPv6loopback = IP{0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1}
IPv6interfacelocalallnodes = IP{0xff, 0x01, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0x01}
IPv6linklocalallnodes = IP{0xff, 0x02, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0x01}
IPv6linklocalallrouters = IP{0xff, 0x02, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0x02}
) DefaultResolver — это разрешитель, используемый функциями Lookup на уровне пакета и Dialer без указанного разрешителя.
var DefaultResolver = &Resolver{} ErrClosed — это ошибка, возвращаемая вызовом ввода-вывода по сетевому соединению, которое уже было закрыто или закрыто другой горутиной до завершения ввода-вывода. Это может быть обернуто в другую ошибку, и обычно следует проверять с помощью errors.Is(err, net.ErrClosed).
var ErrClosed error = errClosed
Различные ошибки, содержащиеся в OpError.
var (
ErrWriteToConnected = errors.New("use of WriteTo with pre-connected connection")
) Функция JoinHostPort
func JoinHostPort(host, port string) string
JoinHostPort объединяет хост и порт в сетевой адрес вида «хост:порт». Если хост содержит двоеточие, как в литеральных адресах IPv6, то JoinHostPort возвращает «[хост]:порт».
См. функцию Dial для описания параметров хост и порт.
Функция LookupAddr
func LookupAddr(addr string) (names []string, err error)
LookupAddr выполняет обратный поиск для заданного адреса, возвращая список имен, сопоставленных с этим адресом.
Возвращаемые имена проверяются на корректность формата представлений доменных имен. Если ответ содержит некорректные имена, такие записи отфильтровываются, а вместе с оставшимися результатами, если таковые имеются, возвращается ошибка.
При использовании разрешителя C библиотеки хоста возвращается не более одного результата. Чтобы обойти разрешитель хоста, используйте настраиваемый Resolver.
LookupAddr использует context.Background внутри; для указания контекста используйте Resolver.LookupAddr.
Функция LookupCNAME
func LookupCNAME(host string) (cname string, err error)
LookupCNAME возвращает каноническое имя для заданного хоста. Вызывающие стороны, которым не нужно каноническое имя, могут напрямую вызвать LookupHost или LookupIP; оба заботятся о разрешении канонического имени как части поиска.
Каноническое имя — это окончательное имя после следования нулю или более записям CNAME. LookupCNAME не возвращает ошибку, если хост не содержит DNS-записи «CNAME», пока хост разрешается в записи адреса.
Возвращаемое каноническое имя проверяется на соответствие формату представлений доменного имени.
LookupCNAME использует context.Background внутри; для указания контекста используйте Resolver.LookupCNAME.
Функция LookupHost
func LookupHost(host string) (addrs []string, err error)
LookupHost ищет заданный хост с помощью локального разрешителя. Он возвращает массив адресов этого хоста.
LookupHost использует context.Background внутри; для указания контекста используйте Resolver.LookupHost.
Функция LookupPort
func LookupPort(network, service string) (port int, err error)
LookupPort ищет порт для заданной сети и службы.
LookupPort использует context.Background внутри; для указания контекста используйте Resolver.LookupPort.
Функция LookupTXT
func LookupTXT(name string) ([]string, error)
LookupTXT возвращает DNS-записи TXT для заданного доменного имени.
Если в записи DNS TXT содержится несколько строк, они объединяются в одну строку.
LookupTXT использует context.Background внутри; для указания контекста используйте Resolver.LookupTXT.
Функция ParseCIDR
func ParseCIDR(s string) (IP, *IPNet, error)
ParseCIDR анализирует s как адрес IP в CIDR-нотации и длину префикса, например, «192.0.2.0/24» или «2001:db8::/32», как определено в RFC 4632 и RFC 4291.
Он возвращает адрес IP и сеть, подразумеваемую IP и длиной префикса. Например, ParseCIDR("192.0.2.1/24") возвращает адрес IP 192.0.2.1 и сеть 192.0.2.0/24.
Пример
Код:
ipv4Addr, ipv4Net, err := net.ParseCIDR("192.0.2.1/24")
if err != nil {
log.Fatal(err)
}
fmt.Println(ipv4Addr)
fmt.Println(ipv4Net)
ipv6Addr, ipv6Net, err := net.ParseCIDR("2001:db8:a0b:12f0::1/32")
if err != nil {
log.Fatal(err)
}
fmt.Println(ipv6Addr)
fmt.Println(ipv6Net)
Вывод:
192.0.2.1 192.0.2.0/24 2001:db8:a0b:12f0::1 2001:db8::/32
Функция Pipe
func Pipe() (Conn, Conn)
Pipe создаёт синхронное, внутрипроцессорное, полнодуплексное сетевое соединение; оба конца реализуют интерфейс Conn. Чтения с одной стороны соответствуют записям на другой, копируя данные напрямую между ними; внутреннего буферирования нет.
Функция SplitHostPort
func SplitHostPort(hostport string) (host, port string, err error)
SplitHostPort разделяет сетевой адрес вида «хост:порт», «хост%зона:порт», «[хост]:порт» или «[хост%зона]:порт» на хост или хост%зона и порт.
Литеральный адрес IPv6 в hostport должен быть заключён в квадратные скобки, например, «[::1]:80», «[::1%lo0]:80».
См. функцию Dial для описания параметра hostport и результатов хост и порт.
Тип Addr
Addr представляет адрес конечной точки сети.
Два метода [Addr.Network] и [Addr.String] по соглашению возвращают строки, которые можно передать в качестве аргументов к Dial, но точный вид и значение строк зависят от реализации.
type Addr interface {
Network() string // name of the network (for example, "tcp", "udp")
String() string // string form of address (for example, "192.0.2.1:25", "[2001:db8::1]:80")
} Функция InterfaceAddrs
func InterfaceAddrs() ([]Addr, error)
InterfaceAddrs возвращает список адресов одноадресных интерфейсов системы.
Возвращаемый список не идентифицирует связанный интерфейс; используйте Interfaces и Interface.Addrs для получения более подробной информации.
Тип AddrError
type AddrError struct {
Err string
Addr string
}
Функция (*AddrError) Error
func (e *AddrError) Error() string
Функция (*AddrError) Temporary
func (e *AddrError) Temporary() bool
Функция (*AddrError) Timeout
func (e *AddrError) Timeout() bool
Тип Buffers 1.8
Buffers содержит ноль или более последовательностей байтов для записи.
На некоторых машинах, для некоторых типов соединений, это оптимизируется в операцию пакетной записи, специфичную для ОС (например, «writev»).
type Buffers [][]byte
Функция (*Buffers) Read 1.8
func (v *Buffers) Read(p []byte) (n int, err error)
Чтение из буферов.
Read реализует io.Reader для Buffers.
Read изменяет срез v, а также v[i] для 0 ≤ i < len(v), но не изменяет v[i][j] для любых i, j.
Функция (*Buffers) WriteTo 1.8
func (v *Buffers) WriteTo(w io.Writer) (n int64, err error)
WriteTo записывает содержимое буферов в w.
WriteTo реализует io.WriterTo для Buffers.
WriteTo изменяет срез v, а также v[i] для 0 ≤ i < len(v), но не изменяет v[i][j] для любых i, j.
Тип Conn
Conn — это общее потоковое сетевое соединение.
Несколько горутин могут одновременно вызывать методы Conn.
type Conn interface {
// Read reads data from the connection.
// Read can be made to time out and return an error after a fixed
// time limit; see SetDeadline and SetReadDeadline.
Read(b []byte) (n int, err error)
// Write writes data to the connection.
// Write can be made to time out and return an error after a fixed
// time limit; see SetDeadline and SetWriteDeadline.
Write(b []byte) (n int, err error)
// Close closes the connection.
// Any blocked Read or Write operations will be unblocked and return errors.
Close() error
// LocalAddr returns the local network address, if known.
LocalAddr() Addr
// RemoteAddr returns the remote network address, if known.
RemoteAddr() Addr
// SetDeadline sets the read and write deadlines associated
// with the connection. It is equivalent to calling both
// SetReadDeadline and SetWriteDeadline.
//
// A deadline is an absolute time after which I/O operations
// fail instead of blocking. The deadline applies to all future
// and pending I/O, not just the immediately following call to
// Read or Write. After a deadline has been exceeded, the
// connection can be refreshed by setting a deadline in the future.
//
// If the deadline is exceeded a call to Read or Write or to other
// I/O methods will return an error that wraps os.ErrDeadlineExceeded.
// This can be tested using errors.Is(err, os.ErrDeadlineExceeded).
// The error's Timeout method will return true, but note that there
// are other possible errors for which the Timeout method will
// return true even if the deadline has not been exceeded.
//
// An idle timeout can be implemented by repeatedly extending
// the deadline after successful Read or Write calls.
//
// A zero value for t means I/O operations will not time out.
SetDeadline(t time.Time) error
// SetReadDeadline sets the deadline for future Read calls
// and any currently-blocked Read call.
// A zero value for t means Read will not time out.
SetReadDeadline(t time.Time) error
// SetWriteDeadline sets the deadline for future Write calls
// and any currently-blocked Write call.
// Even if write times out, it may return n > 0, indicating that
// some of the data was successfully written.
// A zero value for t means Write will not time out.
SetWriteDeadline(t time.Time) error
} Функция Dial
func Dial(network, address string) (Conn, error)
Dial подключается к адресу по указанной сети.
Известные сети: «tcp», «tcp4» (только IPv4), «tcp6» (только IPv6), «udp», «udp4» (только IPv4), «udp6» (только IPv6), «ip», «ip4» (только IPv4), «ip6» (только IPv6), «unix», «unixgram» и «unixpacket».
Для сетей TCP и UDP адрес имеет вид "хост:порт". Хост должен быть буквальным IP-адресом или именем хоста, разрешаемым в IP-адреса. Порт должен быть буквальным номером порта или именем службы. Если хост является буквальным IPv6-адресом, он должен быть заключен в квадратные скобки, как в "[2001:db8::1]:80" или "[fe80::1%zone]:80". Зона определяет область действия буквального IPv6-адреса, как определено в RFC 4007. Функции JoinHostPort и SplitHostPort обрабатывают пару хост и порт в этом формате. При использовании TCP, если хост разрешается в несколько IP-адресов, Dial будет пытаться подключиться к каждому IP-адресу по порядку до тех пор, пока один из них не увенчается успехом.
Примеры:
Dial("tcp", "golang.org:http")
Dial("tcp", "192.0.2.1:http")
Dial("tcp", "198.51.100.1:80")
Dial("udp", "[2001:db8::1]:domain")
Dial("udp", "[fe80::1%lo0]:53")
Dial("tcp", ":80")
Для IP-сетей сеть должна быть "ip", "ip4" или "ip6", за которыми следует двоеточие и буквальный номер протокола или имя протокола, а адрес имеет вид "хост". Хост должен быть буквальным IP-адресом или буквальным IPv6-адресом с зоной. От каждого операционной системы зависит, как она ведет себя с нестандартным номером протокола, например, "0" или "255".
Примеры:
Dial("ip4:1", "192.0.2.1")
Dial("ip6:ipv6-icmp", "2001:db8::1")
Dial("ip6:58", "fe80::1%lo0")
Для сетей TCP, UDP и IP, если хост пуст или является буквальным неопределённым IP-адресом, как в ":80", "0.0.0.0:80" или "[::]:80" для TCP и UDP, "", "0.0.0.0" или "::" для IP, предполагается локальная система.
Для сетей Unix адрес должен быть путём в файловой системе.
func DialTimeout
func DialTimeout(network, address string, timeout time.Duration) (Conn, error)
DialTimeout ведет себя как Dial, но принимает таймаут.
Таймаут включает разрешение имени, если требуется. При использовании TCP и хост в параметре адреса разрешается в несколько IP-адресов, таймаут распределяется по каждому подключению, так что каждому предоставляется соответствующая доля времени для подключения.
См. функцию Dial для описания параметров сети и адреса.
func FileConn
func FileConn(f *os.File) (c Conn, err error)
FileConn возвращает копию сетевого соединения, соответствующего открытому файлу f. Ответственность за закрытие f лежит на вызывающей стороне. Закрытие c не влияет на f, а закрытие f не влияет на c.
type DNSConfigError
DNSConfigError представляет собой ошибку при чтении конфигурации DNS машины. (Больше не используется; сохраняется для совместимости.)
type DNSConfigError struct {
Err error
}
func (*DNSConfigError) Error
func (e *DNSConfigError) Error() string
func (*DNSConfigError) Temporary
func (e *DNSConfigError) Temporary() bool
func (*DNSConfigError) Timeout
func (e *DNSConfigError) Timeout() bool
func (*DNSConfigError) Unwrap 1.13
func (e *DNSConfigError) Unwrap() error
type DNSError
DNSError представляет ошибку поиска DNS.
type DNSError struct {
UnwrapErr error // error returned by the [DNSError.Unwrap] method, might be nil; added in Go 1.23
Err string // description of the error
Name string // name looked for
Server string // server used
IsTimeout bool // if true, timed out; not all timeouts set this
IsTemporary bool // if true, error is temporary; not all errors set this; added in Go 1.6
// IsNotFound is set to true when the requested name does not
// contain any records of the requested type (data not found),
// or the name itself was not found (NXDOMAIN).
IsNotFound bool // Go 1.13
}
func (*DNSError) Error
func (e *DNSError) Error() string
func (*DNSError) Temporary
func (e *DNSError) Temporary() bool
Temporary сообщает, является ли ошибка DNS временной. Это не всегда известно; поиск DNS может завершиться ошибкой из-за временной проблемы и вернуть DNSError, для которого Temporary возвращает false.
func (*DNSError) Timeout
func (e *DNSError) Timeout() bool
Timeout сообщает, известно ли, что поиск DNS превысил время ожидания. Это не всегда известно; поиск DNS может завершиться ошибкой из-за таймаута и вернуть DNSError, для которого Timeout возвращает false.
func (*DNSError) Unwrap 1.23
func (e *DNSError) Unwrap() error
Unwrap возвращает e.UnwrapErr.
type Dialer 1.1
Dialer содержит параметры для подключения к адресу.
Значение по умолчанию для каждого поля эквивалентно подключению без этого параметра. Подключение с нулевым значением Dialer эквивалентно простому вызову функции Dial.
Безопасно вызывать методы Dialer одновременно.
type Dialer struct {
// Timeout is the maximum amount of time a dial will wait for
// a connect to complete. If Deadline is also set, it may fail
// earlier.
//
// The default is no timeout.
//
// When using TCP and dialing a host name with multiple IP
// addresses, the timeout may be divided between them.
//
// With or without a timeout, the operating system may impose
// its own earlier timeout. For instance, TCP timeouts are
// often around 3 minutes.
Timeout time.Duration
// Deadline is the absolute point in time after which dials
// will fail. If Timeout is set, it may fail earlier.
// Zero means no deadline, or dependent on the operating system
// as with the Timeout option.
Deadline time.Time
// LocalAddr is the local address to use when dialing an
// address. The address must be of a compatible type for the
// network being dialed.
// If nil, a local address is automatically chosen.
LocalAddr Addr
// DualStack previously enabled RFC 6555 Fast Fallback
// support, also known as "Happy Eyeballs", in which IPv4 is
// tried soon if IPv6 appears to be misconfigured and
// hanging.
//
// Deprecated: Fast Fallback is enabled by default. To
// disable, set FallbackDelay to a negative value.
DualStack bool // Go 1.2
// FallbackDelay specifies the length of time to wait before
// spawning a RFC 6555 Fast Fallback connection. That is, this
// is the amount of time to wait for IPv6 to succeed before
// assuming that IPv6 is misconfigured and falling back to
// IPv4.
//
// If zero, a default delay of 300ms is used.
// A negative value disables Fast Fallback support.
FallbackDelay time.Duration // Go 1.5
// KeepAlive specifies the interval between keep-alive
// probes for an active network connection.
//
// KeepAlive is ignored if KeepAliveConfig.Enable is true.
//
// If zero, keep-alive probes are sent with a default value
// (currently 15 seconds), if supported by the protocol and operating
// system. Network protocols or operating systems that do
// not support keep-alive ignore this field.
// If negative, keep-alive probes are disabled.
KeepAlive time.Duration // Go 1.3
// KeepAliveConfig specifies the keep-alive probe configuration
// for an active network connection, when supported by the
// protocol and operating system.
//
// If KeepAliveConfig.Enable is true, keep-alive probes are enabled.
// If KeepAliveConfig.Enable is false and KeepAlive is negative,
// keep-alive probes are disabled.
KeepAliveConfig KeepAliveConfig // Go 1.23
// Resolver optionally specifies an alternate resolver to use.
Resolver *Resolver // Go 1.8
// Cancel is an optional channel whose closure indicates that
// the dial should be canceled. Not all types of dials support
// cancellation.
//
// Deprecated: Use DialContext instead.
Cancel <-chan struct{} // Go 1.6
// If Control is not nil, it is called after creating the network
// connection but before actually dialing.
//
// Network and address parameters passed to Control function are not
// necessarily the ones passed to Dial. Calling Dial with TCP networks
// will cause the Control function to be called with "tcp4" or "tcp6",
// UDP networks become "udp4" or "udp6", IP networks become "ip4" or "ip6",
// and other known networks are passed as-is.
//
// Control is ignored if ControlContext is not nil.
Control func(network, address string, c syscall.RawConn) error // Go 1.11
// If ControlContext is not nil, it is called after creating the network
// connection but before actually dialing.
//
// Network and address parameters passed to ControlContext function are not
// necessarily the ones passed to Dial. Calling Dial with TCP networks
// will cause the ControlContext function to be called with "tcp4" or "tcp6",
// UDP networks become "udp4" or "udp6", IP networks become "ip4" or "ip6",
// and other known networks are passed as-is.
//
// If ControlContext is not nil, Control is ignored.
ControlContext func(ctx context.Context, network, address string, c syscall.RawConn) error // Go 1.20
// contains filtered or unexported fields
}
Пример
Код:
var d net.Dialer
ctx, cancel := context.WithTimeout(context.Background(), time.Minute)
defer cancel()
conn, err := d.DialContext(ctx, "tcp", "localhost:12345")
if err != nil {
log.Fatalf("Failed to dial: %v", err)
}
defer conn.Close()
if _, err := conn.Write([]byte("Hello, World!")); err != nil {
log.Fatal(err)
}
Пример (Unix)
Код:
// DialUnix does not take a context.Context parameter. This example shows
// how to dial a Unix socket with a Context. Note that the Context only
// applies to the dial operation; it does not apply to the connection once
// it has been established.
var d net.Dialer
ctx, cancel := context.WithTimeout(context.Background(), time.Minute)
defer cancel()
d.LocalAddr = nil // if you have a local addr, add it here
raddr := net.UnixAddr{Name: "/path/to/unix.sock", Net: "unix"}
conn, err := d.DialContext(ctx, "unix", raddr.String())
if err != nil {
log.Fatalf("Failed to dial: %v", err)
}
defer conn.Close()
if _, err := conn.Write([]byte("Hello, socket!")); err != nil {
log.Fatal(err)
}
func (*Dialer) Dial 1.1
func (d *Dialer) Dial(network, address string) (Conn, error)
Dial подключается к адресу в указанной сети.
См. функцию Dial для описания параметров сети и адреса.
Dial использует context.Background внутри; для указания контекста используйте Dialer.DialContext.
func (*Dialer) DialContext 1.7
func (d *Dialer) DialContext(ctx context.Context, network, address string) (Conn, error)
DialContext подключается к адресу в указанной сети, используя предоставленный контекст.
Предоставленный контекст должен быть не null. Если контекст истечёт, прежде чем подключение будет завершено, возвращается ошибка. После успешного подключения любое истечение контекста не повлияет на подключение.
При использовании TCP и хост в параметре адреса разрешается в несколько сетевых адресов, любой таймаут подключения (из d.Timeout или ctx) распределяется по каждому подключению, таким образом, каждому предоставляется соответствующая часть времени для подключения. Например, если хост имеет 4 IP-адреса, а таймаут составляет 1 минуту, подключение к каждому адресу получит 15 секунд для завершения, прежде чем будет попытка подключения к следующему.
См. функцию Dial для описания параметров сети и адреса.
func (*Dialer) MultipathTCP 1.21
func (d *Dialer) MultipathTCP() bool
MultipathTCP сообщает, будет ли использоваться MPTCP.
Этот метод не проверяет, поддерживается ли MPTCP операционной системой или нет.
func (*Dialer) SetMultipathTCP 1.21
func (d *Dialer) SetMultipathTCP(use bool)
SetMultipathTCP направляет методы Dial использовать или не использовать MPTCP, если это поддерживается операционной системой. Этот метод переопределяет системный параметр и настройку GODEBUG=multipathtcp=... (если таковая имеется).
Если MPTCP недоступен на хосте или не поддерживается сервером, методы Dial вернутся к TCP.
type Error
Error представляет собой сетевую ошибку.
type Error interface {
error
Timeout() bool // Is the error a timeout?
// Deprecated: Temporary errors are not well-defined.
// Most "temporary" errors are timeouts, and the few exceptions are surprising.
// Do not use this method.
Temporary() bool
} type Flags
type Flags uint
const (
FlagUp Flags = 1 << iota // interface is administratively 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
FlagRunning // interface is in running state
) func (Flags) String
func (f Flags) String() string
type HardwareAddr
HardwareAddr представляет физический аппаратный адрес.
type HardwareAddr []byte
func ParseMAC
func ParseMAC(s string) (hw HardwareAddr, err error)
ParseMAC парсит s как IEEE 802 MAC-48, EUI-48, EUI-64 или 20-байтовый IP-адрес по InfiniBand канала связи с помощью одного из следующих форматов:
00:00:5e:00:53:01 02:00:5e:10:00:00:00:01 00:00:00:00:fe:80:00:00:00:00:00:00:02:00:5e:10:00:00:00:01 00-00-5e-00-53-01 02-00-5e-10-00-00-00-01 00-00-00-00-fe-80-00-00-00-00-00-00-02-00-5e-10-00-00-00-01 0000.5e00.5301 0200.5e10.0000.0001 0000.0000.fe80.0000.0000.0000.0200.5e10.0000.0001
func (HardwareAddr) String
func (a HardwareAddr) String() string
type IP
IP — это единственный IP-адрес, представленный как массив байтов. Функции в этом пакете принимают в качестве входных данных массивы байтов длиной 4 байта (IPv4) или 16 байт (IPv6).
Обратите внимание, что в этой документации ссылка на IP-адрес как IPv4-адрес или IPv6-адрес — это семантическое свойство адреса, а не только длина массива байтов: массив байтов длиной 16 байт может всё ещё представлять IPv4-адрес.
type IP []byte
func IPv4
func IPv4(a, b, c, d byte) IP
IPv4 возвращает IP-адрес (в 16-байтовом формате) IPv4-адреса a.b.c.d.
Пример
Код:
fmt.Println(net.IPv4(8, 8, 8, 8))
Вывод:
8.8.8.8
func LookupIP
func LookupIP(host string) ([]IP, error)
LookupIP выполняет поиск хоста с помощью локального решателя. Он возвращает массив IPv4 и IPv6 адресов этого хоста.
func ParseIP
func ParseIP(s string) IP
ParseIP парсит s как IP-адрес и возвращает результат. Строка s может быть в формате IPv4 (192.0.2.1), IPv6 (2001:db8::68) или IPv4-mapped IPv6 (::ffff:192.0.2.1). Если s не является допустимым текстовым представлением IP-адреса, ParseIP возвращает nil. Возвращаемый адрес всегда имеет длину 16 байт, IPv4-адреса возвращаются в формате IPv4-mapped IPv6.
Пример
Код:
fmt.Println(net.ParseIP("192.0.2.1"))
fmt.Println(net.ParseIP("2001:db8::68"))
fmt.Println(net.ParseIP("192.0.2"))
Вывод:
192.0.2.1 2001:db8::68 <nil>
func (IP) AppendText 1.24
func (ip IP) AppendText(b []byte) ([]byte, error)
AppendText реализует интерфейс encoding.TextAppender. Кодирование такое же, как и возвращаемое IP.String, за одним исключением: если len(ip) равен нулю, ничего не добавляется.
func (IP) DefaultMask
func (ip IP) DefaultMask() IPMask
DefaultMask возвращает стандартную IP-маску для IP-адреса ip. Только IPv4-адреса имеют стандартные маски; DefaultMask возвращает nil, если ip не является допустимым IPv4-адресом.
Пример
Код:
ip := net.ParseIP("192.0.2.1")
fmt.Println(ip.DefaultMask())
Вывод:
ffffff00
func (IP) Equal
func (ip IP) Equal(x IP) bool
Equal проверяет, являются ли ip и x одним и тем же IP-адресом. IPv4-адрес и тот же адрес в формате IPv6 считаются равными.
Пример
Код:
ipv4DNS := net.ParseIP("8.8.8.8")
ipv4Lo := net.ParseIP("127.0.0.1")
ipv6DNS := net.ParseIP("0:0:0:0:0:FFFF:0808:0808")
fmt.Println(ipv4DNS.Equal(ipv4DNS))
fmt.Println(ipv4DNS.Equal(ipv4Lo))
fmt.Println(ipv4DNS.Equal(ipv6DNS))
Вывод:
true false true
func (IP) IsGlobalUnicast
func (ip IP) IsGlobalUnicast() bool
IsGlobalUnicast сообщает, является ли ip глобальным адресом одноадресной рассылки.
Идентификация глобальных адресов одноадресной рассылки использует идентификацию типа адреса, как определено в RFC 1122, RFC 4632 и RFC 4291, за исключением IPv4-адресов прямой трансляции. Он возвращает true, даже если ip находится в частном адресном пространстве IPv4 или локальном адресном пространстве IPv6 одноадресной рассылки.
Пример
Код:
ipv6Global := net.ParseIP("2000::")
ipv6UniqLocal := net.ParseIP("2000::")
ipv6Multi := net.ParseIP("FF00::")
ipv4Private := net.ParseIP("10.255.0.0")
ipv4Public := net.ParseIP("8.8.8.8")
ipv4Broadcast := net.ParseIP("255.255.255.255")
fmt.Println(ipv6Global.IsGlobalUnicast())
fmt.Println(ipv6UniqLocal.IsGlobalUnicast())
fmt.Println(ipv6Multi.IsGlobalUnicast())
fmt.Println(ipv4Private.IsGlobalUnicast())
fmt.Println(ipv4Public.IsGlobalUnicast())
fmt.Println(ipv4Broadcast.IsGlobalUnicast())
Вывод:
true true false true true false
func (IP) IsInterfaceLocalMulticast
func (ip IP) IsInterfaceLocalMulticast() bool
IsInterfaceLocalMulticast сообщает, является ли ip адресом локальной многоадресной рассылки интерфейса.
Пример
Код:
ipv6InterfaceLocalMulti := net.ParseIP("ff01::1")
ipv6Global := net.ParseIP("2000::")
ipv4 := net.ParseIP("255.0.0.0")
fmt.Println(ipv6InterfaceLocalMulti.IsInterfaceLocalMulticast())
fmt.Println(ipv6Global.IsInterfaceLocalMulticast())
fmt.Println(ipv4.IsInterfaceLocalMulticast())
Вывод:
true false false
func (IP) IsLinkLocalMulticast
func (ip IP) IsLinkLocalMulticast() bool
IsLinkLocalMulticast сообщает, является ли ip адресом локальной многоадресной рассылки подсети.
Пример
Код:
ipv6LinkLocalMulti := net.ParseIP("ff02::2")
ipv6LinkLocalUni := net.ParseIP("fe80::")
ipv4LinkLocalMulti := net.ParseIP("224.0.0.0")
ipv4LinkLocalUni := net.ParseIP("169.254.0.0")
fmt.Println(ipv6LinkLocalMulti.IsLinkLocalMulticast())
fmt.Println(ipv6LinkLocalUni.IsLinkLocalMulticast())
fmt.Println(ipv4LinkLocalMulti.IsLinkLocalMulticast())
fmt.Println(ipv4LinkLocalUni.IsLinkLocalMulticast())
Вывод:
true false true false
func (IP) IsLinkLocalUnicast
func (ip IP) IsLinkLocalUnicast() bool
IsLinkLocalUnicast сообщает, является ли ip адресом локальной одноадресной рассылки подсети.
Пример
Код:
ipv6LinkLocalUni := net.ParseIP("fe80::")
ipv6Global := net.ParseIP("2000::")
ipv4LinkLocalUni := net.ParseIP("169.254.0.0")
ipv4LinkLocalMulti := net.ParseIP("224.0.0.0")
fmt.Println(ipv6LinkLocalUni.IsLinkLocalUnicast())
fmt.Println(ipv6Global.IsLinkLocalUnicast())
fmt.Println(ipv4LinkLocalUni.IsLinkLocalUnicast())
fmt.Println(ipv4LinkLocalMulti.IsLinkLocalUnicast())
Вывод:
true false true false
func (IP) IsLoopback
func (ip IP) IsLoopback() bool
IsLoopback сообщает, является ли ip адресом обратной петли.
Пример
Код:
ipv6Lo := net.ParseIP("::1")
ipv6 := net.ParseIP("ff02::1")
ipv4Lo := net.ParseIP("127.0.0.0")
ipv4 := net.ParseIP("128.0.0.0")
fmt.Println(ipv6Lo.IsLoopback())
fmt.Println(ipv6.IsLoopback())
fmt.Println(ipv4Lo.IsLoopback())
fmt.Println(ipv4.IsLoopback())
Вывод:
true false true false
func (IP) IsMulticast
func (ip IP) IsMulticast() bool
IsMulticast сообщает, является ли ip мультиадресным адресом.
Пример
Код:
ipv6Multi := net.ParseIP("FF00::")
ipv6LinkLocalMulti := net.ParseIP("ff02::1")
ipv6Lo := net.ParseIP("::1")
ipv4Multi := net.ParseIP("239.0.0.0")
ipv4LinkLocalMulti := net.ParseIP("224.0.0.0")
ipv4Lo := net.ParseIP("127.0.0.0")
fmt.Println(ipv6Multi.IsMulticast())
fmt.Println(ipv6LinkLocalMulti.IsMulticast())
fmt.Println(ipv6Lo.IsMulticast())
fmt.Println(ipv4Multi.IsMulticast())
fmt.Println(ipv4LinkLocalMulti.IsMulticast())
fmt.Println(ipv4Lo.IsMulticast())
Вывод:
true true false true true false
func (IP) IsPrivate 1.17
func (ip IP) IsPrivate() bool
IsPrivate сообщает, является ли ip частным адресом в соответствии с RFC 1918 (IPv4 адреса) и RFC 4193 (IPv6 адреса).
Пример
Код:
ipv6Private := net.ParseIP("fc00::")
ipv6Public := net.ParseIP("fe00::")
ipv4Private := net.ParseIP("10.255.0.0")
ipv4Public := net.ParseIP("11.0.0.0")
fmt.Println(ipv6Private.IsPrivate())
fmt.Println(ipv6Public.IsPrivate())
fmt.Println(ipv4Private.IsPrivate())
fmt.Println(ipv4Public.IsPrivate())
Вывод:
true false true false
func (IP) IsUnspecified
func (ip IP) IsUnspecified() bool
IsUnspecified сообщает, является ли ip неопределенным адресом, либо IPv4 адрес "0.0.0.0", либо IPv6 адрес "::".
Пример
Код:
ipv6Unspecified := net.ParseIP("::")
ipv6Specified := net.ParseIP("fe00::")
ipv4Unspecified := net.ParseIP("0.0.0.0")
ipv4Specified := net.ParseIP("8.8.8.8")
fmt.Println(ipv6Unspecified.IsUnspecified())
fmt.Println(ipv6Specified.IsUnspecified())
fmt.Println(ipv4Unspecified.IsUnspecified())
fmt.Println(ipv4Specified.IsUnspecified())
Вывод:
true false true false
func (IP) MarshalText 1.2
func (ip IP) MarshalText() ([]byte, error)
MarshalText реализует интерфейс encoding.TextMarshaler. Кодирование такое же, как возвращается IP.String, с одним исключением: Если len(ip) равно нулю, возвращается пустой срез.
func (IP) Mask
func (ip IP) Mask(mask IPMask) IP
Mask возвращает результат маскирования IP адреса ip маской mask.
Пример
Код:
ipv4Addr := net.ParseIP("192.0.2.1")
// This mask corresponds to a /24 subnet for IPv4.
ipv4Mask := net.CIDRMask(24, 32)
fmt.Println(ipv4Addr.Mask(ipv4Mask))
ipv6Addr := net.ParseIP("2001:db8:a0b:12f0::1")
// This mask corresponds to a /32 subnet for IPv6.
ipv6Mask := net.CIDRMask(32, 128)
fmt.Println(ipv6Addr.Mask(ipv6Mask))
Вывод:
192.0.2.0 2001:db8::
func (IP) String
func (ip IP) String() string
String возвращает строковую форму IP адреса ip. Возвращает одну из 4 форм:
- "<nil>", если ip имеет длину 0
- точечную десятичную запись ("192.0.2.1"), если ip является IPv4 или IP4-отображенным IPv6 адресом
- IPv6 в соответствии с RFC 5952 ("2001:db8::1"), если ip является валидным IPv6 адресом
- шестнадцатеричную форму ip без знаков препинания, если не применимы другие случаи
Пример
Код:
ipv6 := net.IP{0xfc, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0}
ipv4 := net.IPv4(10, 255, 0, 0)
fmt.Println(ipv6.String())
fmt.Println(ipv4.String())
Вывод:
fc00:: 10.255.0.0
func (IP) To16
func (ip IP) To16() IP
To16 преобразует IP адрес ip в 16-байтовое представление. Если ip не является IP адресом (неправильной длины), To16 возвращает nil.
Пример
Код:
ipv6 := net.IP{0xfc, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0}
ipv4 := net.IPv4(10, 255, 0, 0)
fmt.Println(ipv6.To16())
fmt.Println(ipv4.To16())
Вывод:
fc00:: 10.255.0.0
func (IP) To4
func (ip IP) To4() IP
To4 преобразует IPv4 адрес ip в 4-байтовое представление. Если ip не является IPv4 адресом, To4 возвращает nil.
Пример
Код:
ipv6 := net.IP{0xfc, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0}
ipv4 := net.IPv4(10, 255, 0, 0)
fmt.Println(ipv6.To4())
fmt.Println(ipv4.To4())
Вывод:
<nil> 10.255.0.0
func (*IP) UnmarshalText 1.2
func (ip *IP) UnmarshalText(text []byte) error
UnmarshalText реализует интерфейс encoding.TextUnmarshaler. Ожидается, что IP адрес будет в форме, принятой ParseIP.
type IPAddr
IPAddr представляет адрес IP конечной точки.
type IPAddr struct {
IP IP
Zone string // IPv6 scoped addressing zone; added in Go 1.1
}
func ResolveIPAddr
func ResolveIPAddr(network, address string) (*IPAddr, error)
ResolveIPAddr возвращает адрес IP конечной точки.
Сеть должна быть именем IP сети.
Если хост в параметре адреса не является литеральным IP адресом, ResolveIPAddr разрешает адрес до адреса IP конечной точки. В противном случае, он анализирует адрес как литеральный IP адрес. Параметр адреса может использовать имя хоста, но это не рекомендуется, потому что он вернет не более одного IP адреса хоста.
См. функцию Dial для описания параметров сети и адреса.
func (*IPAddr) Network
func (a *IPAddr) Network() string
Network возвращает имя сети адреса, "ip".
func (*IPAddr) String
func (a *IPAddr) String() string
type IPConn
IPConn — реализация интерфейсов Conn и PacketConn для IP сетевых подключений.
type IPConn struct {
// contains filtered or unexported fields
}
func DialIP
func DialIP(network string, laddr, raddr *IPAddr) (*IPConn, error)
DialIP действует как Dial для IP сетей.
Сеть должна быть именем IP сети; см. функцию Dial для деталей.
Если laddr равен nil, локальный адрес выбирается автоматически. Если поле IP в raddr равно nil или представляет неопределенный IP адрес, используется локальная система.
func ListenIP
func ListenIP(network string, laddr *IPAddr) (*IPConn, error)
ListenIP действует как ListenPacket для IP сетей.
Сеть должна быть именем IP сети; см. функцию Dial для деталей.
Если поле IP в laddr равно nil или представляет неопределенный IP адрес, ListenIP прослушивает все доступные IP адреса локальной системы, кроме мультиадресных IP адресов.
func (*IPConn) Close
func (c *IPConn) Close() error
Close закрывает подключение.
func (*IPConn) File
func (c *IPConn) File() (f *os.File, err error)
File возвращает копию базового os.File. Ответственность вызывающей стороны — закрыть f после завершения. Закрытие c не влияет на f, и закрытие f не влияет на c.
Дескриптор файла возвращаемого os.File отличается от дескриптора файла соединения. Попытки изменить свойства оригинала с помощью этой копии могут или не могут иметь желаемый эффект.
func (*IPConn) LocalAddr
func (c *IPConn) LocalAddr() Addr
LocalAddr возвращает локальный сетевой адрес. Возвращаемый Addr общий для всех вызовов LocalAddr, поэтому не изменяйте его.
func (*IPConn) Read
func (c *IPConn) Read(b []byte) (int, error)
Read реализует метод Conn Read.
func (*IPConn) ReadFrom
func (c *IPConn) ReadFrom(b []byte) (int, Addr, error)
ReadFrom реализует метод PacketConn ReadFrom.
func (*IPConn) ReadFromIP
func (c *IPConn) ReadFromIP(b []byte) (int, *IPAddr, error)
ReadFromIP действует как ReadFrom, но возвращает IPAddr.
func (*IPConn) ReadMsgIP 1.1
func (c *IPConn) ReadMsgIP(b, oob []byte) (n, oobn, flags int, addr *IPAddr, err error)
ReadMsgIP считывает сообщение из c, копируя содержимое в b, и ассоциированные данные вне зоны передачи в oob. Возвращает количество скопированных в b байтов, количество скопированных в oob байтов, флаги, установленные в сообщении и адрес источника сообщения.
Пакеты golang.org/x/net/ipv4 и golang.org/x/net/ipv6 могут использоваться для управления опциями IP-уровня в oob.
func (*IPConn) RemoteAddr
func (c *IPConn) RemoteAddr() Addr
RemoteAddr возвращает удаленный сетевой адрес. Возвращаемый Addr общий для всех вызовов RemoteAddr, поэтому не изменяйте его.
func (*IPConn) SetDeadline
func (c *IPConn) SetDeadline(t time.Time) error
SetDeadline реализует метод Conn SetDeadline.
func (*IPConn) SetReadBuffer
func (c *IPConn) SetReadBuffer(bytes int) error
SetReadBuffer устанавливает размер буфера приема операционной системы, связанного с подключением.
func (*IPConn) SetReadDeadline
func (c *IPConn) SetReadDeadline(t time.Time) error
SetReadDeadline реализует метод Conn SetReadDeadline.
func (*IPConn) SetWriteBuffer
func (c *IPConn) SetWriteBuffer(bytes int) error
SetWriteBuffer устанавливает размер буфера передачи операционной системы, связанного с подключением.
func (*IPConn) SetWriteDeadline
func (c *IPConn) SetWriteDeadline(t time.Time) error
SetWriteDeadline реализует метод Conn SetWriteDeadline.
func (*IPConn) SyscallConn 1.9
func (c *IPConn) SyscallConn() (syscall.RawConn, error)
SyscallConn возвращает исходное сетевое соединение. Это реализует интерфейс syscall.Conn.
func (*IPConn) Write
func (c *IPConn) Write(b []byte) (int, error)
Write реализует метод Conn Write.
func (*IPConn) WriteMsgIP 1.1
func (c *IPConn) WriteMsgIP(b, oob []byte, addr *IPAddr) (n, oobn int, err error)
WriteMsgIP отправляет сообщение на addr через c, копируя содержимое из b и ассоциированные данные вне зоны передачи из oob. Возвращает количество записанных байтов содержимого и вне зоны передачи.
Пакеты golang.org/x/net/ipv4 и golang.org/x/net/ipv6 могут использоваться для управления опциями IP-уровня в oob.
func (*IPConn) WriteTo
func (c *IPConn) WriteTo(b []byte, addr Addr) (int, error)
WriteTo реализует метод PacketConn WriteTo.
func (*IPConn) WriteToIP
func (c *IPConn) WriteToIP(b []byte, addr *IPAddr) (int, error)
WriteToIP действует как IPConn.WriteTo, но принимает IPAddr.
type IPMask
IPMask — это маска битов, которая может использоваться для управления IP адресами в IP адресации и маршрутизации.
См. тип IPNet и функцию ParseCIDR для деталей.
type IPMask []byte
func CIDRMask
func CIDRMask(ones, bits int) IPMask
CIDRMask возвращает IPMask состоящую из 'ones' 1 бит, за которыми следуют 0 вплоть до общей длины 'bits' битов. Для маски этой формы CIDRMask является обратным IPMask.Size.
Пример
Код:
// This mask corresponds to a /31 subnet for IPv4. fmt.Println(net.CIDRMask(31, 32)) // This mask corresponds to a /64 subnet for IPv6. fmt.Println(net.CIDRMask(64, 128))
Вывод:
fffffffe ffffffffffffffff0000000000000000
func IPv4Mask
func IPv4Mask(a, b, c, d byte) IPMask
IPv4Mask возвращает IP маску (в 4-байтовой форме) IPv4 маски a.b.c.d.
Пример
Код:
fmt.Println(net.IPv4Mask(255, 255, 255, 0))
Вывод:
ffffff00
func (IPMask) Size
func (m IPMask) Size() (ones, bits int)
Size возвращает количество старших единиц и общее количество битов в маске. Если маска не в канонической форме — единицы, за которыми следуют нули — то Size возвращает 0, 0.
func (IPMask) String
func (m IPMask) String() string
String возвращает шестнадцатеричную форму m без знаков препинания.
type IPNet
IPNet представляет IP сеть.
type IPNet struct {
IP IP // network number
Mask IPMask // network mask
}
func (*IPNet) Contains
func (n *IPNet) Contains(ip IP) bool
Contains сообщает, включает ли сеть ip.
func (*IPNet) Network
func (n *IPNet) Network() string
Network возвращает имя сети адреса, "ip+net".
func (*IPNet) String
func (n *IPNet) String() string
String возвращает CIDR-запись n, например, «192.0.2.0/24» или «2001:db8::/48», как определено в RFC 4632 и RFC 4291. Если маска не в канонической форме, она возвращает строку, состоящую из IP-адреса, за которым следует косая черта и маска, выраженная в шестнадцатеричном формате без знаков препинания, например, «198.51.100.0/c000ff00».
тип Interface
Interface представляет отображение между именем сетевого интерфейса и его индексом. Он также представляет информацию о сетевом интерфейсе.
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
}
функция InterfaceByIndex
func InterfaceByIndex(index int) (*Interface, error)
InterfaceByIndex возвращает интерфейс, указанный по индексу.
В Solaris она возвращает один из логических сетевых интерфейсов, разделяющих логическое канальное соединение; для большей точности используйте InterfaceByName.
функция InterfaceByName
func InterfaceByName(name string) (*Interface, error)
InterfaceByName возвращает интерфейс, указанный по имени.
функция Interfaces
func Interfaces() ([]Interface, error)
Interfaces возвращает список сетевых интерфейсов системы.
функция (*Interface) Addrs
func (ifi *Interface) Addrs() ([]Addr, error)
Addrs возвращает список адресов одноадресной рассылки интерфейса для определенного интерфейса.
функция (*Interface) MulticastAddrs
func (ifi *Interface) MulticastAddrs() ([]Addr, error)
MulticastAddrs возвращает список адресов групповой многоадресной рассылки, к которым подключен определенный интерфейс.
тип InvalidAddrError
type InvalidAddrError string
функция (InvalidAddrError) Error
func (e InvalidAddrError) Error() string
функция (InvalidAddrError) Temporary
func (e InvalidAddrError) Temporary() bool
функция (InvalidAddrError) Timeout
func (e InvalidAddrError) Timeout() bool
тип KeepAliveConfig 1.23
KeepAliveConfig содержит параметры TCP keep-alive.
Если поля Idle, Interval или Count равны нулю, выбирается значение по умолчанию. Если поле отрицательное, соответствующий параметр сокета останется неизменным.
Обратите внимание, что до версии Windows 10 1709 не поддерживается ни отдельная установка Idle и Interval, ни изменение Count (обычно 10). Поэтому рекомендуется устанавливать как Idle, так и Interval в неотрицательные значения вместе с -1 для Count в старых версиях Windows, если вы хотите настроить параметры TCP keep-alive. В противоположность этому, если только одно из полей Idle и Interval установлено в неотрицательное значение, другое будет установлено в системное значение по умолчанию, и, в конечном итоге, установите как Idle, так и Interval в отрицательные значения, если хотите оставить их без изменений.
Обратите внимание, что Solaris и его производные не поддерживают установку Interval в неотрицательное значение и Count в отрицательное значение, или наоборот.
type KeepAliveConfig struct {
// If Enable is true, keep-alive probes are enabled.
Enable bool
// Idle is the time that the connection must be idle before
// the first keep-alive probe is sent.
// If zero, a default value of 15 seconds is used.
Idle time.Duration
// Interval is the time between keep-alive probes.
// If zero, a default value of 15 seconds is used.
Interval time.Duration
// Count is the maximum number of keep-alive probes that
// can go unanswered before dropping a connection.
// If zero, a default value of 9 is used.
Count int
}
тип ListenConfig 1.11
ListenConfig содержит параметры прослушивания адреса.
type ListenConfig struct {
// If Control is not nil, it is called after creating the network
// connection but before binding it to the operating system.
//
// Network and address parameters passed to Control function are not
// necessarily the ones passed to Listen. Calling Listen with TCP networks
// will cause the Control function to be called with "tcp4" or "tcp6",
// UDP networks become "udp4" or "udp6", IP networks become "ip4" or "ip6",
// and other known networks are passed as-is.
Control func(network, address string, c syscall.RawConn) error
// KeepAlive specifies the keep-alive period for network
// connections accepted by this listener.
//
// KeepAlive is ignored if KeepAliveConfig.Enable is true.
//
// If zero, keep-alive are enabled if supported by the protocol
// and operating system. Network protocols or operating systems
// that do not support keep-alive ignore this field.
// If negative, keep-alive are disabled.
KeepAlive time.Duration // Go 1.13
// KeepAliveConfig specifies the keep-alive probe configuration
// for an active network connection, when supported by the
// protocol and operating system.
//
// If KeepAliveConfig.Enable is true, keep-alive probes are enabled.
// If KeepAliveConfig.Enable is false and KeepAlive is negative,
// keep-alive probes are disabled.
KeepAliveConfig KeepAliveConfig // Go 1.23
// contains filtered or unexported fields
}
функция (*ListenConfig) Listen 1.11
func (lc *ListenConfig) Listen(ctx context.Context, network, address string) (Listener, error)
Listen объявляет прослушивание локального сетевого адреса.
См. функцию Listen для описания параметров сети и адреса.
Аргумент ctx используется при разрешении адреса, на котором необходимо прослушивать; он не влияет на возвращаемый Listener.
функция (*ListenConfig) ListenPacket 1.11
func (lc *ListenConfig) ListenPacket(ctx context.Context, network, address string) (PacketConn, error)
ListenPacket объявляет прослушивание локального сетевого адреса.
См. функцию ListenPacket для описания параметров сети и адреса.
Аргумент ctx используется при разрешении адреса, на котором необходимо прослушивать; он не влияет на возвращаемый Listener.
функция (*ListenConfig) MultipathTCP 1.21
func (lc *ListenConfig) MultipathTCP() bool
MultipathTCP сообщает, будет ли использоваться MPTCP.
Этот метод не проверяет, поддерживается ли MPTCP операционной системой.
функция (*ListenConfig) SetMultipathTCP 1.21
func (lc *ListenConfig) SetMultipathTCP(use bool)
SetMultipathTCP указывает методу Listen использовать или не использовать MPTCP, если это поддерживается операционной системой. Этот метод переопределяет системное значение по умолчанию и значение GODEBUG=multipathtcp=..., если таковое имеется.
Если MPTCP недоступен на хосте или не поддерживается клиентом, метод Listen вернется к TCP.
тип Listener
Listener — это универсальный сетевой слушатель для потоковых протоколов.
Несколько горутин могут одновременно вызывать методы Listener.
type Listener interface {
// Accept waits for and returns the next connection to the listener.
Accept() (Conn, error)
// Close closes the listener.
// Any blocked Accept operations will be unblocked and return errors.
Close() error
// Addr returns the listener's network address.
Addr() Addr
} Пример
Код:
// Listen on TCP port 2000 on all available unicast and
// anycast IP addresses of the local system.
l, err := net.Listen("tcp", ":2000")
if err != nil {
log.Fatal(err)
}
defer l.Close()
for {
// Wait for a connection.
conn, err := l.Accept()
if err != nil {
log.Fatal(err)
}
// Handle the connection in a new goroutine.
// The loop then returns to accepting, so that
// multiple connections may be served concurrently.
go func(c net.Conn) {
// Echo all incoming data.
io.Copy(c, c)
// Shut down the connection.
c.Close()
}(conn)
}
функция FileListener
func FileListener(f *os.File) (ln Listener, err error)
FileListener возвращает копию сетевого слушателя, соответствующего открытому файлу f. Ответственность вызывающей стороны — закрыть ln по завершении. Закрытие ln не влияет на f, а закрытие f не влияет на ln.
функция Listen
func Listen(network, address string) (Listener, error)
Listen объявляет прослушивание локального сетевого адреса.
Сеть должна быть «tcp», «tcp4», «tcp6», «unix» или «unixpacket».
Для TCP-сетей, если хост в параметре адреса пустой или является литералом неопределенного IP-адреса, Listen прослушивает все доступные одноадресные и любой адрес IP локальной системы. Чтобы использовать только IPv4, используйте сеть «tcp4». Адрес может использовать имя хоста, но это не рекомендуется, поскольку это создаст слушателя для не более чем одного из IP-адресов хоста. Если порт в параметре адреса пустой или «0», как в «127.0.0.1:» или «[::1]:0», номер порта выбирается автоматически. Метод Addr Listener может быть использован для определения выбранного порта.
См. функцию Dial для описания параметров сети и адреса.
Listen использует context.Background внутри; для указания контекста используйте ListenConfig.Listen.
тип MX
MX представляет собой отдельный DNS-запись MX.
type MX struct {
Host string
Pref uint16
}
функция LookupMX
func LookupMX(name string) ([]*MX, error)
LookupMX возвращает DNS-записи MX для заданного доменного имени, отсортированные по приоритету.
Возвращаемые имена почтовых серверов валидируются на соответствие правильному формату имен доменов в формате представления. Если ответ содержит невалидные имена, эти записи отфильтровываются, и возвращается ошибка вместе с оставшимися результатами, если таковые имеются.
LookupMX использует context.Background внутри; для указания контекста используйте Resolver.LookupMX.
тип NS 1.1
NS представляет собой отдельный DNS-запись NS.
type NS struct {
Host string
}
функция LookupNS 1.1
func LookupNS(name string) ([]*NS, error)
LookupNS возвращает DNS-записи NS для заданного доменного имени.
Возвращаемые имена серверов имен валидируются на соответствие правильному формату имен доменов в формате представления. Если ответ содержит невалидные имена, эти записи отфильтровываются, и возвращается ошибка вместе с оставшимися результатами, если таковые имеются.
LookupNS использует context.Background внутри; для указания контекста используйте Resolver.LookupNS.
тип OpError
OpError — тип ошибки, обычно возвращаемый функциями в пакете net. Он описывает операцию, тип сети и адрес ошибки.
type OpError struct {
// Op is the operation which caused the error, such as
// "read" or "write".
Op string
// Net is the network type on which this error occurred,
// such as "tcp" or "udp6".
Net string
// For operations involving a remote network connection, like
// Dial, Read, or Write, Source is the corresponding local
// network address.
Source Addr // Go 1.5
// Addr is the network address for which this error occurred.
// For local operations, like Listen or SetDeadline, Addr is
// the address of the local endpoint being manipulated.
// For operations involving a remote network connection, like
// Dial, Read, or Write, Addr is the remote address of that
// connection.
Addr Addr
// Err is the error that occurred during the operation.
// The Error method panics if the error is nil.
Err error
}
функция (*OpError) Error
func (e *OpError) Error() string
функция (*OpError) Temporary
func (e *OpError) Temporary() bool
функция (*OpError) Timeout
func (e *OpError) Timeout() bool
функция (*OpError) Unwrap 1.13
func (e *OpError) Unwrap() error
тип PacketConn
PacketConn — это универсальное соединение для сетевых пакетов.
Несколько горутин могут одновременно вызывать методы PacketConn.
type PacketConn interface {
// ReadFrom reads a packet from the connection,
// copying the payload into p. It returns the number of
// bytes copied into p and the return address that
// was on the packet.
// It returns the number of bytes read (0 <= n <= len(p))
// and any error encountered. Callers should always process
// the n > 0 bytes returned before considering the error err.
// ReadFrom can be made to time out and return an error after a
// fixed time limit; see SetDeadline and SetReadDeadline.
ReadFrom(p []byte) (n int, addr Addr, err error)
// WriteTo writes a packet with payload p to addr.
// WriteTo can be made to time out and return an Error after a
// fixed time limit; see SetDeadline and SetWriteDeadline.
// On packet-oriented connections, write timeouts are rare.
WriteTo(p []byte, addr Addr) (n int, err error)
// Close closes the connection.
// Any blocked ReadFrom or WriteTo operations will be unblocked and return errors.
Close() error
// LocalAddr returns the local network address, if known.
LocalAddr() Addr
// SetDeadline sets the read and write deadlines associated
// with the connection. It is equivalent to calling both
// SetReadDeadline and SetWriteDeadline.
//
// A deadline is an absolute time after which I/O operations
// fail instead of blocking. The deadline applies to all future
// and pending I/O, not just the immediately following call to
// Read or Write. After a deadline has been exceeded, the
// connection can be refreshed by setting a deadline in the future.
//
// If the deadline is exceeded a call to Read or Write or to other
// I/O methods will return an error that wraps os.ErrDeadlineExceeded.
// This can be tested using errors.Is(err, os.ErrDeadlineExceeded).
// The error's Timeout method will return true, but note that there
// are other possible errors for which the Timeout method will
// return true even if the deadline has not been exceeded.
//
// An idle timeout can be implemented by repeatedly extending
// the deadline after successful ReadFrom or WriteTo calls.
//
// A zero value for t means I/O operations will not time out.
SetDeadline(t time.Time) error
// SetReadDeadline sets the deadline for future ReadFrom calls
// and any currently-blocked ReadFrom call.
// A zero value for t means ReadFrom will not time out.
SetReadDeadline(t time.Time) error
// SetWriteDeadline sets the deadline for future WriteTo calls
// and any currently-blocked WriteTo call.
// Even if write times out, it may return n > 0, indicating that
// some of the data was successfully written.
// A zero value for t means WriteTo will not time out.
SetWriteDeadline(t time.Time) error
} функция FilePacketConn
func FilePacketConn(f *os.File) (c PacketConn, err error)
FilePacketConn возвращает копию пакетного сетевого соединения, соответствующего открытому файлу f. Вызывающая сторона несет ответственность за закрытие f по завершении. Закрытие c не влияет на f, а закрытие f не влияет на c.
функция ListenPacket
func ListenPacket(network, address string) (PacketConn, error)
ListenPacket объявляет прослушивание локального сетевого адреса.
Сеть должна быть «udp», «udp4», «udp6», «unixgram» или сетевым транспортом IP. Транспорты IP — это «ip», «ip4» или «ip6», за которыми следует двоеточие и литеранный номер протокола или имя протокола, как в «ip:1» или «ip:icmp».
Для UDP- и IP-сетей, если хост в параметре адреса пустой или является литералом неопределенного IP-адреса, ListenPacket прослушивает все доступные IP-адреса локальной системы, за исключением IP-адресов многоадресной рассылки. Чтобы использовать только IPv4, используйте сеть «udp4» или «ip4:proto». Адрес может использовать имя хоста, но это не рекомендуется, поскольку это создаст слушателя для не более чем одного из IP-адресов хоста. Если порт в параметре адреса пустой или «0», как в «127.0.0.1:» или «[::1]:0», номер порта выбирается автоматически. Метод LocalAddr PacketConn может быть использован для определения выбранного порта.
См. функцию Dial для описания параметров сети и адреса.
ListenPacket использует context.Background внутри; для указания контекста используйте ListenConfig.ListenPacket.
тип ParseError
ParseError — тип ошибки парсеров сетевых адресов в литеральной форме.
type ParseError struct {
// Type is the type of string that was expected, such as
// "IP address", "CIDR address".
Type string
// Text is the malformed text string.
Text string
}
функция (*ParseError) Error
func (e *ParseError) Error() string
функция (*ParseError) Temporary 1.17
func (e *ParseError) Temporary() bool
функция (*ParseError) Timeout 1.17
func (e *ParseError) Timeout() bool
тип Resolver 1.8
Resolver выполняет поиск имен и чисел.
nil *Resolver эквивалентен нулевому Resolver.
type Resolver struct {
// PreferGo controls whether Go's built-in DNS resolver is preferred
// on platforms where it's available. It is equivalent to setting
// GODEBUG=netdns=go, but scoped to just this resolver.
PreferGo bool
// StrictErrors controls the behavior of temporary errors
// (including timeout, socket errors, and SERVFAIL) when using
// Go's built-in resolver. For a query composed of multiple
// sub-queries (such as an A+AAAA address lookup, or walking the
// DNS search list), this option causes such errors to abort the
// whole query instead of returning a partial result. This is
// not enabled by default because it may affect compatibility
// with resolvers that process AAAA queries incorrectly.
StrictErrors bool // Go 1.9
// Dial optionally specifies an alternate dialer for use by
// Go's built-in DNS resolver to make TCP and UDP connections
// to DNS services. The host in the address parameter will
// always be a literal IP address and not a host name, and the
// port in the address parameter will be a literal port number
// and not a service name.
// If the Conn returned is also a PacketConn, sent and received DNS
// messages must adhere to RFC 1035 section 4.2.1, "UDP usage".
// Otherwise, DNS messages transmitted over Conn must adhere
// to RFC 7766 section 5, "Transport Protocol Selection".
// If nil, the default dialer is used.
Dial func(ctx context.Context, network, address string) (Conn, error) // Go 1.9
// contains filtered or unexported fields
}
функция (*Resolver) LookupAddr 1.8
func (r *Resolver) LookupAddr(ctx context.Context, addr string) ([]string, error)
LookupAddr выполняет обратный поиск для заданного адреса, возвращая список имен, сопоставленных с этим адресом.
Возвращаемые имена валидируются на соответствие правильному формату имен доменов в формате представления. Если ответ содержит невалидные имена, эти записи отфильтровываются, и возвращается ошибка вместе с оставшимися результатами, если таковые имеются.
функция (*Resolver) LookupCNAME 1.8
func (r *Resolver) LookupCNAME(ctx context.Context, host string) (string, error)
LookupCNAME возвращает каноническое имя для заданного хоста. Вызывающие стороны, которым не нужно каноническое имя, могут напрямую вызвать LookupHost или LookupIP; оба метода заботятся о разрешении канонического имени как части поиска.
Каноническое имя — это конечное имя после следования нулю или более записей CNAME. LookupCNAME не возвращает ошибку, если хост не содержит записи DNS «CNAME», если хост разрешается до записей адреса.
Возвращаемое каноническое имя проверяется на соответствие правильному формату доменного имени в формате представления.
func (*Resolver) LookupHost 1.8
func (r *Resolver) LookupHost(ctx context.Context, host string) (addrs []string, err error)
LookupHost выполняет поиск заданного хоста с помощью локального решателя. Он возвращает список адресов этого хоста.
func (*Resolver) LookupIP 1.15
func (r *Resolver) LookupIP(ctx context.Context, network, host string) ([]IP, error)
LookupIP выполняет поиск хоста для заданной сети с помощью локального решателя. Он возвращает список IP-адресов этого хоста типа, указанного в сети. network должен быть одним из «ip», «ip4» или «ip6».
func (*Resolver) LookupIPAddr 1.8
func (r *Resolver) LookupIPAddr(ctx context.Context, host string) ([]IPAddr, error)
LookupIPAddr выполняет поиск хоста с помощью локального решателя. Он возвращает список адресов IPv4 и IPv6 этого хоста.
func (*Resolver) LookupMX 1.8
func (r *Resolver) LookupMX(ctx context.Context, name string) ([]*MX, error)
LookupMX возвращает записи DNS MX для заданного доменного имени, отсортированные по приоритету.
Возвращаемые имена почтовых серверов проверяются на соответствие правильному формату доменного имени в формате представления. Если ответ содержит недопустимые имена, такие записи отфильтровываются, и вместе с оставшимися результатами, если таковые имеются, возвращается ошибка.
func (*Resolver) LookupNS 1.8
func (r *Resolver) LookupNS(ctx context.Context, name string) ([]*NS, error)
LookupNS возвращает записи DNS NS для заданного доменного имени.
Возвращаемые имена серверов имен проверяются на соответствие правильному формату доменного имени в формате представления. Если ответ содержит недопустимые имена, такие записи отфильтровываются, и вместе с оставшимися результатами, если таковые имеются, возвращается ошибка.
func (*Resolver) LookupNetIP 1.18
func (r *Resolver) LookupNetIP(ctx context.Context, network, host string) ([]netip.Addr, error)
LookupNetIP выполняет поиск хоста с помощью локального решателя. Он возвращает список IP-адресов этого хоста типа, указанного в сети. Сеть должна быть одной из «ip», «ip4» или «ip6».
func (*Resolver) LookupPort 1.8
func (r *Resolver) LookupPort(ctx context.Context, network, service string) (port int, err error)
LookupPort выполняет поиск порта для заданной сети и службы.
Сеть должна быть одной из «tcp», «tcp4», «tcp6», «udp», «udp4», «udp6» или «ip».
func (*Resolver) LookupSRV 1.8
func (r *Resolver) LookupSRV(ctx context.Context, service, proto, name string) (string, []*SRV, error)
LookupSRV пытается разрешить запрос SRV заданной службы, протокола и доменного имени. Proto — это «tcp» или «udp». Возвращаемые записи сортируются по приоритету и случайным образом по весу внутри приоритета.
LookupSRV строит имя DNS для поиска в соответствии с RFC 2782. То есть он выполняет поиск _service._proto.name. Чтобы учесть службы, публикующие записи SRV под нестандартными именами, если service и proto — пустые строки, LookupSRV выполняет поиск по name напрямую.
Возвращаемые имена служб проверяются на соответствие правильному формату доменного имени в формате представления. Если ответ содержит недопустимые имена, такие записи отфильтровываются, и вместе с оставшимися результатами, если таковые имеются, возвращается ошибка.
func (*Resolver) LookupTXT 1.8
func (r *Resolver) LookupTXT(ctx context.Context, name string) ([]string, error)
LookupTXT возвращает записи DNS TXT для заданного доменного имени.
Если запись DNS TXT содержит несколько строк, они объединяются в одну строку.
тип SRV
SRV представляет собой отдельную запись DNS SRV.
type SRV struct {
Target string
Port uint16
Priority uint16
Weight uint16
}
func LookupSRV
func LookupSRV(service, proto, name string) (cname string, addrs []*SRV, err error)
LookupSRV пытается разрешить запрос SRV заданной службы, протокола и доменного имени. Proto — это «tcp» или «udp». Возвращаемые записи сортируются по приоритету и случайным образом по весу внутри приоритета.
LookupSRV строит имя DNS для поиска в соответствии с RFC 2782. То есть он выполняет поиск _service._proto.name. Чтобы учесть службы, публикующие записи SRV под нестандартными именами, если service и proto — пустые строки, LookupSRV выполняет поиск по name напрямую.
Возвращаемые имена служб проверяются на соответствие правильному формату доменного имени в формате представления. Если ответ содержит недопустимые имена, такие записи отфильтровываются, и вместе с оставшимися результатами, если таковые имеются, возвращается ошибка.
тип TCPAddr
TCPAddr представляет адрес конечной точки TCP.
type TCPAddr struct {
IP IP
Port int
Zone string // IPv6 scoped addressing zone; added in Go 1.1
}
func ResolveTCPAddr
func ResolveTCPAddr(network, address string) (*TCPAddr, error)
ResolveTCPAddr возвращает адрес конечной точки TCP.
Сеть должна быть именем TCP-сети.
Если хост в параметре адреса не является буквальным IP-адресом или порт не является буквальным номером порта, ResolveTCPAddr разрешает адрес в адрес конечной точки TCP. В противном случае он анализирует адрес как пару буквального IP-адреса и номера порта. Параметр адреса может использовать имя хоста, но это не рекомендуется, так как он вернет не более одного IP-адреса имени хоста.
См. функцию Dial для описания параметров сети и адреса.
func TCPAddrFromAddrPort 1.18
func TCPAddrFromAddrPort(addr netip.AddrPort) *TCPAddr
TCPAddrFromAddrPort возвращает addr как TCPAddr. Если addr.IsValid() ложно, то возвращаемый TCPAddr будет содержать пустое поле IP, указывающее на адресную семейство-независимую неопределенную адресную строку.
func (*TCPAddr) AddrPort 1.18
func (a *TCPAddr) AddrPort() netip.AddrPort
AddrPort возвращает TCPAddr как netip.AddrPort.
Если a.Port не помещается в uint16, он молча обрезается.
Если a равно null, возвращается значение по умолчанию.
func (*TCPAddr) Network
func (a *TCPAddr) Network() string
Network возвращает имя сети адреса, «tcp».
func (*TCPAddr) String
func (a *TCPAddr) String() string
тип TCPConn
TCPConn — это реализация интерфейса Conn для TCP-соединений.
type TCPConn struct {
// contains filtered or unexported fields
}
func DialTCP
func DialTCP(network string, laddr, raddr *TCPAddr) (*TCPConn, error)
DialTCP действует как Dial для TCP-сетей.
Сеть должна быть именем TCP-сети; см. функцию Dial для подробностей.
Если laddr равен null, локальный адрес выбирается автоматически. Если поле IP raddr равно null или неопределенному IP-адресу, используется локальная система.
func (*TCPConn) Close
func (c *TCPConn) Close() error
Close закрывает соединение.
func (*TCPConn) CloseRead
func (c *TCPConn) CloseRead() error
CloseRead завершает чтение стороны TCP-соединения. Большинство вызывающих сторон должны просто использовать Close.
func (*TCPConn) CloseWrite
func (c *TCPConn) CloseWrite() error
CloseWrite завершает запись стороны TCP-соединения. Большинство вызывающих сторон должны просто использовать Close.
func (*TCPConn) File
func (c *TCPConn) File() (f *os.File, err error)
File возвращает копию базового os.File. Ответственность вызывающей стороны — закрыть f по завершении. Закрытие c не влияет на f, и закрытие f не влияет на c.
Дескриптор файла возвращаемого os.File отличается от дескриптора файла подключения. Попытки изменить свойства оригинала с помощью этой копии могут или не могут иметь желаемый эффект.
func (*TCPConn) LocalAddr
func (c *TCPConn) LocalAddr() Addr
LocalAddr возвращает локальный сетевой адрес. Возвращаемый адрес общий для всех вызовов LocalAddr, поэтому не изменяйте его.
func (*TCPConn) MultipathTCP 1.21
func (c *TCPConn) MultipathTCP() (bool, error)
MultipathTCP сообщает, использует ли текущее соединение MPTCP.
Если многопутевой TCP не поддерживается хостом, другим узлом или намеренно/случайно отфильтрован устройством между ними, будет выполнен переход на TCP. Этот метод делает все возможное для проверки того, используется ли MPTCP или нет.
В Linux для ядер >= v5.16 проверяется больше условий, улучшая результаты.
func (*TCPConn) Read
func (c *TCPConn) Read(b []byte) (int, error)
Read реализует метод Conn Read.
func (*TCPConn) ReadFrom
func (c *TCPConn) ReadFrom(r io.Reader) (int64, error)
ReadFrom реализует метод io.ReaderFrom ReadFrom.
func (*TCPConn) RemoteAddr
func (c *TCPConn) RemoteAddr() Addr
RemoteAddr возвращает удаленный сетевой адрес. Возвращаемый адрес общий для всех вызовов RemoteAddr, поэтому не изменяйте его.
func (*TCPConn) SetDeadline
func (c *TCPConn) SetDeadline(t time.Time) error
SetDeadline реализует метод Conn SetDeadline.
func (*TCPConn) SetKeepAlive
func (c *TCPConn) SetKeepAlive(keepalive bool) error
SetKeepAlive задает, следует ли операционной системе отправлять сообщения keep-alive по подключению.
func (*TCPConn) SetKeepAliveConfig 1.23
func (c *TCPConn) SetKeepAliveConfig(config KeepAliveConfig) error
SetKeepAliveConfig настраивает сообщения keep-alive, отправляемые операционной системой.
func (*TCPConn) SetKeepAlivePeriod 1.2
func (c *TCPConn) SetKeepAlivePeriod(d time.Duration) error
SetKeepAlivePeriod задает период времени, в течение которого соединение должно оставаться неактивным, прежде чем TCP начнет отправлять зонды keep-alive.
Обратите внимание, что вызов этого метода на Windows до Windows 10 версии 1709 приведет к сбросу KeepAliveInterval до значения по умолчанию системы, которое обычно составляет 1 секунду.
func (*TCPConn) SetLinger
func (c *TCPConn) SetLinger(sec int) error
SetLinger устанавливает поведение Close для соединения, у которого все еще есть данные, ожидающие отправки или подтверждения.
Если sec < 0 (по умолчанию), операционная система завершает отправку данных в фоновом режиме.
Если sec == 0, операционная система отбрасывает любые неосланные или неподтвержденные данные.
Если sec > 0, данные отправляются в фоновом режиме, как и при sec < 0. В некоторых операционных системах, включая Linux, это может привести к блокировке Close до тех пор, пока все данные не будут отправлены или отброшены. В некоторых операционных системах после истечения sec секунд любые оставшиеся неосланные данные могут быть отброшены.
func (*TCPConn) SetNoDelay
func (c *TCPConn) SetNoDelay(noDelay bool) error
SetNoDelay управляет тем, должна ли операционная система задерживать передачу пакетов в надежде отправить меньше пакетов (алгоритм Найгла). По умолчанию значение равно true (без задержки), что означает, что данные отправляются как можно скорее после Write.
func (*TCPConn) SetReadBuffer
func (c *TCPConn) SetReadBuffer(bytes int) error
SetReadBuffer задаёт размер буфера приёма операционной системы, связанного с соединением.
func (*TCPConn) SetReadDeadline
func (c *TCPConn) SetReadDeadline(t time.Time) error
SetReadDeadline реализует метод Conn SetReadDeadline.
func (*TCPConn) SetWriteBuffer
func (c *TCPConn) SetWriteBuffer(bytes int) error
SetWriteBuffer задаёт размер буфера отправки операционной системы, связанного с соединением.
func (*TCPConn) SetWriteDeadline
func (c *TCPConn) SetWriteDeadline(t time.Time) error
SetWriteDeadline реализует метод Conn SetWriteDeadline.
func (*TCPConn) SyscallConn 1.9
func (c *TCPConn) SyscallConn() (syscall.RawConn, error)
SyscallConn возвращает исходное сетевое соединение. Это реализует интерфейс syscall.Conn.
func (*TCPConn) Write
func (c *TCPConn) Write(b []byte) (int, error)
Write реализует метод Conn Write.
func (*TCPConn) WriteTo 1.22
func (c *TCPConn) WriteTo(w io.Writer) (int64, error)
WriteTo реализует метод io.WriterTo WriteTo.
type TCPListener
TCPListener — это TCP-сетевой слушатель. Клиенты обычно должны использовать переменные типа Listener, а не предполагать TCP.
type TCPListener struct {
// contains filtered or unexported fields
}
func ListenTCP
func ListenTCP(network string, laddr *TCPAddr) (*TCPListener, error)
ListenTCP работает так же, как Listen для TCP-сетей.
Сеть должна быть именем TCP-сети; см. функцию Dial для получения подробностей.
Если поле IP в laddr равно null или это неопределённый IP-адрес, ListenTCP прослушивает все доступные одноадресные и многоадресные IP-адреса локальной системы. Если поле Port в laddr равно 0, номер порта выбирается автоматически.
func (*TCPListener) Accept
func (l *TCPListener) Accept() (Conn, error)
Accept реализует метод Accept в интерфейсе Listener; он ожидает следующего вызова и возвращает общий Conn.
func (*TCPListener) AcceptTCP
func (l *TCPListener) AcceptTCP() (*TCPConn, error)
AcceptTCP принимает следующий входящий вызов и возвращает новое соединение.
func (*TCPListener) Addr
func (l *TCPListener) Addr() Addr
Addr возвращает сетевой адрес слушателя, *TCPAddr. Возвращаемый адрес используется всеми вызовами Addr, поэтому не изменяйте его.
func (*TCPListener) Close
func (l *TCPListener) Close() error
Close прекращает прослушивание по TCP-адресу. Уже принятые соединения не закрываются.
func (*TCPListener) File
func (l *TCPListener) File() (f *os.File, err error)
File возвращает копию базового os.File. Ответственность вызывающей стороны — закрыть f по завершении. Закрытие l не влияет на f, а закрытие f не влияет на l.
Дескриптор файла возвращённого os.File отличается от дескриптора соединения. Попытка изменить свойства оригинала с помощью этой копии может или не может иметь желаемый эффект.
func (*TCPListener) SetDeadline
func (l *TCPListener) SetDeadline(t time.Time) error
SetDeadline устанавливает срок для слушателя. Значение времени 0 отключает срок.
func (*TCPListener) SyscallConn 1.10
func (l *TCPListener) SyscallConn() (syscall.RawConn, error)
SyscallConn возвращает исходное сетевое соединение. Это реализует интерфейс syscall.Conn.
Возвращённый RawConn поддерживает только вызов Control. Read и Write возвращают ошибку.
type UDPAddr
UDPAddr представляет адрес конечной точки UDP.
type UDPAddr struct {
IP IP
Port int
Zone string // IPv6 scoped addressing zone; added in Go 1.1
}
func ResolveUDPAddr
func ResolveUDPAddr(network, address string) (*UDPAddr, error)
ResolveUDPAddr возвращает адрес конечной точки UDP.
Сеть должна быть именем UDP-сети.
Если хост в параметре адреса не является литеральным IP-адресом или порт не является литеральным номером порта, ResolveUDPAddr разрешает адрес на адрес конечной точки UDP. В противном случае он анализирует адрес как пару литерального IP-адреса и номера порта. Параметр адреса может использовать имя хоста, но это не рекомендуется, потому что он вернёт не более одного IP-адреса хоста.
См. функцию Dial для описания параметров сети и адреса.
func UDPAddrFromAddrPort 1.18
func UDPAddrFromAddrPort(addr netip.AddrPort) *UDPAddr
UDPAddrFromAddrPort возвращает addr как UDPAddr. Если addr.IsValid() ложно, то возвращаемый UDPAddr будет содержать поле IP, равное null, указывая на неопределённый адрес, независимый от семейства адресов.
func (*UDPAddr) AddrPort 1.18
func (a *UDPAddr) AddrPort() netip.AddrPort
AddrPort возвращает UDPAddr a как netip.AddrPort.
Если a.Port не помещается в uint16, он будет безмолвно усечён.
Если a равно null, возвращается нулевое значение.
func (*UDPAddr) Network
func (a *UDPAddr) Network() string
Network возвращает имя сети адреса, "udp".
func (*UDPAddr) String
func (a *UDPAddr) String() string
type UDPConn
UDPConn — это реализация интерфейсов Conn и PacketConn для UDP-сетевых соединений.
type UDPConn struct {
// contains filtered or unexported fields
}
func DialUDP
func DialUDP(network string, laddr, raddr *UDPAddr) (*UDPConn, error)
DialUDP работает так же, как Dial для UDP-сетей.
Сеть должна быть именем UDP-сети; см. функцию Dial для получения подробностей.
Если laddr равно null, локальный адрес выбирается автоматически. Если поле IP в raddr равно null или это неопределённый IP-адрес, предполагается локальная система.
func ListenMulticastUDP
func ListenMulticastUDP(network string, ifi *Interface, gaddr *UDPAddr) (*UDPConn, error)
ListenMulticastUDP работает так же, как ListenPacket для UDP-сетей, но принимает адрес группы на определённом сетевом интерфейсе.
Сеть должна быть именем UDP-сети; см. функцию Dial для получения подробностей.
ListenMulticastUDP прослушивает все доступные IP-адреса локальной системы, включая группу, многоадресной IP-адрес. Если ifi равно null, ListenMulticastUDP использует системно назначенный многоадресной интерфейс, хотя это не рекомендуется, так как присвоение зависит от платформ и иногда может потребовать конфигурации маршрутизации. Если поле Port в gaddr равно 0, номер порта выбирается автоматически.
ListenMulticastUDP предназначен только для удобства простых, небольших приложений. Для общих целей используются пакеты golang.org/x/net/ipv4 и golang.org/x/net/ipv6.
Обратите внимание, что ListenMulticastUDP устанавливает сокет-опцию IP_MULTICAST_LOOP для IPPROTO_IP в 0, чтобы отключить обратную связь многоадресных пакетов.
func ListenUDP
func ListenUDP(network string, laddr *UDPAddr) (*UDPConn, error)
ListenUDP работает так же, как ListenPacket для UDP-сетей.
Сеть должна быть именем UDP-сети; см. функцию Dial для получения подробностей.
Если поле IP в laddr равно null или это неопределённый IP-адрес, ListenUDP прослушивает все доступные IP-адреса локальной системы, за исключением многоадресных IP-адресов. Если поле Port в laddr равно 0, номер порта выбирается автоматически.
func (*UDPConn) Close
func (c *UDPConn) Close() error
Close закрывает соединение.
func (*UDPConn) File
func (c *UDPConn) File() (f *os.File, err error)
File возвращает копию базового os.File. Ответственность вызывающей стороны — закрыть f по завершении. Закрытие c не влияет на f, а закрытие f не влияет на c.
Дескриптор файла возвращённого os.File отличается от дескриптора соединения. Попытка изменить свойства оригинала с помощью этой копии может или не может иметь желаемый эффект.
func (*UDPConn) LocalAddr
func (c *UDPConn) LocalAddr() Addr
LocalAddr возвращает локальный сетевой адрес. Возвращаемый адрес используется всеми вызовами LocalAddr, поэтому не изменяйте его.
func (*UDPConn) Read
func (c *UDPConn) Read(b []byte) (int, error)
Read реализует метод Conn Read.
func (*UDPConn) ReadFrom
func (c *UDPConn) ReadFrom(b []byte) (int, Addr, error)
ReadFrom реализует метод PacketConn ReadFrom.
func (*UDPConn) ReadFromUDP
func (c *UDPConn) ReadFromUDP(b []byte) (n int, addr *UDPAddr, err error)
ReadFromUDP работает так же, как UDPConn.ReadFrom, но возвращает UDPAddr.
func (*UDPConn) ReadFromUDPAddrPort 1.18
func (c *UDPConn) ReadFromUDPAddrPort(b []byte) (n int, addr netip.AddrPort, err error)
ReadFromUDPAddrPort работает так же, как ReadFrom, но возвращает netip.AddrPort.
Если c связан с неопределённым адресом, возвращённый netip.AddrPort's address может быть IPv4-mapped IPv6 адресом. Используйте netip.Addr.Unmap, чтобы получить адрес без префикса IPv6.
func (*UDPConn) ReadMsgUDP 1.1
func (c *UDPConn) ReadMsgUDP(b, oob []byte) (n, oobn, flags int, addr *UDPAddr, err error)
ReadMsgUDP считывает сообщение из c, копируя содержимое в b и связанные данные вне зоны обслуживания в oob. Он возвращает количество скопированных в b байт, количество скопированных в oob байт, флаги, установленные в сообщении, и адрес источника сообщения.
Пакеты golang.org/x/net/ipv4 и golang.org/x/net/ipv6 могут использоваться для управления опциями сокета на уровне IP в oob.
func (*UDPConn) ReadMsgUDPAddrPort 1.18
func (c *UDPConn) ReadMsgUDPAddrPort(b, oob []byte) (n, oobn, flags int, addr netip.AddrPort, err error)
ReadMsgUDPAddrPort похож на UDPConn.ReadMsgUDP, но возвращает netip.AddrPort вместо UDPAddr.
func (*UDPConn) RemoteAddr
func (c *UDPConn) RemoteAddr() Addr
RemoteAddr возвращает удалённый сетевой адрес. Возвращаемый адрес используется всеми вызовами RemoteAddr, поэтому не изменяйте его.
func (*UDPConn) SetDeadline
func (c *UDPConn) SetDeadline(t time.Time) error
SetDeadline реализует метод Conn SetDeadline.
func (*UDPConn) SetReadBuffer
func (c *UDPConn) SetReadBuffer(bytes int) error
SetReadBuffer задаёт размер буфера приёма операционной системы, связанного с соединением.
func (*UDPConn) SetReadDeadline
func (c *UDPConn) SetReadDeadline(t time.Time) error
SetReadDeadline реализует метод Conn SetReadDeadline.
func (*UDPConn) SetWriteBuffer
func (c *UDPConn) SetWriteBuffer(bytes int) error
SetWriteBuffer устанавливает размер буфера передачи операционной системы, связанного с подключением.
func (*UDPConn) SetWriteDeadline
func (c *UDPConn) SetWriteDeadline(t time.Time) error
SetWriteDeadline реализует метод Conn SetWriteDeadline.
func (*UDPConn) SyscallConn 1.9
func (c *UDPConn) SyscallConn() (syscall.RawConn, error)
SyscallConn возвращает исходное сетевое подключение. Реализует интерфейс syscall.Conn.
func (*UDPConn) Write
func (c *UDPConn) Write(b []byte) (int, error)
Write реализует метод Conn Write.
func (*UDPConn) WriteMsgUDP 1.1
func (c *UDPConn) WriteMsgUDP(b, oob []byte, addr *UDPAddr) (n, oobn int, err error)
WriteMsgUDP записывает сообщение в addr через c, если c не подключено, или в удалённый адрес c, если c подключено (в этом случае addr должен быть nil). Данные полезной нагрузки копируются из b, а связанные данные вне полосы – из oob. Возвращает количество записанных байт полезной нагрузки и вне полосы.
Пакеты golang.org/x/net/ipv4 и golang.org/x/net/ipv6 можно использовать для манипулирования опциями сокета на уровне IP в oob.
func (*UDPConn) WriteMsgUDPAddrPort 1.18
func (c *UDPConn) WriteMsgUDPAddrPort(b, oob []byte, addr netip.AddrPort) (n, oobn int, err error)
WriteMsgUDPAddrPort подобен UDPConn.WriteMsgUDP, но использует netip.AddrPort вместо UDPAddr.
func (*UDPConn) WriteTo
func (c *UDPConn) WriteTo(b []byte, addr Addr) (int, error)
WriteTo реализует метод PacketConn WriteTo.
Пример
Код:
// Unlike Dial, ListenPacket creates a connection without any
// association with peers.
conn, err := net.ListenPacket("udp", ":0")
if err != nil {
log.Fatal(err)
}
defer conn.Close()
dst, err := net.ResolveUDPAddr("udp", "192.0.2.1:2000")
if err != nil {
log.Fatal(err)
}
// The connection can write data to the desired address.
_, err = conn.WriteTo([]byte("data"), dst)
if err != nil {
log.Fatal(err)
}
func (*UDPConn) WriteToUDP
func (c *UDPConn) WriteToUDP(b []byte, addr *UDPAddr) (int, error)
WriteToUDP работает подобно UDPConn.WriteTo, но использует UDPAddr.
func (*UDPConn) WriteToUDPAddrPort 1.18
func (c *UDPConn) WriteToUDPAddrPort(b []byte, addr netip.AddrPort) (int, error)
WriteToUDPAddrPort работает подобно UDPConn.WriteTo, но использует netip.AddrPort.
type UnixAddr
UnixAddr представляет адрес конечной точки сокета Unix доменного типа.
type UnixAddr struct {
Name string
Net string
}
func ResolveUnixAddr
func ResolveUnixAddr(network, address string) (*UnixAddr, error)
ResolveUnixAddr возвращает адрес конечной точки сокета Unix доменного типа.
Сеть должна быть именем Unix-сети.
См. функцию Dial для описания параметров сети и адреса.
func (*UnixAddr) Network
func (a *UnixAddr) Network() string
Network возвращает имя сети адреса, "unix", "unixgram" или "unixpacket".
func (*UnixAddr) String
func (a *UnixAddr) String() string
type UnixConn
UnixConn — реализация интерфейса Conn для подключений к сокетам Unix доменного типа.
type UnixConn struct {
// contains filtered or unexported fields
}
func DialUnix
func DialUnix(network string, laddr, raddr *UnixAddr) (*UnixConn, error)
DialUnix работает подобно Dial для Unix-сетей.
Сеть должна быть именем Unix-сети; см. функцию Dial для получения деталей.
Если laddr не равен nil, он используется в качестве локального адреса для подключения.
func ListenUnixgram
func ListenUnixgram(network string, laddr *UnixAddr) (*UnixConn, error)
ListenUnixgram работает подобно ListenPacket для Unix-сетей.
Сеть должна быть "unixgram".
func (*UnixConn) Close
func (c *UnixConn) Close() error
Close закрывает подключение.
func (*UnixConn) CloseRead 1.1
func (c *UnixConn) CloseRead() error
CloseRead закрывает сторону чтения Unix-подключения доменного типа. Большинство вызывающих сторон должны использовать просто Close.
func (*UnixConn) CloseWrite 1.1
func (c *UnixConn) CloseWrite() error
CloseWrite закрывает сторону записи Unix-подключения доменного типа. Большинство вызывающих сторон должны использовать просто Close.
func (*UnixConn) File
func (c *UnixConn) File() (f *os.File, err error)
File возвращает копию базового os.File. Вызывающая сторона несет ответственность за закрытие f по завершении. Закрытие c не влияет на f, а закрытие f не влияет на c.
Дескриптор файла возвращённого os.File отличается от дескриптора файла подключения. Попытки изменить свойства оригинала с помощью этой копии могут или не могут иметь желаемый эффект.
func (*UnixConn) LocalAddr
func (c *UnixConn) LocalAddr() Addr
LocalAddr возвращает локальный сетевой адрес. Возвращённый Addr используется всеми вызовами LocalAddr, поэтому его не следует изменять.
func (*UnixConn) Read
func (c *UnixConn) Read(b []byte) (int, error)
Read реализует метод Conn Read.
func (*UnixConn) ReadFrom
func (c *UnixConn) ReadFrom(b []byte) (int, Addr, error)
ReadFrom реализует метод PacketConn ReadFrom.
func (*UnixConn) ReadFromUnix
func (c *UnixConn) ReadFromUnix(b []byte) (int, *UnixAddr, error)
ReadFromUnix работает подобно UnixConn.ReadFrom, но возвращает UnixAddr.
func (*UnixConn) ReadMsgUnix
func (c *UnixConn) ReadMsgUnix(b, oob []byte) (n, oobn, flags int, addr *UnixAddr, err error)
ReadMsgUnix считывает сообщение из c, копируя полезную нагрузку в b и связанные данные вне полосы в oob. Возвращает количество скопированных байт в b, количество скопированных байт в oob, флаги, установленные для сообщения, и адрес источника сообщения.
Обратите внимание, что если len(b) == 0 и len(oob) > 0, эта функция всё равно прочитает (и отбросит) 1 байт из подключения.
func (*UnixConn) RemoteAddr
func (c *UnixConn) RemoteAddr() Addr
RemoteAddr возвращает удалённый сетевой адрес. Возвращённый Addr используется всеми вызовами RemoteAddr, поэтому его не следует изменять.
func (*UnixConn) SetDeadline
func (c *UnixConn) SetDeadline(t time.Time) error
SetDeadline реализует метод Conn SetDeadline.
func (*UnixConn) SetReadBuffer
func (c *UnixConn) SetReadBuffer(bytes int) error
SetReadBuffer устанавливает размер буфера приёма операционной системы, связанного с подключением.
func (*UnixConn) SetReadDeadline
func (c *UnixConn) SetReadDeadline(t time.Time) error
SetReadDeadline реализует метод Conn SetReadDeadline.
func (*UnixConn) SetWriteBuffer
func (c *UnixConn) SetWriteBuffer(bytes int) error
SetWriteBuffer устанавливает размер буфера передачи операционной системы, связанного с подключением.
func (*UnixConn) SetWriteDeadline
func (c *UnixConn) SetWriteDeadline(t time.Time) error
SetWriteDeadline реализует метод Conn SetWriteDeadline.
func (*UnixConn) SyscallConn 1.9
func (c *UnixConn) SyscallConn() (syscall.RawConn, error)
SyscallConn возвращает исходное сетевое подключение. Реализует интерфейс syscall.Conn.
func (*UnixConn) Write
func (c *UnixConn) Write(b []byte) (int, error)
Write реализует метод Conn Write.
func (*UnixConn) WriteMsgUnix
func (c *UnixConn) WriteMsgUnix(b, oob []byte, addr *UnixAddr) (n, oobn int, err error)
WriteMsgUnix записывает сообщение в addr через c, копируя полезную нагрузку из b и связанные данные вне полосы из oob. Возвращает количество записанных байт полезной нагрузки и вне полосы.
Обратите внимание, что если len(b) == 0 и len(oob) > 0, эта функция всё равно запишет 1 байт в подключение.
func (*UnixConn) WriteTo
func (c *UnixConn) WriteTo(b []byte, addr Addr) (int, error)
WriteTo реализует метод PacketConn WriteTo.
func (*UnixConn) WriteToUnix
func (c *UnixConn) WriteToUnix(b []byte, addr *UnixAddr) (int, error)
WriteToUnix работает подобно UnixConn.WriteTo, но использует UnixAddr.
type UnixListener
UnixListener — слушатель сокетов Unix доменного типа. Клиенты обычно должны использовать переменные типа Listener, а не предполагать сокеты Unix доменного типа.
type UnixListener struct {
// contains filtered or unexported fields
}
func ListenUnix
func ListenUnix(network string, laddr *UnixAddr) (*UnixListener, error)
ListenUnix работает подобно Listen для Unix-сетей.
Сеть должна быть "unix" или "unixpacket".
func (*UnixListener) Accept
func (l *UnixListener) Accept() (Conn, error)
Accept реализует метод Accept в интерфейсе Listener. Возвращаемые подключения будут типа *UnixConn.
func (*UnixListener) AcceptUnix
func (l *UnixListener) AcceptUnix() (*UnixConn, error)
AcceptUnix принимает следующий входящий вызов и возвращает новое подключение.
func (*UnixListener) Addr
func (l *UnixListener) Addr() Addr
Addr возвращает сетевой адрес слушателя. Возвращённый Addr используется всеми вызовами Addr, поэтому его не следует изменять.
func (*UnixListener) Close
func (l *UnixListener) Close() error
Close останавливает прослушивание на Unix-адресе. Уже принятые подключения не закрываются.
func (*UnixListener) File
func (l *UnixListener) File() (f *os.File, err error)
File возвращает копию базового os.File. Вызывающая сторона несет ответственность за закрытие f по завершении. Закрытие l не влияет на f, а закрытие f не влияет на l.
Дескриптор файла возвращённого os.File отличается от дескриптора файла подключения. Попытки изменить свойства оригинала с помощью этой копии могут или не могут иметь желаемый эффект.
func (*UnixListener) SetDeadline
func (l *UnixListener) SetDeadline(t time.Time) error
SetDeadline устанавливает срок, связанный с слушателем. Значение нулевого времени отключает срок.
func (*UnixListener) SetUnlinkOnClose 1.8
func (l *UnixListener) SetUnlinkOnClose(unlink bool)
SetUnlinkOnClose устанавливает, следует ли удалять базовый файл сокета из файловой системы при закрытии слушателя.
По умолчанию файл сокета удаляется только в том случае, если пакет net его создал. То есть, если слушатель и базовый файл сокета были созданы вызовом Listen или ListenUnix, то по умолчанию закрытие слушателя удалит файл сокета. Но если слушатель был создан вызовом FileListener для использования уже существующего файла сокета, то по умолчанию закрытие слушателя не удалит файл сокета.
func (*UnixListener) SyscallConn 1.10
func (l *UnixListener) SyscallConn() (syscall.RawConn, error)
SyscallConn возвращает исходное сетевое подключение. Реализует интерфейс syscall.Conn.
Возвращённый RawConn поддерживает только вызовы Control. Read и Write возвращают ошибку.
type UnknownNetworkError
type UnknownNetworkError string
func (UnknownNetworkError) Error
func (e UnknownNetworkError) Error() string
func (UnknownNetworkError) Temporary
func (e UnknownNetworkError) Temporary() bool
func (UnknownNetworkError) Timeout
func (e UnknownNetworkError) Timeout() bool
Ошибки
- ☞
В JS и Windows функции FileConn, FileListener и FilePacketConn не реализованы.
- ☞
В JS методы и функции, относящиеся к Interface, не реализованы.
- ☞
В AIX, DragonFly BSD, NetBSD, OpenBSD, Plan 9 и Solaris метод MulticastAddrs интерфейса Interface не реализован.
- ☞
На всех платформах POSIX чтение из сети "ip4" с использованием методов ReadFrom или ReadFromIP может не возвращать полный пакет IPv4, включая его заголовок, даже если есть доступное место. Это может произойти даже в тех случаях, когда Read или ReadMsgIP могут вернуть полный пакет. По этой причине рекомендуется не использовать эти методы, если важно получить полный пакет.
Руководство по совместимости Go 1 делает невозможным изменение поведения этих методов; используйте вместо них Read или ReadMsgIP.
- ☞
В JS и Plan 9 методы и функции, относящиеся к IPConn, не реализованы.
- ☞
В Windows метод File интерфейса IPConn не реализован.
- ☞
В DragonFly BSD и OpenBSD прослушивание сетей "tcp" и "udp" не прослушивает подключения IPv4 и IPv6 одновременно. Это связано с тем, что трафик IPv4 не будет маршрутизирован в сокет IPv6 — для поддержки обоих семейств адресов требуется два отдельных сокета. Подробнее см. inet6(4).
- ☞
В Windows метод Write интерфейса syscall.RawConn не интегрируется с сетевым обработчиком среды выполнения. Он не может ожидать, пока подключение станет доступным для записи, и не учитывает сроки. Если пользовательская функция-обработчик возвращает false, метод Write немедленно завершается ошибкой.
- ☞
В JS и Plan 9 методы Control, Read и Write интерфейса syscall.RawConn не реализованы.
- ☞
В JS и Windows метод File интерфейсов TCPConn и TCPListener не реализован.
- ☞
В Plan 9 методы ReadMsgUDP и WriteMsgUDP интерфейса UDPConn не реализованы.
- ☞
В Windows метод File интерфейса UDPConn не реализован.
- ☞
В JS методы и функции, относящиеся к UDPConn, не реализованы.
- ☞
В JS, WASIP1 и Plan 9 методы и функции, относящиеся к UnixConn и UnixListener, не реализованы.
- ☞
В Windows методы и функции, относящиеся к UnixConn и UnixListener, не работают для "unixgram" и "unixpacket".
Поддиректории
| Имя | Синопсис |
|---|---|
| .. | |
| http | Пакет http предоставляет реализации HTTP-клиента и сервера. |
| cgi | Пакет cgi реализует CGI (Common Gateway Interface) согласно RFC 3875. |
| cookiejar | Пакет cookiejar реализует совместимый с RFC 6265 хранилище cookie http.CookieJar в оперативной памяти. |
| fcgi | Пакет fcgi реализует протокол FastCGI. |
| httptest | Пакет httptest предоставляет утилиты для тестирования HTTP. |
| httptrace | Пакет httptrace предоставляет механизмы для отслеживания событий в запросах HTTP-клиента. |
| httputil | Пакет httputil предоставляет утилиты HTTP, дополняющие более распространённые утилиты в пакете net/http. |
| pprof | Пакет pprof отображает данные о профилировании среды выполнения через HTTP-сервер в формате, ожидаемом инструментом визуализации pprof. |
| Пакет mail реализует парсинг почтовых сообщений. | |
| netip | Пакет netip определяет тип IP-адреса как тип со небольшим размером. |
| rpc | Пакет rpc предоставляет доступ к экспортированным методам объекта через сеть или другое соединение ввода-вывода. |
| jsonrpc | Пакет jsonrpc реализует JSON-RPC 1.0 ClientCodec и ServerCodec для пакета rpc. |
| smtp | Пакет smtp реализует протокол Simple Mail Transfer Protocol, определенный в RFC 5321. |
| textproto | Пакет textproto реализует общую поддержку текстовых протоколов запроса/ответа, таких как HTTP, NNTP и SMTP. |
| url | Пакет url анализирует URL-адреса и реализует кодирование запросов. |
© Google, Inc.
Licensed under the Creative Commons Attribution License 3.0.
http://golang.org/pkg/net/
