tag 123929 - patch thanks Hi Andre,
Rather belatedly, I'd like to say thanks for submitting a translation of the update-inetd manpage. (Just don't shoot me for taking so long to get a reply: I only took over the package now ;) In the unlikely case that your email remains the same, I'd like to point out that the manpage has had some important changes, and kindly request that you consider updating your patch. Do note however that the manpage is likely to be updated again within a few months, as update-inetd will undergo a rewrite. Anyhow, the new version of the manpage is in the 4.32 release of the update-inetd package (update-inetd has been spinned off netbase, since you submitted your translation), and can also be retrieved from [0] For your conveniencee, I'm attaching a diff between the version of the manpage you translated and the current one. Cheers, Serafeim [0] http://git.debian.org/?p=collab-maint/update-inetd.git;a=blob_plain;f=update-inetd.8;hb=558ca123fbd85d61aff28496296abc15247662a8 -- debtags-organised WNPP bugs: http://members.hellug.gr/serzan/wnpp
diff --git a/update-inetd.8 b/update-inetd.8 index c81db29..6292db4 100644 --- a/update-inetd.8 +++ b/update-inetd.8 @@ -1,6 +1,6 @@ .\" Copyright 1995 Peter Tobias <tob...@et-inf.fho-emden.de> .\" May be distributed under the GNU General Public License -.TH update-inetd 8 "21 September 1995" "Linux" "Linux Programmer's Manual" +.TH update-inetd 8 "27 August 2009" "Linux" "Linux Programmer's Manual" .SH NAME update\-inetd \- create, remove, enable or disable entry in /etc/inetd.conf @@ -11,7 +11,7 @@ in /etc/inetd.conf .B update\-inetd [\-\-file FILENAME] [\-\-help] [\-\-version] [\-\-verbose] -[--debug] \-\-remove ENTRY +[\-\-debug] \-\-remove ENTRY .B update\-inetd [\-\-file FILENAME] [\-\-help] [\-\-version] [\-\-verbose] @@ -50,9 +50,17 @@ also means that if you already have an entry that is commented out you can't add an entry for the same service without removing the old one first. -update-inetd treats entries that are commented out by a single `#' character -as entries that have been commented out by a user. It won't change such -entries. +In accordance with the Debian Policy, update-inetd treats entries that are +prefixed with a single `#' character as commented out by a user. This means +that for a user to disable a service using update-inetd, and for the service +to remain disabled after upgrades, the user must run update-inetd with +\-\-comment-chars '#' (see relevant option below). Conversely, package +maintainer scripts should not override the default comment chars (and when +they do, they must not use '#'). + +Also note that \-\-enable and \-\-remove will not be acted upon for service +entries that are commented out using anything but the value specified with +\-\-comment-chars (or the default value if none is specified). .SH OPTIONS @@ -92,7 +100,8 @@ The default group is \*(rqOTHER". update-inetd uses \*(rq#<off>#\ \*(rq 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. +services of the same name. If you do use this option, it is your +responsibility to eventually remove the commented out entry. .TP .I "\-\-pattern PATTERN" @@ -104,15 +113,15 @@ option if you have two (or more) services of the same name. 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 asks the user if he want to continue. +a warning and prompt the user for an explicit confirmation. .TP .I "\-\-add ENTRY" Add an entry to .IR /etc/inetd.conf \&. A description of the ENTRY format can be found in the inetd(8) -or inetd.conf(5) manual pages (or just look at the /etc/services -file). In order to prevent the shell from changing your ENTRY +or inetd.conf(5) manual pages (or just look at /etc/inetd.conf). +In order to prevent the shell from changing your ENTRY definition you have to quote the ENTRY using single or double quotes. You can use tabs (the tab character or \et) and spaces to separate the fields of the ENTRY. To add the ENTRY to a @@ -163,32 +172,32 @@ allowed). You've installed ssh (secure encrypting remote shell) and wish to disable its unencrypted cousins: - update-inetd --comment-chars '#' --disable login,shell,exec,telnet + update\-inetd \-\-comment\-chars '#' \-\-disable login,shell,exec,telnet -Using a single '#' character as a comment-char prevents update-inetd +Using a single '#' character as a comment\-char prevents update\-inetd to reenable the services on package upgrades. You think the clock on your computer is often inaccurate and wish to make sure other computers cannot read it: - update-inetd --disable time,daytime + update\-inetd \-\-comment\-chars '#' \-\-disable time,daytime You get the clock fixed: - update-inetd --enable time,daytime + update\-inetd \-\-enable time,daytime You hear a rumor that inetd is easily crashed via a SYN attack against the time and daytime services, you want to turn off only their TCP versions, while leaving the analogous UDP services enabled: - update-inetd --pattern tcp --disable time,daytime + update\-inetd \-\-comment\-chars '#' \-\-pattern tcp \-\-disable time,daytime You just finished writing a POP3 server and want to install the /etc/inetd.conf entry from the makefile: - update-inetd --group MAIL --add \e - 'pop-3\et\etstream\ettcp\etnowait\etroot\et/usr/sbin/tcpd\et/usr/sbin/in.pop3d' + update\-inetd \-\-group MAIL \-\-add \e +\&'pop\-3\et\etstream\ettcp\etnowait\etroot\et/usr/sbin/tcpd\et/usr/sbin/in.pop3d' .SH FILES /etc/inetd.conf
