home *** CD-ROM | disk | FTP | other *** search
/ Unix System Administration Handbook 1997 October / usah_oct97.iso / news / cnews.tar / doc / dirs < prev    next >
Text File  |  1992-02-16  |  3KB  |  102 lines
  1. .Ch "Directory Layout and PATH in C News"
  2. .Ix directories
  3. .Ix PATH
  4. .Ix /usr/lib/news
  5. .Ix /usr/lib/newsbin
  6. .Ix /usr/spool/news
  7. .SH
  8. Intro
  9. .LP
  10. C News
  11. is constrained by historical compatibility with
  12. B News,
  13. but we also want to provide more flexibility for local news administrators.
  14. Accordingly, our directory organization is a little different from that
  15. of B News.
  16. We also make a lot of use of subordinate programs rather than lumping
  17. everything into a few giant lumps,
  18. and this means we need a notion of
  19. search paths.
  20. .LP
  21. See also ``Configuration Mechanisms in C News'',
  22. which talks about how
  23. to alter the defaults for these paths and such.
  24. .SH
  25. Directory organization
  26. .LP
  27. We retain the notion that a single directory
  28. (usually /usr/spool/news)
  29. is the top of the news-article database.
  30. We also use subdirectories of this directory,
  31. using names including `.' to
  32. ensure that they cannot collide with newsgroup names,
  33. to hold incoming batches and outgoing batch control files.
  34. One can debate whether this is the right place for these activities,
  35. but in practice
  36. /usr/spool/news
  37. tends to be where people want to put
  38. potentially-big traffic-handling directories,
  39. and it's not worth providing for separate variation of the location.
  40. .LP
  41. We do split the former
  42. /usr/lib/news
  43. into two,
  44. however.
  45. We reserve
  46. /usr/lib/news
  47. itself for control files that are logically
  48. part of the database.
  49. (It would make sense to put those under some subdirectory of
  50. /usr/spool/news,
  51. but that would break a lot of programs that think these
  52. files live in
  53. /usr/lib/news.)
  54. The programs\(emthose which don't need to be directly executable by
  55. users or \fIuucp\fR\(emlive in
  56. /usr/lib/newsbin.
  57. Actually,
  58. they usually live in subdirectories thereof,
  59. with each significant subsystem having its own subdirectory to keep the
  60. individual directories manageable in complexity.
  61. There are occasional general-purpose utilities at the top level;
  62. there aren't enough of them to be worth a separate directory.
  63. .SH
  64. PATH
  65. .LP
  66. In general,
  67. things are organized to permit sharing of
  68. /usr/lib/newsbin
  69. among multiple databases.
  70. It doesn't make sense to share
  71. /usr/lib/news
  72. among multiple databases,
  73. as much of the stuff that lives there is logically part of the database.
  74. .LP
  75. There is a possibility that an individual database will want to override
  76. specific decisions made by the programs,
  77. i.e. will want its own version
  78. of some programs.
  79. Accordingly,
  80. provision is made for a `bin' directory under
  81. /usr/lib/news.
  82. News software should set its PATH to something on the order of
  83. .DS
  84. .ft B
  85. /usr/lib/news/bin:/usr/lib/newsbin/xxx:/usr/lib/newsbin:/bin:/usr/bin
  86. .ft
  87. .DE
  88. (See the ``Configuration Mechanisms'' document for how this
  89. should \fIactually\fR be written,
  90. to facilitate configuration changes
  91. and local customization.)
  92. That is,
  93. first look in the database's bin directory for overrides,
  94. then in some subdirectory of
  95. /usr/lib/newsbin
  96. for the subsystem's
  97. programs,
  98. then in
  99. newsbin
  100. itself for news-wide utilities,
  101. then in the standard system directories for standard Unix utilities.
  102.