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

       sage on the standard output.  If the client is not  autho­
       rized 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  InterNet­
       News.  This is revision 1.1.1.1, dated 1997/08/04.


SEE ALSO

       libinn(3).


Man(1) output converted with man2html