clientlib man page on BSDi

Man page or keyword search:  
man Server   6284 pages
apropos Keyword Search (all sections)
Output format
BSDi logo
[printable version]



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 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

								1

CLIENTLIB(3)					     CLIENTLIB(3)

       authorized,  but	 handle_server_response will print a mes-
       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.2.1, dated 1999/06/12.

SEE ALSO
       libinn(3).

								2

[top]

List of man pages available for BSDi

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