.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.40)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "inetsim.conf 5"
.TH inetsim.conf 5 "2021-02-02" "perl v5.32.0" " "
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
inetsim.conf \- Configuration file for INetSim
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\fIinetsim.conf\fR is the configuration file for \fBinetsim\fR(1).
.PP
The format of \fIinetsim.conf\fR is simple: one option per line, with blank
lines and lines starting with # ignored.
.SH "GLOBAL OPTIONS"
.IX Header "GLOBAL OPTIONS"
.IP "\fIstart_service \s-1SERVICE\s0\fR" 4
.IX Item "start_service SERVICE"
Start service \s-1SERVICE.\s0
.IP "\fIservice_bind_address \s-1ADDRESS\s0\fR" 4
.IX Item "service_bind_address ADDRESS"
The \s-1IP\s0 address to bind services to.
.IP "\fIservice_run_as_user \s-1USER\s0\fR" 4
.IX Item "service_run_as_user USER"
User to run services.
.IP "\fIservice_max_childs \s-1NUMBER\s0\fR" 4
.IX Item "service_max_childs NUMBER"
Maximum number of child processes (number of parallel
connections) for each service.
.IP "\fIservice_timeout \s-1SECONDS\s0\fR" 4
.IX Item "service_timeout SECONDS"
Timeout in seconds after which a connection is closed
by the service.
.IP "\fI[servicename]_bind_port \s-1PORT\s0\fR" 4
.IX Item "[servicename]_bind_port PORT"
\&\s-1PORT\s0 number to bind service to.
.IP "\fIcreate_reports [YES|NO]\fR" 4
.IX Item "create_reports [YES|NO]"
Create report with a summary of connections for the session on shutdown.
.IP "\fIreport_language \s-1LANGUAGE\s0\fR" 4
.IX Item "report_language LANGUAGE"
Set language for reports.
.IP "\fIinclude \s-1FILENAME\s0\fR" 4
.IX Item "include FILENAME"
Include additional file in configuration.
Allowed only in main configuration file.
.SH "FAKETIME OPTIONS"
.IX Header "FAKETIME OPTIONS"
.IP "\fIfaketime_init_delta \s-1SECONDS\s0\fR" 4
.IX Item "faketime_init_delta SECONDS"
Initial number of seconds (positive or negative) relative to current
date/time for fake time used by all services. If set to '0', current
date/time is used.
.IP "\fIfaketime_auto_delay \s-1SECONDS\s0\fR" 4
.IX Item "faketime_auto_delay SECONDS"
Number of seconds to wait before incrementing/decrementing fake time
by amount of seconds specified with \fBfaketime_auto_increment\fR.
Setting to '0' disables this option.
.IP "\fIfaketime_auto_increment \s-1SECONDS\s0\fR" 4
.IX Item "faketime_auto_increment SECONDS"
Number of seconds by which fake time is incremented/decremented at regular
intervals specified by \fBfaketime_auto_delay\fR.
This option only takes effect if \fBfaketime_auto_delay\fR is enabled (not set
to '0').
.SH "ADDITIONAL DNS OPTIONS"
.IX Header "ADDITIONAL DNS OPTIONS"
.IP "\fIdns_default_ip IP-ADDRESS\fR" 4
.IX Item "dns_default_ip IP-ADDRESS"
Default \s-1IP\s0 address to return in \s-1DNS\s0 replies.
.IP "\fIdns_default_hostname \s-1HOSTNAME\s0\fR" 4
.IX Item "dns_default_hostname HOSTNAME"
Default hostname to return in \s-1DNS\s0 replies.
.IP "\fIdns_default_domainname \s-1DOMAINNAME\s0\fR" 4
.IX Item "dns_default_domainname DOMAINNAME"
Default domainname to return in \s-1DNS\s0 replies.
.IP "\fIdns_static \s-1FQDN_HOSTNAME\s0 IP-ADDRESS\fR" 4
.IX Item "dns_static FQDN_HOSTNAME IP-ADDRESS"
Static mapping for \s-1DNS.\s0
.IP "\fIdns_version \s-1STRING\s0\fR" 4
.IX Item "dns_version STRING"
Version string to return.
.SH "ADDITIONAL HTTP(S) OPTIONS"
.IX Header "ADDITIONAL HTTP(S) OPTIONS"
.IP "\fIhttp(s)_version\fR" 4
.IX Item "http(s)_version"
Version string to return in \s-1HTTP\s0(S) replies.
.IP "\fIhttp(s)_post_limit \s-1NUMBER\s0\fR" 4
.IX Item "http(s)_post_limit NUMBER"
Size limit for \s-1POST\s0 requests in bytes.
.IP "\fIhttp(s)_fakemode [YES|NO]\fR" 4
.IX Item "http(s)_fakemode [YES|NO]"
Turn \s-1HTTP\s0(S) fake mode on or off.
.IP "\fIhttp(s)_fakefile \s-1EXTENSION FILENAME MIMETYPE\s0\fR" 4
.IX Item "http(s)_fakefile EXTENSION FILENAME MIMETYPE"
The fake files returned in fake mode based on the file extension in the \s-1HTTP\s0(S) request.
.IP "\fIhttp(s)_default_fakefile \s-1FILENAME MIMETYPE\s0\fR" 4
.IX Item "http(s)_default_fakefile FILENAME MIMETYPE"
The default fake file and \s-1MIME\s0 type returned in fake mode if the file extension in the
\&\s-1HTTP\s0(S) request does not match any of the extensions defined with \fBhttp(s)_fakefile\fR.
.IP "\fIhttp(s)_static_fakefile \s-1PATH FILENAME MIMETYPE\s0\fR" 4
.IX Item "http(s)_static_fakefile PATH FILENAME MIMETYPE"
The fake files returned in fake mode based on the path in the \s-1HTTP\s0(S) request.
.SH "ADDITIONAL SMTP(S) OPTIONS"
.IX Header "ADDITIONAL SMTP(S) OPTIONS"
.IP "\fIsmtp(s)_banner \s-1STRING\s0\fR" 4
.IX Item "smtp(s)_banner STRING"
The banner string used in \s-1SMTP\s0 greeting message.
.IP "\fIsmtp(s)_fqdn_hostname \s-1FQDN_HOST\s0\fR" 4
.IX Item "smtp(s)_fqdn_hostname FQDN_HOST"
The \s-1FQDN\s0 hostname used for \s-1SMTP.\s0
.IP "\fIsmtp(s)_helo_required [YES|NO]\fR" 4
.IX Item "smtp(s)_helo_required [YES|NO]"
Client has to send \s-1HELO/EHLO\s0 before any other command.
.IP "\fIsmtp(s)_extended_smtp\fR" 4
.IX Item "smtp(s)_extended_smtp"
Turn support for 'Extended \s-1SMTP\s0' (\s-1ESMTP\s0) on or off.
.IP "\fIsmtp(s)_service_extension \s-1EXTENSION\s0 [\s-1PARAMETER\s0(S)]\fR" 4
.IX Item "smtp(s)_service_extension EXTENSION [PARAMETER(S)]"
\&\s-1SMTP\s0 service extensions offered to client.
.IP "\fIsmtp(s)_auth_reversibleonly [YES|NO]\fR" 4
.IX Item "smtp(s)_auth_reversibleonly [YES|NO]"
Only offer authentication mechanisms which allow reversing the authentication information
sent by a client to clear text username/password.
.IP "\fIsmtp(s)_auth_required [YES|NO]\fR" 4
.IX Item "smtp(s)_auth_required [YES|NO]"
Force the client to authenticate.
.SH "ADDITIONAL POP3(S) OPTIONS"
.IX Header "ADDITIONAL POP3(S) OPTIONS"
.IP "\fIpop3(s)_banner \s-1STRING\s0\fR" 4
.IX Item "pop3(s)_banner STRING"
The banner string used in \s-1POP3\s0 greeting message.
.IP "\fIpop3(s)_hostname \s-1HOST\s0\fR" 4
.IX Item "pop3(s)_hostname HOST"
The hostname used in \s-1POP3\s0 greeting message.
.IP "\fIpop3(s)_mbox_maxmails \s-1NUMBER\s0\fR" 4
.IX Item "pop3(s)_mbox_maxmails NUMBER"
Maximum number of e\-mails to select from supplied mbox files for creation of random \s-1POP3\s0 mailbox.
.IP "\fIpop3(s)_mbox_reread \s-1NUMBER\s0\fR" 4
.IX Item "pop3(s)_mbox_reread NUMBER"
Re-read supplied mbox files if \s-1POP3\s0 service was inactive for <\s-1NUMBER\s0> seconds.
.IP "\fIpop3(s)_mbox_rebuild \s-1NUMBER\s0\fR" 4
.IX Item "pop3(s)_mbox_rebuild NUMBER"
Rebuild random \s-1POP3\s0 mailbox if \s-1POP3\s0 service was inactive for <\s-1NUMBER\s0> seconds.
.IP "\fIpop3(s)_auth_reversibleonly [YES|NO]\fR" 4
.IX Item "pop3(s)_auth_reversibleonly [YES|NO]"
Only offer authentication mechanisms which allow reversing the authentication information
sent by a client to clear text username/password.
.IP "\fIpop3(s)_enable_apop [YES|NO]\fR" 4
.IX Item "pop3(s)_enable_apop [YES|NO]"
Turn \s-1APOP\s0 on or off.
.IP "\fIpop3(s)_enable_capabilities [YES|NO]\fR" 4
.IX Item "pop3(s)_enable_capabilities [YES|NO]"
Turn support for pop3 capabilities on or off.
.IP "\fIpop3(s)_capability \s-1CAPABILITY\s0 [\s-1PARAMETER\s0(S)]\fR" 4
.IX Item "pop3(s)_capability CAPABILITY [PARAMETER(S)]"
\&\s-1POP3\s0 capabilities offered to client.
.SH "ADDITIONAL FTP(S) OPTIONS"
.IX Header "ADDITIONAL FTP(S) OPTIONS"
.IP "\fIftp(s)_banner \s-1STRING\s0\fR" 4
.IX Item "ftp(s)_banner STRING"
The banner string used in \s-1FTP\s0 greeting message.
.IP "\fIftp(s)_version \s-1STRING\s0\fR" 4
.IX Item "ftp(s)_version STRING"
Version string to return in replies to the \s-1STAT\s0 command.
.IP "\fIftp(s)_recursive_delete [YES|NO]\fR" 4
.IX Item "ftp(s)_recursive_delete [YES|NO]"
Allow recursive deletion of directories, even if they are not empty.
.IP "\fIftp(s)_max_filesize \s-1NUMBER\s0\fR" 4
.IX Item "ftp(s)_max_filesize NUMBER"
Size limit for uploaded files in bytes.
.SH "ADDITIONAL TFTP OPTIONS"
.IX Header "ADDITIONAL TFTP OPTIONS"
.IP "\fItftp_allow_overwrite [YES|NO]\fR" 4
.IX Item "tftp_allow_overwrite [YES|NO]"
Allow overwriting of existing files.
.IP "\fItftp_max_filesize \s-1NUMBER\s0\fR" 4
.IX Item "tftp_max_filesize NUMBER"
Size limit for uploaded files in bytes.
.IP "\fItftp_enable_options [YES|NO]\fR" 4
.IX Item "tftp_enable_options [YES|NO]"
Turn support for tftp options on or off.
.IP "\fItftp_option \s-1OPTION PARAMETER\s0(S)\fR" 4
.IX Item "tftp_option OPTION PARAMETER(S)"
\&\s-1TFTP\s0 options offered to client.
.SH "ADDITIONAL NTP OPTIONS"
.IX Header "ADDITIONAL NTP OPTIONS"
.IP "\fIntp_server_ip IP-ADDRESS\fR" 4
.IX Item "ntp_server_ip IP-ADDRESS"
The \s-1IP\s0 address to return in \s-1NTP\s0 replies.
.IP "\fIntp_strict_checks [YES|NO]\fR" 4
.IX Item "ntp_strict_checks [YES|NO]"
Turn strict checks for client packets on or off.
.SH "ADDITIONAL IRC OPTIONS"
.IX Header "ADDITIONAL IRC OPTIONS"
.IP "\fIirc_fqdn_hostname \s-1FQDN_HOST\s0\fR" 4
.IX Item "irc_fqdn_hostname FQDN_HOST"
The \s-1FQDN\s0 hostname used for \s-1IRC.\s0
.IP "\fIirc_version \s-1STRING\s0\fR" 4
.IX Item "irc_version STRING"
Version string to return.
.SH "ADDITIONAL DUMMY OPTIONS"
.IX Header "ADDITIONAL DUMMY OPTIONS"
.IP "\fIdummy_banner \s-1STRING\s0\fR" 4
.IX Item "dummy_banner STRING"
Banner string sent to client if no data has been received for
\&\fBdummy_banner_wait\fR seconds since the client has established
the connection. If set to an empty string (""), only \s-1CRLF\s0 will
be sent. This option only takes effect if \fBdummy_banner_wait\fR
is not set to '0'.
.IP "\fIdummy_banner_wait \s-1NUMBER\s0\fR" 4
.IX Item "dummy_banner_wait NUMBER"
Number of seconds to wait for client sending any data after
establishing a new connection. If no data has been received
within this amount of time, \fBdummy_banner\fR will be sent to
the client. Setting to '0' disables sending of a banner string.
.SH "REDIRECT OPTIONS"
.IX Header "REDIRECT OPTIONS"
.IP "\fIredirect_enabled [YES|NO]\fR" 4
.IX Item "redirect_enabled [YES|NO]"
Turn connection redirection on or off.
.IP "\fIredirect_unknown_services [YES|NO]\fR" 4
.IX Item "redirect_unknown_services [YES|NO]"
Redirect connection attempts to unbound ports to dummy service.
.IP "\fIredirect_external_address IP-ADDRESS\fR" 4
.IX Item "redirect_external_address IP-ADDRESS"
\&\s-1IP\s0 address used as source address if \fBINetSim\fR acts as a router for redirecting packets to external
networks.
This option only takes effect if static rules for redirecting packets to external networks are
defined (see \fBredirect_static_rule\fR).
.IP "\fIredirect_static_rule \s-1PROTOCOL IP\-ADDRESS:PORT IP\-ADDRESS:PORT\s0\fR" 4
.IX Item "redirect_static_rule PROTOCOL IP-ADDRESS:PORT IP-ADDRESS:PORT"
Static mappings for connection redirection.
.IP "\fIredirect_change_ttl [YES|NO]\fR" 4
.IX Item "redirect_change_ttl [YES|NO]"
Change the time-to-live header field to a random value in outgoing \s-1IP\s0 packets.
.IP "\fIredirect_exclude_port \s-1PROTOCOL:PORT\s0\fR" 4
.IX Item "redirect_exclude_port PROTOCOL:PORT"
Connections to <service_bind_address> on this port
are not redirected.
.IP "\fIredirect_ignore_bootp [YES|NO]\fR" 4
.IX Item "redirect_ignore_bootp [YES|NO]"
If set to 'yes', \s-1BOOTP\s0 (\s-1DHCP\s0) broadcasts will not be redirected (\s-1UDP\s0 packets with source
address 0.0.0.0, port 68 and destination address 255.255.255.255, port 67 or vice versa).
.IP "\fIredirect_ignore_netbios [YES|NO]\fR" 4
.IX Item "redirect_ignore_netbios [YES|NO]"
If set to 'yes', NetBIOS broadcasts will not be redirected (\s-1UDP\s0 packets with
source/destination port 137/138 and destination address x.x.x.255 on the local network).
.IP "\fIredirect_icmp_timestamp [MS|SEC|NO]\fR" 4
.IX Item "redirect_icmp_timestamp [MS|SEC|NO]"
If set to 'ms', \s-1ICMP\s0 Timestamp requests will be answered with number of milliseconds since midnight \s-1UTC\s0 according to faketime.
If set to 'sec', \s-1ICMP\s0 Timestamp requests will be answered with number of seconds since epoch (high order bit of the timestamp will be set to indicate non-standard value).
Setting to 'no' disables manipulation of \s-1ICMP\s0 Timestamp requests.
.SH "SSL OPTIONS"
.IX Header "SSL OPTIONS"
.IP "\fI[servicename]_ssl_keyfile \s-1FILENAME\s0\fR" 4
.IX Item "[servicename]_ssl_keyfile FILENAME"
Name of the \s-1SSL\s0 private key \s-1PEM\s0 file. The key \s-1MUST NOT\s0 be encrypted!
.IP "\fI[servicename]_ssl_certfile \s-1FILENAME\s0\fR" 4
.IX Item "[servicename]_ssl_certfile FILENAME"
Name of the \s-1SSL\s0 certificate file.
.IP "\fI[servicename]_ssl_dhfile \s-1FILENAME\s0\fR" 4
.IX Item "[servicename]_ssl_dhfile FILENAME"
Name of the Diffie-Hellman parameter \s-1PEM\s0 file.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
.RS 4
\&\fBinetsim\fR(1)
.RE
.SH "AUTHOR"
.IX Header "AUTHOR"
Matthias\ Eckert <me@inetsim.org>, 
Thomas\ Hungenberg <th@inetsim.org>