clientlib man page on 4.4BSD

Printed from http://www.polarhome.com/service/man/?qf=clientlib&af=0&tf=2&of=4.4BSD

CLIENTLIB(3)							  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 pro‐
       grams 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 con‐
       nection.

HISTORY
       Written	by  Rich  $alz <rsalz@uunet.uu.net> for InterNetNews.  This is
       revision 1.4, dated 1992/04/03.

SEE ALSO
       libinn(3).

								  CLIENTLIB(3)
[top]

List of man pages available for 4.4BSD

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net