package safesocket

import "tailscale.com/safesocket"

Package safesocket creates either a Unix socket, if possible, or otherwise a localhost TCP connection.

Index ¶

• Variables
• func ConnCloseRead(c net.Conn) error
• func ConnCloseWrite(c net.Conn) error
• func Connect(path string) (net.Conn, error)
• func ConnectContext(ctx context.Context, path string) (net.Conn, error)
• func GOOSUsesPeerCreds(goos string) bool
• func Listen(path string) (net.Listener, error)
• func LocalTCPPortAndToken() (port int, token string, err error)
• func PlatformUsesPeerCreds() bool

Variables ¶

var (
	ErrTokenNotFound = errors.New("no token found")
	ErrNoTokenOnOS   = errors.New("no token on " + runtime.GOOS)
)

Functions ¶

func ConnCloseRead ¶

func ConnCloseRead(c net.Conn) error

ConnCloseRead calls c's CloseRead method. c is expected to be either a UnixConn or TCPConn as returned from this package.

func ConnCloseWrite ¶

func ConnCloseWrite(c net.Conn) error

ConnCloseWrite calls c's CloseWrite method. c is expected to be either a UnixConn or TCPConn as returned from this package.

func Connect ¶

func Connect(path string) (net.Conn, error)

Connect connects to tailscaled using a unix socket or named pipe. Deprecated: use ConnectContext instead.

func ConnectContext ¶

func ConnectContext(ctx context.Context, path string) (net.Conn, error)

ConnectContext connects to tailscaled using a unix socket or named pipe.

func GOOSUsesPeerCreds ¶

func GOOSUsesPeerCreds(goos string) bool

GOOSUsesPeerCreds is like PlatformUsesPeerCreds but takes a runtime.GOOS value instead of using the current one.

func Listen ¶

func Listen(path string) (net.Listener, error)

Listen returns a listener either on Unix socket path (on Unix), or the NamedPipe path (on Windows).

func LocalTCPPortAndToken ¶

func LocalTCPPortAndToken() (port int, token string, err error)

LocalTCPPortAndToken returns the port number and auth token to connect to the local Tailscale daemon. It's currently only applicable on macOS when tailscaled is being run in the Mac Sandbox from the App Store version of Tailscale.

func PlatformUsesPeerCreds ¶

func PlatformUsesPeerCreds() bool

PlatformUsesPeerCreds reports whether the current platform uses peer credentials to authenticate connections.

Source Files ¶

safesocket.go safesocket_ps.go unixsocket.go