2001-12-30 06:31:25 +00:00
|
|
|
/* ncftp.h
|
|
|
|
*
|
|
|
|
* Copyright (c) 1996-2001 Mike Gleason, NCEMRSoft.
|
|
|
|
* All rights reserved.
|
|
|
|
*
|
|
|
|
*/
|
|
|
|
|
|
|
|
#ifndef _ncftp_h_
|
|
|
|
#define _ncftp_h_ 1
|
|
|
|
|
|
|
|
#define kLibraryVersion "@(#) LibNcFTP 3.0.6 (April 14, 2001)"
|
|
|
|
|
|
|
|
#if defined(WIN32) || defined(_WINDOWS)
|
|
|
|
# define longest_int LONGLONG
|
|
|
|
# define longest_uint ULONGLONG
|
|
|
|
# ifndef HAVE_LONG_LONG
|
|
|
|
# define HAVE_LONG_LONG 1
|
|
|
|
# endif
|
|
|
|
# ifndef SCANF_LONG_LONG
|
|
|
|
# define SCANF_LONG_LONG "%I64d"
|
|
|
|
# endif
|
|
|
|
# ifndef PRINTF_LONG_LONG
|
|
|
|
# define PRINTF_LONG_LONG "%I64d"
|
|
|
|
# endif
|
|
|
|
# ifndef PRINTF_LONG_LONG_I64D
|
|
|
|
# define PRINTF_LONG_LONG_I64D 1
|
|
|
|
# endif
|
|
|
|
# ifndef SCANF_LONG_LONG_I64D
|
|
|
|
# define SCANF_LONG_LONG_I64D 1
|
|
|
|
# endif
|
|
|
|
# ifndef USE_SIO
|
|
|
|
# define USE_SIO 1
|
|
|
|
# endif
|
|
|
|
# ifndef NO_SIGNALS
|
|
|
|
# define NO_SIGNALS 1
|
|
|
|
# endif
|
|
|
|
#else
|
|
|
|
# include <stdio.h>
|
|
|
|
# include <sys/time.h>
|
|
|
|
# if !defined(__ultrix) || !defined(XTI)
|
|
|
|
# include <sys/socket.h>
|
|
|
|
# endif
|
|
|
|
# include <netinet/in.h>
|
|
|
|
# if 1 /* %config1% -- set by configure script -- do not modify */
|
|
|
|
# ifndef USE_SIO
|
|
|
|
# define USE_SIO 1
|
|
|
|
# endif
|
|
|
|
# ifndef NO_SIGNALS
|
|
|
|
# define NO_SIGNALS 1
|
|
|
|
# endif
|
|
|
|
# else
|
|
|
|
# ifndef USE_SIO
|
|
|
|
# define USE_SIO 0
|
|
|
|
# endif
|
|
|
|
/* #undef NO_SIGNALS */
|
|
|
|
# endif
|
|
|
|
#endif
|
|
|
|
|
|
|
|
#include "ncftp_errno.h"
|
|
|
|
|
|
|
|
/* This is used to verify validty of the data passed in.
|
|
|
|
* It also specifies the minimum version that is binary-compatibile with
|
|
|
|
* this version. (So this may not necessarily be kLibraryVersion.)
|
|
|
|
*/
|
|
|
|
#define kLibraryMagic "LibNcFTP 3.0.6"
|
|
|
|
|
|
|
|
#ifndef longest_int
|
|
|
|
#define longest_int long long
|
|
|
|
#define longest_uint unsigned long long
|
|
|
|
#endif
|
|
|
|
|
|
|
|
#ifndef forever
|
|
|
|
# define forever for ( ; ; )
|
|
|
|
#endif
|
|
|
|
|
|
|
|
typedef void (*FTPSigProc)(int);
|
|
|
|
|
|
|
|
typedef struct Line *LinePtr;
|
|
|
|
typedef struct Line {
|
|
|
|
LinePtr prev, next;
|
|
|
|
char *line;
|
|
|
|
} Line;
|
|
|
|
|
|
|
|
typedef struct LineList {
|
|
|
|
LinePtr first, last;
|
|
|
|
int nLines;
|
|
|
|
} LineList, *LineListPtr;
|
|
|
|
|
|
|
|
typedef struct Response {
|
|
|
|
LineList msg;
|
|
|
|
int codeType;
|
|
|
|
int code;
|
|
|
|
int printMode;
|
|
|
|
int eofOkay;
|
|
|
|
int hadEof;
|
|
|
|
} Response, *ResponsePtr;
|
|
|
|
|
|
|
|
#if USE_SIO && !defined(_SReadlineInfo_)
|
|
|
|
#define _SReadlineInfo_ 1
|
|
|
|
typedef struct SReadlineInfo {
|
|
|
|
char *buf; /* Pointer to beginning of buffer. */
|
|
|
|
char *bufPtr; /* Pointer to current position in buffer. */
|
|
|
|
char *bufLim; /* Pointer to end of buffer. */
|
|
|
|
size_t bufSize; /* Current size of buffer block. */
|
|
|
|
size_t bufSizeMax; /* Maximum size available for buffer. */
|
|
|
|
int malloc; /* If non-zero, malloc() was used for buf. */
|
|
|
|
int fd; /* File descriptor to use for I/O. */
|
|
|
|
int timeoutLen; /* Timeout to use, in seconds. */
|
|
|
|
int requireEOLN; /* When buffer is full, continue reading and discarding until \n? */
|
|
|
|
} SReadlineInfo;
|
|
|
|
#endif
|
|
|
|
|
|
|
|
typedef struct FTPLibraryInfo {
|
|
|
|
char magic[16]; /* Don't modify this field. */
|
|
|
|
int init; /* Don't modify this field. */
|
|
|
|
int socksInit; /* Don't modify this field. */
|
|
|
|
unsigned int defaultPort; /* Don't modify this field. */
|
|
|
|
char ourHostName[64]; /* Don't modify this field. */
|
|
|
|
int hresult; /* Don't modify this field. */
|
|
|
|
int htried; /* Don't modify this field. */
|
|
|
|
char defaultAnonPassword[80]; /* You may set this after init. */
|
|
|
|
} FTPLibraryInfo, *FTPLIPtr;
|
|
|
|
|
|
|
|
typedef struct FTPConnectionInfo *FTPCIPtr;
|
|
|
|
typedef void (*FTPProgressMeterProc)(const FTPCIPtr, int);
|
|
|
|
typedef void (*FTPLogProc)(const FTPCIPtr, char *);
|
|
|
|
typedef void (*FTPConnectMessageProc)(const FTPCIPtr, ResponsePtr);
|
|
|
|
typedef void (*FTPLoginMessageProc)(const FTPCIPtr, ResponsePtr);
|
|
|
|
typedef void (*FTPRedialStatusProc)(const FTPCIPtr, int, int);
|
|
|
|
typedef void (*FTPPrintResponseProc)(const FTPCIPtr, ResponsePtr);
|
|
|
|
typedef int (*FTPFtwProc)(const FTPCIPtr cip, const char *fn, int flag);
|
|
|
|
typedef void (*FTPGetPassphraseProc)(const FTPCIPtr, LineListPtr pwPrompt, char *pass, size_t dsize);
|
|
|
|
|
|
|
|
typedef struct FTPConnectionInfo {
|
|
|
|
char magic[16]; /* Don't modify this field. */
|
|
|
|
char host[64]; /* REQUIRED input parameter. */
|
|
|
|
char user[64]; /* OPTIONAL input parameter. */
|
|
|
|
char pass[64]; /* OPTIONAL input parameter. */
|
|
|
|
char acct[64]; /* OPTIONAL input parameter. */
|
|
|
|
unsigned int port; /* OPTIONAL input parameter. */
|
|
|
|
unsigned int xferTimeout; /* OPTIONAL input parameter. */
|
|
|
|
unsigned int connTimeout; /* OPTIONAL input parameter. */
|
|
|
|
unsigned int ctrlTimeout; /* OPTIONAL input parameter. */
|
|
|
|
unsigned int abortTimeout; /* OPTIONAL input parameter. */
|
|
|
|
FILE *debugLog; /* OPTIONAL input parameter. */
|
|
|
|
FILE *errLog; /* OPTIONAL input parameter. */
|
|
|
|
FTPLogProc debugLogProc; /* OPTIONAL input parameter. */
|
|
|
|
FTPLogProc errLogProc; /* OPTIONAL input parameter. */
|
|
|
|
FTPLIPtr lip; /* Do not modify this field. */
|
|
|
|
int maxDials; /* OPTIONAL input parameter. */
|
|
|
|
int redialDelay; /* OPTIONAL input parameter. */
|
|
|
|
int dataPortMode; /* OPTIONAL input parameter. */
|
|
|
|
char actualHost[64]; /* Do not modify this field. */
|
|
|
|
char ip[32]; /* Do not modify this field. */
|
|
|
|
int connected; /* Do not modify this field. */
|
|
|
|
int loggedIn; /* Do not modify this field. */
|
|
|
|
int curTransferType; /* Do not modify this field. */
|
|
|
|
char *startingWorkingDirectory; /* Use, but do not modify. */
|
|
|
|
longest_int startPoint; /* Do not modify this field. */
|
|
|
|
int hasPASV; /* Do not modify this field. */
|
|
|
|
int hasSIZE; /* Do not modify this field. */
|
|
|
|
int hasMDTM; /* Do not modify this field. */
|
|
|
|
int hasREST; /* Do not modify this field. */
|
|
|
|
int hasNLST_d; /* Do not modify this field. */
|
|
|
|
int hasUTIME; /* Do not modify this field. */
|
|
|
|
int hasFEAT; /* Do not modify this field. */
|
|
|
|
int hasMLSD; /* Do not modify this field. */
|
|
|
|
int hasMLST; /* Do not modify this field. */
|
|
|
|
int usedMLS; /* Do not modify this field. */
|
|
|
|
int hasCLNT; /* Do not modify this field. */
|
|
|
|
int hasRETRBUFSIZE; /* Do not modify this field. */
|
|
|
|
int hasRBUFSIZ; /* Do not modify this field. */
|
|
|
|
int hasRBUFSZ; /* Do not modify this field. */
|
|
|
|
int hasSTORBUFSIZE; /* Do not modify this field. */
|
|
|
|
int hasSBUFSIZ; /* Do not modify this field. */
|
|
|
|
int hasSBUFSZ; /* Do not modify this field. */
|
|
|
|
int hasBUFSIZE; /* Do not modify this field. */
|
|
|
|
int mlsFeatures; /* Do not modify this field. */
|
|
|
|
int STATfileParamWorks; /* Do not modify this field. */
|
|
|
|
int NLSTfileParamWorks; /* Do not modify this field. */
|
|
|
|
struct sockaddr_in servCtlAddr; /* Do not modify this field. */
|
|
|
|
struct sockaddr_in servDataAddr; /* Do not modify this field. */
|
|
|
|
struct sockaddr_in ourCtlAddr; /* Do not modify this field. */
|
|
|
|
struct sockaddr_in ourDataAddr; /* Do not modify this field. */
|
|
|
|
int netMode; /* Do not use or modify. */
|
|
|
|
char *buf; /* Do not modify this field. */
|
|
|
|
size_t bufSize; /* Do not modify this field. */
|
|
|
|
FILE *cin; /* Do not use or modify. */
|
|
|
|
FILE *cout; /* Do not use or modify. */
|
|
|
|
int ctrlSocketR; /* You may use but not modify/close. */
|
|
|
|
int ctrlSocketW; /* You may use but not modify/close. */
|
|
|
|
int dataSocket; /* You may use but not modify/close. */
|
|
|
|
int errNo; /* You may modify this if you want. */
|
|
|
|
unsigned short ephemLo; /* You may modify this if you want. */
|
|
|
|
unsigned short ephemHi; /* You may modify this if you want. */
|
|
|
|
int cancelXfer; /* You may modify this. */
|
|
|
|
longest_int bytesTransferred; /* Do not modify this field. */
|
|
|
|
FTPProgressMeterProc progress; /* You may modify this if you want. */
|
|
|
|
int useProgressMeter; /* Used internally. */
|
|
|
|
int leavePass; /* You may modify this. */
|
|
|
|
double sec; /* Do not modify this field. */
|
|
|
|
double secLeft; /* Do not modify this field. */
|
|
|
|
double kBytesPerSec; /* Do not modify this field. */
|
|
|
|
double percentCompleted; /* Do not modify this field. */
|
|
|
|
longest_int expectedSize; /* Do not modify this field. */
|
|
|
|
time_t mdtm; /* Do not modify this field. */
|
|
|
|
time_t nextProgressUpdate; /* Do not modify this field. */
|
|
|
|
const char *rname; /* Do not modify this field. */
|
|
|
|
const char *lname; /* Do not modify this field. */
|
|
|
|
struct timeval t0; /* Do not modify this field. */
|
|
|
|
int stalled; /* Do not modify this field. */
|
|
|
|
int dataTimedOut; /* Do not modify this field. */
|
|
|
|
int eofOkay; /* Do not use or modify. */
|
|
|
|
char lastFTPCmdResultStr[128]; /* You may modify this if you want. */
|
|
|
|
LineList lastFTPCmdResultLL; /* Use, but do not modify. */
|
|
|
|
int lastFTPCmdResultNum; /* You may modify this if you want. */
|
|
|
|
char firewallHost[64]; /* You may modify this. */
|
|
|
|
char firewallUser[64]; /* You may modify this. */
|
|
|
|
char firewallPass[64]; /* You may modify this. */
|
|
|
|
unsigned int firewallPort; /* You may modify this. */
|
|
|
|
int firewallType; /* You may modify this. */
|
|
|
|
int require20; /* You may modify this. */
|
|
|
|
int usingTAR; /* Use, but do not modify. */
|
|
|
|
FTPConnectMessageProc onConnectMsgProc; /* You may modify this. */
|
|
|
|
FTPRedialStatusProc redialStatusProc; /* You may modify this. */
|
|
|
|
FTPPrintResponseProc printResponseProc; /* You may modify this. */
|
|
|
|
FTPLoginMessageProc onLoginMsgProc; /* You may modify this. */
|
|
|
|
size_t ctrlSocketRBufSize; /* You may modify this. */
|
|
|
|
size_t ctrlSocketSBufSize; /* You may modify this. */
|
|
|
|
size_t dataSocketRBufSize; /* You may modify this. */
|
|
|
|
size_t dataSocketSBufSize; /* You may modify this. */
|
|
|
|
int serverType; /* Do not use or modify. */
|
|
|
|
int ietfCompatLevel; /* Do not use or modify. */
|
|
|
|
int numDownloads; /* Do not use or modify. */
|
|
|
|
int numUploads; /* Do not use or modify. */
|
|
|
|
int numListings; /* Do not use or modify. */
|
|
|
|
int doNotGetStartingWorkingDirectory; /* You may modify this. */
|
|
|
|
#if USE_SIO
|
|
|
|
char srlBuf[768];
|
|
|
|
SReadlineInfo ctrlSrl; /* Do not use or modify. */
|
|
|
|
#endif
|
|
|
|
FTPGetPassphraseProc passphraseProc; /* You may modify this. */
|
|
|
|
int iUser; /* Scratch integer field you can use. */
|
|
|
|
void *pUser; /* Scratch pointer field you can use. */
|
|
|
|
longest_int llUser; /* Scratch long long field you can use. */
|
|
|
|
const char *asciiFilenameExtensions; /* You may assign this. */
|
|
|
|
int reserved[32]; /* Do not use or modify. */
|
|
|
|
} FTPConnectionInfo;
|
|
|
|
|
|
|
|
typedef struct FileInfo *FileInfoPtr, **FileInfoVec;
|
|
|
|
typedef struct FileInfo {
|
|
|
|
FileInfoPtr prev, next;
|
|
|
|
char *relname;
|
|
|
|
char *rname;
|
|
|
|
char *rlinkto;
|
|
|
|
char *lname;
|
|
|
|
char *plug; /* permissions, links, user, group */
|
|
|
|
int type;
|
|
|
|
time_t mdtm;
|
|
|
|
longest_int size;
|
|
|
|
size_t relnameLen;
|
|
|
|
} FileInfo;
|
|
|
|
|
|
|
|
typedef struct FileInfoList {
|
|
|
|
FileInfoPtr first, last;
|
|
|
|
FileInfoVec vec;
|
|
|
|
size_t maxFileLen;
|
|
|
|
size_t maxPlugLen;
|
|
|
|
int nFileInfos;
|
|
|
|
int sortKey;
|
|
|
|
int sortOrder;
|
|
|
|
} FileInfoList, *FileInfoListPtr;
|
|
|
|
|
|
|
|
/* Used with UnMlsT() */
|
|
|
|
typedef struct MLstItem{
|
|
|
|
char fname[512];
|
|
|
|
char linkto[512];
|
|
|
|
int ftype;
|
|
|
|
longest_int fsize;
|
|
|
|
time_t ftime;
|
|
|
|
int mode; /* "UNIX.mode" fact */
|
|
|
|
int uid; /* "UNIX.uid" fact */
|
|
|
|
int gid; /* "UNIX.gid" fact */
|
|
|
|
char perm[16]; /* "perm" fact */
|
|
|
|
char owner[16]; /* "UNIX.owner" fact */
|
|
|
|
char group[16]; /* "UNIX.group" fact */
|
|
|
|
} MLstItem, *MLstItemPtr;
|
|
|
|
|
|
|
|
/* Messages we pass to the current progress meter function. */
|
|
|
|
#define kPrInitMsg 1
|
|
|
|
#define kPrUpdateMsg 2
|
|
|
|
#define kPrEndMsg 3
|
|
|
|
|
|
|
|
/* Parameter for OpenDataConnection() */
|
|
|
|
#define kSendPortMode 0
|
|
|
|
#define kPassiveMode 1
|
|
|
|
#define kFallBackToSendPortMode 2
|
|
|
|
|
|
|
|
/* Parameter for AcceptDataConnection() */
|
|
|
|
#define kAcceptForWriting 00100
|
|
|
|
#define kAcceptForReading 00101
|
|
|
|
#define kNetWriting kAcceptForWriting
|
|
|
|
#define kNetReading kAcceptForReading
|
|
|
|
|
|
|
|
/* Value for printMode field of Response structure.
|
|
|
|
* Generally, don't worry about this.
|
|
|
|
*/
|
|
|
|
#define kResponseNoPrint 00001
|
|
|
|
#define kResponseNoSave 00002
|
|
|
|
#define kResponseNoProc 00002
|
|
|
|
|
|
|
|
#define kDefaultFTPPort 21
|
|
|
|
|
|
|
|
#define kDefaultFTPBufSize 32768
|
|
|
|
|
|
|
|
#ifdef USE_SIO
|
|
|
|
/* This version of the library can handle timeouts without
|
|
|
|
* a user-installed signal handler.
|
|
|
|
*/
|
|
|
|
#define kDefaultXferTimeout 600
|
|
|
|
#define kDefaultConnTimeout 30
|
|
|
|
#define kDefaultCtrlTimeout 135
|
|
|
|
#define kDefaultAbortTimeout 10
|
|
|
|
#else
|
|
|
|
/* The library doesn't use timeouts by default because it would
|
|
|
|
* break apps that don't have a SIGALRM handler.
|
|
|
|
*/
|
|
|
|
#define kDefaultXferTimeout (0) /* No timeout. */
|
|
|
|
#define kDefaultConnTimeout (0) /* No timeout. */
|
|
|
|
#define kDefaultCtrlTimeout (0) /* No timeout. */
|
|
|
|
#define kDefaultAbortTimeout 10
|
|
|
|
#endif
|
|
|
|
|
|
|
|
|
|
|
|
/* Suggested timeout values, in seconds, if you use timeouts. */
|
|
|
|
#define kSuggestedDefaultXferTimeout (0) /* No timeout on data blocks. */
|
|
|
|
#define kSuggestedDefaultConnTimeout 30
|
2005-05-07 21:24:31 +00:00
|
|
|
#define kSuggestedDefaultCtrlTimeout 135 /* 2*MSL, + slop */
|
2001-12-30 06:31:25 +00:00
|
|
|
#define kSuggestedAbortTimeout 10
|
|
|
|
|
|
|
|
#define kDefaultMaxDials 3
|
|
|
|
#define kDefaultRedialDelay 20 /* seconds */
|
|
|
|
|
|
|
|
#define kDefaultDataPortMode kSendPortMode
|
|
|
|
|
|
|
|
#define kRedialStatusDialing 0
|
|
|
|
#define kRedialStatusSleeping 1
|
|
|
|
|
|
|
|
#ifndef INADDR_NONE
|
|
|
|
# define INADDR_NONE (0xffffffff) /* <netinet/in.h> should have it. */
|
|
|
|
#endif
|
|
|
|
|
|
|
|
#define kTypeAscii 'A'
|
|
|
|
#define kTypeBinary 'I'
|
|
|
|
#define kTypeEbcdic 'E'
|
|
|
|
|
|
|
|
#define kGlobChars "[*?"
|
|
|
|
#define GLOBCHARSINSTR(a) (strpbrk(a, kGlobChars) != NULL)
|
|
|
|
|
|
|
|
#define kGlobYes 1
|
|
|
|
#define kGlobNo 0
|
|
|
|
#define kRecursiveYes 1
|
|
|
|
#define kRecursiveNo 0
|
|
|
|
#define kAppendYes 1
|
|
|
|
#define kAppendNo 0
|
|
|
|
#define kResumeYes 1
|
|
|
|
#define kResumeNo 0
|
|
|
|
#define kDeleteYes 1
|
|
|
|
#define kDeleteNo 0
|
|
|
|
#define kTarYes 1
|
|
|
|
#define kTarNo 0
|
|
|
|
|
|
|
|
#define UNIMPLEMENTED_CMD(a) ((a == 500) || (a == 502) || (a == 504))
|
|
|
|
|
|
|
|
/* Possible values returned by GetDateAndTime. */
|
|
|
|
#define kSizeUnknown ((longest_int) (-1))
|
|
|
|
#define kModTimeUnknown ((time_t) (-1))
|
|
|
|
|
|
|
|
#define kCommandAvailabilityUnknown (-1)
|
|
|
|
#define kCommandAvailable 1
|
|
|
|
#define kCommandNotAvailable 0
|
|
|
|
|
|
|
|
/* Values returned by FTPDecodeURL. */
|
|
|
|
#define kNotURL (-1)
|
|
|
|
#define kMalformedURL (-2)
|
|
|
|
|
|
|
|
/* Values for the firewall/proxy open. */
|
|
|
|
#define kFirewallNotInUse 0
|
|
|
|
#define kFirewallUserAtSite 1
|
|
|
|
#define kFirewallLoginThenUserAtSite 2
|
|
|
|
#define kFirewallSiteSite 3
|
|
|
|
#define kFirewallOpenSite 4
|
|
|
|
#define kFirewallUserAtUserPassAtPass 5
|
|
|
|
#define kFirewallFwuAtSiteFwpUserPass 6
|
|
|
|
#define kFirewallUserAtSiteFwuPassFwp 7
|
|
|
|
#define kFirewallLastType kFirewallUserAtSiteFwuPassFwp
|
|
|
|
|
|
|
|
/* For MLSD, MLST, and STAT. */
|
|
|
|
#define kPreferredMlsOpts (kMlsOptType | kMlsOptSize | kMlsOptModify | kMlsOptUNIXmode | kMlsOptUNIXowner | kMlsOptUNIXgroup | kMlsOptUNIXuid | kMlsOptUNIXgid | kMlsOptPerm)
|
|
|
|
|
|
|
|
#define kMlsOptType 00001
|
|
|
|
#define kMlsOptSize 00002
|
|
|
|
#define kMlsOptModify 00004
|
|
|
|
#define kMlsOptUNIXmode 00010
|
|
|
|
#define kMlsOptUNIXowner 00020
|
|
|
|
#define kMlsOptUNIXgroup 00040
|
|
|
|
#define kMlsOptPerm 00100
|
|
|
|
#define kMlsOptUNIXuid 00200
|
|
|
|
#define kMlsOptUNIXgid 00400
|
|
|
|
#define kMlsOptUnique 01000
|
|
|
|
|
|
|
|
/* For FTPFtw(). */
|
|
|
|
#define kFtwFile 0
|
|
|
|
#define kFtwDir 1
|
|
|
|
|
|
|
|
/* For FTPChdir3(). */
|
|
|
|
#define kChdirOnly 00000
|
|
|
|
#define kChdirAndMkdir 00001
|
|
|
|
#define kChdirAndGetCWD 00002
|
|
|
|
#define kChdirOneSubdirAtATime 00004
|
|
|
|
|
|
|
|
/* Return codes for custom ConfirmResumeDownloadProcs. */
|
|
|
|
#define kConfirmResumeProcNotUsed 0
|
|
|
|
#define kConfirmResumeProcSaidSkip 1
|
|
|
|
#define kConfirmResumeProcSaidResume 2
|
|
|
|
#define kConfirmResumeProcSaidOverwrite 3
|
|
|
|
#define kConfirmResumeProcSaidAppend 4
|
|
|
|
#define kConfirmResumeProcSaidBestGuess 5
|
|
|
|
#define kConfirmResumeProcSaidCancel 6
|
|
|
|
|
|
|
|
typedef int (*ConfirmResumeDownloadProc)(
|
|
|
|
const char *volatile *localpath,
|
|
|
|
volatile longest_int localsize,
|
|
|
|
volatile time_t localmtime,
|
|
|
|
const char *volatile remotepath,
|
|
|
|
volatile longest_int remotesize,
|
|
|
|
volatile time_t remotetime,
|
|
|
|
volatile longest_int *volatile startPoint
|
|
|
|
);
|
|
|
|
|
|
|
|
typedef int (*ConfirmResumeUploadProc)(
|
|
|
|
const char *volatile localpath,
|
|
|
|
volatile longest_int localsize,
|
|
|
|
volatile time_t localmtime,
|
|
|
|
const char *volatile *remotepath,
|
|
|
|
volatile longest_int remotesize,
|
|
|
|
volatile time_t remotetime,
|
|
|
|
volatile longest_int *volatile startPoint
|
|
|
|
);
|
|
|
|
|
|
|
|
#define NoConfirmResumeDownloadProc ((ConfirmResumeDownloadProc) 0)
|
|
|
|
#define NoConfirmResumeUploadProc ((ConfirmResumeUploadProc) 0)
|
|
|
|
#define NoGetPassphraseProc ((FTPGetPassphraseProc) 0)
|
|
|
|
|
|
|
|
/* Types of FTP server software.
|
|
|
|
*
|
|
|
|
* We try to recognize a few of these, for information
|
|
|
|
* only, and occasional uses to determine some additional
|
|
|
|
* or broken functionality.
|
|
|
|
*/
|
|
|
|
#define kServerTypeUnknown 0
|
|
|
|
#define kServerTypeWuFTPd 1
|
|
|
|
#define kServerTypeNcFTPd 2
|
|
|
|
#define kServerTypeProFTPD 3
|
|
|
|
#define kServerTypeMicrosoftFTP 4
|
|
|
|
#define kServerTypeWarFTPd 5
|
|
|
|
#define kServerTypeServ_U 6
|
|
|
|
#define kServerTypeWFTPD 7
|
|
|
|
#define kServerTypeVFTPD 8
|
|
|
|
#define kServerTypeFTP_Max 9
|
|
|
|
#define kServerTypeRoxen 10
|
|
|
|
#define kServerTypeNetWareFTP 11
|
|
|
|
#define kServerTypeWS_FTP 12
|
|
|
|
|
|
|
|
|
|
|
|
#if !defined(WIN32) && !defined(_WINDOWS) && !defined(closesocket)
|
|
|
|
# define closesocket close
|
|
|
|
#endif
|
|
|
|
|
|
|
|
#if !defined(WIN32) && !defined(_WINDOWS) && !defined(ioctlsocket)
|
|
|
|
# define ioctlsocket ioctl
|
|
|
|
#endif
|
|
|
|
|
|
|
|
#if defined(WIN32) || defined(_WINDOWS)
|
|
|
|
# define LOCAL_PATH_DELIM '\\'
|
|
|
|
# define LOCAL_PATH_DELIM_STR "\\"
|
|
|
|
# define LOCAL_PATH_ALTDELIM '/'
|
|
|
|
# define IsLocalPathDelim(c) ((c == LOCAL_PATH_DELIM) || (c == LOCAL_PATH_ALTDELIM))
|
|
|
|
# define UNC_PATH_PREFIX "\\\\"
|
|
|
|
# define IsUNCPrefixed(s) (IsLocalPathDelim(s[0]) && IsLocalPathDelim(s[1]))
|
|
|
|
#else
|
|
|
|
# define LOCAL_PATH_DELIM '/'
|
|
|
|
# define LOCAL_PATH_DELIM_STR "/"
|
|
|
|
# define StrFindLocalPathDelim(a) strchr(a, LOCAL_PATH_DELIM)
|
|
|
|
# define StrRFindLocalPathDelim(a) strrchr(a, LOCAL_PATH_DELIM)
|
|
|
|
# define StrRemoveTrailingLocalPathDelim StrRemoveTrailingSlashes
|
|
|
|
# define IsLocalPathDelim(c) (c == LOCAL_PATH_DELIM)
|
|
|
|
# define TVFSPathToLocalPath(s)
|
|
|
|
# define LocalPathToTVFSPath(s)
|
|
|
|
#endif
|
|
|
|
|
|
|
|
#ifdef __cplusplus
|
|
|
|
extern "C"
|
|
|
|
{
|
|
|
|
#endif /* __cplusplus */
|
|
|
|
|
|
|
|
#ifndef _libncftp_ftp_c_
|
|
|
|
extern char gLibNcFTPVersion[64];
|
|
|
|
#endif
|
|
|
|
|
|
|
|
#ifndef _libncftp_errno_c_
|
|
|
|
extern int gLibNcFTP_Uses_Me_To_Quiet_Variable_Unused_Warnings;
|
|
|
|
#endif
|
|
|
|
|
|
|
|
#if (defined(__GNUC__)) && (__GNUC__ >= 2)
|
|
|
|
# ifndef UNUSED
|
|
|
|
# define UNUSED(a) a __attribute__ ((unused))
|
|
|
|
# endif
|
|
|
|
# define LIBNCFTP_USE_VAR(a)
|
|
|
|
#else
|
|
|
|
# define LIBNCFTP_USE_VAR(a) gLibNcFTP_Uses_Me_To_Quiet_Variable_Unused_Warnings = (a == 0)
|
|
|
|
# ifndef UNUSED
|
|
|
|
# define UNUSED(a) a
|
|
|
|
# endif
|
|
|
|
#endif
|
|
|
|
|
|
|
|
/* Public routines */
|
|
|
|
void FTPAbortDataTransfer(const FTPCIPtr cip);
|
|
|
|
int FTPChdir(const FTPCIPtr cip, const char *const cdCwd);
|
|
|
|
int FTPChdirAndGetCWD(const FTPCIPtr cip, const char *const cdCwd, char *const newCwd, const size_t newCwdSize);
|
|
|
|
int FTPChdir3(FTPCIPtr cip, const char *const cdCwd, char *const newCwd, const size_t newCwdSize, int flags);
|
|
|
|
int FTPChmod(const FTPCIPtr cip, const char *const pattern, const char *const mode, const int doGlob);
|
|
|
|
int FTPCloseHost(const FTPCIPtr cip);
|
|
|
|
int FTPCmd(const FTPCIPtr cip, const char *const cmdspec, ...)
|
|
|
|
#if (defined(__GNUC__)) && (__GNUC__ >= 2)
|
|
|
|
__attribute__ ((format (printf, 2, 3)))
|
|
|
|
#endif
|
|
|
|
;
|
|
|
|
int FTPDecodeURL(const FTPCIPtr cip, char *const url, LineListPtr cdlist, char *const fn, const size_t fnsize, int *const xtype, int *const wantnlst);
|
|
|
|
int FTPDelete(const FTPCIPtr cip, const char *const pattern, const int recurse, const int doGlob);
|
|
|
|
int FTPFileExists(const FTPCIPtr cip, const char *const file);
|
|
|
|
int FTPFileModificationTime(const FTPCIPtr cip, const char *const file, time_t *const mdtm);
|
|
|
|
int FTPFileSize(const FTPCIPtr cip, const char *const file, longest_int *const size, const int type);
|
|
|
|
int FTPFileSizeAndModificationTime(const FTPCIPtr cip, const char *const file, longest_int *const size, const int type, time_t *const mdtm);
|
|
|
|
int FTPFileType(const FTPCIPtr cip, const char *const file, int *const ftype);
|
|
|
|
int FTPGetCWD(const FTPCIPtr cip, char *const newCwd, const size_t newCwdSize);
|
|
|
|
int FTPGetFiles3(const FTPCIPtr cip, const char *pattern, const char *const dstdir, const int recurse, int doGlob, const int xtype, const int resumeflag, int appendflag, const int deleteflag, const int tarflag, const ConfirmResumeDownloadProc resumeProc, int reserved);
|
|
|
|
int FTPGetOneFile3(const FTPCIPtr cip, const char *const file, const char *const dstfile, const int xtype, const int fdtouse, const int resumeflag, const int appendflag, const int deleteflag, const ConfirmResumeDownloadProc resumeProc, int reserved);
|
|
|
|
int FTPInitConnectionInfo(const FTPLIPtr lip, const FTPCIPtr cip, size_t bufsize);
|
|
|
|
int FTPInitLibrary(const FTPLIPtr lip);
|
|
|
|
int FTPIsDir(const FTPCIPtr cip, const char *const dir);
|
|
|
|
int FTPIsRegularFile(const FTPCIPtr cip, const char *const file);
|
|
|
|
int FTPList(const FTPCIPtr cip, const int outfd, const int longMode, const char *const lsflag);
|
|
|
|
int FTPListToMemory(const FTPCIPtr cip, const char *const pattern, const LineListPtr llines, const char *const lsflags);
|
|
|
|
int FTPLocalGlob(FTPCIPtr cip, LineListPtr fileList, const char *pattern, int doGlob);
|
|
|
|
int FTPLoginHost(const FTPCIPtr cip);
|
|
|
|
int FTPMkdir(const FTPCIPtr cip, const char *const newDir, const int recurse);
|
|
|
|
int FTPMkdir2(const FTPCIPtr cip, const char *const newDir, const int recurse, const char *const curDir);
|
|
|
|
int FTPOpenHost(const FTPCIPtr cip);
|
|
|
|
int FTPOpenHostNoLogin(const FTPCIPtr cip);
|
|
|
|
void FTPPerror(const FTPCIPtr cip, const int err, const int eerr, const char *const s1, const char *const s2);
|
|
|
|
int FTPPutOneFile3(const FTPCIPtr cip, const char *const file, const char *const dstfile, const int xtype, const int fdtouse, const int appendflag, const char *const tmppfx, const char *const tmpsfx, const int resumeflag, const int deleteflag, const ConfirmResumeUploadProc resumeProc, int reserved);
|
|
|
|
int FTPPutFiles3(const FTPCIPtr cip, const char *const pattern, const char *const dstdir, const int recurse, const int doGlob, const int xtype, int appendflag, const char *const tmppfx, const char *const tmpsfx, const int resumeflag, const int deleteflag, const ConfirmResumeUploadProc resumeProc, int reserved);
|
|
|
|
int FTPRemoteGlob(FTPCIPtr cip, LineListPtr fileList, const char *pattern, int doGlob);
|
|
|
|
int FTPRename(const FTPCIPtr cip, const char *const oldname, const char *const newname);
|
|
|
|
int FTPRmdir(const FTPCIPtr cip, const char *const pattern, const int recurse, const int doGlob);
|
|
|
|
void FTPShutdownHost(const FTPCIPtr cip);
|
|
|
|
const char *FTPStrError(int e);
|
|
|
|
int FTPSymlink(const FTPCIPtr cip, const char *const lfrom, const char *const lto);
|
|
|
|
int FTPUmask(const FTPCIPtr cip, const char *const umsk);
|
|
|
|
int FTPUtime(const FTPCIPtr cip, const char *const file, time_t actime, time_t modtime, time_t crtime);
|
|
|
|
|
|
|
|
/* LineList routines */
|
|
|
|
int CopyLineList(LineListPtr, LineListPtr);
|
|
|
|
void DisposeLineListContents(LineListPtr);
|
|
|
|
void InitLineList(LineListPtr);
|
|
|
|
LinePtr RemoveLine(LineListPtr, LinePtr);
|
|
|
|
LinePtr AddLine(LineListPtr, const char *);
|
|
|
|
|
|
|
|
/* Other routines that might be useful. */
|
|
|
|
char *StrDup(const char *);
|
|
|
|
char *FGets(char *, size_t, FILE *);
|
|
|
|
void GetHomeDir(char *, size_t);
|
|
|
|
void GetUsrName(char *, size_t);
|
|
|
|
void Scramble(unsigned char *dst, size_t dsize, unsigned char *src, char *key);
|
|
|
|
time_t UnMDTMDate(char *);
|
|
|
|
int MkDirs(const char *const, int mode1);
|
|
|
|
char *GetPass(const char *const prompt);
|
|
|
|
int FilenameExtensionIndicatesASCII(const char *const pathName, const char *const extnList);
|
|
|
|
void StrRemoveTrailingSlashes(char *dst);
|
|
|
|
#if defined(WIN32) || defined(_WINDOWS)
|
|
|
|
char *StrFindLocalPathDelim(const char *src);
|
|
|
|
char *StrRFindLocalPathDelim(const char *src);
|
|
|
|
void StrRemoveTrailingLocalPathDelim(char *dst);
|
|
|
|
void TVFSPathToLocalPath(char *dst);
|
|
|
|
void LocalPathToTVFSPath(char *dst);
|
|
|
|
int gettimeofday(struct timeval *const tp, void *junk);
|
|
|
|
void WinSleep(unsigned int seconds);
|
|
|
|
#endif
|
|
|
|
|
|
|
|
#ifdef HAVE_SIGACTION
|
|
|
|
void (*NcSignal(int signum, void (*handler)(int)))(int);
|
|
|
|
#elif !defined(NcSignal)
|
|
|
|
# define NcSignal signal
|
|
|
|
#endif
|
|
|
|
|
|
|
|
/* Obselete routines. */
|
|
|
|
int FTPGetOneFile(const FTPCIPtr cip, const char *const file, const char *const dstfile);
|
|
|
|
int FTPGetOneFile2(const FTPCIPtr cip, const char *const file, const char *const dstfile, const int xtype, const int fdtouse, const int resumeflag, const int appendflag);
|
|
|
|
int FTPGetFiles(const FTPCIPtr cip, const char *const pattern, const char *const dstdir, const int recurse, const int doGlob);
|
|
|
|
int FTPGetFiles2(const FTPCIPtr cip, const char *const pattern, const char *const dstdir, const int recurse, const int doGlob, const int xtype, const int resumeflag, const int appendflag);
|
|
|
|
int FTPGetOneFileAscii(const FTPCIPtr cip, const char *const file, const char *const dstfile);
|
|
|
|
int FTPGetFilesAscii(const FTPCIPtr cip, const char *const pattern, const char *const dstdir, const int recurse, const int doGlob);
|
|
|
|
int FTPPutOneFile(const FTPCIPtr cip, const char *const file, const char *const dstfile);
|
|
|
|
int FTPPutOneFile2(const FTPCIPtr cip, const char *const file, const char *const dstfile, const int xtype, const int fdtouse, const int appendflag, const char *const tmppfx, const char *const tmpsfx);
|
|
|
|
int FTPPutFiles(const FTPCIPtr cip, const char *const pattern, const char *const dstdir, const int recurse, const int doGlob);
|
|
|
|
int FTPPutFiles2(const FTPCIPtr cip, const char *const pattern, const char *const dstdir, const int recurse, const int doGlob, const int xtype, const int appendflag, const char *const tmppfx, const char *const tmpsfx);
|
|
|
|
int FTPPutOneFileAscii(const FTPCIPtr cip, const char *const file, const char *const dstfile);
|
|
|
|
int FTPPutFilesAscii(const FTPCIPtr cip, const char *const pattern, const char *const dstdir, const int recurse, const int doGlob);
|
|
|
|
|
|
|
|
/* Private routines, or stuff for testing */
|
|
|
|
char *FTPGetLocalCWD(char *buf, size_t size);
|
|
|
|
int FTPQueryFeatures(const FTPCIPtr);
|
|
|
|
int FTPMListOneFile(const FTPCIPtr cip, const char *const file, const MLstItemPtr mlip);
|
|
|
|
void FTPInitializeOurHostName(const FTPLIPtr);
|
|
|
|
void FTPInitializeAnonPassword(const FTPLIPtr);
|
|
|
|
int FTPListToMemory2(const FTPCIPtr cip, const char *const pattern, const LineListPtr llines, const char *const lsflags, const int blanklines, int *const tryMLSD);
|
|
|
|
void FTPInitIOTimer(const FTPCIPtr);
|
|
|
|
int FTPStartDataCmd(const FTPCIPtr, int, int, longest_int, const char *,...)
|
|
|
|
#if (defined(__GNUC__)) && (__GNUC__ >= 2)
|
|
|
|
__attribute__ ((format (printf, 5, 6)))
|
|
|
|
#endif
|
|
|
|
;
|
|
|
|
void FTPStartIOTimer(const FTPCIPtr);
|
|
|
|
void FTPStopIOTimer(const FTPCIPtr);
|
|
|
|
void FTPUpdateIOTimer(const FTPCIPtr);
|
|
|
|
int FTPSetTransferType(const FTPCIPtr, int);
|
|
|
|
int FTPEndDataCmd(const FTPCIPtr, int);
|
|
|
|
int FTPRemoteHelp(const FTPCIPtr, const char *const, const LineListPtr);
|
|
|
|
int FTPCmdNoResponse(const FTPCIPtr, const char *const cmdspec,...)
|
|
|
|
#if (defined(__GNUC__)) && (__GNUC__ >= 2)
|
|
|
|
__attribute__ ((format (printf, 2, 3)))
|
|
|
|
#endif
|
|
|
|
;
|
|
|
|
int WaitResponse(const FTPCIPtr, unsigned int);
|
|
|
|
int FTPLocalRecursiveFileList(FTPCIPtr, LineListPtr, FileInfoListPtr);
|
|
|
|
int FTPLocalRecursiveFileList2(FTPCIPtr cip, LineListPtr fileList, FileInfoListPtr files, int erelative);
|
|
|
|
int FTPRemoteRecursiveFileList(FTPCIPtr, LineListPtr, FileInfoListPtr);
|
|
|
|
int FTPRemoteRecursiveFileList1(FTPCIPtr, char *const, FileInfoListPtr);
|
|
|
|
int FTPRebuildConnectionInfo(const FTPLIPtr lip, const FTPCIPtr cip);
|
|
|
|
int FTPFileExistsStat(const FTPCIPtr cip, const char *const file);
|
|
|
|
int FTPFileExistsNlst(const FTPCIPtr cip, const char *const file);
|
|
|
|
int FTPFileExists2(const FTPCIPtr cip, const char *const file, const int tryMDTM, const int trySIZE, const int tryMLST, const int trySTAT, const int tryNLST);
|
|
|
|
int FTPFtw(const FTPCIPtr cip, const char *const dir, FTPFtwProc proc, int maxdepth);
|
|
|
|
int BufferGets(char *, size_t, int, char *, char **, char **, size_t);
|
|
|
|
void DisposeFileInfoListContents(FileInfoListPtr);
|
|
|
|
void InitFileInfoList(FileInfoListPtr);
|
|
|
|
void InitFileInfo(FileInfoPtr);
|
|
|
|
FileInfoPtr RemoveFileInfo(FileInfoListPtr, FileInfoPtr);
|
|
|
|
FileInfoPtr AddFileInfo(FileInfoListPtr, FileInfoPtr);
|
|
|
|
void SortFileInfoList(FileInfoListPtr, int, int);
|
|
|
|
void VectorizeFileInfoList(FileInfoListPtr);
|
|
|
|
void UnvectorizeFileInfoList(FileInfoListPtr);
|
|
|
|
int ComputeRNames(FileInfoListPtr, const char *, int, int);
|
|
|
|
int ComputeLNames(FileInfoListPtr, const char *, const char *, int);
|
|
|
|
int ConcatFileInfoList(FileInfoListPtr, FileInfoListPtr);
|
|
|
|
int ConcatFileToFileInfoList(FileInfoListPtr, char *);
|
|
|
|
int LineListToFileInfoList(LineListPtr, FileInfoListPtr);
|
|
|
|
int LineToFileInfoList(LinePtr, FileInfoListPtr);
|
|
|
|
void URLCopyToken(char *, size_t, const char *, size_t);
|
|
|
|
int UnMlsT(const char *const, const MLstItemPtr);
|
|
|
|
int UnMlsD(FileInfoListPtr, LineListPtr);
|
|
|
|
int UnLslR(FileInfoListPtr, LineListPtr, int);
|
|
|
|
void TraceResponse(const FTPCIPtr, ResponsePtr);
|
|
|
|
void PrintResponse(const FTPCIPtr, LineListPtr);
|
|
|
|
void DoneWithResponse(const FTPCIPtr, ResponsePtr);
|
|
|
|
ResponsePtr InitResponse(void);
|
|
|
|
void ReInitResponse(const FTPCIPtr, ResponsePtr);
|
|
|
|
int GetTelnetString(const FTPCIPtr, char *, size_t, FILE *, FILE *);
|
|
|
|
int GetResponse(const FTPCIPtr, ResponsePtr);
|
|
|
|
int RCmd(const FTPCIPtr, ResponsePtr, const char *, ...)
|
|
|
|
#if (defined(__GNUC__)) && (__GNUC__ >= 2)
|
|
|
|
__attribute__ ((format (printf, 3, 4)))
|
|
|
|
#endif
|
|
|
|
;
|
|
|
|
|
|
|
|
#ifdef __cplusplus
|
|
|
|
}
|
|
|
|
#endif /* __cplusplus */
|
|
|
|
|
|
|
|
#endif /* _ncftp_h_ */
|