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>