home *** CD-ROM | disk | FTP | other *** search
/ Il CD di internet / CD.iso / SOURCE / N / NN / _NN-SPOO.TAR / usr / doc / nn / PROBLEMS < prev    next >
Encoding:
Text File  |  1991-04-23  |  14.1 KB  |  380 lines

  1.                 KNOWN PROBLEMS
  2.                 --------------
  3.  
  4. Here is a collection of some of the problems people have had with
  5. installation and operation of nn in the past.  Some of these may no
  6. longer be completely valid since release 6.4 has changed quite a
  7. number of things since release 6.3, but there may still be some hints
  8. to solving the problems you might encounter.
  9.  
  10.  
  11.              RUNNING NN ON 80286
  12.              -------------------
  13.  
  14. The system and machine file for a '286 running Microport UNIX V/AT are
  15. s-uport2-2.h and m-i80286.h, but to get it running you probably have
  16. to do the following things as well:
  17.  
  18. - tgetstr.o in libcurses is broken in 2.4.
  19.   Get an old version (e.g. 1.3) and replaced tgetstr.o.
  20.  
  21. - Use the m286 malloc posted recently to comp.sources.misc
  22.  
  23. Thanks to Wietse Z. Venema and Miek Grenier for a lot of work on
  24. locating and fixing 16/32 bit problems in nn 6.3 which caused it not
  25. to work on the '286.  (I hope I haven't introduced new problems in
  26. 6.4, but I cannot promise it).
  27.  
  28.                 NNTP PROBLEMS
  29.                 -------------
  30.  
  31. Other problems with the current NNTP support are described in the NNTP
  32. file.
  33.  
  34.  
  35.                FILE PERMISSIONS
  36.                ----------------
  37.  
  38. You should run as root when installing the package & db, because some
  39. directories might be created in places where ordinary users are not
  40. allowed to write, and secondly because it is not allowed to change the
  41. owner of a file (nnmaster) on some systems.
  42.  
  43. Specifically, nnmaster will report "nnmaster already running" if it
  44. doesn't have write access to the MASTER_DIRECTORY.
  45.  
  46. This might be the cause of your problems.
  47.  
  48.  
  49. In general, the permissions and ownership of the various programs
  50. should be set to allow the following access:
  51.  
  52. - To let the nnmaster READ the news directory (no problem since
  53.   /usr/spool/news normally has mode 755),
  54.  
  55. - To let the nnmaster WRITE in the db-directory and files
  56.  
  57. - To let ordinary users programs (i.e. nn) READ the db-directory.
  58.  
  59. For example,
  60.               owner   group   mode
  61.   db-directory & files:    news    news    755
  62.   nnmaster:        news    news    4755 (suid)
  63.   nn etc:        storm    other    755
  64.  
  65.  
  66.          EXPIRED ARTICLES STILL SHOW UP ON THE MENUS
  67.          -------------------------------------------
  68.  
  69. This happens if expiration has not been performed on the database
  70. after expire has been run on the news system (or NNTP server).
  71.  
  72. To run expire on the database regularly, inserting the following
  73. command in the crontab to be executed at a suitable time (with
  74. permissions of the owner of nnmaster).  Preferably it should run
  75. immediately after normal expire has *completed*:
  76.     /usr/local/bin/nnadmin =EYW
  77.  
  78. This expire is relatively cheap on a local system (< 10 minutes), but
  79. via NNTP, it may be more expensive, so there it is recommended to only
  80. run once a week or so.  I have some directions for a patch to the NNTP
  81. server which will cure this problem -- see NNTP and nntp.c!
  82.  
  83.  
  84.              ABOUT BLOCKED GROUPS
  85.              --------------------
  86.  
  87. A group is blocked while the nnmaster is collecting new articles in
  88. that group.  In a newly initialized database, all groups will be
  89. blocked until the nnmaster has collected them the first time, which
  90. may take an hour or so the first time you run nnmaster -r.
  91.  
  92. This means that there may not be any news to read for a while after
  93. you have just started the nnmaster the first time.
  94.  
  95. If you run nnmaster with only a selection of groups on the command
  96. line, you may also see some blocked groups among the groups that are
  97. not collected.
  98.  
  99.  
  100.             PROBLEMS SENDING MAIL
  101.             ---------------------
  102.  
  103. Some people have experienced problems sending mail.
  104.  
  105. The unfortunate thing about this is that the report about the problems
  106. is sent to the user *by mail* - sort of catch-22.
  107.  
  108. The most common cause of these problems is that the definition of
  109. REC_MAIL in config.h is not correct.  Either it is an invalid path or
  110. program name, or the command does not read its standard input to
  111. get the letter (for example, MMDF's `post' command wants the letter in
  112. a file).  The 'inst' script will check that the REC_MAIL and INEWS
  113. programs exist, but not that they actually work.
  114.  
  115. In another case, uux was not silent causing the trace file (in the aux
  116. script) to be non-empty which fooled nn to think that nothing had been
  117. sent (although it did).  If you get failed reply/follow-up messages
  118. look for a line saying something like "uucp job XXXXX" - This is
  119. caused by the environment setting JOBNO=ON.
  120.  
  121. In one case, the recmail program was corrupted.
  122.  
  123. Also notice that some recmail programs may treat a line consisting of
  124. a single period in the first position as end-of-file.
  125.  
  126. If you don't have any program which can be used as recmail, there is
  127. one possible candidate in the contrib/ directory.
  128.  
  129.  
  130.                ACCESSING NEWS REMOTELY
  131.                -----------------------
  132.  
  133. I have received the following problem description which seems to
  134. indicate a network problem.  You can now set the variable
  135.     retry-on-error
  136. to the number of times nn should try to open an article (you may
  137. want to do this in the global init file!):
  138.  
  139.    We are running on a VAXstation 2000, with the news accessed
  140.    remotely, so I get a lot of "can't read" errors.  It seems to
  141.    me these errors should ALWAYS require acknowledgement before
  142.    clearing the message, and should offer the possibility to
  143.    re-try the operation (which usually then works for us).
  144.  
  145. There is a similar option [-y] to nnmaster which can be set to have
  146. the nnmaster perform retries as well.
  147.  
  148.  
  149.             GROUPS BECOME OR REMAIN EMPTY
  150.             -----------------------------
  151.  
  152. It has been observed on a few occations that some groups are not
  153. collected correctly.  We have seldom managed to track down the actual
  154. problem, but in practically all cases, NNTP and/or NFS has been
  155. involved, either accessing the news spool files remotely, or nnmaster
  156. updating the database on another machine, or both.
  157.  
  158. It is very much recommended that nnmaster runs on the system when the
  159. database is placed, and if at all possible that this is also the
  160. system on which the news spool files are located.  Furthermore, this
  161. is by far the most efficient way to run things.
  162.  
  163. In any case, don't hesistate to tell me if you see this problem with
  164. release 6.4.
  165.  
  166.  
  167.             TERMINAL I-O PROBLEMS
  168.             ---------------------
  169.  
  170. nn does not echo the characters you type except when you are entering
  171. a string, e.g. a file name.  Instead it attempts to make a significant
  172. change to the data displayed on the screen.  On a slow system this may
  173. be seen as a drawback; on fast systems it is an intended feature!
  174.  
  175. If CBREAK is available, nn will use it, but when CBREAK is not avaiable
  176. nn uses raw mode when reading from the keyboard and cooked mode when
  177. printing on the screen (it flips forth and back).  [This behaviour can
  178. be disabled by unsetting the flow-control variable]  This has caused
  179. problems on some systems (e.g. the 3B2) where the tty driver is
  180. located on a dedicated IO-processor, which for some reason handles
  181. ioctl's "out of band".  I have tried to work around these problems by
  182. outputting \r\n sequences where \n should have been sufficient.
  183.  
  184. nn also intentionally discards type-ahead at certain points, but only
  185. if CBREAK mode is not supported, and the flow-control variable is set.
  186.  
  187. On some systems, TCSETAF also flushes the output queue; you may try to
  188. replace it by TCSETAW followed by TCFLSH.
  189.  
  190. On terminals where the arrow keys send single characters, nn will not
  191. recognize the arrow keys as arrows if they send a character which is
  192. already recognized by nn for another purpose.  For example, on the
  193. wyse 50, the left arrow key sends the same code as the backspace key
  194. which is the default erase-key.  Therefore, the left arrow key will be
  195. interpreted as the erase-key.  (This is contrary to 6.3 where the
  196. normal function of the erase-key was - erroneously - inhibited and
  197. interpreted as the arrow key).
  198.  
  199.  
  200.                 Cnews
  201.                 -----
  202.  
  203. nn wants articles to contain Lines: headers, but Cnews doesn't
  204. generate these in the default setup.  You may uncomment the
  205. Lines: code in the inews script.
  206.  
  207. The requirement for Cnews to update the 'min' field in the active
  208. field has been removed in release 6.4.
  209.  
  210.  
  211.         NNMASTER WILL NOT START OR IS LOOPING
  212.         -------------------------------------
  213.  
  214. If no nnmaster is running, and nnmaster refuses to start up, you
  215. should check for the existence of the MPID file in the LIB directory,
  216. If it exists, it should be removed.
  217.  
  218. If nnmaster starts looping, you should check the permissions on the
  219. LIB directory and notice if a GATE file exists which nnmaster is not
  220. allowed to unlink.
  221.  
  222.  
  223.             NNMASTER DIES RANDOMLY
  224.             ----------------------
  225.  
  226. The definition DETATCH_TERMINAL in the s- file you use may not work
  227. (it is a no-op on some systems).  This will cause a hangup signal to
  228. be sent to the master when you logout, and that will terminate the
  229. master.  This may explain why the nnmaster seems to die for no
  230. apparant reason!
  231.  
  232. If nnmaster accesses news via NNTP, you should be aware of an NNTP
  233. limitation which may cause problems to the nnmaster:  Groups with more
  234. than 4096 articles may cause the nntp server to crash!   The easiest
  235. way to circumvent this problem is run expire on the large groups more
  236. frequently.  (Thanks to Scott Hankin for this information).
  237.  
  238.  
  239.              WARNINGS DURING COMPILATION
  240.              ---------------------------
  241.  
  242. If you get a syntax error when compiling the folder.c file, you
  243. probably have defined HAVE_DIRECTORY in the s- file, but even though
  244. the include file exists, it does not define the DIR type.  Either get
  245. hold of a public domain directory package (look in the gnu
  246. distribution), or just undefine HAVE_DIRECTORY which causes nn to use
  247. (much slower) shell commands for file name completion (and disables
  248. the ?-help for file names).
  249.  
  250. If the linker complains about not finding the function `strcspn'
  251. (which should be in most standard libraries these days), define the
  252. symbol STRCSPN in the m- file (or config.h) to use the version in
  253. regexp.c.
  254.  
  255.  
  256.             FORMATTING THE MANUALS
  257.             ----------------------
  258.  
  259. Many versions of the -man package may have problems handling the `@'
  260. characters as hanging tags (.TP).  Fix your man package by
  261. substituting ALL occurrences of the @ character in tmac.an (or perhaps
  262. tmac.an.new) by a BEL (^G) character.
  263.  
  264.  
  265.                    RESIZING
  266.                    --------
  267.  
  268. Resizing only works with termcap (on BSD systems)!  It may also work
  269. on System V, but then you will probably also have to define the symbol
  270. SYSV_RESIZING in config.h (see term.c).
  271.  
  272. If resizing occurs while reading an article, the article is repositioned
  273. on the first page of the article.
  274.  
  275.  
  276.         NNMASTER AND NN DOES NOT FIND ANY NEWS
  277.         --------------------------------------
  278.  
  279. All known occurrences of this problem have been identified and fixed,
  280. or somehow "explained" as being a NFS networking problem.
  281.  
  282. Be careful about the 'limit' and 'old' variables.  Setting them in the
  283. init file may cause nn to behave strangely (as documented :-)
  284.  
  285.  
  286.     THE DATABASE BECOMES CORRUPTED FOR NO APPARENT REASON
  287.     -----------------------------------------------------
  288.  
  289. This has been seen on some systems in the past.
  290.  
  291. - The expire problem in release 6.3 has been fixed, since the code
  292.   to perform the expiration has been rewritten and optimized.  No
  293.   known bugs exist in this code.
  294.  
  295. - Some .o files had not been recompiled by make after modifying the
  296.   config.h file (this happened on SunOS 4.0 which seems to forget to
  297.   update file modification times for some files (has anybody seen this
  298.   before?)).
  299.  
  300.  
  301.                 8 BIT SUPPORT
  302.                 -------------
  303.  
  304. I am rather embarrassed to admit that a program leaving Denmark in
  305. 1990 still does not fully support 8 bit character sets - however, that
  306. is the plain truth.  Currently, all characters typed on the keyboard
  307. are stripped to 7 bits, but articles displayed on the screen can be
  308. shown either in 7 or 8 bit mode via the data-bits variable.
  309.  
  310. With patch #6 installed, nn does indeed support 8 bit input if
  311. data-bits = 8.  However, the positions 0x80 through 0x9f are reserved
  312. for internal use, so only the various ISO 8859/* character sets are
  313. *fully* supported, while some PC code pages may overlay some national
  314. characters with function keys.
  315.  
  316.  
  317.                  MAIL RECORDS
  318.                  ------------
  319.  
  320. There are some things you have to consider in connection with the mail
  321. and news record files:
  322.  
  323.  - When you :mail to yourself, a copy is not saved in the mail-record.
  324.  
  325.  - If the mail/post fails, the message is saved in ~/dead.letter instead
  326.  
  327.  - Since the posting is performed in the background and it may take
  328.    upto a minute to complete posting an article, updating news-record
  329.    will not happen instantly.
  330.  
  331.  - In previous releases the mail header created by nn in the record
  332.    files are not recognized by the digest splitting code in nn, i.e.
  333.    they always appear to contain a single article.  This was fixed in
  334.    release 6.3, but you may have some very old folders which nn will
  335.    not be able to split (there is no From: line).
  336.  
  337.  
  338.              OLD AWK vs. NEW AWK
  339.              -------------------
  340.  
  341. Some scripts will not run with 'new awk'.  If your system's `awk' is
  342. the new awk, you must define the symbol OLD_AWK to the path name of
  343. the old awk program (normally `oawk').  See s-template.h.
  344.  
  345.  
  346.                 NN ON APOLLOS
  347.                 -------------
  348.  
  349. Apollo's C-preprocessor may not make a working ymakefile, because it
  350. may convert leading tabs to spaces, and thus confusing make.  You'll
  351. have to reconstruct the tabs somehow, e.g. using something like
  352.     sed 's/^  */TAB/' < ymakefile > ...    (not tested!!)
  353.  
  354. Also notice that releases prior to SR10 will not handle directories
  355. with more than 1300 entries, thus giving problems if you have more
  356. than 650 groups in the database directory (d+x file).  Leaving
  357. DB_DIRECTORY undefined should fix this.
  358.  
  359. Patch #13 contains some patches which should allow nn to run under
  360. Domain OS (with included s-apollo.h).
  361.  
  362.  
  363.              RUNNING nn VIA SUNLINK X.25
  364.              ---------------------------
  365.  
  366. For logins via Sunlink X.25, the article selection display may be all
  367. messed up.  This is because, on entry to cooked mode, Sunlink X.25
  368. sends the screen width parameter to the PAD, and the PAD dumbly
  369. inserts CR/LF after every 80 characters of output.  Not all PADs are
  370. this dumb.  To fix it, insert `set noflow-control' in the global init
  371. file.  Thanks to mills@ccu.umanitoba.ca (Gary Mills) for the info.
  372.  
  373.  
  374.                 OTHER PROBLEMS
  375.                 --------------
  376.  
  377. The 'master flags' set on a group with nnadmin are forgotten if the
  378. database is reinitialized with nnmaster -I.  To set these flags
  379. permanently, you should set them in the GROUPS file.
  380.