hsuantinglu / channel-emulator Goto Github PK

**********************************************************************
Summary
**********************************************************************

The Channel Emulator (CE) is a software-based network-testing tool. Its
primary functions are providing framing services, acting as a flexible
protocol gateway, and providing network emulation capabilities.

The CE can send and receive data from multiple types of devices and sources.
Some or all of the incoming protocol data can be stripped, units can be
resized, and new headers or trailers added. Network emulation such as delay,
jitter, or errors can be inserted at any point in the stream.  For example, one
example use of the CE is to act as a "bump in the wire" Martian delay emulator
- taking packets from one Ethernet interface and delaying them for minutes and
then forwarding them out another interface.

The core functionality of the CE is controlled by either a configuration file
or by XML-RPC calls (for which an experimental web interface is available).

For details please see the full manual.

**********************************************************************
Basic Usage
**********************************************************************
NOTE: ctsced must be run as with superuser privileges, see the important
SECURITY CONSIDERATIONS notes.

Usage: ctsced [options]
  --config/-c <filename>            Specify initial devices/channels config file name (Default: devices-channels.cfg)
  --config-path/-C <directory>      Specify path to devices/channels config file directory (Default: /etc/ctsce)
  --debug/-d <level>                Specify debug level (0-8) (Default: 7)
  --foreground/-f                   Remain in the foreground at startup
  --fileio-path/-F <directory>      Specify path to file I/O directory (Default: /var/lib/ctsce/fileIO)
  --log/-l <filename>               Specify path to the log file (Default: /var/log/ctsced.log)
  --protect/-p ethX,ethY,...        Comma-separated list of Ethernet interfaces to avoid
  --srv-config/-s <filename>        Specify path to the server config file (Default: /etc/ctsced.cfg)
  --no-save/-n                      Do not save a new config file on exit
  --web-doc-path/-w <directory>     Specify path to web documents (Default: /var/lib/ctsce/www)


**********************************************************************
SECURITY CONSIDERATIONS
**********************************************************************

The primary functions of this software involve the manipulation of network
traffic at a raw socket level.  Thus, the Channel Emulator must be run with
superuser privileges.  This software should be treated as experimental, and
adequate security precautions should be taken to protect any hosts that run
this software.  This software was not intended for use on the Internet, but
rather closed experimental networks.

**********************************************************************
Channel Emulator build prerequisites
**********************************************************************
ACE-6.0.1
libnl-2.0
xmlrpc-c
libconfig
boost-regex
libmagic

**********************************************************************
 ACE 6.0.1
**********************************************************************
- Obtain from http://www.cs.wustl.edu/~schmidt/ACE.html or
  use OS packages.
- Build/use shared lib version.
- Must have TIMED_MESSAGE_BLOCKS enabled

**********************************************************************
 libnl 2.0
**********************************************************************
- Obtain from http://people.suug.ch/~tgr/libnl/
- for i in libnl-genl libnl-nf libnl-route libnl; do
	sudo ln -s $prefix/lib/$i.so.2.0 $prefix/lib/$i.so; done
- sudo cp netlink-generic.h netlink-local.h \
	netlink-tc.h netlink-types.h \
	$prefix/include

**********************************************************************
 xmlrpc-c
**********************************************************************
- Obtain from http://xmlrpc-c.sourceforge.net/
- Pre-requisites:
  - libcurl (http://curl.haxx.se/libcurl/) 
  - libwww (http://www.w3.org/Library/)
- Compile and install with default values.

**********************************************************************
libconfig
**********************************************************************
- Obtain from http://www.hyperrealm.com/libconfig/
- Compile and install with default values.

**********************************************************************
 boost-regex
**********************************************************************
- Obtain from http://www.boost.org/ or distribution package.
- Install with shared libraries.

**********************************************************************
 libmagic
**********************************************************************
- Obtain from http://www.darwinsys.com/file/ or distribution package.
- Install with shared libraries.


**********************************************************************
BUILDING
**********************************************************************

cmake .
make