NAME¶

inetsim - INetSim is a suite for simulating common internet services

SYNOPSIS¶

inetsim [--config <configuration file>] [--version] [--data-dir <data directory>] [--log-dir <log directory>] [--report-dir <report directory>] [--bind-address <ip address>] [--max-childs <maximum child processes>] [--user <user name>] [--faketime-init-delta <initial time delta>] [--faketime-auto-delay <delay time>] [--faketime-auto-incr <stepwidth>] [--session <session name>] [--pidfile <pid file>]

DESCRIPTION¶

INetSim simulates common internet services like DNS, HTTP, SMTP or POP3.

OPTIONS¶

--config <configuration file>

The configuration file to use, default is /etc/inetsim/inetsim.conf.

--version

Output version information.

--data-dir <data directory>

The data directory to use, default is /var/lib/inetsim/.

--log-dir <log directory>

The log directory to use, default is /var/log/inetsim/.

--report-dir <report directory>

The report directory to use, default is /var/log/inetsim/report/.

--bind-address <IP address>

The IP address to bind services to.

--max-childs <maximum child processes>

The maximum number of child processes (number of parallel connections) for each service. Default is 10.

--user <username>

User to run services. Default is 'inetsim'.

--faketime-init-delta <initial time delta>

Initial number of seconds (positive or negative) relative to current date/time for fake time used by all services. This overrides the option 'faketime-init-delta' in the configuration file. Default is 0 (use current date/time).

--faketime-auto-delay <delay time>

Number of seconds to wait before incrementing or decrementing fake time by amount of seconds specified with faketime-auto-incr. Setting to '0' disables this option. This overrides the option 'faketime-auto-delay' in the configuration file. Default is 0 (disabled).

--faketime-auto-incr <stepwidth>

Number of seconds by which fake time is incremented or decremented at regular intervals specified by faketime_auto_delay. This option only takes effect if faketime-auto-delay is enabled (not set to '0'). This overrides the option 'faketime-auto-incr' in the configuration file. Default is 3600.

--session <session name>

Session name to use, default is the PID of the parent process.

--pidfile <pid file>

The pid file to use, default is /var/run/inetsim.pid.

EXAMPLES¶

Start the simulation with session name 'simtest5'

        # inetsim --session simtest5

Start the simulation with a one-day-jump to the future after 60 seconds

        # inetsim --faketime-auto-delay 60 --faketime-auto-incr 86400

dito, but with jump to the past

        # inetsim --faketime-auto-delay 60 --faketime-auto-incr -86400

REQUIRES¶

Perl 5, Net::Server, Net::DNS, IO::Socket, IPC::Shareable, Digest::SHA, nfqueue (optional)

AUTHOR¶

Matthias Eckert <me@inetsim.org>, Thomas Hungenberg <th@inetsim.org>