go-ethereum: github.com/ethereum/go-ethereum/p2p/nat Index | Files

package nat

import "github.com/ethereum/go-ethereum/p2p/nat"

Package nat provides access to common network port mapping protocols.

Index

Package Files

nat.go natpmp.go natupnp.go

func Map Uses

❖
func Map(m Interface, c <-chan struct{}, protocol string, extport, intport int, name string)

Map adds a port mapping on m and keeps it alive until c is closed. This function is typically invoked in its own goroutine.

type ExtIP Uses

❖
type ExtIP net.IP

ExtIP assumes that the local machine is reachable on the given external IP address, and that any required ports were mapped manually. Mapping operations will not return an error but won't actually do anything.

func (ExtIP) AddMapping Uses

❖
func (ExtIP) AddMapping(string, int, int, string, time.Duration) error

func (ExtIP) DeleteMapping Uses

❖
func (ExtIP) DeleteMapping(string, int, int) error

func (ExtIP) ExternalIP Uses

❖
func (n ExtIP) ExternalIP() (net.IP, error)

func (ExtIP) String Uses

❖
func (n ExtIP) String() string

type Interface Uses

❖
type Interface interface {
    // These methods manage a mapping between a port on the local
    // machine to a port that can be connected to from the internet.
    //
    // protocol is "UDP" or "TCP". Some implementations allow setting
    // a display name for the mapping. The mapping may be removed by
    // the gateway when its lifetime ends.
    AddMapping(protocol string, extport, intport int, name string, lifetime time.Duration) error
    DeleteMapping(protocol string, extport, intport int) error

    // This method should return the external (Internet-facing)
    // address of the gateway device.
    ExternalIP() (net.IP, error)

    // Should return name of the method. This is used for logging.
    String() string
}

An implementation of nat.Interface can map local ports to ports accessible from the Internet.

func Any Uses

❖
func Any() Interface

Any returns a port mapper that tries to discover any supported mechanism on the local network.

func PMP Uses

❖
func PMP(gateway net.IP) Interface

PMP returns a port mapper that uses NAT-PMP. The provided gateway address should be the IP of your router. If the given gateway address is nil, PMP will attempt to auto-discover the router.

func Parse Uses

❖
func Parse(spec string) (Interface, error)

Parse parses a NAT interface description. The following formats are currently accepted. Note that mechanism names are not case-sensitive. 

"" or "none"         return nil
"extip:77.12.33.4"   will assume the local machine is reachable on the given IP
"any"                uses the first auto-detected mechanism
"upnp"               uses the Universal Plug and Play protocol
"pmp"                uses NAT-PMP with an auto-detected gateway address
"pmp:192.168.0.1"    uses NAT-PMP with the given gateway address

func UPnP Uses

❖
func UPnP() Interface

UPnP returns a port mapper that uses UPnP. It will attempt to discover the address of your router using UDP broadcasts.

Package nat imports 11 packages (graph) and is imported by 912 packages. Updated 2020-11-25. Refresh now. Tools for package owners.