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  removing
       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>