home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / unix / volume14 / nntp1.5 / part01 / common / README.LIB < prev    next >
Encoding:
Text File  |  1988-04-18  |  1.3 KB  |  35 lines
  1.      This directory contains lotsa good stuff common to both
  2. the news server, support, and client programs.  The short of it is:
  3.  
  4. conf.h        Configuration information for NNTP server,
  5.         support, and client programs.  Described in detail
  6.         in README in this directory.
  7.  
  8. nntp.h        These are the #define's of the numeric response
  9.         codes (and other stuff) in NNTP as defined by RFC 977.
  10.  
  11. clientlib.c    This file is a collection of routines which clients
  12.         can use to talk to the NNTP server.  The code is
  13.         well documented, but briefly, the functions are
  14.  
  15.             getserverbyfile    Opens a named file and
  16.                     returns the contents,
  17.                     presumed to be a host name
  18.             server_init    Open connection to server
  19.             getsocket    Get a stream socket
  20.             get_server    Get line from server
  21.             put_server    Send line to server
  22.             close_server    Close connection
  23.  
  24.         It is worth noting that these routines use
  25.         buffered I/O, and leave the external variables
  26.         "ser_rd_fp" and "ser_wr_fp" (server read/write
  27.         file pointers, respectively) floating around
  28.         for use by programs which need them.
  29.  
  30. If you use the clientlib package to build an NNTP client of your
  31. own, you either need to define NNTPSRC on the "cc" command
  32. line when compiling clientlib.c, or add compile-type -D lines to
  33. the "cc" command line for each option.  Defining NNTPSRC will
  34. try to include "../common/conf.h", which should be used if it exists.
  35.