.\" Copyright 1995 Peter Tobias <tobias@et-inf.fho-emden.de>
.\" May be distributed under the GNU General Public License
.TH DebianNet 3pm "21 September 1995" "Linux" "Linux Programmer's Manual"
.SH NAME
DebianNet.pm \- create, remove, enable or disable entry
in /etc/inetd.conf

.SH SYNOPSIS
.B require DebianNet;

.B DebianNet::add_service($newentry, $group);

.B DebianNet::remove_service($entry);

.B DebianNet::enable_service($service, $pattern);

.B DebianNet::disable_service($service, $pattern);


.SH DESCRIPTION
You can use the functions in
.B DebianNet.pm
to to add, remove, enable or disable entries in the
.IR /etc/inetd.conf
file. After the
.IR /etc/inetd.conf
file has been changed, a SIGHUP signal will be sent to the
inetd process to make sure that inetd will use the new
.IR /etc/inetd.conf
file. For shell scripts you can also use the
.B update\-inetd
command. See
.BR update\-inetd (8)
for further information.

.SH VARIABLES
.TP
.I $DebianNet::inetdcf = \*(rqFILENAME";
Use FILENAME instead of
.IR /etc/inetd.conf
(e.g. for testing purposes).

.TP
.I $DebianNet::sep = \*(rq#<off>#\ \*(rq;
\*(rq#<off>#\ \*(rq will be used 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.

.TP
.I $DebianNet::verbose = \*(rqtrue";
Explain what is being done.

.SH FUNCTIONS
.TP
.I DebianNet::add_service($newentry, $group);
Add $newentry to the group $group of the
.IR /etc/inetd.conf
file. If the entry already exist it will be enabled (it will also
detect entries with different program options). Using $group
is optional (the default group is the group OTHER).  If the group
does not exist the entry will be placed at the end of the file.

.TP
.I DebianNet::remove_service($entry);
Remove $entry from
.IR /etc/inetd.conf
\&. You can use a regular expression to remove the entry.

.TP
.I DebianNet::enable_service($service, $pattern);
Enable $service (e.g. \*(rqftp") in
.IR /etc/inetd.conf
\&. Using $pattern is optional. It can be used to select a service.
You only need this option if you have two (or more) services of
the same name. An example: you have three ftp entries in the
.IR /etc/inetd.conf
file (all disabled by default) and you want to enable the entry
which uses the wu-ftpd daemon. To do this, use
the pattern \*(rqwu-ftpd" (or any other regular expression that
matches this entry).

.TP
.I DebianNet::disable_service($service, $pattern);
Disable SERVICE (e.g. \*(rqftp") in
.IR /etc/inetd.conf
\&. Using $pattern is optional (see above).


.SH AUTHORS
Peter Tobias, <tobias@et\-inf.fho\-emden.de>
.br
Ian Jackson <iwj10@cus.cam.ac.uk>