< Previous PageNext Page >

Realm-networking (user_nat) Reference Application

This topic explains how to build user_nat, which provides networking functionality for BlackDog applications.

Realm-networking provides network address translation (NAT) services for the BlackDog device without requiring administrator level access to the host PC. This allows the Blackdog Device to access the internet, and other networks connected to the host PC.

Building Realm-networking

Requirements:

Building:

  1. Obtain the source from SDK_ROOT/src/user_nat.
  2. To build user_nat, enter the following commands:

    ./autogen.sh

    ./configure

    make

  3. Optional. Compress the resulting Realm-networking.exe binary with UPX (Ultimate Packer for eXecutables) to reduce its size. For more information, please refer to: http://upx.sourceforge.net.

Running:

To run user_nat, enter the following command:

Realm-networking.exe <ip address>

Syntax:

USAGE:
./Realm-networking [-d FILE] [-h] [-f LPORT,RHOST,RPORT] [-p PORT] [-a IP] [-n NUM] TARGET [-z LEVEL]
Establish a VTUN UDP gateway to a remote host and act as a NAT proxy agent for the remote host.

 

OPTIONS:  
-a IP Use IP as special ip address for NAT [default is one class C address above the TARGET address, plus 2.] This need not be modified under most circumstances.
-d FILE Dump PCAP log of networking traffic to FILE
-h Print this help message
-f LPORT, RHOST, RPORT Forward local port LPORT to host RHOST:RPORT
-n NUM Attempt to connect NUM times before exiting [default 1]
-p PORT Use PORT on remote host to connect [default 5000]
-z LEVEL Enable LZO compression with compress level LEVEL [1-9]


 

 

 

 < Previous PageNext Page >
Copyright © Realm Systems, Inc. 2003-2005.
All rights reserved.