GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  CLIENTLIB (3)

NAME

clientlib - NNTP clientlib part of InterNetNews library

CONTENTS

Synopsis
Description
History

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).
Search for    or go to Top of page |  Section 3 |  Main Index


CLIENTLIB (3) -->

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.