vde-2/man/vde_over_ns.1

   1 .TH VDE_OVER_NS 1 "May 2, 2007" "Virtual Distributed Ethernet"
   2 .SH NAME
   3 vde_over_ns \- Steganographic cable over NS protocol for Virtual Distributed Ethernet
   4 .SH SYNOPSIS
   5 .B vde_over_ns
   6 [\fB\-D\fR]
   7 [\fB\-c\fI server_address\fR]
   8 [\fB\-s\fI vde_plug\fR]
   9 [\fB\-i\fI ip.to.bi.nd\fR]
  10 \fIdomain.name
  11
  12 .br
  13 .SH DESCRIPTION
  14 A
  15 \fBvde_over_ns\fP
  16 allows to connect two remote vde_switches through steganographic NS query/response datagrams.
  17 e.g.:
  18
  19 .B
  20 dpipe vde_plug /tmp/s1 = vde_over_ns tun.mydomain.vde
  21
  22 binds to udp port 53 and listen for incoming steganographic NS queries (server mode).
  23 All the traffic to/from stdout/stdin is redirected to the client via ns responses.
  24
  25 creates a wire between two vde_switches (with sockets /tmp/s1 and /tmp/s2
  26 respectively). This cable looses 10% of the packets in each direction.
  27
  28 The same vde_over_dns server can be created using:
  29
  30 .B
  31 vde_over_ns -s /tmp/s1 tun.mydomain.vde
  32
  33 The syntax is almost identical for the client mode, except that
  34 to have a vde_over_ns client connect to that server, the \fB -c \fIserver\fR
  35 option must be specified.
  36
  37 .SH OPTIONS
  38 .TP
  39 .B \-s "\fIvdeplug\fP"
  40 If specified, the vde_over_ns will connect to the local vde socket \fIvdeplug\fP
  41 instead pf stdin/stdout, using the libvdeplug library.
  42 .TP
  43 .B \-D
  44 Detach console and send the process to background.
  45 .TP
  46 .B \-b "\fIip.to.bind\fP"
  47 The NS server will bind only to the specified ip, instead of any ip.
  48 Only valid in server mode (without -c)
  49 .TP
  50 .B \-c "\fIserver_addr\fP"
  51 If specified, client mode is enabled. Vde_over_ns will try to send NS requests to \fIserver_addr\fP. If not specified, server mode is enabled by default.
  52
  53 .SH NOTICE
  54 Virtual Distributed Ethernet is not related in any way with
  55 www.vde.com ("Verband der Elektrotechnik, Elektronik und Informationstechnik"
  56 i.e. the German "Association for Electrical, Electronic & Information
  57 Technologies").
  58
  59 .SH SEE ALSO
  60 \fBvde_switch\fP(1),
  61 \fBvdeq\fP(1).
  62 \fBdpipe\fP(1).
  63 \fBunixterm\fP(1).
  64 .br
  65 .SH AUTHORS
  66 VDE_OVER_NS is a tool by Daniele Lacamera <root@danielinux.net>
  67
  68 VDE is a project by Renzo Davoli <renzo@cs.unibo.it>
  69
  70 based on nstx, a steganographic ns client/server software by:
  71
  72         Florian Heinz <sky@sysv.de>
  73
  74         Julien Oster <frodo@sysv.de>
  75
  76