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