Man page - clientlib(3)
Packages contas this manual
- subst(1)
- ctlinnd(8)
- makeactive(8)
- hosts.nntp(5)
- shlock(1)
- convdate(1)
- overview.fmt(5)
- pgpverify(8)
- innwatch.ctl(5)
- installit(1)
- news-recovery(8)
- shrinkfile(1)
- innwatch(8)
- history(5)
- batcher(8)
- buffchan(8)
- clientlib(3)
- fastrm(8)
- nntpsend(8)
- innstat(8)
- newslog(8)
- filechan(8)
- grephistory(1)
- expirerm(8)
- scanlogs(8)
- innd(8)
- distrib.pats(5)
- expire(8)
- libinn(3)
- innxmit(8)
- inndcomm(3)
- control.ctl(5)
- expireover(8)
- active(5)
- tally.unwanted(8)
- cvtbatch(8)
- makehistory(8)
- overchan(8)
- news.daily(8)
- newsfeeds(5)
- rnews(1)
- innconfval(1)
- newslog(5)
- newsrequeue(8)
- getlist(1)
- moderators(5)
- send-uucp(8)
- in.nnrpd(8)
- prunehistory(8)
- nntpget(1)
- crosspost(8)
- parsedate(3)
- expire.ctl(5)
- nnrp.access(5)
- inncheck(8)
- inndstart(8)
- nntpsend.ctl(5)
- inews(1)
- dbz(3)
- innxbatch(8)
- qio(3)
- tally.control(8)
- inn.conf(5)
- actsync(8)
- innlog.pl(8)
- archive(8)
- writelog(8)
- wildmat(3)
- passwd.nntp(5)
apt-get install inn
Manual
| CLIENTLIB(3) | Library Functions Manual | 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 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).