bionic (3) DebianNet.3pm.gz

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>