xinetd/xinetd.log.man

   1 .\"(c) Copyright 1992 by Panagiotis Tsirigotis
   2 .\"(c) Sections Copyright 1998-2001 by Rob Braun
   3 .\"All rights reserved.  The file named COPYRIGHT specifies the terms
   4 .\"and conditions for redistribution.
   5 .\"
   6 .\" $Id: xinetd.log.man,v 1.3 2003/02/27 22:15:13 steveg Exp $
   7 .TH XINETD.LOG 5 "28 April 1993"
   8 .SH NAME
   9 xinetd.log \- xinetd service log format
  10 .\" *********************** DESCRIPTION ****************************
  11 .SH "DESCRIPTION"
  12 A service configuration may specify various degrees of logging when
  13 attempts are made to access the service. When logging for a service
  14 is enabled,
  15 .B xinetd
  16 will generate one-line log entries which have the following format
  17 (all entries have a timestamp as a prefix):
  18 .sp 1
  19 .RS
  20 \fIentry\fP: \fIservice-id\fP \fIdata\fP
  21 .RE
  22 .LP
  23 The \fIdata\fP depends on the \fIentry\fP.
  24 Possible \fIentry\fP types include:
  25 .RS
  26 .TP 12
  27 .B START
  28 generated when a server is started
  29 .TP
  30 .B EXIT
  31 generated when a server exits
  32 .TP
  33 .B FAIL
  34 generated when it is not possible to start a server
  35 .TP
  36 .B USERID
  37 generated if the \fIUSERID\fP log option is used.
  38 .TP
  39 .B NOID
  40 generated if the
  41 .I USERID
  42 log option is used,
  43 and the
  44 .I IDONLY
  45 service flag is used,
  46 and the remote end does not identify who is trying to access the service.
  47 .RE
  48 .LP
  49 In the following, the information enclosed in brackets appears
  50 if the appropriate log option is used.
  51 .LP
  52 A \fISTART\fP entry has the format:
  53 .sp 1
  54 .RS
  55 START: \fIservice-id\fP [pid=%d] [from=%d.%d.%d.%d]
  56 .RE
  57 .LP
  58 An \fIEXIT\fP entry has the format:
  59 .sp 1
  60 .RS
  61 EXIT: \fIservice-id\fP [\fItype\fP=%d] [pid=%d] [duration=%d(sec)]
  62 .RE
  63 .sp 1
  64 .I type
  65 can be either
  66 .B status
  67 or
  68 .B signal.
  69 The number is either the exit status or the signal that caused process
  70 termination.
  71 .LP
  72 A \fIFAIL\fP entry has the format:
  73 .sp 1
  74 .RS
  75 FAIL: \fIservice-id\fP \fIreason\fP [from=%d.%d.%d.%d]
  76 .RE
  77 .sp 1
  78 Possible \fIreasons\fP are:
  79 .RS
  80 .TP 15
  81 .B fork
  82 a certain number of consecutive fork attempts failed (this number is
  83 a configurable parameter)
  84 .TP
  85 .B time
  86 the time check failed
  87 .TP
  88 .B address
  89 the address check failed
  90 .TP
  91 .B service_limit
  92 the allowed number of server instances for this service would be exceeded
  93 .TP
  94 .B process_limit
  95 a limit on the number of forked processes was specified and it would
  96 be exceeded
  97 .RE
  98 .LP
  99 A \fIDATA\fP entry has the format:
 100 .sp 1
 101 .RS
 102 DATA: \fIservice-id\fP \fIdata\fP
 103 .RE
 104 .sp 1
 105 The \fIdata\fP logged depends on the service.
 106 .RS
 107 .TP 12
 108 .B login
 109 remote_user=%s local_user=%s tty=%s
 110 .TP
 111 .B exec
 112 remote_user=%s verify=\fIstatus\fP command=%s
 113 .br
 114 Possible
 115 .I status
 116 values:
 117 .RS
 118 .TP 10
 119 .I ok
 120 the password was correct
 121 .TP
 122 .I failed
 123 the password was incorrect
 124 .TP
 125 .I baduser
 126 no such user
 127 .RE
 128 .TP
 129 .B shell
 130 remote_user=%s local_user=%s command=%s
 131 .TP
 132 .B finger
 133 \fIreceived string\fP or
 134 .I EMPTY-LINE
 135 .RE
 136 .LP
 137 A \fIUSERID\fP entry has the format:
 138 .sp 1
 139 .RS
 140 USERID: \fIservice-id\fP \fItext\fP
 141 .RE
 142 .sp 1
 143 The \fItext\fP is the response of the identification daemon at the remote end
 144 excluding the port numbers (which are included in the response).
 145 .LP
 146 A \fINOID\fP entry has the format:
 147 .sp 1
 148 .RS
 149 NOID: \fIservice-id\fP \fIIP-address\fP \fIreason\fP
 150 .RE
 151 .\" *********************** SEE ALSO ****************************
 152 .SH "SEE ALSO"
 153 .BR xinetd "(1L), " xinetd.conf (5)