Poster of Linux kernelThe best gift for a Linux geek
CLIENTLIB

CLIENTLIB

Section: C Library Functions (3)
Local index Up
 

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.4, dated 1992/04/03.  

SEE ALSO

libinn(3).


 

Index

NAME
SYNOPSIS
DESCRIPTION
HISTORY
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 21:43:33 GMT, April 16, 2011