// Purpose: FTP protocol
// Author: Vadim Zeitlin
// Modified by: Mark Johnson, wxWindows@mj10777.de
-// 20000917 : RmDir, GetLastResult, GetList
+// 20000917 : RmDir, GetLastResult, GetList
// Created: 07/07/1997
// RCS-ID: $Id$
// Copyright: (c) 1997, 1998 Guilhem Lavaux
-// Licence: wxWindows license
+// Licence: wxWindows licence
/////////////////////////////////////////////////////////////////////////////
#ifndef __WX_FTP_H__
#define __WX_FTP_H__
-#ifdef __GNUG__
- #pragma interface "ftp.h"
-#endif
+#include "wx/defs.h"
+
+#if wxUSE_PROTOCOL_FTP
-#include "wx/object.h"
#include "wx/sckaddr.h"
#include "wx/protocol/protocol.h"
#include "wx/url.h"
-class WXDLLEXPORT wxFTP : public wxProtocol
+class WXDLLIMPEXP_NET wxFTP : public wxProtocol
{
public:
enum TransferMode
void SetUser(const wxString& user) { m_user = user; }
void SetPassword(const wxString& passwd) { m_passwd = passwd; }
- bool Connect(wxSockAddress& addr, bool wait = TRUE);
+ bool Connect(wxSockAddress& addr, bool wait = true);
bool Connect(const wxString& host);
// disconnect
// Parameters set up
// set transfer mode now
+ void SetPassive(bool pasv) { m_bPassive = pasv; }
+ void SetDefaultTimeout(wxUint32 Value);
bool SetBinary() { return SetTransferMode(BINARY); }
bool SetAscii() { return SetTransferMode(ASCII); }
bool SetTransferMode(TransferMode mode);
bool Rename(const wxString& src, const wxString& dst);
bool RmFile(const wxString& path);
- // Get the size of a file in the current dir.
- // this function tries its best to deliver the size in bytes using BINARY
- // (the SIZE command reports different sizes depending on whether
- // type is set to ASCII or BINARY)
- // returns -1 if file is non-existant or size could not be found
- int GetFileSize(const wxString& fileName);
+ // Get the size of a file in the current dir.
+ // this function tries its best to deliver the size in bytes using BINARY
+ // (the SIZE command reports different sizes depending on whether
+ // type is set to ASCII or BINARY)
+ // returns -1 if file is non-existant or size could not be found
+ int GetFileSize(const wxString& fileName);
// Check to see if a file exists in the current dir
- bool FileExists(const wxString& fileName);
+ bool FileExists(const wxString& fileName);
// Download methods
bool Abort();
bool GetFilesList(wxArrayString& files,
const wxString& wildcard = wxEmptyString)
{
- return GetList(files, wildcard, FALSE);
+ return GetList(files, wildcard, false);
}
// get a directory list in server dependent format - this can be shown
bool GetDirList(wxArrayString& files,
const wxString& wildcard = wxEmptyString)
{
- return GetList(files, wildcard, TRUE);
+ return GetList(files, wildcard, true);
}
// equivalent to either GetFilesList() (default) or GetDirList()
bool GetList(wxArrayString& files,
const wxString& wildcard = wxEmptyString,
- bool details = FALSE);
-
-#ifdef WXWIN_COMPATIBILITY_2
- // deprecated
- wxList *GetList(const wxString& wildcard, bool details = FALSE);
-#endif // WXWIN_COMPATIBILITY_2
+ bool details = false);
protected:
// this executes a simple ftp command with the given argument and returns
- // TRUE if it its return code starts with '2'
+ // true if it its return code starts with '2'
bool DoSimpleCommand(const wxChar *command,
const wxString& arg = wxEmptyString);
// get the server reply, return the first character of the reply code,
- // '1'..'5' for normal FTP replies, 0 (*not* '0') if an error occured
+ // '1'..'5' for normal FTP replies, 0 (*not* '0') if an error occurred
char GetResult();
// check that the result is equal to expected value
bool CheckResult(char ch) { return GetResult() == ch; }
- wxSocketClient *GetPort();
+ // return the socket to be used, Passive/Active versions are used only by
+ // GetPort()
+ wxSocketBase *GetPort();
+ wxSocketBase *GetPassivePort();
+ wxSocketBase *GetActivePort();
+
+ // helper for GetPort()
+ wxString GetPortCmdArgument(const wxIPV4address& Local, const wxIPV4address& New);
+
+ // accept connection from server in active mode, returns the same socket as
+ // passed in in passive mode
+ wxSocketBase *AcceptIfActive(wxSocketBase *sock);
+
wxString m_user,
m_passwd;
friend class wxInputFTPStream;
friend class wxOutputFTPStream;
- DECLARE_DYNAMIC_CLASS(wxFTP)
+ bool m_bPassive;
+ wxUint32 m_uiDefaultTimeout;
+
+ // following is true when a read or write times out, we then assume
+ // the connection is dead and abort. we avoid additional delays this way
+ bool m_bEncounteredError;
+
+
+ DECLARE_DYNAMIC_CLASS_NO_COPY(wxFTP)
DECLARE_PROTOCOL(wxFTP)
};
// wxLog::AddTraceMask(FTP_TRACE_MASK) to see them in output
#define FTP_TRACE_MASK _T("ftp")
+#endif // wxUSE_PROTOCOL_FTP
+
#endif // __WX_FTP_H__