-d, --debug | Be verbose, don't log to the system logger. | help + man |
--trace | Be extra verbose, show single packets. | help + man |
--stats DELAY | Display events statistics with a minimum DELAY seconds between updates. | help + man |
-q, --quiet | Don't print informational messages. | help + man |
-f, --foreground | Don't run in background default: run in background | help + man |
-l, --log-file PATH | Log to file PATH, and not to the system logger. | help + man |
--log-size BYTES | Maximum size of log file default: 1 MiB | help + man |
--runas UID|UID:GID | Attempt to change to given UID and corresponding group if UID is given, or to given UID and given GID if both are given. | help + man |
-c, --conf-path PATH | Path for configuration and control socket used by pesto(1) to dynamically update passt or pasta's configuration. | help + man |
-h, --help | Display this help message and exit | help + man |
--version | Show version and exit. | help + man |
-s, --socket, --socket-path PATH | UNIX domain socket path default: probe free path starting from /tmp/passt_1.socket | help + man |
--vhost-user | Enable vhost-user mode UNIX domain socket is provided by -s option | help + man |
--print-capabilities | Print back-end capabilities in JSON format, only meaningful for vhost-user mode. | help + man |
--repair-path PATH | Path for UNIX domain socket used by the passt-repair(1) helper to connect to passt in order to set or clear the TCP_REPAIR option on sockets, during migration. | help + man |
--migrate-exit (DEPRECATED) | DEPRECATED: source quits after migration default: source keeps running after migration | help + man |
--migrate-no-linger (DEPRECATED) | DEPRECATED: close sockets on migration default: keep sockets open, ignore events | help + man |
-F, --fd FD | Pass a pre-opened, connected socket to passt. | help + man |
-p, --pcap FILE | Capture tap-facing (that is, guest-side or namespace-side) network packets to file in pcap format. | help + man |
-P, --pid FILE | Write own PID to file once initialisation is done, before forking to background (if configured to do so). | help + man |
-m, --mtu MTU | Assign MTU via DHCP/NDP a zero value disables assignment default: 65520: maximum 802.3 MTU minus 802.3 header length, rounded to 32 bits (IPv4 words) | help + man |
-a, --address ADDR | Assign IPv4 or IPv6 address ADDR[/PREFIXLEN] can be specified zero to two times (for IPv4 and IPv6) default: use addresses from interface with default route | help |
-n, --netmask MASK | Assign IPv4 netmask mask, expressed as dot-decimal or number of bits, via DHCP (option 1). | help + man |
-M, --mac-addr ADDR | Use source MAC address addr when communicating to the guest or to the target namespace. | help + man |
-g, --gateway ADDR | Assign IPv4 addr as default gateway via DHCP (option 3), or IPv6 addr as source for NDP Router Advertisement and DHCPv6 messages. | help + man |
-i, --interface NAME | Interface for addresses and routes default: from --outbound-if4 and --outbound-if6, if any otherwise interface with first default route | help + man |
-o, --outbound ADDR | Use an IPv4 addr as source address for IPv4 outbound TCP connections, UDP flows, ICMP requests, or an IPv6 addr for IPv6 ones, by binding outbound sockets to it. | help + man |
--outbound-if4 NAME | Bind IPv4 outbound sockets to host interface name, and, unless another interface is specified via -i, --interface, use this interface to derive IPv4 addresses and routes. | help + man |
--outbound-if6 NAME | Bind IPv6 outbound sockets to host interface name, and, unless another interface is specified via -i, --interface, use this interface to derive IPv6 addresses and routes. | help + man |
-D, --dns ADDR | Instruct the guest (via DHCP, DHVPv6 or NDP) to use addr (IPv4 or IPv6) as a nameserver, as configured (see options --no-dhcp-dns, --dhcp-dns) instead of reading addresses from /etc/resolv.conf. | help + man |
-S, --search LIST | Use space-separated list for DHCP, DHCPv6, and NDP purposes, instead of reading entries from /etc/resolv.conf. | help + man |
-H, --hostname NAME | Hostname to configure the client with. | help + man |
--fqdn NAME | FQDN to configure client with default: use search list from /etc/resolv.conf | help + man |
--no-dhcp-dns | In passt mode, do not assign IPv4 addresses via DHCP (option 23) or IPv6 addresses via NDP Router Advertisement (option type 25) and DHCPv6 (option 23) as DNS resolvers. | help + man |
--no-dhcp-search | In passt mode, do not send the DNS domain search list addresses via DHCP (option 119), via NDP Router Advertisement (option type 31) and DHCPv6 (option 24). | help + man |
--map-host-loopback ADDR | Translate ADDR to refer to host can be specified zero to two times (for IPv4 and IPv6) default: gateway address | help + man |
--map-guest-addr ADDR | Translate ADDR to guest's address can be specified zero to two times (for IPv4 and IPv6) default: none | help + man |
--dns-forward ADDR | Map addr (IPv4 or IPv6) as seen from guest or namespace to the nameserver (with corresponding IP version) specified by the --dns-host option. | help + man |
--dns-host ADDR | Host nameserver to direct queries to can be specified zero to two times (for IPv4 and IPv6) default: first nameserver from host's /etc/resolv.conf | help + man |
--no-tcp | Disable the TCP protocol handler. | help + man |
--no-udp | Disable the UDP protocol handler. | help + man |
--no-icmp | Disable the ICMP/ICMPv6 protocol handler. | help + man |
--no-dhcp | Disable the DHCP server. | help + man |
--no-ndp | Disable Neighbor Discovery. | help + man |
--no-dhcpv6 | Disable the DHCPv6 server. | help + man |
--no-ra | Disable Router Advertisements. | help + man |
--freebind | Allow any binding address to be specified for -t and -u options. | help + man |
--no-map-gw | Don't remap TCP connections and untracked UDP traffic, with the gateway address as destination, to the host. | help + man |
--chroot-fallback | Enable fallback to chroot() in case pivot_root(), used to switch to an empty filesystem for stricter isolation, returns an error. | help + man |
-4, --ipv4-only | Enable IPv4-only operation. | help + man |
-6, --ipv6-only | Enable IPv6-only operation. | help + man |
-t, --tcp-ports SPEC | TCP port forwarding to guest can be specified multiple times SPEC can be: 'none': don't forward any ports [ADDR[%IFACE]/]PORTS: forward specific ports PORTS is a comma-separated list of ports or port… | help + man |
-u, --udp-ports SPEC | UDP port forwarding to guest SPEC is as described for TCP above default: none | help + man |
-1, --one-off | Quit after handling a single client connection, that is, once the client closes the socket, or once we get a socket error. | help + man |
-e, --stderr (DEPRECATED) | This option has no effect, and is maintained for compatibility purposes only. (in the manual page but not in --help) | man |
--dhcp-dns | In pasta mode, assign IPv4 addresses via DHCP (option 23) or IPv6 addresses via NDP Router Advertisement (option type 25) and DHCPv6 (option 23) as DNS resolvers. (in the manual page but not in --help) | man |
--dhcp-search | In pasta mode, send the DNS domain search list addresses via DHCP (option 119), via NDP Router Advertisement (option type 31) and DHCPv6 (option 24). (in the manual page but not in --help) | man |
-I, --ns-ifname name | Name of tap interface to be created in target namespace. (in the manual page but not in --help) | man |
-T, --tcp-ns spec | Configure TCP port forwarding from target namespace to init namespace. (in the manual page but not in --help) | man |
-U, --udp-ns spec | Configure UDP port forwarding from target namespace to init namespace. (in the manual page but not in --help) | man |
--host-lo-to-ns-lo | If specified, connections to a host loopback address forwarded with -t or -u will be delivered to the same loopback address in the namespace. (in the manual page but not in --help) | man |
--userns spec | Target user namespace to join, as a path. (in the manual page but not in --help) | man |
--netns spec | Target network namespace to join, as a path or a name. (in the manual page but not in --help) | man |
--netns-only | Join only a target network namespace, not a user namespace, and don't create one for sandboxing purposes either. (in the manual page but not in --help) | man |
--no-netns-quit | Do not exit once the target namespace reference is removed. (in the manual page but not in --help) | man |
--no-pidns | Don't create a new PID namespace for the spawned command or shell: keep it in the PID namespace pasta itself runs in, and don't mount a new procfs instance on /proc for it. (in the manual page but not in --help) | man |
--config-net | Configure networking in the namespace: set up addresses and routes as configured or sourced from the host, and bring up the tap interface. (in the manual page but not in --help) | man |
--no-copy-routes (DEPRECATED) | With --config-net, do not copy all the routes associated to the interface we derive addresses and routes from: set up only the default gateway. (in the manual page but not in --help) | man |
--no-copy-addrs (DEPRECATED) | With --config-net, do not copy all the addresses associated to the interface we derive addresses and routes from: set up a single one. (in the manual page but not in --help) | man |
--ns-mac-addr addr | Configure MAC address addr on the tap interface in the namespace. (in the manual page but not in --help) | man |
--no-splice | Disable the bypass path for inbound, local traffic. (in the manual page but not in --help) | man |
--splice-only | Do not create a tap device in the namespace. (in the manual page but not in --help) | man |