File: inetsim.en.pod

package info (click to toggle)
inetsim 1.3.1+dfsg.1-1
  • links: PTS, VCS
  • area: main
  • in suites: bullseye, sid
  • size: 1,672 kB
  • sloc: perl: 13,059; sh: 267; makefile: 18; ansic: 13
file content (130 lines) | stat: -rw-r--r-- 3,222 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
=pod


=head1 NAME

B<inetsim> - INetSim is a suite for simulating common internet services


=head1 SYNOPSIS

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


=head1 DESCRIPTION

B<INetSim> simulates common internet services like
I<DNS>, I<HTTP>, I<SMTP> or I<POP3>.


=head1 OPTIONS

=over 4

=item B<--config> <I<configuration file>>

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

=item B<--version>

Output version information.

=item B<--data-dir> <I<data directory>>

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

=item B<--log-dir> <I<log directory>>

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

=item B<--report-dir> <I<report directory>>

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

=item B<--bind-address> <I<IP address>>

The IP address to bind services to.

=item B<--max-childs> <I<maximum child processes>>

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

=item B<--user> <I<username>>

User to run services. Default is 'inetsim'.

=item B<--faketime-init-delta> <I<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).

=item B<--faketime-auto-delay> <I<delay time>>

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

=item B<--faketime-auto-incr> <I<stepwidth>>

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

=item B<--session> <I<session name>>

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

=item B<--pidfile> <I<pid file>>

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

=back


=head1 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


=head1 REQUIRES

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


=head1 AUTHOR

S<Matthias Eckert> E<lt>S<me@inetsim.org>E<gt>, 
S<Thomas Hungenberg> E<lt>S<th@inetsim.org>E<gt>

=cut