OS Manuals

/usr/bin/pesto

Plug A Simple Socket Transport

From passt 2026.10.02-r2 (enterprise-packages), captured 2026-11-08 by running pesto --help (exit 0). permalink

Usage: /usr/bin/pesto [OPTION]... PATH

  -A, --add		Add following specifiers to forwards
  -D, --delete		Delete following specifiers instead
  -C, --clear PIF	Clear forwarding table for given PIF
  -t, --tcp-ports SPEC	TCP inbound port forwarding
    can be specified multiple times
    SPEC can be:
      'none': don't forward any ports
      [ADDR[%IFACE]/]PORTS: forward specific ports
        PORTS is either 'all' (forward all unbound, non-ephemeral
        ports), or a comma-separated list of ports, optionally
        ranged with '-' and optional target ports after ':'.
        Ranges can be reduced by excluding ports or ranges
        prefixed by '~'.
        The 'auto' keyword may be given to only forward
        ports which are bound in the target namespace
        Examples:
        -t all         Forward all ports
        -t 127.0.0.1/all Forward all ports from local address
                         127.0.0.1
        -t 22		Forward local port 22 to 22
        -t 22:23	Forward local port 22 to 23
        -t 22,25	Forward ports 22, 25 to ports 22, 25
        -t 22-80  	Forward ports 22 to 80
        -t 22-80:32-90	Forward ports 22 to 80 to
			corresponding port numbers plus 10
        -t 192.0.2.1/5	Bind port 5 of 192.0.2.1
        -t 5-25,~10-20	Forward ports 5 to 9, and 21 to 25
        -t ~25		Forward all ports except for 25
        -t auto	Forward all ports bound in namespace
        -t 192.0.2.2/auto Forward ports from 192.0.2.2 if
                          they are bound in the namespace
        -t 8000-8010,auto Forward ports 8000-8010 if they
                          are bound in the namespace
  -u, --udp-ports SPEC	UDP inbound port forwarding
    SPEC is as described for TCP above
  -T, --tcp-ns SPEC	TCP port forwarding to init namespace
    SPEC is as described above
  -U, --udp-ns SPEC	UDP port forwarding to init namespace
    SPEC is as described above
  -s, --show		Show configuration before and after
  -d, --debug		Print debugging messages
  -h, --help		Display this help message and exit
  --version		Show version and exit
Options (11)
OptionDescriptionSource
-A, --addAdd the port forwarding specifiers following this option to the current forwarding table, rather than replacing it.help + man
-D, --deleteDelete the port forwarding specifiers following this option from the current forwarding table, rather than adding them to it.help + man
-C, --clear PIFClear the forwarding table associated to a given pif, that is, a conceptual type of interface in passt(1) or pasta(1) representing a specific data path and direction.help + man
-t, --tcp-ports SPECTCP inbound port forwarding can be specified multiple times SPEC can be: 'none': don't forward any ports [ADDR[%IFACE]/]PORTS: forward specific ports PORTS is either 'all' (forward all unbound,…help + man
-u, --udp-ports SPECUDP inbound port forwarding SPEC is as described for TCP abovehelp + man
-T, --tcp-ns SPECConfigure TCP port forwarding from target namespace to init namespace.help + man
-U, --udp-ns SPECConfigure UDP port forwarding from target namespace to init namespace.help + man
-s, --showShow the forwarding configuration before and after changes are applied.help + man
-d, --debugPrint debugging messageshelp + man
-h, --helpDisplay this help message and exithelp + man
--versionShow version and exit.help + man

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.