Index for Section 3

Alphabetical listing for C

Bottom of page

CLIENTLIB(3)
NAME
  clientlib - NNTP clientlib part of InterNetNews library

SYNOPSIS
  extern FILE	       *ser_rd_fp;
  extern FILE	       *ser_wr_fp;
  extern char	       ser_line[];

  char *
  getserverbyfile(file)
      char	       *file;

  int
  server_init(host)
      char	       *host;

  int
  handle_server_response(response, host)
      int	       reponse;
      char	       *host;

  void
  put_server(text)
      char	       *text;

  int
  get_server(buff, buffsize)
      char	       *buff;
      int	       buffsize;

  void
  close_server()

DESCRIPTION
  The routines described in this manual page are part of the InterNetNews
  library, libinn(3).  They are replacements for the ``clientlib'' part of
  the NNTP distribution, and are intended to be used in building programs
  like rrn.

  Getserverbyfile calls GetConfigValue to get the name of the local NNTP
  server.  It returns a pointer to static space.  The file parameter is
  ignored.

  Server_init opens a connect to the NNTP server at the specified host.	 It
  returns the server's response code or -1 on error.  If a connection was
  made, then ser_rd_fp and ser_wr_fp can be used to read from and write to
  the server, respectively, and ser_line will contain the server's response.
  Ser_line can also be used in other routines.

  Handle_server_response decodes the response, which comes from the server on
  host.	 If the client is authorized, it returns 0.  A client that is only
  allowed to read is authorized, but handle_server_response will print a
  message on the standard output.  If the client is not authorized to talk to
  the server, then a message is printed and the routine returns -1.

  Put_server sends the text in buff to the server, adding the necessary NNTP
  line terminators, and flushing the I/O buffer.

  Get_server reads a line of text from the server into buff, reading at most
  buffsize characters.	Any trailing \r\n terminators are stripped off.
  Get_server returns -1 on error.

  Close_server sends a ``quit'' command to the server and closes the
  connection.

HISTORY
  Written by Rich $alz <rsalz@uunet.uu.net> for InterNetNews.  This is
  revision 1.1.1.1, dated 1997/08/04.

SEE ALSO
  libinn(3).

Index for Section 3

Alphabetical listing for C

Top of page