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