ipxe/src/net/tcp/ftp.c

#include <stddef.h>
#include <stdlib.h>
#include <stdio.h>
#include <string.h>
#include <assert.h>
#include <errno.h>
#include <byteswap.h>
#include <gpxe/async.h>
#include <gpxe/buffer.h>
#include <gpxe/uri.h>
#include <gpxe/download.h>
#include <gpxe/tcp.h>
#include <gpxe/ftp.h>

/** @file
 *
 * File transfer protocol
 *
 */

/*****************************************************************************
 *
 * FTP control channel
 *
 */

/** FTP control channel strings
 *
 * These are used as printf() format strings.  Since only one of them
 * (RETR) takes an argument, we always supply that argument to the
 * snprintf() call.
 */
static const char * ftp_strings[] = {
	[FTP_CONNECT]	= "",
	[FTP_USER]	= "USER anonymous\r\n",
	[FTP_PASS]	= "PASS etherboot@etherboot.org\r\n",
	[FTP_TYPE]	= "TYPE I\r\n",
	[FTP_PASV]	= "PASV\r\n",
	[FTP_RETR]	= "RETR %s\r\n", 
	[FTP_QUIT]	= "QUIT\r\n",
	[FTP_DONE]	= "",
};

/**
 * Get FTP request from control stream application
 *
 * @v app		Stream application
 * @ret ftp		FTP request
 */
static inline struct ftp_request *
stream_to_ftp ( struct stream_application *app ) {
	return container_of ( app, struct ftp_request, stream );
}

/**
 * Mark FTP operation as complete
 *
 * @v ftp		FTP request
 * @v rc		Return status code
 */
static void ftp_done ( struct ftp_request *ftp, int rc ) {

	DBGC ( ftp, "FTP %p completed with status %d\n", ftp, rc );

	/* Close both stream connections */
	stream_close ( &ftp->stream );
	stream_close ( &ftp->stream_data );

	/* Mark asynchronous operation as complete */
	async_done ( &ftp->async, rc );
}

/**
 * Parse FTP byte sequence value
 *
 * @v text		Text string
 * @v value		Value buffer
 * @v len		Length of value buffer
 *
 * This parses an FTP byte sequence value (e.g. the "aaa,bbb,ccc,ddd"
 * form for IP addresses in PORT commands) into a byte sequence.  @c
 * *text will be updated to point beyond the end of the parsed byte
 * sequence.
 *
 * This function is safe in the presence of malformed data, though the
 * output is undefined.
 */
static void ftp_parse_value ( char **text, uint8_t *value, size_t len ) {
	do {
		*(value++) = strtoul ( *text, text, 10 );
		if ( **text )
			(*text)++;
	} while ( --len );
}

/**
 * Handle an FTP control channel response
 *
 * @v ftp		FTP request
 *
 * This is called once we have received a complete response line.
 */
static void ftp_reply ( struct ftp_request *ftp ) {
	char status_major = ftp->status_text[0];

	DBGC ( ftp, "FTP %p received status %s\n", ftp, ftp->status_text );

	/* Ignore "intermediate" responses (1xx codes) */
	if ( status_major == '1' )
		return;

	/* Anything other than success (2xx) or, in the case of a
	 * repsonse to a "USER" command, a password prompt (3xx), is a
	 * fatal error.
	 */
	if ( ! ( ( status_major == '2' ) ||
		 ( ( status_major == '3' ) && ( ftp->state == FTP_USER ) ) ) ){
		/* Flag protocol error and close connections */
		ftp_done ( ftp, -EPROTO );
	}

	/* Open passive connection when we get "PASV" response */
	if ( ftp->state == FTP_PASV ) {
		char *ptr = ftp->passive_text;
		union {
			struct sockaddr_in sin;
			struct sockaddr sa;
		} sa;
		int rc;

		sa.sin.sin_family = AF_INET;
		ftp_parse_value ( &ptr, ( uint8_t * ) &sa.sin.sin_addr,
				  sizeof ( sa.sin.sin_addr ) );
		ftp_parse_value ( &ptr, ( uint8_t * ) &sa.sin.sin_port,
				  sizeof ( sa.sin.sin_port ) );
		if ( ( rc = tcp_open ( &ftp->stream_data ) ) != 0 ) {
			DBGC ( ftp, "FTP %p could not open data connection\n",
			       ftp );
			ftp_done ( ftp, rc );
			return;
		}
		if ( ( rc = stream_connect ( &ftp->stream_data,
					     &sa.sa ) ) != 0 ){
			DBGC ( ftp, "FTP %p could not make data connection\n",
			       ftp );
			ftp_done ( ftp, rc );
			return;
		}
	}

	/* Move to next state */
	if ( ftp->state < FTP_DONE )
		ftp->state++;
	ftp->already_sent = 0;

	if ( ftp->state < FTP_DONE ) {
		DBGC ( ftp, "FTP %p sending ", ftp );
		DBGC ( ftp, ftp_strings[ftp->state], ftp->uri->path );
	}

	return;
}

/**
 * Handle new data arriving on FTP control channel
 *
 * @v app		Stream application
 * @v data		New data
 * @v len		Length of new data
 *
 * Data is collected until a complete line is received, at which point
 * its information is passed to ftp_reply().
 */
static void ftp_newdata ( struct stream_application *app,
			  void *data, size_t len ) {
	struct ftp_request *ftp = stream_to_ftp ( app );
	char *recvbuf = ftp->recvbuf;
	size_t recvsize = ftp->recvsize;
	char c;
	
	while ( len-- ) {
		c = * ( ( char * ) data++ );
		switch ( c ) {
		case '\r' :
		case '\n' :
			/* End of line: call ftp_reply() to handle
			 * completed reply.  Avoid calling ftp_reply()
			 * twice if we receive both \r and \n.
			 */
			if ( recvsize == 0 )
				ftp_reply ( ftp );
			/* Start filling up the status code buffer */
			recvbuf = ftp->status_text;
			recvsize = sizeof ( ftp->status_text ) - 1;
			break;
		case '(' :
			/* Start filling up the passive parameter buffer */
			recvbuf = ftp->passive_text;
			recvsize = sizeof ( ftp->passive_text ) - 1;
			break;
		case ')' :
			/* Stop filling the passive parameter buffer */
			recvsize = 0;
			break;
		default :
			/* Fill up buffer if applicable */
			if ( recvsize > 0 ) {
				*(recvbuf++) = c;
				recvsize--;
			}
			break;
		}
	}

	/* Store for next invocation */
	ftp->recvbuf = recvbuf;
	ftp->recvsize = recvsize;
}

/**
 * Handle acknowledgement of data sent on FTP control channel
 *
 * @v app		Stream application
 */
static void ftp_acked ( struct stream_application *app, size_t len ) {
	struct ftp_request *ftp = stream_to_ftp ( app );
	
	/* Mark off ACKed portion of the currently-transmitted data */
	ftp->already_sent += len;
}

/**
 * Construct data to send on FTP control channel
 *
 * @v app		Stream application
 * @v buf		Temporary data buffer
 * @v len		Length of temporary data buffer
 */
static void ftp_senddata ( struct stream_application *app,
			   void *buf, size_t len ) {
	struct ftp_request *ftp = stream_to_ftp ( app );

	/* Send the as-yet-unACKed portion of the string for the
	 * current state.
	 */
	len = snprintf ( buf, len, ftp_strings[ftp->state], ftp->uri->path );
	stream_send ( app, buf + ftp->already_sent, len - ftp->already_sent );
}

/**
 * Handle control channel being closed
 *
 * @v app		Stream application
 *
 * When the control channel is closed, the data channel must also be
 * closed, if it is currently open.
 */
static void ftp_closed ( struct stream_application *app, int rc ) {
	struct ftp_request *ftp = stream_to_ftp ( app );

	DBGC ( ftp, "FTP %p control connection closed: %s\n",
	       ftp, strerror ( rc ) );

	/* Complete FTP operation */
	ftp_done ( ftp, rc );
}

/** FTP control channel operations */
static struct stream_application_operations ftp_stream_operations = {
	.closed		= ftp_closed,
	.acked		= ftp_acked,
	.newdata	= ftp_newdata,
	.senddata	= ftp_senddata,
};

/*****************************************************************************
 *
 * FTP data channel
 *
 */

/**
 * Get FTP request from data stream application
 *
 * @v app		Stream application
 * @ret ftp		FTP request
 */
static inline struct ftp_request *
stream_to_ftp_data ( struct stream_application *app ) {
	return container_of ( app, struct ftp_request, stream_data );
}

/**
 * Handle data channel being closed
 *
 * @v app		Stream application
 *
 * When the data channel is closed, the control channel should be left
 * alone; the server will send a completion message via the control
 * channel which we'll pick up.
 *
 * If the data channel is closed due to an error, we abort the request.
 */
static void ftp_data_closed ( struct stream_application *app, int rc ) {
	struct ftp_request *ftp = stream_to_ftp_data ( app );

	DBGC ( ftp, "FTP %p data connection closed: %s\n",
	       ftp, strerror ( rc ) );
	
	/* If there was an error, close control channel and record status */
	if ( rc )
		ftp_done ( ftp, rc );
}

/**
 * Handle new data arriving on the FTP data channel
 *
 * @v app		Stream application
 * @v data		New data
 * @v len		Length of new data
 */
static void ftp_data_newdata ( struct stream_application *app,
			       void *data, size_t len ) {
	struct ftp_request *ftp = stream_to_ftp_data ( app );
	int rc;

	/* Fill data buffer */
	if ( ( rc = fill_buffer ( ftp->buffer, data,
				  ftp->buffer->fill, len ) ) != 0 ){
		DBGC ( ftp, "FTP %p failed to fill data buffer: %s\n",
		       ftp, strerror ( rc ) );
		ftp_done ( ftp, rc );
		return;
	}
}

/** FTP data channel operations */
static struct stream_application_operations ftp_data_stream_operations = {
	.closed		= ftp_data_closed,
	.newdata	= ftp_data_newdata,
};

/*****************************************************************************
 *
 * API
 *
 */

/**
 * Reap asynchronous operation
 *
 * @v async		Asynchronous operation
 */
static void ftp_reap ( struct async *async ) {
	struct ftp_request *ftp =
		container_of ( async, struct ftp_request, async );

	free ( ftp );
}

/** FTP asynchronous operations */
static struct async_operations ftp_async_operations = {
	.reap = ftp_reap,
};

/**
 * Initiate an FTP connection
 *
 * @v uri		Uniform Resource Identifier
 * @v buffer		Buffer into which to download file
 * @v parent		Parent asynchronous operation
 * @ret rc		Return status code
 */
int ftp_get ( struct uri *uri, struct buffer *buffer, struct async *parent ) {
	struct ftp_request *ftp = NULL;
	int rc;

	/* Sanity checks */
	if ( ! uri->path ) {
		rc = -EINVAL;
		goto err;
	}

	/* Allocate and populate FTP structure */
	ftp = malloc ( sizeof ( *ftp ) );
	if ( ! ftp ) {
		rc = -ENOMEM;
		goto err;
	}
	memset ( ftp, 0, sizeof ( *ftp ) );
	ftp->uri = uri;
	ftp->buffer = buffer;
	ftp->state = FTP_CONNECT;
	ftp->already_sent = 0;
	ftp->recvbuf = ftp->status_text;
	ftp->recvsize = sizeof ( ftp->status_text ) - 1;
	ftp->stream.op = &ftp_stream_operations;
	ftp->stream_data.op = &ftp_data_stream_operations;

#warning "Quick name resolution hack"
	union {
		struct sockaddr sa;
		struct sockaddr_in sin;
	} server;
	server.sin.sin_port = htons ( FTP_PORT );
	server.sin.sin_family = AF_INET;
	if ( inet_aton ( uri->host, &server.sin.sin_addr ) == 0 ) {
		rc = -EINVAL;
		goto err;
	}

	DBGC ( ftp, "FTP %p fetching %s\n", ftp, ftp->uri->path );

	if ( ( rc = tcp_open ( &ftp->stream ) ) != 0 )
		goto err;
	if ( ( rc = stream_connect ( &ftp->stream, &server.sa ) ) != 0 )
		goto err;

	async_init ( &ftp->async, &ftp_async_operations, parent );
	return 0;

 err:
	DBGC ( ftp, "FTP %p could not create request: %s\n", 
	       ftp, strerror ( rc ) );
	free ( ftp );
	return rc;
}

/** HTTP download protocol */
struct download_protocol ftp_download_protocol __download_protocol = {
	.name = "ftp",
	.start_download = ftp_get,
};