1 /*****************************************************************************
2 * ftp.c: FTP input module
3 *****************************************************************************
4 * Copyright (C) 2001-2006 the VideoLAN team
5 * Copyright © 2006 Rémi Denis-Courmont
8 * Authors: Laurent Aimar <fenrir@via.ecp.fr> - original code
9 * Rémi Denis-Courmont <rem # videolan.org> - EPSV support
11 * This program is free software; you can redistribute it and/or modify
12 * it under the terms of the GNU General Public License as published by
13 * the Free Software Foundation; either version 2 of the License, or
14 * (at your option) any later version.
16 * This program is distributed in the hope that it will be useful,
17 * but WITHOUT ANY WARRANTY; without even the implied warranty of
18 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19 * GNU General Public License for more details.
21 * You should have received a copy of the GNU General Public License
22 * along with this program; if not, write to the Free Software
23 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
24 *****************************************************************************/
26 /*****************************************************************************
28 *****************************************************************************/
33 #include <vlc_common.h>
34 #include <vlc_plugin.h>
38 #include <vlc_access.h>
39 #include <vlc_dialog.h>
41 #include <vlc_network.h>
44 #include <vlc_charset.h>
47 # define IPPORT_FTP 21u
50 /*****************************************************************************
52 *****************************************************************************/
53 static int InOpen ( vlc_object_t * );
54 static void InClose( vlc_object_t * );
55 static int OutOpen ( vlc_object_t * );
56 static void OutClose( vlc_object_t * );
58 #define CACHING_TEXT N_("Caching value in ms")
59 #define CACHING_LONGTEXT N_( \
60 "Caching value for FTP streams. This " \
61 "value should be set in milliseconds." )
62 #define USER_TEXT N_("FTP user name")
63 #define USER_LONGTEXT N_("User name that will " \
64 "be used for the connection.")
65 #define PASS_TEXT N_("FTP password")
66 #define PASS_LONGTEXT N_("Password that will be " \
67 "used for the connection.")
68 #define ACCOUNT_TEXT N_("FTP account")
69 #define ACCOUNT_LONGTEXT N_("Account that will be " \
70 "used for the connection.")
73 set_shortname( "FTP" )
74 set_description( N_("FTP input") )
75 set_capability( "access", 0 )
76 set_category( CAT_INPUT )
77 set_subcategory( SUBCAT_INPUT_ACCESS )
78 add_integer( "ftp-caching", 2 * DEFAULT_PTS_DELAY / 1000, NULL,
79 CACHING_TEXT, CACHING_LONGTEXT, true )
81 add_string( "ftp-user", "anonymous", NULL, USER_TEXT, USER_LONGTEXT,
83 add_string( "ftp-pwd", "anonymous@example.com", NULL, PASS_TEXT,
84 PASS_LONGTEXT, false )
85 add_string( "ftp-account", "anonymous", NULL, ACCOUNT_TEXT,
86 ACCOUNT_LONGTEXT, false )
88 set_callbacks( InOpen, InClose )
91 set_shortname( "FTP" )
92 set_description( N_("FTP upload output") )
93 set_capability( "sout access", 0 )
94 set_category( CAT_SOUT )
95 set_subcategory( SUBCAT_SOUT_ACO )
97 set_callbacks( OutOpen, OutClose )
100 /*****************************************************************************
102 *****************************************************************************/
103 static ssize_t Read( access_t *, uint8_t *, size_t );
104 static ssize_t Write( sout_access_out_t *, block_t * );
105 static int Seek( access_t *, uint64_t );
106 static int OutSeek( sout_access_out_t *, off_t );
107 static int Control( access_t *, int, va_list );
116 char sz_epsv_ip[NI_MAXNUMERICHOST];
120 #define GET_OUT_SYS( p_this ) \
121 ((access_sys_t *)(((sout_access_out_t *)(p_this))->p_sys))
123 static int ftp_SendCommand( vlc_object_t *, access_sys_t *, const char *, ... );
124 static int ftp_ReadCommand( vlc_object_t *, access_sys_t *, int *, char ** );
125 static int ftp_StartStream( vlc_object_t *, access_sys_t *, uint64_t );
126 static int ftp_StopStream ( vlc_object_t *, access_sys_t * );
128 static int Login( vlc_object_t *p_access, access_sys_t *p_sys )
133 /* *** Open a TCP connection with server *** */
134 int fd = p_sys->fd_cmd = net_ConnectTCP( p_access, p_sys->url.psz_host,
138 msg_Err( p_access, "connection failed" );
139 dialog_Fatal( p_access, _("Network interaction failed"), "%s",
140 _("VLC could not connect with the given server.") );
144 while( ftp_ReadCommand( p_access, p_sys, &i_answer, NULL ) == 1 );
146 if( i_answer / 100 != 2 )
148 msg_Err( p_access, "connection rejected" );
149 dialog_Fatal( p_access, _("Network interaction failed"), "%s",
150 _("VLC's connection to the given server was rejected.") );
154 msg_Dbg( p_access, "connection accepted (%d)", i_answer );
156 if( p_sys->url.psz_username && *p_sys->url.psz_username )
157 psz = strdup( p_sys->url.psz_username );
159 psz = var_CreateGetString( p_access, "ftp-user" );
163 if( ftp_SendCommand( p_access, p_sys, "USER %s", psz ) < 0 ||
164 ftp_ReadCommand( p_access, p_sys, &i_answer, NULL ) < 0 )
171 switch( i_answer / 100 )
174 msg_Dbg( p_access, "user accepted" );
177 msg_Dbg( p_access, "password needed" );
178 if( p_sys->url.psz_password && *p_sys->url.psz_password )
179 psz = strdup( p_sys->url.psz_password );
181 psz = var_CreateGetString( p_access, "ftp-pwd" );
185 if( ftp_SendCommand( p_access, p_sys, "PASS %s", psz ) < 0 ||
186 ftp_ReadCommand( p_access, p_sys, &i_answer, NULL ) < 0 )
193 switch( i_answer / 100 )
196 msg_Dbg( p_access, "password accepted" );
199 msg_Dbg( p_access, "account needed" );
200 psz = var_CreateGetString( p_access, "ftp-account" );
201 if( ftp_SendCommand( p_access, p_sys, "ACCT %s",
203 ftp_ReadCommand( p_access, p_sys, &i_answer, NULL ) < 0 )
210 if( i_answer / 100 != 2 )
212 msg_Err( p_access, "account rejected" );
213 dialog_Fatal( p_access,
214 _("Network interaction failed"),
215 "%s", _("Your account was rejected.") );
218 msg_Dbg( p_access, "account accepted" );
222 msg_Err( p_access, "password rejected" );
223 dialog_Fatal( p_access, _("Network interaction failed"),
224 "%s", _("Your password was rejected.") );
229 msg_Err( p_access, "user rejected" );
230 dialog_Fatal( p_access, _("Network interaction failed"), "%s",
231 _("Your connection attempt to the server was rejected.") );
238 static int Connect( vlc_object_t *p_access, access_sys_t *p_sys )
240 if( Login( p_access, p_sys ) < 0 )
243 /* Extended passive mode */
244 if( ftp_SendCommand( p_access, p_sys, "EPSV ALL" ) < 0 )
246 msg_Err( p_access, "cannot request extended passive mode" );
247 net_Close( p_sys->fd_cmd );
251 if( ftp_ReadCommand( p_access, p_sys, NULL, NULL ) == 2 )
253 if( net_GetPeerAddress( p_sys->fd_cmd, p_sys->sz_epsv_ip, NULL ) )
255 net_Close( p_sys->fd_cmd );
261 /* If ESPV ALL fails, we fallback to PASV.
262 * We have to restart the connection in case there is a NAT that
263 * understands EPSV ALL in the way, and hence won't allow PASV on
264 * the initial connection.
266 msg_Info( p_access, "FTP Extended passive mode disabled" );
267 net_Close( p_sys->fd_cmd );
269 if( Login( p_access, p_sys ) )
271 net_Close( p_sys->fd_cmd );
276 /* check binary mode support */
277 if( ftp_SendCommand( p_access, p_sys, "TYPE I" ) < 0 ||
278 ftp_ReadCommand( p_access, p_sys, NULL, NULL ) != 2 )
280 msg_Err( p_access, "cannot set binary transfer mode" );
281 net_Close( p_sys->fd_cmd );
289 static int parseURL( vlc_url_t *url, const char *path )
294 /* *** Parse URL and get server addr/port and path *** */
295 while( *path == '/' )
298 vlc_UrlParse( url, path, 0 );
300 if( url->psz_host == NULL || *url->psz_host == '\0' )
303 if( url->i_port <= 0 )
304 url->i_port = IPPORT_FTP; /* default port */
306 if( url->psz_path == NULL )
308 /* FTP URLs are relative to user's default directory (RFC1738 §3.2)
309 For absolute path use ftp://foo.bar//usr/local/etc/filename */
310 /* FIXME: we should issue a series of CWD, one per slash */
313 assert( url->psz_path[0] == '/' );
317 char *type = strstr( url->psz_path, ";type=" );
321 if( strchr( "iI", type[6] ) == NULL )
322 return VLC_EGENERIC; /* ASCII and directory not supported */
324 decode_URI( url->psz_path );
325 /* FIXME: check for UTF-8 support, otherwise only ASCII is allowed */
326 EnsureUTF8( url->psz_path );
331 /****************************************************************************
332 * Open: connect to ftp server and ask for file
333 ****************************************************************************/
334 static int InOpen( vlc_object_t *p_this )
336 access_t *p_access = (access_t*)p_this;
341 STANDARD_READ_ACCESS_INIT
344 p_sys->directory = false;
346 if( parseURL( &p_sys->url, p_access->psz_location ) )
349 if( Connect( p_this, p_sys ) )
353 if( p_sys->url.psz_path == NULL )
354 p_sys->directory = true;
356 if( ftp_SendCommand( p_this, p_sys, "SIZE %s", p_sys->url.psz_path ) < 0
357 || ftp_ReadCommand( p_this, p_sys, NULL, &psz_arg ) != 2 )
359 msg_Dbg( p_access, "cannot get file size" );
360 msg_Dbg( p_access, "will try to get directory contents" );
361 if( ftp_SendCommand( p_this, p_sys, "CWD %s", p_sys->url.psz_path ) < 0
362 || ftp_ReadCommand( p_this, p_sys, NULL, &psz_arg ) != 2 )
364 msg_Err( p_access, "file or directory doesn't exist" );
365 net_Close( p_sys->fd_cmd );
368 p_sys->directory = true;
372 p_access->info.i_size = atoll( &psz_arg[4] );
374 msg_Dbg( p_access, "file size: %"PRIu64, p_access->info.i_size );
377 /* Start the 'stream' */
378 if( ftp_StartStream( p_this, p_sys, 0 ) < 0 )
380 msg_Err( p_access, "cannot retrieve file" );
381 net_Close( p_sys->fd_cmd );
385 /* Update default_pts to a suitable value for ftp access */
386 var_Create( p_access, "ftp-caching", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT );
391 vlc_UrlClean( &p_sys->url );
396 static int OutOpen( vlc_object_t *p_this )
398 sout_access_out_t *p_access = (sout_access_out_t *)p_this;
401 p_sys = calloc( 1, sizeof( *p_sys ) );
409 if( parseURL( &p_sys->url, p_access->psz_path ) )
411 if( p_sys->url.psz_path == NULL )
413 msg_Err( p_this, "no filename specified" );
417 if( Connect( p_this, p_sys ) )
420 /* Start the 'stream' */
421 if( ftp_StartStream( p_this, p_sys, 0 ) < 0 )
423 msg_Err( p_access, "cannot store file" );
424 net_Close( p_sys->fd_cmd );
428 p_access->pf_seek = OutSeek;
429 p_access->pf_write = Write;
430 p_access->p_sys = (void *)p_sys;
435 vlc_UrlClean( &p_sys->url );
440 /*****************************************************************************
441 * Close: free unused data structures
442 *****************************************************************************/
443 static void Close( vlc_object_t *p_access, access_sys_t *p_sys )
445 msg_Dbg( p_access, "stopping stream" );
446 ftp_StopStream( p_access, p_sys );
448 if( ftp_SendCommand( p_access, p_sys, "QUIT" ) < 0 )
450 msg_Warn( p_access, "cannot quit" );
454 ftp_ReadCommand( p_access, p_sys, NULL, NULL );
456 net_Close( p_sys->fd_cmd );
459 vlc_UrlClean( &p_sys->url );
463 static void InClose( vlc_object_t *p_this )
465 Close( p_this, ((access_t *)p_this)->p_sys);
468 static void OutClose( vlc_object_t *p_this )
470 Close( p_this, GET_OUT_SYS(p_this));
474 /*****************************************************************************
475 * Seek: try to go at the right place
476 *****************************************************************************/
477 static int _Seek( vlc_object_t *p_access, access_sys_t *p_sys, uint64_t i_pos )
479 msg_Dbg( p_access, "seeking to %"PRIu64, i_pos );
481 ftp_StopStream( (vlc_object_t *)p_access, p_sys );
482 if( ftp_StartStream( (vlc_object_t *)p_access, p_sys, i_pos ) < 0 )
488 static int Seek( access_t *p_access, uint64_t i_pos )
490 int val = _Seek( (vlc_object_t *)p_access, p_access->p_sys, i_pos );
494 p_access->info.b_eof = false;
495 p_access->info.i_pos = i_pos;
500 static int OutSeek( sout_access_out_t *p_access, off_t i_pos )
502 return _Seek( (vlc_object_t *)p_access, GET_OUT_SYS( p_access ), i_pos);
505 /*****************************************************************************
507 *****************************************************************************/
508 static ssize_t Read( access_t *p_access, uint8_t *p_buffer, size_t i_len )
510 access_sys_t *p_sys = p_access->p_sys;
512 assert( p_sys->fd_data != -1 );
513 assert( !p_sys->out );
515 if( p_access->info.b_eof )
518 if( p_sys->directory )
520 char *psz_line = net_Gets( p_access, p_sys->fd_data, NULL );
523 p_access->info.b_eof = true;
528 snprintf( (char*)p_buffer, i_len, "ftp://%s:%d%s/%s\n",
529 p_sys->url.psz_host, p_sys->url.i_port,
530 p_sys->url.psz_path, psz_line );
532 return strlen( (const char *)p_buffer );
537 int i_read = net_Read( p_access, p_sys->fd_data, NULL,
538 p_buffer, i_len, false );
540 p_access->info.b_eof = true;
541 else if( i_read > 0 )
542 p_access->info.i_pos += i_read;
548 /*****************************************************************************
550 *****************************************************************************/
551 static ssize_t Write( sout_access_out_t *p_access, block_t *p_buffer )
553 access_sys_t *p_sys = GET_OUT_SYS(p_access);
556 assert( p_sys->fd_data != -1 );
558 while( p_buffer != NULL )
560 block_t *p_next = p_buffer->p_next;;
562 i_write += net_Write( p_access, p_sys->fd_data, NULL,
563 p_buffer->p_buffer, p_buffer->i_buffer );
564 block_Release( p_buffer );
572 /*****************************************************************************
574 *****************************************************************************/
575 static int Control( access_t *p_access, int i_query, va_list args )
583 case ACCESS_CAN_SEEK:
584 pb_bool = (bool*)va_arg( args, bool* );
587 case ACCESS_CAN_FASTSEEK:
588 pb_bool = (bool*)va_arg( args, bool* );
591 case ACCESS_CAN_PAUSE:
592 pb_bool = (bool*)va_arg( args, bool* );
593 *pb_bool = true; /* FIXME */
595 case ACCESS_CAN_CONTROL_PACE:
596 pb_bool = (bool*)va_arg( args, bool* );
597 *pb_bool = true; /* FIXME */
601 case ACCESS_GET_PTS_DELAY:
602 pi_64 = (int64_t*)va_arg( args, int64_t * );
603 *pi_64 = var_GetInteger( p_access, "ftp-caching" ) * INT64_C(1000);
607 case ACCESS_SET_PAUSE_STATE:
608 pb_bool = (bool*)va_arg( args, bool* );
610 return Seek( p_access, p_access->info.i_pos );
613 case ACCESS_GET_TITLE_INFO:
614 case ACCESS_SET_TITLE:
615 case ACCESS_SET_SEEKPOINT:
616 case ACCESS_SET_PRIVATE_ID_STATE:
617 case ACCESS_GET_CONTENT_TYPE:
618 case ACCESS_GET_META:
622 msg_Warn( p_access, "unimplemented query in control: %d", i_query);
629 /*****************************************************************************
631 *****************************************************************************/
632 static int ftp_SendCommand( vlc_object_t *p_access, access_sys_t *p_sys,
633 const char *psz_fmt, ... )
638 va_start( args, psz_fmt );
639 if( vasprintf( &psz_cmd, psz_fmt, args ) == -1 )
644 msg_Dbg( p_access, "ftp_SendCommand:\"%s\"", psz_cmd);
646 if( net_Printf( p_access, p_sys->fd_cmd, NULL, "%s\r\n", psz_cmd ) < 0 )
648 msg_Err( p_access, "failed to send command" );
654 /* TODO support this s**t :
655 RFC 959 allows the client to send certain TELNET strings at any moment,
656 even in the middle of a request:
659 * \377\376x where x is one byte.
660 * \377\375x where x is one byte. The server is obliged to send \377\374x
661 * immediately after reading x.
662 * \377\374x where x is one byte.
663 * \377\373x where x is one byte. The server is obliged to send \377\376x
664 * immediately after reading x.
665 * \377x for any other byte x.
667 These strings are not part of the requests, except in the case \377\377,
668 where the request contains one \377. */
669 static int ftp_ReadCommand( vlc_object_t *p_access, access_sys_t *p_sys,
670 int *pi_answer, char **ppsz_answer )
675 psz_line = net_Gets( p_access, p_sys->fd_cmd, NULL );
676 if( psz_line == NULL || strlen( psz_line ) < 3 )
678 msg_Err( p_access, "cannot get answer" );
680 if( pi_answer ) *pi_answer = 500;
681 if( ppsz_answer ) *ppsz_answer = NULL;
684 msg_Dbg( p_access, "answer=%s", psz_line );
686 if( psz_line[3] == '-' ) /* Multiple response */
690 memcpy( end, psz_line, 3 );
695 char *psz_tmp = net_Gets( p_access, p_sys->fd_cmd, NULL );
697 if( psz_tmp == NULL ) /* Error */
700 if( !strncmp( psz_tmp, end, 4 ) )
709 i_answer = atoi( psz_line );
711 if( pi_answer ) *pi_answer = i_answer;
714 *ppsz_answer = psz_line;
720 return( i_answer / 100 );
723 static int ftp_StartStream( vlc_object_t *p_access, access_sys_t *p_sys,
726 char psz_ipv4[16], *psz_ip = p_sys->sz_epsv_ip;
728 char *psz_arg, *psz_parser;
731 assert( p_sys->fd_data == -1 );
733 if( ( ftp_SendCommand( p_access, p_sys, *psz_ip ? "EPSV" : "PASV" ) < 0 )
734 || ( ftp_ReadCommand( p_access, p_sys, &i_answer, &psz_arg ) != 2 ) )
736 msg_Err( p_access, "cannot set passive mode" );
740 psz_parser = strchr( psz_arg, '(' );
741 if( psz_parser == NULL )
744 msg_Err( p_access, "cannot parse passive mode response" );
750 char psz_fmt[7] = "(|||%u";
751 psz_fmt[1] = psz_fmt[2] = psz_fmt[3] = psz_parser[1];
753 if( sscanf( psz_parser, psz_fmt, &i_port ) < 1 )
756 msg_Err( p_access, "cannot parse passive mode response" );
762 unsigned a1, a2, a3, a4, p1, p2;
764 if( ( sscanf( psz_parser, "(%u,%u,%u,%u,%u,%u", &a1, &a2, &a3, &a4,
765 &p1, &p2 ) < 6 ) || ( a1 > 255 ) || ( a2 > 255 )
766 || ( a3 > 255 ) || ( a4 > 255 ) || ( p1 > 255 ) || ( p2 > 255 ) )
769 msg_Err( p_access, "cannot parse passive mode response" );
773 sprintf( psz_ipv4, "%u.%u.%u.%u", a1, a2, a3, a4 );
775 i_port = (p1 << 8) | p2;
779 msg_Dbg( p_access, "ip:%s port:%d", psz_ip, i_port );
781 if( ftp_SendCommand( p_access, p_sys, "TYPE I" ) < 0 ||
782 ftp_ReadCommand( p_access, p_sys, &i_answer, NULL ) != 2 )
784 msg_Err( p_access, "cannot set binary transfer mode" );
790 if( ftp_SendCommand( p_access, p_sys, "REST %"PRIu64, i_start ) < 0 ||
791 ftp_ReadCommand( p_access, p_sys, &i_answer, NULL ) > 3 )
793 msg_Err( p_access, "cannot set restart offset" );
798 msg_Dbg( p_access, "waiting for data connection..." );
799 p_sys->fd_data = net_ConnectTCP( p_access, psz_ip, i_port );
800 if( p_sys->fd_data < 0 )
802 msg_Err( p_access, "failed to connect with server" );
805 msg_Dbg( p_access, "connection with \"%s:%d\" successful",
808 if( p_sys->directory )
810 if( ftp_SendCommand( p_access, p_sys, "NLST" ) < 0 ||
811 ftp_ReadCommand( p_access, p_sys, NULL, &psz_arg ) > 2 )
813 msg_Err( p_access, "cannot list directory contents" );
820 assert( p_sys->url.psz_path );
821 if( ftp_SendCommand( p_access, p_sys, "%s %s",
822 p_sys->out ? "STOR" : "RETR",
823 p_sys->url.psz_path ) < 0
824 || ftp_ReadCommand( p_access, p_sys, &i_answer, NULL ) > 2 )
826 msg_Err( p_access, "cannot retrieve file" );
831 shutdown( p_sys->fd_data, p_sys->out ? SHUT_RD : SHUT_WR );
836 static int ftp_StopStream ( vlc_object_t *p_access, access_sys_t *p_sys )
838 if( ftp_SendCommand( p_access, p_sys, "ABOR" ) < 0 )
840 msg_Warn( p_access, "cannot abort file" );
841 if( p_sys->fd_data > 0 )
842 net_Close( p_sys->fd_data );
847 if( p_sys->fd_data != -1 )
849 net_Close( p_sys->fd_data );
851 /* Read the final response from RETR/STOR, i.e. 426 or 226 */
852 ftp_ReadCommand( p_access, p_sys, NULL, NULL );
854 /* Read the response from ABOR, i.e. 226 or 225 */
855 ftp_ReadCommand( p_access, p_sys, NULL, NULL );