---
name: "dns2tcpd"
section: "1"
platform: "linux"
package: "dns2tcp"
version: "0.5.2-3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/dns2tcpd"
---

# dns2tcpd(1)

A tunneling tool that encapsulate TCP traffic over DNS.

## NAME

dns2tcpd - A tunneling tool that encapsulate TCP traffic over DNS.

## SYNOPSIS

**dns2tcpd** \[ **-h** \] \[ **-F** \] \[ **-i** *address* \] \[ **-f** *config\_file* \] \[ **-p** *pidfile* \] \[ **-d** *debug\_level* \]\

## DESCRIPTION

dns2tcp is a network tool used to encapsulate TCP communications in DNS. When connections are received on a specific port all TCP traffic is sent to the remote dns2tcpd server and forwarded to a specific host and port. Multiple connections are supported.

It was written for demonstration purposes

## OPTIONS

- **-h**

  Help Menu

- **-F**

  Run in foreground

- **-i** **IP address**

  IP address to bind (default 0.0.0.0)

- **-f** **config file**

  Configuration file to use

- **-p** **pidfile**

  File where our pid will be written

- **-d** **debug level**

  Change debug level. Levels available are 1, 2 or 3.

## CONFIGURATION FILES

By default ${HOME}/.dns2tcprcd is used if no configuration file is specified. The resource syntax is \<resource-name\>:\<server\>:\<port\>. Multiple resources can be defined in multilines, but must be comma separated.

Here is an example :

- listen = 127.0.0.1

  ```
  port = 53
  user = nobody
  chroot = /tmp
  pid_file = /var/run/dns2tcp.pid
  domain = dns2tcp.hsc.fr
  debug_level = 0
  resources = ssh:127.0.0.1:22 , smtp:127.0.0.1:25,
               pop3:10.0.0.1:110
  ```

## AUTHORS

Olivier Dembour \<olivier.dembour@hsc.fr\>

## SEE ALSO

ssltunnel