package ktimeout

import "tailscale.com/net/ktimeout"

Package ktimeout configures kernel TCP stack timeouts via the provided control functions. Platform support varies; on unsupported platforms control functions may be entirely no-ops.

Index ¶

• func SetUserTimeout(fd uintptr, timeout time.Duration) error
• func UserTimeout(timeout time.Duration) func(network, address string, c syscall.RawConn) error

Examples ¶

• UserTimeout

Functions ¶

func SetUserTimeout ¶

func SetUserTimeout(fd uintptr, timeout time.Duration) error

SetUserTimeout sets the TCP_USER_TIMEOUT option on the given file descriptor.

func UserTimeout ¶

func UserTimeout(timeout time.Duration) func(network, address string, c syscall.RawConn) error

UserTimeout returns a control function that sets the TCP user timeout (TCP_USER_TIMEOUT on linux). A user timeout specifies the maximum age of unacknowledged data on the connection (either in buffer, or sent but not acknowledged) before the connection is terminated. This timer has no effect on limiting the lifetime of idle connections. This may be entirely local to the network stack or may also apply RFC 5482 options to packets.

{
	lc := net.ListenConfig{
		Control: UserTimeout(30 * time.Second),
	}
	l, err := lc.Listen(context.TODO(), "tcp", "127.0.0.1:0")
	if err != nil {
		fmt.Printf("error: %v", err)
		return
	}
	l.Close()
	// Output:
}

Source Files ¶

ktimeout.go ktimeout_linux.go