home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / rxiutl16.zip / ngfetch.txt < prev    next >
Text File  |  2000-01-10  |  2KB  |  60 lines
  1. News group list fetch v0.16
  2.  
  3. For whatever purpose, you may want a simple list of newsgroups without 
  4. having to export from a news reader program.  
  5.  
  6. That's what this news group list fetcher is for.  
  7.  
  8. The usage:
  9.  
  10. ngfetch.cmd <host> [options]
  11.  
  12. <host> is the name of the news server you want to grab a list from.  All 
  13. available groups will be downloaded and written to a file.  A progress 
  14. indicator will be displayed, showing bytes transferred, and the rate of 
  15. transfer, as well as the number of groups parsed.  
  16.  
  17. Options:
  18.  
  19. /q - Quiet mode.  No transfer status display.
  20.  
  21. /qq - Super quiet mode.  Suppresses all output.
  22.  
  23. /w - Write raw data to file.  No newsgroup parsing.
  24.  
  25. /s - Sort received newsgroups before writing (somewhat slow).
  26.  
  27. /b# - Specify transfer block size (512-65535).  Default is 10240.
  28.  
  29. /t# - Specify transfer status timing interval in 100ths of a second.
  30.       Default is 50 (updated twice a second).
  31.  
  32. /m# - Specify maximum retries on socket receive errors.  Default is 1000.
  33.  
  34. You should note that the final size of .newsrc will not match the total 
  35. bytes transferred, because the groups will have been parsed out of 
  36. information pertaining to article numbers and posting permission.  If, for 
  37. some reason, you want this information, just use the /w switch.  All
  38. information will be written to .newsrc without any parsing.  Naturally, 
  39. there will be no status information concerning the number of groups 
  40. received using this switch.  If you have a fast connection, this will be 
  41. much faster due to the lack of parsing.
  42.  
  43. At the end of the transfer, there will be a stats line with the number of 
  44. bytes transferred, seconds of duration, and effective transfer rate.  If 
  45. the /w switch is not used, there will be another line stating how many
  46. groups were received.  
  47.  
  48. Exit codes:
  49.  
  50. 0 - newsgroup list retrieval successful
  51. 1 - news host connection failed at socket level
  52. 2 - connection refused by remote server
  53. 3 - user aborted
  54. 4 - program error
  55. 5 - bad usage
  56.  
  57. For any questions, comments, complaints, etc., e-mail me at:
  58.  
  59.     <thannymeister@yahoo.com>
  60.