[BACK]Return to HTFTP.html CVS log [TXT] [DIR] Up to [Public] / libwww / Library / src

Annotation of libwww/Library/src/HTFTP.html, revision 2.20

2.7       timbl       1: <HTML>
                      2: <HEAD>
2.6       timbl       3: <TITLE>FTP access module for libwww</TITLE>
2.7       timbl       4: <NEXTID N="z1">
                      5: </HEAD>
2.6       timbl       6: <BODY>
2.18      frystyk     7: 
2.9       frystyk     8: <H1>FTP access functions</H1>
2.14      frystyk     9: 
2.18      frystyk    10: <PRE>
                     11: /*
                     12: **     (c) COPYRIGHT CERN 1994.
                     13: **     Please first read the full copyright statement in the file COPYRIGH.
                     14: */
                     15: </PRE>
                     16: 
                     17: This is the FTP load module that handles all communication with
                     18: FTP-servers. <P>
2.14      frystyk    19: 
                     20: <B>Authors</B><P>
2.9       frystyk    21: 
                     22: <UL>
2.14      frystyk    23: <LI>Tim Berners-lee, timbl@info.cern.ch
                     24: <LI>Denis DeLaRoca 310 825-4580, CSP1DWD@mvs.oac.ucla.edu
                     25: <LI>Lou Montulli, montulli@ukanaix.cc.ukans.edu
                     26: <LI>Foteos Macrides, macrides@sci.wfeb.edu
                     27: <LI>Henrik Frystyk, frystyk@dxcern.cern.ch
2.9       frystyk    28: </UL>
                     29: 
2.18      frystyk    30: This module is implemented by <A HREF="HTFTP.c">HTFTP.c</A>, and it is
                     31: a part of the <A
                     32: HREF="http://info.cern.ch/hypertext/WWW/Library/User/Guide/Guide.html">
                     33: Library of Common Code</A>.
                     34: 
                     35: <PRE>
                     36: #ifndef HTFTP_H
2.1       timbl      37: #define HTFTP_H
2.20    ! frystyk    38: 
2.9       frystyk    39: #include "HTChunk.h"
                     40: </PRE>
                     41: 
2.14      frystyk    42: <H2>Public Functions</H2>
2.1       timbl      43: 
2.14      frystyk    44: Theese are the public functions...
                     45: 
                     46: <H3>Accessing FTP-Server</H3>
2.1       timbl      47: 
2.9       frystyk    48: <PRE>
2.12      frystyk    49: extern int  HTLoadFTP PARAMS((HTRequest * request));
2.6       timbl      50: </PRE>
2.9       frystyk    51: 
2.14      frystyk    52: <H3>Enable/Disable Reuse of Control Connections on Client Side</H3>
                     53: 
2.9       frystyk    54: The next two functions are for enabling and disabling reuse og control
                     55: connections on client side. Though, this is a temporary solution as the
                     56: library is going to be multi-threaded and then the control of open
                     57: connections changes. Reuse of control connections is mainly intended for use
                     58: when loading several files from the same server in the same directory, but
                     59: changing directory IS supported using FTP-commands CDUP and CWD.
                     60: 
                     61: <PRE>
                     62: extern void HTFTP_enable_session NOPARAMS;
                     63: extern BOOL HTFTP_disable_session NOPARAMS;
                     64: </PRE>
                     65: 
2.15      frystyk    66: <H3>Various Functions to parse information</H3>
2.14      frystyk    67: 
2.15      frystyk    68: Theese functions are necessary in order to keep the internal data structures
                     69: hidden.
2.14      frystyk    70: 
2.9       frystyk    71: <PRE>
2.17      frystyk    72: extern HTChunk *HTFTPWelcomeMsg PARAMS ((HTNetInfo *data));
                     73: extern BOOL HTFTUseList PARAMS ((HTNetInfo *data));
2.9       frystyk    74: </PRE>
2.14      frystyk    75: 
2.9       frystyk    76: <H2>Flags for FTP connections</H2>
                     77: 
2.14      frystyk    78: Those are the flags for configuring the FTP client.
                     79: 
                     80: <PRE>
                     81: extern BOOL HTFTPUserInfo;
                     82: extern long HTFTPTimeOut;
                     83: </PRE>
                     84: 
                     85: If HTFTPUserInfo = YES (as pr default) then the users login name and password
                     86: is reused when conneting to the same host. It is, however, overwritten by any
2.16      frystyk    87: userid and passwd specified in the URL. This is only for the client side, as
2.14      frystyk    88: server forks itself on any request. If this flag is not set, then anonymous
                     89: and username of the current proces is used. <P>
                     90: 
                     91: In addition, the following defines are available in the module: <P>
2.9       frystyk    92: 
2.6       timbl      93: <DL>
2.9       frystyk    94: <DT>LISTEN 
                     95: <DD>This defines makes it possible to use PORT and hence do an passive
                     96: open for the data connection. Though, if defined, this is only used AFTER
                     97: an active open has been tried using PASV.
                     98: <DT>REPEAT_PORT
2.11      luotonen   99: <DD>If LISTEN is defined, then when we have found a passive port, then reuse
2.9       frystyk   100: it for the next time, else we ask the system to get a new one.
                    101: <DT>POLL_PORTS
2.11      luotonen  102: <DD>If the system doesn't support finding a new port, then let's try it
2.9       frystyk   103: ourselves.
2.6       timbl     104: </DL>
                    105: 
2.9       frystyk   106: 
                    107: <PRE>
2.8       luotonen  108: #endif
2.6       timbl     109: </PRE>
2.16      frystyk   110: end of HTFTP Module
2.9       frystyk   111: </BODY>
                    112: </HTML>
2.1       timbl     113: 
                    114: 
Webmaster