home *** CD-ROM | disk | FTP | other *** search
/ Acorn User 2 / AUCD2.iso / internet / acornet.spk / !Acornet / Apps / !FreeNews / Advanced < prev    next >
Text File  |  1995-10-20  |  4KB  |  86 lines
  1. FreeNews' Advanced Configuration
  2. ================================
  3.  
  4. PLEASE NOTE: The options in advanved configuration are exactly that. Advanced. DO NOT alter
  5.                 them unless you know what you are doing, or you have been specifically advised
  6.                 to do so.
  7.  
  8. (This file last updated Fri 20th October 1995 for FreeNews 1.01)
  9.  
  10.  
  11. Advanced configuration options control internal parameters for FreeNews, and
  12. once set, should generally left well alone. If you do make any changes, you
  13. are strongly advised to make a backup copy of your "Config" file.
  14.  
  15. To change an option, you must load the file <FreeNews$Dir>.Data.Config into
  16. an editor, and change the lines with the relevant tags.
  17.  
  18.  
  19. Pipelining
  20. ----------
  21. Pipelining is the process by which articles are fetched from an NNTP server
  22. so that all components in the link (server, phone line and client) are kept
  23. as busy as possible. If any component is idle waiting for others to complete
  24. a task, the overall process of news fetching will become slower.
  25.  
  26. There are two advanced configuration options that control pipelining,
  27. "pipeline_min" and "pipeline_max". Their use is determined by the narrative
  28. below:
  29.  
  30. Once connected to the server, FreeNews will attempt to keep the line and
  31. the server as busy as possible. To do this, it will request not just one
  32. article, but as many as possible. Since the reply to such a request will keep
  33. the phone line busy for a while, the process will be sped up.
  34.  
  35. "As many as possible" is defined as the number of requests that will fit into
  36. an NNTP command buffer (512 bytes) up to a certain limit. The limit is there
  37. so that any buffers on the server do not get overloaded. This limit is
  38. "pipeline_max".
  39.  
  40. However, as article requests are of varying lengths, FreeNews does not know
  41. in advance how many requests to send. FreeNews will attempt to add requests
  42. to the 512 byte buffer until there are a total of pipline_max requests
  43. pending (in the buffer or at ther server already). However, if the output
  44. buffer becomes full, only the currently composed article requests will be
  45. sent. In this way, FreeNews only sends a maximum of one buffer (hopefully,
  46. one TCP/IP packet) at a time.
  47.  
  48. Each time the server completes sending a message to FreeNews, FreeNews
  49. inspects the parameter "pipeline_min". If the current number of articles
  50. which have pending requests is LESS than pipeline_min, FreeNews will request
  51. some more (as above) until either a block is full, or pipeline_max is
  52. reached.
  53.  
  54. The reason that these parameters may require changing is that if you have a
  55. very fast line and/or a very lightly loaded server, the pipe could empty more
  56. quickly. 
  57.  
  58. It is important to note that pipeline_min must always be less than
  59. pipeline_max, and that the difference between them is not too great to avoid
  60. overflowing server buffers.
  61.  
  62. Defaults :-
  63.      pipeline_min: 5
  64.      pipeline_max: 12
  65.  
  66.  
  67. Ignore_502
  68. ----------
  69. With the release of FreeNews 1.00, some people observed that their server
  70. sometimes returned the string "502 Permission Denied" to the request of a
  71. message. This is only returned for occasional messages, and succeeding ones
  72. would fetch correctly.
  73.  
  74. FreeNews 1.01 onwards will now ignore "502" responses (or rather, they are
  75. treated in the same way as a "220 Article Retrieved" message.
  76.  
  77. However, this is an option because the NNTP standard, RFC977 states that
  78. messages of the form 5xx are fatal errors. Thus, if you experience 502
  79. responses, you should set this option to "Yes".
  80.  
  81. WARNING: FreeNews' behaviour is undefined should a 502 response occur at
  82. other times during transfer.
  83.  
  84. Default :-
  85.     ignore_502: No
  86.