home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / internet / freenews / !FreeNews / Advanced < prev    next >
Encoding:
Text File  |  1997-04-12  |  4.3 KB  |  101 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 Sun 08th September 1996 for FreeNews 1.03)
  9. (version 1.10 does not add any Advanced parameters)
  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: 15
  64.      pipeline_max: 22
  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.  
  87. Check_rate
  88. ----------
  89. To ensure that FreeNews' downloads are not slowed down by additional tasks
  90. on the icon bar, 1.03+ of FreeNews supports the "check_rate" advanced option.
  91.  
  92. In 1.02 and before, FreeNews' behaviour was to be super-nice to any other 
  93. tasks on the machine by calling wimp_poll as often as possible, usually after
  94. every line is received from the server ("check_rate: 1").
  95.  
  96. From version 1.03, FreeNews can be instructed to read and process "n" lines 
  97. per Wimp_Poll. Please note that setting this value too low will result in FreeNews
  98. slowing down when other tasks are loaded. Setting it too high will result in
  99. maximum throughput, but with great effect on the machine's ability to multitask.
  100.  
  101.