1XINETD(8)                   System Manager's Manual                  XINETD(8)
2
3
4

NAME

6       xinetd - the extended Internet services daemon
7

SYNOPSIS

9       xinetd [options]
10

DESCRIPTION

12       xinetd  performs  the  same  function as inetd: it starts programs that
13       provide Internet services.  Instead of having such servers  started  at
14       system  initialization  time, and be dormant until a connection request
15       arrives, xinetd is the only daemon process started and  it  listens  on
16       all  service  ports  for the services listed in its configuration file.
17       When a request comes in, xinetd starts the appropriate server.  Because
18       of  the  way it operates, xinetd (as well as inetd) is also referred to
19       as a super-server.
20
21       The services listed in xinetd's configuration  file  can  be  separated
22       into two groups.  Services in the first group are called multi-threaded
23       and they require the forking of a new server process for each new  con‐
24       nection  request.   The  new  server then handles that connection.  For
25       such services, xinetd keeps listening for new requests so that  it  can
26       spawn  new  servers.  On the other hand, the second group includes ser‐
27       vices for which the service daemon is responsible for handling all  new
28       connection  requests.   Such  services  are  called single-threaded and
29       xinetd will stop handling new requests for them until the server  dies.
30       Services in this group are usually datagram-based.
31
32       So far, the only reason for the existence of a super-server was to con‐
33       serve system resources by avoiding to fork a  lot  of  processes  which
34       might  be  dormant  for  most of their lifetime.  While fulfilling this
35       function, xinetd takes advantage of the idea of a super-server to  pro‐
36       vide  features such as access control and logging.  Furthermore, xinetd
37       is not limited to services listed in /etc/services.  Therefore, anybody
38       can use xinetd to start special-purpose servers.
39

OPTIONS

41       -d     Enables debug mode. This produces a lot of debugging output, and
42              it makes it possible to use a debugger on xinetd.
43
44       -syslog syslog_facility
45              This option enables syslog logging of  xinetd-produced  messages
46              using  the  specified  syslog  facility.  The following facility
47              names are supported: daemon, auth, user, local[0-7] (check  sys‐
48              log.conf(5)  for their meanings).  This option is ineffective in
49              debug mode since all relevant messages are sent to the terminal.
50
51       -filelog logfile
52              xinetd-produced messages will be placed in the  specified  file.
53              Messages  are always appended to the file.  If the file does not
54              exist, it will be created.  This option is ineffective in  debug
55              mode since all relevant messages are sent to the terminal.
56
57       -f config_file
58              Determines  the  file  that  xinetd  uses for configuration. The
59              default is /etc/xinetd.conf.
60
61       -pidfile pid_file
62              The process ID is written to the file. This option  is  ineffec‐
63              tive in debug mode.
64
65       -dontfork
66              Tells  xinetd  to  stay  in the foreground rather than detaching
67              itself, to support being run  from  init  or  daemontools.  This
68              option automatically sets -stayalive (see below).
69
70       -stayalive
71              Tells xinetd to stay running even if no services are specified.
72
73       -limit proc_limit
74              This option places a limit on the number of concurrently running
75              processes that can be started by xinetd.  Its purpose is to pre‐
76              vent process table overflows.
77
78       -logprocs limit
79              This option places a limit on the number of concurrently running
80              servers for remote userid acquisition.
81
82       -version
83              This option causes xinetd to print out its version information.
84
85       -inetd_compat
86              This option causes xinetd to read /etc/inetd.conf in addition to
87              the standard xinetd config files.  /etc/inetd.conf is read after
88              the standard xinetd config files.
89
90       -cc interval
91              This option instructs xinetd  to  perform  periodic  consistency
92              checks on its internal state every interval seconds.
93
94       The  syslog  and  filelog  options  are mutually exclusive.  If none is
95       specified, the default is syslog using the daemon facility.  You should
96       not  confuse  xinetd messages with messages related to service logging.
97       The latter are logged only if this is specified via  the  configuration
98       file.
99

CONTROLLING XINETD

101       xinetd  performs certain actions when it receives certain signals.  The
102       actions associated with the specific signals can be redefined by  edit‐
103       ing config.h and recompiling.
104
105       SIGHUP         causes  a  hard reconfiguration, which means that xinetd
106                      re-reads  the  configuration  file  and  terminates  the
107                      servers  for  services  that  are  no  longer available.
108                      Access control is performed again on running servers  by
109                      checking  the  remote  location, access times and server
110                      instances. If the number of server instances is lowered,
111                      some  arbitrarily  picked servers will be killed to sat‐
112                      isfy the limit; this will happen after any  servers  are
113                      terminated  because  of  failing  the remote location or
114                      access time checks.  Also, if  the  INTERCEPT  flag  was
115                      clear  and  is set, any running servers for that service
116                      will be terminated; the purpose of  this  is  to  ensure
117                      that  after a hard reconfiguration there will be no run‐
118                      ning servers that can accept packets from addresses that
119                      do not meet the access control criteria.
120
121       SIGQUIT        causes program termination.
122
123       SIGTERM        terminates   all   running  servers  before  terminating
124                      xinetd.
125
126       SIGUSR1        causes an internal state dump (the default dump file  is
127                      /var/run/xinetd.dump;  to change the filename, edit con‐
128                      fig.h and recompile).
129
130       SIGIOT         causes an internal consistency check to verify that  the
131                      data  structures  used by the program have not been cor‐
132                      rupted.  When the check is completed xinetd will  gener‐
133                      ate  a  message that says if the check was successful or
134                      not.
135
136       On reconfiguration the log files are closed and reopened.  This  allows
137       removal of old log files.
138

FILES

140       /etc/xinetd.conf    default configuration file
141       /var/run/xinetd.dump
142                           default dump file
143

SEE ALSO

145       inetd(8),
146
147       xinetd.conf(5),
148
149       xinetd.log(5)
150
151       http://cr.yp.to/daemontools.html
152

AUTHOR

154       Panos Tsirigotis, CS Dept, University of Colorado, Boulder Rob Braun
155

PRONUNCIATION

157       zy-net-d
158
159
160
161
162                                 14 June 2001                        XINETD(8)
Impressum