---
name: "inetsim"
section: "1"
platform: "linux"
package: "inetsim"
version: "1.3.2+dfsg.1-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/inetsim"
---

# inetsim(1)

INetSim is a suite for simulating common internet services

## 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\>