mirror of
https://github.com/curl/curl.git
synced 2026-08-25 20:43:32 +03:00
protocol source, all about protocols and uri schemes
Add protocol.h and protocol.c containing all about libcurl's known URI schemes and their protocol handlers (so they exist). Moves the scheme definitions from the various sources files into protocol.c. Schemes are known and used, even of the protocol handler is not build or just not implemented at all. Closes #20906
This commit is contained in:
Stefan Eissing
Daniel Stenberg
parent
32531f20f9
commit
eb14705280
42 changed files with 1089 additions and 992 deletions
135
lib/ftp.h
135
lib/ftp.h
|
|
@ -25,73 +25,11 @@
|
|||
***************************************************************************/
|
||||
#include "curl_setup.h"
|
||||
|
||||
#include "pingpong.h"
|
||||
|
||||
extern const struct Curl_scheme Curl_scheme_ftp;
|
||||
extern const struct Curl_scheme Curl_scheme_ftps;
|
||||
|
||||
#ifndef CURL_DISABLE_FTP
|
||||
extern const struct Curl_protocol Curl_protocol_ftp;
|
||||
|
||||
bool ftp_conns_match(struct connectdata *needle, struct connectdata *conn);
|
||||
|
||||
#endif /* CURL_DISABLE_FTP */
|
||||
|
||||
/****************************************************************************
|
||||
* FTP unique setup
|
||||
***************************************************************************/
|
||||
enum {
|
||||
FTP_STOP, /* do nothing state, stops the state machine */
|
||||
FTP_WAIT220, /* waiting for the initial 220 response immediately after
|
||||
a connect */
|
||||
FTP_AUTH,
|
||||
FTP_USER,
|
||||
FTP_PASS,
|
||||
FTP_ACCT,
|
||||
FTP_PBSZ,
|
||||
FTP_PROT,
|
||||
FTP_CCC,
|
||||
FTP_PWD,
|
||||
FTP_SYST,
|
||||
FTP_NAMEFMT,
|
||||
FTP_QUOTE, /* waiting for a response to a command sent in a quote list */
|
||||
FTP_RETR_PREQUOTE,
|
||||
FTP_STOR_PREQUOTE,
|
||||
FTP_LIST_PREQUOTE,
|
||||
FTP_POSTQUOTE,
|
||||
FTP_CWD, /* change directory */
|
||||
FTP_MKD, /* if the directory did not exist */
|
||||
FTP_MDTM, /* to figure out the datestamp */
|
||||
FTP_TYPE, /* to set type when doing a head-like request */
|
||||
FTP_LIST_TYPE, /* set type when about to do a directory list */
|
||||
FTP_RETR_LIST_TYPE,
|
||||
FTP_RETR_TYPE, /* set type when about to RETR a file */
|
||||
FTP_STOR_TYPE, /* set type when about to STOR a file */
|
||||
FTP_SIZE, /* get the remote file's size for head-like request */
|
||||
FTP_RETR_SIZE, /* get the remote file's size for RETR */
|
||||
FTP_STOR_SIZE, /* get the size for STOR */
|
||||
FTP_REST, /* when used to check if the server supports it in head-like */
|
||||
FTP_RETR_REST, /* when asking for "resume" in for RETR */
|
||||
FTP_PORT, /* generic state for PORT, LPRT and EPRT, check count1 */
|
||||
FTP_PRET, /* generic state for PRET RETR, PRET STOR and PRET LIST/NLST */
|
||||
FTP_PASV, /* generic state for PASV and EPSV, check count1 */
|
||||
FTP_LIST, /* generic state for LIST, NLST or a custom list command */
|
||||
FTP_RETR,
|
||||
FTP_STOR, /* generic state for STOR and APPE */
|
||||
FTP_QUIT,
|
||||
FTP_LAST /* never used */
|
||||
};
|
||||
typedef unsigned char ftpstate; /* use the enum values */
|
||||
|
||||
struct ftp_parselist_data; /* defined later in ftplistparser.c */
|
||||
|
||||
struct ftp_wc {
|
||||
struct ftp_parselist_data *parser;
|
||||
|
||||
struct {
|
||||
curl_write_callback write_function;
|
||||
FILE *file_descriptor;
|
||||
} backup;
|
||||
};
|
||||
|
||||
typedef enum {
|
||||
FTPFILE_MULTICWD = 1, /* as defined by RFC1738 */
|
||||
FTPFILE_NOCWD = 2, /* use SIZE / RETR / STOR on the full path */
|
||||
|
|
@ -99,74 +37,7 @@ typedef enum {
|
|||
file */
|
||||
} curl_ftpfile;
|
||||
|
||||
/* This FTP struct is used in the Curl_easy. All FTP data that is
|
||||
connection-oriented must be in FTP_conn to properly deal with the fact that
|
||||
perhaps the Curl_easy is changed between the times the connection is
|
||||
used. */
|
||||
struct FTP {
|
||||
char *path; /* points to the urlpieces struct field */
|
||||
char *pathalloc; /* if non-NULL a pointer to an allocated path */
|
||||
|
||||
/* transfer a file/body or not, done as a typedefed enum to make debuggers
|
||||
display the full symbol and not the numerical value */
|
||||
curl_pp_transfer transfer;
|
||||
curl_off_t downloadsize;
|
||||
};
|
||||
|
||||
/* one struct entry for each path component (of 'rawpath') */
|
||||
struct pathcomp {
|
||||
int start; /* start column */
|
||||
int len; /* length in bytes */
|
||||
};
|
||||
|
||||
/* ftp_conn is used for struct connection-oriented data in the connectdata
|
||||
struct */
|
||||
struct ftp_conn {
|
||||
struct pingpong pp;
|
||||
char *account;
|
||||
char *alternative_to_user;
|
||||
char *entrypath; /* the PWD reply when we logged on */
|
||||
const char *file; /* url-decoded filename (or path), points into rawpath */
|
||||
char *rawpath; /* URL decoded, allocated, version of the path */
|
||||
struct pathcomp *dirs; /* allocated array for path components */
|
||||
char *prevpath; /* url-decoded conn->path from the previous transfer */
|
||||
char transfertype; /* set by ftp_transfertype for use by Curl_client_write()a
|
||||
and others (A/I or zero) */
|
||||
char *server_os; /* The target server operating system. */
|
||||
curl_off_t known_filesize; /* file size is different from -1, if wildcard
|
||||
LIST parsing was done and wc_statemach set
|
||||
it */
|
||||
int count1; /* general purpose counter for the state machine */
|
||||
int count2; /* general purpose counter for the state machine */
|
||||
int count3; /* general purpose counter for the state machine */
|
||||
unsigned short dirdepth; /* number of entries used in the 'dirs' array,
|
||||
< FTP_MAX_DIR_DEPTH */
|
||||
unsigned short cwdcount; /* number of CWD commands issued,
|
||||
< FTP_MAX_DIR_DEPTH */
|
||||
unsigned char state; /* (ftpstate enum) always use ftp.c:state() to change
|
||||
state! */
|
||||
unsigned char use_ssl; /* if AUTH TLS is to be attempted etc, for FTP or
|
||||
IMAP or POP3 or others! (type: curl_usessl)*/
|
||||
unsigned char ccc; /* ccc level for this connection */
|
||||
BIT(ftp_trying_alternative);
|
||||
BIT(dont_check); /* Set to TRUE to prevent the final (post-transfer)
|
||||
file size and 226/250 status check. It should still
|
||||
read the line, ignore the result. */
|
||||
BIT(ctl_valid); /* Tells Curl_ftp_quit() whether or not to do anything. If
|
||||
the connection has timed out or been closed, this
|
||||
should be FALSE when it gets to Curl_ftp_quit() */
|
||||
BIT(cwddone); /* if it has been determined that the proper CWD combo
|
||||
already has been done */
|
||||
BIT(cwdfail); /* set TRUE if a CWD command fails, as then we must prevent
|
||||
caching the current directory */
|
||||
BIT(wait_data_conn); /* this is set TRUE if data connection is waited */
|
||||
BIT(shutdown); /* connection is being shutdown, e.g. QUIT */
|
||||
};
|
||||
|
||||
/* meta key for storing `struct FTP` as easy meta data */
|
||||
#define CURL_META_FTP_EASY "meta:proto:ftp:easy"
|
||||
/* meta key for storing `struct ftp_conn` as connection meta data */
|
||||
#define CURL_META_FTP_CONN "meta:proto:ftp:conn"
|
||||
#endif /* CURL_DISABLE_FTP */
|
||||
|
||||
#define DEFAULT_ACCEPT_TIMEOUT 60000 /* milliseconds == one minute */
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue