source: server/other/xinetd.xml@ 518538f

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;

<!ENTITY xinetd-download-http "http://www.xinetd.org/xinetd-&xinetd-version;.tar.gz">
<!ENTITY xinetd-download-ftp " ">
<!ENTITY xinetd-size "291 KB">
<!ENTITY xinetd-buildsize "3.91 MB">
<!ENTITY xinetd-time "0.09 SBU">

]>

<sect1 id="xinetd" xreflabel="xinetd-&xinetd-version;">
<sect1info>
<othername>$LastChangedBy$</othername>
<date>$Date$</date>
</sect1info>
<?dbhtml filename="xinetd.html"?>
<title>xinetd-&xinetd-version;</title>

<sect2>
<title>Introduction to <application>xinetd</application></title>

<para><application>xinetd</application> is the eXtended InterNET services 
Daemon, a secure replacement for <command>inetd</command>.</para>

<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink url="&xinetd-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink url="&xinetd-download-ftp;"/></para></listitem>
<listitem><para>Download size: &xinetd-size;</para></listitem>
<listitem><para>Estimated disk space required: &xinetd-buildsize;</para></listitem>
<listitem><para>Estimated build time: &xinetd-time;</para></listitem></itemizedlist>
</sect3>

<sect3><title><application>xinetd</application> dependencies</title>
<sect4><title>Optional</title>
<para><xref linkend="tcpwrappers"/></para></sect4>
</sect3>

</sect2>

<sect2>
<title>Installation of <application>xinetd</application></title>

<para>Install <application>xinetd</application> by running the following 
commands:</para>

<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
make &amp;&amp;
make install</command></userinput></screen>

</sect2>

<sect2>
<title>Configuring <application>xinetd</application></title>

<sect3><title>Config files</title>
<para><filename>/etc/xinetd.conf</filename></para>
</sect3>

<sect3><title>Configuration Information</title>

<para>Ensure the path to all daemons is 
<filename class="directory">/usr/sbin</filename>, rather than the default path 
of <filename class="directory">/usr/etc</filename>, and install the 
<application>xinetd</application> configuration file by running the following
command:</para>

<screen><userinput><command>sed -e 's/etc/sbin/g' xinetd/sample.conf &gt; /etc/xinetd.conf</command>
</userinput></screen>

<para>The format of the <filename>/etc/xinetd.conf</filename> is
documented in the xinetd.conf man page. Further information can be
found at <ulink url="http://www.xinetd.org"/>.</para>

<para>Install the <filename>/etc/rc.d/init.d/xinetd</filename>
init script included in the <xref linkend="intro-important-bootscripts"/> 
package.</para>

<screen><userinput><command>make install-xinetd</command></userinput></screen>

<para>Now, use the new boot script to start <command>xinetd</command>: </para>

<screen><userinput><command>/etc/rc.d/init.d/xinetd start</command></userinput></screen>

<para>Checking the <filename>/var/log/daemon.log</filename> file
should prove quite entertaining. This file may contain entries
similar to the following:</para>

<screen><userinput>Aug 22 21:40:21 dps10 xinetd[2696]: Server /usr/sbin/in.rlogind is not 
executable [line=29]
Aug 22 21:40:21 dps10 xinetd[2696]: Error parsing attribute server -
DISABLING SERVICE [line=29]
Aug 22 21:40:21 dps10 xinetd[2696]: Server /usr/sbin/in.rshd is not
executable [line=42]</userinput></screen>

<para>These errors are because most of the servers <command>xinetd</command> 
is trying to control are not installed yet.</para>

</sect3>

</sect2>

<sect2>
<title>Contents</title>

<para>The <application>xinetd</application> package contains
<command>xinetd</command>,
<command>itox</command> and
<command>xconv.pl</command>.</para></sect2>

<sect2><title>Description</title>

<sect3><title>xinetd</title>
<para><command>xinetd</command> is the Internet services daemon.</para></sect3>

<sect3><title>itox</title>
<para><command>itox</command> is a utility used for converting
<filename>inetd.conf</filename> files to
<filename>xinetd.conf</filename> format.</para></sect3>

<sect3><title>xconv.pl</title>
<para><command>xconv.pl</command> is a <application>Perl</application> script 
used for converting <filename>inetd.conf</filename> files to 
<filename>xinetd.conf</filename> format, similar to 
<command>itox</command>.</para></sect3>

</sect2>

</sect1>