4e20d73bb5
will enable us to cascade async operations, which is necessary in order to properly support DNS. (For example, an HTTP request may have to redirect to a new location and will have to perform a new DNS lookup, so we can't just rely on doing the name lookup at the time of parsing the initial URL). Anything other than HTTP is probably broken right now; I'll fix the others up asap.
73 lines
1.4 KiB
C
73 lines
1.4 KiB
C
#ifndef _GPXE_FTP_H
|
|
#define _GPXE_FTP_H
|
|
|
|
/** @file
|
|
*
|
|
* File transfer protocol
|
|
*
|
|
*/
|
|
|
|
#include <stdint.h>
|
|
#include <gpxe/async.h>
|
|
#include <gpxe/tcp.h>
|
|
|
|
struct buffer;
|
|
|
|
/** FTP default port */
|
|
#define FTP_PORT 21
|
|
|
|
/**
|
|
* FTP states
|
|
*
|
|
* These @b must be sequential, i.e. a successful FTP session must
|
|
* pass through each of these states in order.
|
|
*/
|
|
enum ftp_state {
|
|
FTP_CONNECT = 0,
|
|
FTP_USER,
|
|
FTP_PASS,
|
|
FTP_TYPE,
|
|
FTP_PASV,
|
|
FTP_RETR,
|
|
FTP_QUIT,
|
|
FTP_DONE,
|
|
};
|
|
|
|
/**
|
|
* An FTP request
|
|
*
|
|
*/
|
|
struct ftp_request {
|
|
/** Server address */
|
|
struct sockaddr_tcpip server;
|
|
/** File to download */
|
|
const char *filename;
|
|
/** Data buffer to fill */
|
|
struct buffer *buffer;
|
|
|
|
/** Current state */
|
|
enum ftp_state state;
|
|
/** Amount of current message already transmitted */
|
|
size_t already_sent;
|
|
/** Buffer to be filled with data received via the control channel */
|
|
char *recvbuf;
|
|
/** Remaining size of recvbuf */
|
|
size_t recvsize;
|
|
/** FTP status code, as text */
|
|
char status_text[4];
|
|
/** Passive-mode parameters, as text */
|
|
char passive_text[24]; /* "aaa,bbb,ccc,ddd,eee,fff" */
|
|
|
|
/** TCP application for the control channel */
|
|
struct tcp_application tcp;
|
|
/** TCP application for the data channel */
|
|
struct tcp_application tcp_data;
|
|
|
|
/** Asynchronous operation for this FTP operation */
|
|
struct async async;
|
|
};
|
|
|
|
struct async_operation * ftp_get ( struct ftp_request *ftp );
|
|
|
|
#endif /* _GPXE_FTP_H */
|