home *** CD-ROM | disk | FTP | other *** search
/ Unix System Administration Handbook 1997 October / usah_oct97.iso / news / cnews.tar / doc / log < prev    next >
Text File  |  1992-02-17  |  3KB  |  94 lines
  1. .Ch "Log File Formats in C News"
  2. .Ix logs
  3. .Ix "file formats"
  4. .SH
  5. Introduction
  6. .PP
  7. The two main log files in C news are
  8. .Df log
  9. .Df files log
  10. .Df errlog
  11. .Df files errlog
  12. \fINEWSCTL\fP\fB/log\fR
  13. and
  14. \fINEWSCTL\fP\fB/errlog\fR,
  15. which are the standard output and standard error streams
  16. of
  17. .I relaynews .
  18. .Ix relaynews
  19. .B errlog
  20. should be empty;
  21. if not,
  22. something is seriously wrong,
  23. probably with your configuration or
  24. with unencapsulated news arriving mangled
  25. courtesy of some network.
  26. .SH
  27. Formats
  28. .PP
  29. .B errlog
  30. is a copy of any error messages written on
  31. standard error by
  32. .I relaynews
  33. or its auxiliaries
  34. (including control messages programs).
  35. There are no timestamps
  36. and the contents obey no special format.
  37. A non-empty
  38. .B errlog
  39. is a sign of trouble,
  40. which should be fixed promptly.
  41. .PP
  42. .B log
  43. is written in a stylised format,
  44. with whitespace separating the fields:
  45. date and time, to millisecond resolution though possibly not
  46. to millisecond accuracy;
  47. the machine that sent us this article;
  48. a single-character classification code;
  49. the article's message-id;
  50. and
  51. code-specific information.
  52. For example,
  53. .DS L
  54. .ft B
  55. .ps 8
  56. .vs 10
  57. Jun 30 03:32:18.960 utgpu + <1312@sunset.MATH.UCLA.EDU> mailrus dptcdc me
  58. Jun 30 03:32:19.600 utgpu j <1312@sunset.MATH.UCLA.EDU> junked due to groups `alt.drugs'
  59. Jul  3 18:55:35.492 utstat s <470@lexicon.com> utzoo-real
  60. Jul  3 18:55:35.912 utstat i <8907031824.AA09129@ucbvax.Berkeley.EDU> utzoo-send-ids
  61. Jul  4 06:40:22.395 jarvis.csri.toronto.edu + <0541.AA0541@worsel> utgpu
  62. Jul  4 06:40:22.595 jarvis.csri.toronto.edu + <0549.AA0549@worsel> utgpu
  63. Jul  4 07:00:26.565 jarvis.csri.toronto.edu + <295@lancelot> utgpu
  64. Jul  4 07:17:51.537 utgpu - <8258@saturn.ucsc.edu> duplicate
  65. Jul  4 07:17:51.697 utgpu - <1675@neoucom.UUCP> duplicate
  66. Jul  4 07:17:51.757 utgpu - <89Jul4.043358edt.10369@neat.ai.toronto.edu> duplicate
  67. Jul  4 17:23:28.234 utgpu - <2537@quanta.eng.ohio-state.edu> no subscribed groups in `rec.arts.sf-lovers,rec.arts.startrek,rec.arts.drwho'
  68. Jul  4 19:17:15.785 utgpu - <89Jul4.190330edt.5559@gpu.utcs.utoronto.ca> all groups `list.humanist' excluded in active
  69. .vs
  70. .ps
  71. .ft
  72. .DE
  73. .PP
  74. The classification codes are:
  75. .TS
  76. c | c | c
  77. cfB | lw(2.75i) | l .
  78. code    article disposition    code-specific information
  79. _
  80. \-    rejected    reason for rejection
  81. +    accepted    list of sites to which this article was relayed
  82. j    T{
  83. accepted but filed in the \fIjunk\fR pseudo-newsgroup; preceding line will be \fB+\fR
  84. T}    reason for junking
  85. i    generated in response to an \fIihave\fR control message    list of sites to which this article was relayed
  86. s    generated in response to a \fIsendme\fR control message    list of sites to which this article was relayed
  87. .TE
  88. .PP
  89. Beware that control-message handlers inherit
  90. .I relaynews 's
  91. standard output, so if any of them natters on standard output
  92. (we believe none of ours do), the nattering will appear in
  93. .B log .
  94.