]> git.sesse.net Git - vlc/blob - modules/access/directory.c
directory: assert() at critical places.
[vlc] / modules / access / directory.c
1 /*****************************************************************************
2  * directory.c: expands a directory (directory: access plug-in)
3  *****************************************************************************
4  * Copyright (C) 2002-2007 the VideoLAN team
5  * $Id$
6  *
7  * Authors: Derk-Jan Hartman <hartman at videolan dot org>
8  *          RĂ©mi Denis-Courmont
9  *
10  * This program is free software; you can redistribute it and/or modify
11  * it under the terms of the GNU General Public License as published by
12  * the Free Software Foundation; either version 2 of the License, or
13  * (at your option) any later version.
14  *
15  * This program is distributed in the hope that it will be useful,
16  * but WITHOUT ANY WARRANTY; without even the implied warranty of
17  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
18  * GNU General Public License for more details.
19  *
20  * You should have received a copy of the GNU General Public License
21  * along with this program; if not, write to the Free Software
22  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
23  *****************************************************************************/
24
25 /*****************************************************************************
26  * Preamble
27  *****************************************************************************/
28
29 #ifdef HAVE_CONFIG_H
30 # include "config.h"
31 #endif
32
33 #include <assert.h>
34 #include <vlc_common.h>
35 #include <vlc_plugin.h>
36 #warning playlist code must not be used here.
37 #include <vlc_playlist.h>
38 #include <vlc_input.h>
39 #include <vlc_access.h>
40 #include <vlc_demux.h>
41
42 #ifdef HAVE_SYS_TYPES_H
43 #   include <sys/types.h>
44 #endif
45 #ifdef HAVE_SYS_STAT_H
46 #   include <sys/stat.h>
47 #endif
48 #ifdef HAVE_ERRNO_H
49 #   include <errno.h>
50 #endif
51 #ifdef HAVE_FCNTL_H
52 #   include <fcntl.h>
53 #endif
54
55 #ifdef HAVE_UNISTD_H
56 #   include <unistd.h>
57 #elif defined( WIN32 ) && !defined( UNDER_CE )
58 #   include <io.h>
59 #elif defined( UNDER_CE )
60 #   define strcoll strcmp
61 #endif
62
63 #ifdef HAVE_DIRENT_H
64 #   include <dirent.h>
65 #endif
66
67 #include <vlc_charset.h>
68
69 /*****************************************************************************
70  * Module descriptor
71  *****************************************************************************/
72 static int  Open ( vlc_object_t * );
73 static void Close( vlc_object_t * );
74
75 static int  DemuxOpen ( vlc_object_t * );
76
77 #define RECURSIVE_TEXT N_("Subdirectory behavior")
78 #define RECURSIVE_LONGTEXT N_( \
79         "Select whether subdirectories must be expanded.\n" \
80         "none: subdirectories do not appear in the playlist.\n" \
81         "collapse: subdirectories appear but are expanded on first play.\n" \
82         "expand: all subdirectories are expanded.\n" )
83
84 static const char *const psz_recursive_list[] = { "none", "collapse", "expand" };
85 static const char *const psz_recursive_list_text[] = {
86     N_("none"), N_("collapse"), N_("expand") };
87
88 #define IGNORE_TEXT N_("Ignored extensions")
89 #define IGNORE_LONGTEXT N_( \
90         "Files with these extensions will not be added to playlist when " \
91         "opening a directory.\n" \
92         "This is useful if you add directories that contain playlist files " \
93         "for instance. Use a comma-separated list of extensions." )
94
95 vlc_module_begin();
96     set_category( CAT_INPUT );
97     set_shortname( N_("Directory" ) );
98     set_subcategory( SUBCAT_INPUT_ACCESS );
99     set_description( N_("Standard filesystem directory input") );
100     set_capability( "access", 55 );
101     add_shortcut( "directory" );
102     add_shortcut( "dir" );
103     add_shortcut( "file" );
104     add_string( "recursive", "expand" , NULL, RECURSIVE_TEXT,
105                 RECURSIVE_LONGTEXT, false );
106       change_string_list( psz_recursive_list, psz_recursive_list_text, 0 );
107     add_string( "ignore-filetypes", "m3u,db,nfo,jpg,gif,sfv,txt,sub,idx,srt,cue",
108                 NULL, IGNORE_TEXT, IGNORE_LONGTEXT, false );
109     set_callbacks( Open, Close );
110
111     add_submodule();
112         set_description( "Directory EOF");
113         set_capability( "demux", 0 );
114         set_callbacks( DemuxOpen, NULL );
115 vlc_module_end();
116
117
118 /*****************************************************************************
119  * Local prototypes, constants, structures
120  *****************************************************************************/
121
122 enum
123 {
124     MODE_EXPAND,
125     MODE_COLLAPSE,
126     MODE_NONE
127 };
128
129 typedef struct stat_list_t stat_list_t;
130
131 static ssize_t Read( access_t *, uint8_t *, size_t );
132 static ssize_t ReadNull( access_t *, uint8_t *, size_t );
133 static int Control( access_t *, int, va_list );
134
135 static int Demux( demux_t *p_demux );
136 static int DemuxControl( demux_t *p_demux, int i_query, va_list args );
137
138
139 static int ReadDir( access_t *, playlist_t *, const char *psz_name,
140                     int i_mode, playlist_item_t *, input_item_t *,
141                     DIR *handle, stat_list_t *stats );
142
143 static DIR *OpenDir (vlc_object_t *obj, const char *psz_name);
144
145 /*****************************************************************************
146  * Open: open the directory
147  *****************************************************************************/
148 static int Open( vlc_object_t *p_this )
149 {
150     access_t *p_access = (access_t*)p_this;
151
152     if( !p_access->psz_path )
153         return VLC_EGENERIC;
154
155     struct stat st;
156     if( !stat( p_access->psz_path, &st ) && !S_ISDIR( st.st_mode ) )
157         return VLC_EGENERIC;
158
159     DIR *handle = OpenDir (p_this, p_access->psz_path);
160     if (handle == NULL)
161         return VLC_EGENERIC;
162
163     p_access->p_sys = (access_sys_t *)handle;
164
165     p_access->pf_read  = Read;
166     p_access->pf_block = NULL;
167     p_access->pf_seek  = NULL;
168     p_access->pf_control= Control;
169
170     /* Force a demux */
171     free( p_access->psz_demux );
172     p_access->psz_demux = strdup( "directory" );
173
174     return VLC_SUCCESS;
175 }
176
177 /*****************************************************************************
178  * Close: close the target
179  *****************************************************************************/
180 static void Close( vlc_object_t * p_this )
181 {
182     access_t *p_access = (access_t*)p_this;
183     DIR *handle = (DIR *)p_access->p_sys;
184     closedir (handle);
185 }
186
187 /*****************************************************************************
188  * ReadNull: read the directory
189  *****************************************************************************/
190 static ssize_t ReadNull( access_t *p_access, uint8_t *p_buffer, size_t i_len)
191 {
192     /* Return fake data */
193     memset( p_buffer, 0, i_len );
194     return i_len;
195 }
196
197 /*****************************************************************************
198  * Read: read the directory
199  *****************************************************************************/
200 static ssize_t Read( access_t *p_access, uint8_t *p_buffer, size_t i_len)
201 {
202     char               *psz;
203     int                 i_mode;
204     char               *psz_name = strdup (p_access->psz_path);
205
206     if( psz_name == NULL )
207         return VLC_ENOMEM;
208
209     playlist_t         *p_playlist = pl_Yield( p_access );
210     input_thread_t     *p_input = (input_thread_t*)vlc_object_find( p_access, VLC_OBJECT_INPUT, FIND_PARENT );
211
212     playlist_item_t    *p_item_in_category;
213     input_item_t       *p_current_input;
214     playlist_item_t    *p_current;
215
216     if( !p_input )
217     {
218         msg_Err( p_access, "unable to find input (internal error)" );
219         pl_Release( p_access );
220         return VLC_ENOOBJ;
221     }
222
223     p_current_input = input_GetItem( p_input );
224     p_current = playlist_ItemGetByInput( p_playlist, p_current_input, pl_Unlocked );
225
226     if( !p_current )
227     {
228         msg_Err( p_access, "unable to find item in playlist" );
229         vlc_object_release( p_input );
230         pl_Release( p_playlist );
231         return VLC_ENOOBJ;
232     }
233
234     /* Remove the ending '/' char */
235     if( psz_name[0] )
236     {
237         char *ptr = psz_name + strlen (psz_name);
238         switch (*--ptr)
239         {
240             case '/':
241             case '\\':
242                 *ptr = '\0';
243         }
244     }
245
246     /* Handle mode */
247     psz = var_CreateGetString( p_access, "recursive" );
248     if( *psz == '\0' || !strncmp( psz, "none" , 4 )  )
249         i_mode = MODE_NONE;
250     else if( !strncmp( psz, "collapse", 8 )  )
251         i_mode = MODE_COLLAPSE;
252     else
253         i_mode = MODE_EXPAND;
254     free( psz );
255
256     p_current->p_input->i_type = ITEM_TYPE_DIRECTORY;
257     p_item_in_category = playlist_ItemToNode( p_playlist, p_current,
258                                               pl_Unlocked );
259     assert( p_item_in_category );
260
261     ReadDir( p_access, p_playlist, psz_name, i_mode,
262              p_item_in_category,
263              p_current_input, (DIR *)p_access->p_sys, NULL );
264
265     playlist_Signal( p_playlist );
266
267     free( psz_name );
268     vlc_object_release( p_input );
269     pl_Release( p_access );
270
271     /* Return fake data forever */
272     p_access->pf_read = ReadNull;
273     return -1;
274 }
275
276 /*****************************************************************************
277  * Control:
278  *****************************************************************************/
279 static int Control( access_t *p_access, int i_query, va_list args )
280 {
281     bool   *pb_bool;
282     int          *pi_int;
283     int64_t      *pi_64;
284
285     switch( i_query )
286     {
287         /* */
288         case ACCESS_CAN_SEEK:
289         case ACCESS_CAN_FASTSEEK:
290         case ACCESS_CAN_PAUSE:
291         case ACCESS_CAN_CONTROL_PACE:
292             pb_bool = (bool*)va_arg( args, bool* );
293             *pb_bool = false;    /* FIXME */
294             break;
295
296         /* */
297         case ACCESS_GET_MTU:
298             pi_int = (int*)va_arg( args, int * );
299             *pi_int = 0;
300             break;
301
302         case ACCESS_GET_PTS_DELAY:
303             pi_64 = (int64_t*)va_arg( args, int64_t * );
304             *pi_64 = DEFAULT_PTS_DELAY * 1000;
305             break;
306
307         /* */
308         case ACCESS_SET_PAUSE_STATE:
309         case ACCESS_GET_TITLE_INFO:
310         case ACCESS_SET_TITLE:
311         case ACCESS_SET_SEEKPOINT:
312         case ACCESS_SET_PRIVATE_ID_STATE:
313         case ACCESS_GET_CONTENT_TYPE:
314             return VLC_EGENERIC;
315
316         default:
317             msg_Warn( p_access, "unimplemented query in control" );
318             return VLC_EGENERIC;
319     }
320     return VLC_SUCCESS;
321 }
322
323 /*****************************************************************************
324  * DemuxOpen:
325  *****************************************************************************/
326 static int DemuxOpen ( vlc_object_t *p_this )
327 {
328     demux_t *p_demux = (demux_t*)p_this;
329
330     if( strcmp( p_demux->psz_demux, "directory" ) )
331         return VLC_EGENERIC;
332
333     p_demux->pf_demux   = Demux;
334     p_demux->pf_control = DemuxControl;
335     return VLC_SUCCESS;
336 }
337
338 /*****************************************************************************
339  * Demux: EOF
340  *****************************************************************************/
341 static int Demux( demux_t *p_demux )
342 {
343     return 0;
344 }
345
346 /*****************************************************************************
347  * DemuxControl:
348  *****************************************************************************/
349 static int DemuxControl( demux_t *p_demux, int i_query, va_list args )
350 {
351     return demux_vaControlHelper( p_demux->s, 0, 0, 0, 1, i_query, args );
352 }
353
354
355 static int Sort (const char **a, const char **b)
356 {
357     return strcoll (*a, *b);
358 }
359
360 struct stat_list_t
361 {
362     stat_list_t *parent;
363     struct stat st;
364 };
365
366
367 /*****************************************************************************
368  * ReadDir: read a directory and add its content to the list
369  *****************************************************************************/
370 static int ReadDir( access_t *p_access, playlist_t *p_playlist,
371                     const char *psz_name,
372                     int i_mode,
373                     playlist_item_t *p_parent_category,
374                     input_item_t *p_current_input,
375                     DIR *handle, stat_list_t *stparent )
376 {
377     char **pp_dir_content = NULL;
378     int             i_dir_content, i, i_return = VLC_SUCCESS;
379     playlist_item_t *p_node;
380
381     if( !vlc_object_alive( p_access ) )
382         return VLC_EGENERIC;
383
384     if( !vlc_object_alive( p_playlist ) )
385         return VLC_EGENERIC;
386
387     char **ppsz_extensions = NULL;
388     int i_extensions = 0;
389     char *psz_ignore;
390
391     struct stat_list_t stself;
392 #ifndef WIN32
393     int fd = dirfd (handle);
394
395     if ((fd == -1) || fstat (fd, &stself.st))
396     {
397         msg_Err (p_playlist, "cannot stat `%s': %m", psz_name);
398         return VLC_EGENERIC;
399     }
400
401     for (stat_list_t *stats = stparent; stats != NULL; stats = stats->parent)
402     {
403         if ((stself.st.st_ino == stats->st.st_ino)
404          && (stself.st.st_dev == stats->st.st_dev))
405         {
406             msg_Warn (p_playlist,
407                       "ignoring infinitely recursive directory `%s'",
408                       psz_name);
409             return VLC_SUCCESS;
410         }
411     }
412 #else
413         /* Windows has st_dev (driver letter - 'A'), but it zeroes st_ino,
414          * so that the test above will always incorrectly succeed.
415          * Besides, Windows does not have dirfd(). */
416 #endif
417
418     stself.parent = stparent;
419
420     /* Get the first directory entry */
421     i_dir_content = utf8_loaddir (handle, &pp_dir_content, NULL, Sort);
422     if( i_dir_content == -1 )
423     {
424         msg_Err (p_playlist, "cannot read `%s': %m", psz_name);
425         return VLC_EGENERIC;
426     }
427     else if( i_dir_content <= 0 )
428     {
429         /* directory is empty */
430         msg_Dbg( p_playlist, "%s directory is empty", psz_name );
431         free( pp_dir_content );
432         return VLC_SUCCESS;
433     }
434
435     /* Build array with ignores */
436     psz_ignore = var_CreateGetString( p_playlist, "ignore-filetypes" );
437     if( psz_ignore && *psz_ignore )
438     {
439         char *psz_parser = psz_ignore;
440         int a;
441
442         for( a = 0; psz_parser[a] != '\0'; a++ )
443         {
444             if( psz_parser[a] == ',' ) i_extensions++;
445         }
446
447         ppsz_extensions = (char **)calloc (i_extensions, sizeof (char *));
448
449         for( a = 0; a < i_extensions; a++ )
450         {
451             char *tmp, *ptr;
452
453             while( psz_parser[0] != '\0' && psz_parser[0] == ' ' ) psz_parser++;
454             ptr = strchr( psz_parser, ',');
455             tmp = ( ptr == NULL )
456                  ? strdup( psz_parser )
457                  : strndup( psz_parser, ptr - psz_parser );
458
459             ppsz_extensions[a] = tmp;
460             psz_parser = ptr + 1;
461         }
462     }
463     free( psz_ignore );
464
465     /* While we still have entries in the directory */
466     for( i = 0; i < i_dir_content; i++ )
467     {
468         const char *entry = pp_dir_content[i];
469         int i_size_entry = strlen( psz_name ) +
470                            strlen( entry ) + 2 + 7 /* strlen("file://") */;
471         char psz_uri[i_size_entry];
472
473         sprintf( psz_uri, "%s/%s", psz_name, entry);
474
475         /* if it starts with '.' then forget it */
476         if (entry[0] != '.')
477         {
478             DIR *subdir = (i_mode != MODE_COLLAPSE)
479                     ? OpenDir (VLC_OBJECT (p_playlist), psz_uri) : NULL;
480
481             if (subdir != NULL) /* Recurse into subdirectory */
482             {
483                 if( i_mode == MODE_NONE )
484                 {
485                     msg_Dbg( p_playlist, "skipping subdirectory `%s'",
486                              psz_uri );
487                     closedir (subdir);
488                     continue;
489                 }
490
491                 msg_Dbg (p_playlist, "creating subdirectory %s", psz_uri);
492
493                 PL_LOCK;
494                 p_node = playlist_NodeCreate( p_playlist, entry,
495                                               p_parent_category,
496                                               PLAYLIST_NO_REBUILD, NULL );
497                 PL_UNLOCK;
498                 assert( p_node );
499                 /* If we had the parent in category, the it is now node.
500                  * Else, we still don't have  */
501                 i_return = ReadDir( p_access, p_playlist, psz_uri , MODE_EXPAND,
502                                     p_parent_category ? p_node : NULL,
503                                     p_current_input, subdir, &stself );
504                 closedir (subdir);
505                 if (i_return)
506                     break; // error :-(
507             }
508             else
509             {
510                 input_item_t *p_input;
511
512                 if( i_extensions > 0 )
513                 {
514                     const char *psz_dot = strrchr (entry, '.' );
515                     if( psz_dot++ && *psz_dot )
516                     {
517                         int a;
518                         for( a = 0; a < i_extensions; a++ )
519                         {
520                             if( !strcmp( psz_dot, ppsz_extensions[a] ) )
521                                 break;
522                         }
523                         if( a < i_extensions )
524                         {
525                             msg_Dbg( p_playlist, "ignoring file %s", psz_uri );
526                             continue;
527                         }
528                     }
529                 }
530
531                 memmove (psz_uri + 7, psz_uri, sizeof (psz_uri) - 7);
532                 memcpy (psz_uri, "file://", 7);
533                 p_input = input_ItemNewWithType( p_playlist,
534                                                  psz_uri, entry, 0, NULL,
535                                                  -1, ITEM_TYPE_FILE );
536                 if (p_input != NULL)
537                 {
538                     if( p_current_input )
539                         input_ItemCopyOptions( p_current_input, p_input );
540                     assert( p_parent_category );
541                     int i_ret = playlist_BothAddInput( p_playlist, p_input,
542                                            p_parent_category,
543                                            PLAYLIST_APPEND|PLAYLIST_PREPARSE|
544                                            PLAYLIST_NO_REBUILD,
545                                            PLAYLIST_END, NULL, NULL,
546                                            pl_Unlocked );
547                     vlc_gc_decref( p_input );
548                     if( i_ret != VLC_SUCCESS )
549                         return VLC_EGENERIC;
550                 }
551             }
552         }
553     }
554
555     for( i = 0; i < i_extensions; i++ )
556         free( ppsz_extensions[i] );
557     free( ppsz_extensions );
558
559     for( i = 0; i < i_dir_content; i++ )
560         free( pp_dir_content[i] );
561     free( pp_dir_content );
562
563     return i_return;
564 }
565
566
567 static DIR *OpenDir (vlc_object_t *obj, const char *path)
568 {
569     msg_Dbg (obj, "opening directory `%s'", path);
570     DIR *handle = utf8_opendir (path);
571     if (handle == NULL)
572     {
573         int err = errno;
574         if (err != ENOTDIR)
575             msg_Err (obj, "%s: %m", path);
576         else
577             msg_Dbg (obj, "skipping non-directory `%s'", path);
578         errno = err;
579
580         return NULL;
581     }
582     return handle;
583 }