update-inetd.8

   1 .\" Copyright 1995 Peter Tobias <tobias@et-inf.fho-emden.de>
   2 .\" May be distributed under the GNU General Public License
   3 .TH update-inetd 8 "21 September 1995" "Linux" "Linux Programmer's Manual"
   4 .SH NAME
   5 update\-inetd \- create, remove, enable or disable entry
   6 in /etc/inetd.conf
   7 .SH SYNOPSIS
   8 .B update\-inetd
   9 [\-\-file FILENAME] [\-\-help] [\-\-version] [\-\-verbose]
  10 [\-\-comment-chars CHARACTERS] [\-\-debug] [\-\-group GROUPNAME] \-\-add ENTRY
  11
  12 .B update\-inetd
  13 [\-\-file FILENAME] [\-\-help] [\-\-version] [\-\-verbose]
  14 [--debug] \-\-remove ENTRY
  15
  16 .B update\-inetd
  17 [\-\-file FILENAME] [\-\-help] [\-\-version] [\-\-verbose]
  18 [\-\-comment-chars CHARACTERS] [\-\-pattern PATTERN] [\-\-multi]
  19 [\-\-debug] \-\-enable SERVICE
  20
  21 .B update\-inetd
  22 [\-\-file FILENAME] [\-\-help] [\-\-version] [\-\-verbose]
  23 [\-\-comment-chars CHARACTERS] [\-\-pattern PATTERN] [\-\-multi]
  24 [\-\-debug] \-\-disable SERVICE
  25
  26 .SH DESCRIPTION
  27 .B update\-inetd
  28 can be used to add, remove, enable or disable
  29 entries in the
  30 .IR /etc/inetd.conf
  31 file (you can specify a different file by using the
  32 .B \-\-file
  33 option).
  34 After the
  35 .IR /etc/inetd.conf
  36 file has been changed,
  37 .B update\-inetd
  38 will send a SIGHUP signal to the inetd process to make sure
  39 that inetd will use the new
  40 .IR /etc/inetd.conf
  41 file. For Perl scripts you can also use the Perl module
  42 .B DebianNet.pm
  43 \&. See
  44 .BR DebianNet (3pm)
  45 for further information.
  46 .B update\-inetd
  47 can also be used to add entries that are commented out by
  48 default. They will be treated like normal entries. That
  49 also means that if you already have an entry that is
  50 commented out you can't add an entry for the same service
  51 without removing the old one first.
  52
  53 update-inetd treats entries that are commented out by a single `#' character
  54 as entries that have been commented out by a user. It won't change such
  55 entries.
  56
  57
  58 .SH OPTIONS
  59 .TP
  60 .I "\-\-version"
  61 Print version information on standard output and
  62 exit successfully.
  63
  64 .TP
  65 .I "\-\-help"
  66 Print a usage message on standard output and exit
  67 successfully.
  68
  69 .TP
  70 .I "\-\-verbose"
  71 Explain what is being done.
  72
  73 .TP
  74 .I "\-\-debug"
  75 Enables debugging mode.
  76
  77 .TP
  78 .I "\-\-file FILENAME"
  79 Use FILENAME instead of
  80 .IR /etc/inetd.conf
  81 \&.
  82
  83 .TP
  84 .I "\-\-group GROUPNAME"
  85 Specify that the new entry should be placed in group
  86 GROUPNAME (e.g. \*(rqMAIL"). If the group does not
  87 exist the entry will be placed at the end of the file.
  88 The default group is \*(rqOTHER".
  89
  90 .TP
  91 .I "\-\-comment-chars CHARACTERS"
  92 update-inetd uses \*(rq#<off>#\ \*(rq as the default comment characters.
  93 You can use this option to specify different comment characters.
  94 This is only necessary if you have to deal with two (or more)
  95 services of the same name.
  96
  97 .TP
  98 .I "\-\-pattern PATTERN"
  99 This option can be used to select a service. You only need this
 100 option if you have two (or more) services of the same name.
 101
 102 .TP
 103 .I "\-\-multi"
 104 If you want to disable/remove more than one entry at a time
 105 you should use this option. If you try to remove more than one
 106 entry at a time without using this option the program will show
 107 a warning and asks the user if he want to continue.
 108
 109 .TP
 110 .I "\-\-add ENTRY"
 111 Add an entry to
 112 .IR /etc/inetd.conf
 113 \&. A description of the ENTRY format can be found in the inetd(8)
 114 or inetd.conf(5) manual pages (or just look at the /etc/services
 115 file). In order to prevent the shell from changing your ENTRY
 116 definition you have to quote the ENTRY using single or double
 117 quotes. You can use tabs (the tab character or \et) and spaces
 118 to separate the fields of the ENTRY. To add the ENTRY to a
 119 specific section in the /etc/inetd.conf file please use the
 120 .B \-\-group
 121 option in addtion to the
 122 .B \-\-add
 123 option.
 124
 125 If you are trying to add an entry which already exists update-inetd
 126 won't add the entry. For uncommented entries it will do nothing
 127 and for entries that are commented out by the comment-chars (see
 128 option
 129 .B \-\-comment\-chars
 130 ) it will enable the existing entry. If you want to completely replace
 131 an entry just remove the entry with the
 132 .B \-\-remove
 133 option first.
 134
 135 .TP
 136 .I "\-\-remove ENTRY"
 137 Remove an entry from
 138 .IR /etc/inetd.conf
 139 \&. You can use a regular expression to remove the entry.
 140
 141 .TP
 142 .I "\-\-enable SERVICE"
 143 Enable SERVICE (e.g. \*(rqftp") in
 144 .IR /etc/inetd.conf
 145 \&. If you want to enable more than one SERVICE you can use a comma
 146 separated list of services (no whitespace characters allowed).
 147
 148 .TP
 149 .I "\-\-disable SERVICE"
 150 Disable SERVICE (e.g. \*(rqftp") in
 151 .IR /etc/inetd.conf
 152 \&. If you want to disable more than one SERVICE you can use a comma
 153 separated list of services (no whitespace characters allowed).
 154 .PP
 155 In order to prevent the shell from changing your ENTRY definition
 156 you have to quote the ENTRY using single or double quotes. You can
 157 use tabs (the tab character or \et) and spaces to separate the fields
 158 of the ENTRY. If you want to enable/disable more than one SERVICE you
 159 can use a comma separated list of services (no whitespace characters
 160 allowed).
 161
 162 .SH EXAMPLES
 163 You've installed ssh (secure encrypting remote shell) and wish
 164 to disable its unencrypted cousins:
 165
 166          update-inetd --comment-chars '#' --disable login,shell,exec,telnet
 167
 168 Using a single '#' character as a comment-char prevents update-inetd
 169 to reenable the services on package upgrades.
 170
 171 You think the clock on your computer is often inaccurate and
 172 wish to make sure other computers cannot read it:
 173
 174          update-inetd --disable time,daytime
 175
 176 You get the clock fixed:
 177
 178          update-inetd --enable time,daytime
 179
 180 You hear a rumor that inetd is easily crashed via a SYN attack
 181 against the time and daytime services, you want to turn off only
 182 their TCP versions, while leaving the analogous UDP services
 183 enabled:
 184
 185          update-inetd --pattern tcp --disable time,daytime
 186
 187 You just finished writing a POP3 server and want to install the
 188 /etc/inetd.conf entry from the makefile:
 189
 190          update-inetd --group MAIL --add \e
 191  'pop-3\et\etstream\ettcp\etnowait\etroot\et/usr/sbin/tcpd\et/usr/sbin/in.pop3d'
 192
 193 .SH FILES
 194 /etc/inetd.conf
 195 /var/run/inetd.pid
 196 .SH SEE ALSO
 197 DebianNet(3pm)
 198 .SH AUTHOR
 199 Peter Tobias, <tobias@et\-inf.fho\-emden.de>
 200