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

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

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