DebianNet(3pm)						     Linux Programmer's Manual						    DebianNet(3pm)

NAME

       DebianNet.pm - create, remove, enable or disable entry in /etc/inetd.conf

SYNOPSIS

       require DebianNet;

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

       DebianNet::remove_service($entry);

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

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

DESCRIPTION

       You  can  use  the  functions  in  DebianNet.pm	to  to	add,  remove,  enable  or  disable  entries in the /etc/inetd.conf file. After the
       /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
       /etc/inetd.conf	file.  The  functions  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 can't add an entry for the same service without remov-
       ing the old one first.

       The  DebianNet  functions treat 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.

	For shell scripts you can also use the update-inetd command. See update-inetd(8) for further information.

VARIABLES

       $DebianNet::inetdcf = "FILENAME";
	      Use FILENAME instead of /etc/inetd.conf (e.g. for testing purposes).

       $DebianNet::sep = "#<off># ";
	      "#<off># " 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.

       $DebianNet::multi = "true";
	      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.

       $DebianNet::verbose = "true";
	      Explain what is being done.

FUNCTIONS

       DebianNet::add_service($newentry, $group);
	      Add $newentry to the group $group of the /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.

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

       DebianNet::enable_service($service, $pattern);
	      Enable $service (e.g. "ftp") in /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 /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 "wu-ftpd"  (or
	      any other regular expression that matches this entry).

       DebianNet::disable_service($service, $pattern);
	      Disable SERVICE (e.g. "ftp") in /etc/inetd.conf . Using $pattern is optional (see above).

AUTHORS

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

Linux								 21 September 1995						    DebianNet(3pm)