.\" 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 "UPDATE-INETD 1"
.TH UPDATE-INETD 1 "2020-12-24" "perl v5.32.0" "User Contributed Perl Documentation"
.\" 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"
update\-inetd \- create, remove, enable or disable entry /etc/inetd.conf
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
\&\fBupdate-inetd\fR [\fIoption\fR...] \fIcommand\fR \fIargument\fR
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\fBupdate-inetd\fR can be used to add, remove, enable or disable entries in
the \fI/etc/inetd.conf\fR file (you can specify a different file by using the
\&\fB\-\-file\fR option). After the \fI/etc/inetd.conf\fR file has been changed,
\&\fBupdate-inetd\fR will send a \fB\s-1SIGHUP\s0\fR signal to the inetd process to make
sure that inetd will use the new \fI/etc/inetd.conf\fR file. For Perl scripts
you can also use the Perl module \fBDebianNet\fR. See \fBDebianNet\fR(3pm) for
further information. \fBupdate-inetd\fR can also be used to add entries that
are commented out by default. They will be treated like normal entries.
That also means that if you already have an entry that is commented out you
cannot add an entry for the same service without removing the old one first.
.PP
In accordance with the Debian Policy, \fBupdate-inetd\fR treats entries that
are prefixed with a single '\fB#\fR' character as commented out by a user. This
means that for a user to disable a service using \fBupdate-inetd\fR, and for the
service to remain disabled after upgrades, the user must run \fBupdate-inetd\fR
with \fB\-\-comment\-chars '#'\fR (see relevant option below). Conversely, package
maintainer scripts should not override the default comment chars (and when
they do, they must not use '\fB#\fR').
.PP
Also note that \fB\-\-enable\fR and \fB\-\-remove\fR will not be acted upon for service
entries that are commented out using anything but the value specified with
\&\fB\-\-comment\-chars\fR (or the default value if none is specified).
.SH "COMMANDS"
.IX Header "COMMANDS"
.IP "\fB\-\-add\fR \fIentry-line\fR" 4
.IX Item "--add entry-line"
Add an entry to \fI/etc/inetd.conf\fR. A description of the \fIentry-line\fR format
can be found in the \fBinetd\fR(8) or \fBinetd.conf\fR(5) manual pages (or just
look at \fI/etc/inetd.conf\fR). In order to prevent the shell from changing
your \fIentry-line\fR definition you have to quote the \fIentry-line\fR using
single or double quotes. You can use tabs (tab character or \et) and spaces
to separate the fields of the \fIentry-line\fR. To add the \fIentry-line\fR to a
specific section in the \fI/etc/inetd.conf\fR file please use the \fB\-\-group\fR
option.
.Sp
If you are trying to add an entry which already exists, \fBupdate-inetd\fR
will not add the entry. For uncommented entries it will do nothing and
for entries that are commented out by the comment-chars (see option
\&\fB\-\-comment\-chars\fR) it will enable the existing entry. If you want to
completely replace an entry just remove the entry with the \fB\-\-remove\fR
command first.
.IP "\fB\-\-remove\fR \fIentry-regex\fR" 4
.IX Item "--remove entry-regex"
Remove an entry-line matching \fIentry-regex\fR (e.g. "\fItelnet\fR") from
\&\fI/etc/inetd.conf\fR. The \fIentry-regex\fR will be anchored at the beginning
of the entry line.
.IP "\fB\-\-enable\fR \fIservice\fR[,...]" 4
.IX Item "--enable service[,...]"
Enable \fIservice\fR (e.g. "\fIftp\fR") in \fI/etc/inetd.conf\fR. If you want to
enable more than one \fIservice\fR you can use a comma-separated list of
services (no whitespace characters allowed).
.IP "\fB\-\-disable\fR \fIservice\fR[,...]" 4
.IX Item "--disable service[,...]"
Disable \fIservice\fR (e.g. "\fIftp\fR") in \fI/etc/inetd.conf\fR. If you want to
disable more than one \fIservice\fR you can use a comma-separated list of
services (no whitespace characters allowed).
.SH "OPTIONS"
.IX Header "OPTIONS"
.IP "\fB\-\-group\fR \fIgroupname\fR" 4
.IX Item "--group groupname"
Specify that the new entry should be placed in group \fIgroupname\fR
(e.g. "\fI\s-1MAIL\s0\fR\*(L"). If the group does not exist the entry will be placed
at the end of the file. The default group is \*(R"\fB\s-1OTHER\s0\fR".
.Sp
This option is only relevant with the \fB\-\-add\fR command.
.IP "\fB\-\-pattern\fR \fIpattern\fR" 4
.IX Item "--pattern pattern"
This option can be used to select a service. You only need this option if
you have two (or more) services of the same name.
.Sp
This option is not relevant with the \fB\-\-add\fR command.
.IP "\fB\-\-comment\-chars\fR \fIcharacters\fR" 4
.IX Item "--comment-chars characters"
\&\fBupdate-inetd\fR uses "\fB#<off># \fR" as the default comment characters.
You can use this option to specify different comment characters. This is only
necessary if you have to deal with two (or more) services of the same name.
If you do use this option, it is your responsibility to eventually remove
the commented out entry.
.IP "\fB\-\-multi\fR" 4
.IX Item "--multi"
If you want to disable/remove more than one entry at a time you should use
this option. If you try to remove more than one entry at a time without
using this option the program will show a warning and prompt the user for
an explicit confirmation.
.IP "\fB\-\-file\fR \fIfilename\fR" 4
.IX Item "--file filename"
Use \fIfilename\fR instead of \fI/etc/inetd.conf\fR.
.IP "\fB\-\-verbose\fR" 4
.IX Item "--verbose"
Explain what is being done.
.IP "\fB\-\-debug\fR" 4
.IX Item "--debug"
Enables debugging mode.
.IP "\fB\-\-help\fR" 4
.IX Item "--help"
Print a usage message on standard output and exit successfully.
.IP "\fB\-\-version\fR" 4
.IX Item "--version"
Print version information on standard output and exit successfully.
.SH "EXAMPLES"
.IX Header "EXAMPLES"
You have installed ssh (secure encrypting remote shell) and wish to
disable its unencrypted cousins:
.PP
.Vb 1
\&  update\-inetd \-\-comment\-chars \*(Aq#\*(Aq \-\-disable login,shell,exec,telnet
.Ve
.PP
Using a single '\fB#\fR' character as a comment-char prevents \fBupdate-inetd\fR
to re-enable the services on package upgrades.
.PP
You think the clock on your computer is often inaccurate and wish to make
sure other computers cannot read it:
.PP
.Vb 1
\&  update\-inetd \-\-comment\-chars \*(Aq#\*(Aq \-\-disable time,daytime
.Ve
.PP
You get the clock fixed:
.PP
.Vb 1
\&  update\-inetd \-\-enable time,daytime
.Ve
.PP
You hear a rumor that inetd is easily crashed via a \s-1SYN\s0 attack against
the time and daytime services, you want to turn off only their \s-1TCP\s0
versions, while leaving the analogous \s-1UDP\s0 services enabled:
.PP
.Vb 1
\&  update\-inetd \-\-comment\-chars \*(Aq#\*(Aq \-\-pattern tcp \-\-disable time,daytime
.Ve
.PP
You just finished writing a \s-1POP3\s0 server and want to install the
\&\fI/etc/inetd.conf\fR entry from the Makefile:
.PP
.Vb 2
\&  update\-inetd \-\-group MAIL \-\-add \e
\&    \*(Aqpop\-3\et\etstream\ettcp\etnowait\etroot\et/usr/sbin/tcpd\et/usr/sbin/in.pop3d\*(Aq
.Ve
.SH "FILES"
.IX Header "FILES"
\&\fI/etc/inetd.conf\fR
\&\fI/var/run/inetd.pid\fR
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBinetd\fR(8),
\&\fBDebianNet\fR(3pm)