---
name: "vanessa_socket_pipe"
section: "1"
platform: "linux"
package: "libvanessa-socket-pipe"
version: "0.0.13-1.2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/vanessa_socket_pipe"
---

# vanessa\_socket\_pipe(1)

Trivial TCP/IP pipe based on libvanessa\_socket

## NAME

vanessa\_socket\_pipe - Trivial TCP/IP pipe based on libvanessa\_socket

## SYNOPSIS

**vanessa\_socket\_pipe** \[options\]

## DESCRIPTION

A TCP/IP pipe is a user space programme that listens for TCP/IP connections on port on the local host and when a client connects makes a connection to a TCP port, possibly on another host. Once both connections are established data sent on one connection is relayed to the other, hence forming a bi-directional pipe.

Uses include enabling connections to specific ports on hosts behind a packet filter.

This code is intended primarily as an example of how many of the features of libvanessa\_socket work.

## OPTIONS

- **-c\|--connection\_limit:**

  Maximum number of connections to accept simultaneously. A value of zero sets no limit on the number of simultaneous connections.  (default 0)

- **-d\|--debug:**

  Turn on verbose debuging to stderr.

- **-h\|--help:**

  Display this message.

- **-L\|--listen\_port:**

  Port to listen on. (mandatory)

- **-l\|--listen\_host:**

  Address to listen on. May be a hostname or an IP address. If not defined then listen on all local addresses.

- **-n\|--no\_lookup:**

  Turn off lookup of hostnames and portnames. That is, hosts must be given  as IP addresses and ports must be given as numbers.

- **-O\|--outgoing\_port:**

  Define a port to connect to. If not specified -l\|--listen\_port will be used.

- **-o\|--outgoing\_host:**

  Define host to connect to.  May be a hostname or an IP address. (mandatory)

- **-q\|--quiet:**

  Only log errors. Overriden by -d\|--debug.

- **-t\|--timeout:**

  Idle timeout in seconds.  Value of zero sets infinite timeout.  (default 1800)

- **Notes:**

  Default value for binary flags is off.\
   \-L\|--listen\_port and -o\|--outgoing\_host must be defined.

## AUTHOR

Simon Horman \<horms@verge.net.au\>