ftplastresponse(3) [debian man page]

FtpLastResponse(3)					     Library Functions Manual						FtpLastResponse(3)

NAME

       FtpLastResponse - Retrieve the last response sent by the server.

SYNOPSIS

       #include <ftplib.h>

       char *FtpLastResponse(netbuf *nControl);

PARAMETERS

       nControl
	      A pointer to a control handle returned by FtpConnect().

DESCRIPTION

       FtpLastResponse()  returns  a  pointer  to the last response string sent by the server. This can be parsed by the user program to determine
       more information about the last request or can be displayed along with an error message.

RETURN VALUE

       If nControl is a valid control handle, FtpLastResponse() returns a pointer to the last server response string. Otherwise, NULL is returned.

FTPlib								 06 November 1997						FtpLastResponse(3)

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

																      CLIENTLIB(3)