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  42,  dated
       1997-08-04.

SEE ALSO

       libinn(3).

                                                                                     CLIENTLIB(3)