libdvdcss.c 24.1 KB
Newer Older
1
/* libdvdcss.c: DVD reading library.
Sam Hocevar's avatar
 
Sam Hocevar committed
2
 *
3
 * Authors: Stéphane Borel <stef@via.ecp.fr>
4
 *          Sam Hocevar <sam@zoy.org>
5
 *          Håkan Hjort <d95hjort@dtek.chalmers.se>
Sam Hocevar's avatar
 
Sam Hocevar committed
6
 *
7
 * Copyright (C) 1998-2008 VideoLAN
8
 *
9
 * This library is free software; you can redistribute it and/or modify
Sam Hocevar's avatar
 
Sam Hocevar committed
10
11
12
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
13
 *
14
 * This library is distributed in the hope that it will be useful,
Sam Hocevar's avatar
 
Sam Hocevar committed
15
16
17
18
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
Diego Biurrun's avatar
Diego Biurrun committed
19
 * You should have received a copy of the GNU General Public License along
20
 * with this library; if not, write to the Free Software Foundation, Inc.,
Diego Biurrun's avatar
Diego Biurrun committed
21
 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
22
23
 */

24
/**
25
26
27
28
29
30
31
32
 * \mainpage libdvdcss developer documentation
 *
 * \section intro Introduction
 *
 * \e libdvdcss is a simple library designed for accessing DVDs like a block
 * device without having to bother about the decryption. The important features
 * are:
 * \li portability: currently supported platforms are GNU/Linux, FreeBSD,
33
 *     NetBSD, OpenBSD, BeOS, Windows 98/ME, Windows NT/2000/XP, Mac OS X,
34
 *     Solaris, HP-UX and OS/2.
35
36
37
 * \li adaptability: unlike most similar projects, libdvdcss doesn't require
 *     the region of your drive to be set and will try its best to read from
 *     the disc even in the case of a region mismatch.
38
39
40
 * \li simplicity: a DVD player can be built around the \e libdvdcss API using
 *     no more than 4 or 5 library calls.
 *
41
42
43
44
45
46
47
48
49
50
51
 * \e libdvdcss is free software, released under the General Public License.
 * This ensures that \e libdvdcss remains free and used only with free
 * software.
 *
 * \section api The libdvdcss API
 *
 * The complete \e libdvdcss programming interface is documented in the
 * dvdcss.h file.
 *
 * \section env Environment variables
 *
52
 * Some environment variables can be used to change the behavior of
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
 * \e libdvdcss without having to modify the program which uses it. These
 * variables are:
 *
 * \li \b DVDCSS_VERBOSE: sets the verbosity level.
 *     - \c 0 outputs no messages at all.
 *     - \c 1 outputs error messages to stderr.
 *     - \c 2 outputs error messages and debug messages to stderr.
 *
 * \li \b DVDCSS_METHOD: sets the authentication and decryption method
 *     that \e libdvdcss will use to read scrambled discs. Can be one
 *     of \c title, \c key or \c disc.
 *     - \c key is the default method. \e libdvdcss will use a set of
 *       calculated player keys to try and get the disc key. This can fail
 *       if the drive does not recognize any of the player keys.
 *     - \c disc is a fallback method when \c key has failed. Instead of
 *       using player keys, \e libdvdcss will crack the disc key using
 *       a brute force algorithm. This process is CPU intensive and requires
 *       64 MB of memory to store temporary data.
 *     - \c title is the fallback when all other methods have failed. It does
 *       not rely on a key exchange with the DVD drive, but rather uses a
 *       crypto attack to guess the title key. On rare cases this may fail
 *       because there is not enough encrypted data on the disc to perform
 *       a statistical attack, but in the other hand it is the only way to
 *       decrypt a DVD stored on a hard disc, or a DVD with the wrong region
 *       on an RPC2 drive.
 *
79
80
81
82
83
 * \li \b DVDCSS_RAW_DEVICE: specify the raw device to use. Exact usage will
 *     depend on your operating system, the Linux utility to set up raw devices
 *     is \c raw(8) for instance. Please note that on most operating systems,
 *     using a raw device requires highly aligned buffers: Linux requires a
 *     2048 bytes alignment (which is the size of a DVD sector).
84
 *
85
86
87
88
 * \li \b DVDCSS_CACHE: specify a directory in which to store title key
 *     values. This will speed up descrambling of DVDs which are in the
 *     cache. The DVDCSS_CACHE directory is created if it does not exist,
 *     and a subdirectory is created named after the DVD's title or
89
90
91
92
 *     manufacturing date. If DVDCSS_CACHE is not set or is empty, \e libdvdcss
 *     will use the default value which is "${HOME}/.dvdcss/" under Unix and
 *     "C:\Documents and Settings\$USER\Application Data\dvdcss\" under Win32.
 *     The special value "off" disables caching.
93
 */
Sam Hocevar's avatar
 
Sam Hocevar committed
94

95
/*
Sam Hocevar's avatar
 
Sam Hocevar committed
96
 * Preamble
97
 */
Sam Hocevar's avatar
 
Sam Hocevar committed
98
99
100
101
102
103
104
#include "config.h"

#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <sys/types.h>
#include <sys/stat.h>
105
106
107
#ifdef HAVE_SYS_PARAM_H
#   include <sys/param.h>
#endif
108
109
110
#ifdef HAVE_PWD_H
#   include <pwd.h>
#endif
Sam Hocevar's avatar
 
Sam Hocevar committed
111
#include <fcntl.h>
112
#include <errno.h>
Sam Hocevar's avatar
 
Sam Hocevar committed
113
114
115
116
117

#ifdef HAVE_UNISTD_H
#   include <unistd.h>
#endif

Christophe Massiot's avatar
Christophe Massiot committed
118
#ifdef HAVE_LIMITS_H
119
120
121
#   include <limits.h>
#endif

122
123
124
125
#if defined(_WIN32_IE) && _WIN32_IE >= 0x500
#   include <shlobj.h>
#endif

Sam Hocevar's avatar
   
Sam Hocevar committed
126
#include "dvdcss/dvdcss.h"
Sam Hocevar's avatar
 
Sam Hocevar committed
127
128
129
130
131

#include "common.h"
#include "css.h"
#include "libdvdcss.h"
#include "ioctl.h"
132
#include "device.h"
Sam Hocevar's avatar
 
Sam Hocevar committed
133

134
#ifdef HAVE_BROKEN_MKDIR
135
#include <direct.h>
136
137
138
#define mkdir(a, b) _mkdir(a)
#endif

139
140
141
142
143
144
145
146
147
148
149
150
/**
 * \brief Open a DVD device or directory and return a dvdcss instance.
 *
 * \param psz_target a string containing the target name, for instance
 *        "/dev/hdc" or "E:".
 * \return a handle to a dvdcss instance or NULL on error.
 *
 * Initialize the \e libdvdcss library and open the requested DVD device or
 * directory. \e libdvdcss checks whether ioctls can be performed on the disc,
 * and when possible, the disc key is retrieved.
 *
 * dvdcss_open() returns a handle to be used for all subsequent \e libdvdcss
151
 * calls. If an error occurred, NULL is returned.
152
 */
153
LIBDVDCSS_EXPORT dvdcss_t dvdcss_open ( char *psz_target )
Sam Hocevar's avatar
 
Sam Hocevar committed
154
{
155
    char psz_buffer[PATH_MAX];
Sam Hocevar's avatar
 
Sam Hocevar committed
156
157
158
159
    int i_ret;

    char *psz_method = getenv( "DVDCSS_METHOD" );
    char *psz_verbose = getenv( "DVDCSS_VERBOSE" );
160
    char *psz_cache = getenv( "DVDCSS_CACHE" );
161
#ifdef DVDCSS_RAW_OPEN
Sam Hocevar's avatar
 
Sam Hocevar committed
162
163
164
    char *psz_raw_device = getenv( "DVDCSS_RAW_DEVICE" );
#endif

165
    dvdcss_t dvdcss;
Sam Hocevar's avatar
 
Sam Hocevar committed
166

167
168
169
    /*
     *  Allocate the library structure
     */
Sam Hocevar's avatar
 
Sam Hocevar committed
170
171
172
173
174
175
    dvdcss = malloc( sizeof( struct dvdcss_s ) );
    if( dvdcss == NULL )
    {
        return NULL;
    }

176
177
178
    /*
     *  Initialize structure with default values
     */
179
#ifdef DVDCSS_RAW_OPEN
180
    dvdcss->i_raw_fd = -1;
181
#endif
Sam Hocevar's avatar
 
Sam Hocevar committed
182
    dvdcss->p_titles = NULL;
183
    dvdcss->psz_device = (char *)strdup( psz_target );
Sam Hocevar's avatar
 
Sam Hocevar committed
184
    dvdcss->psz_error = "no error";
185
    dvdcss->i_method = DVDCSS_METHOD_KEY;
186
    dvdcss->psz_cachefile[0] = '\0';
Sam Hocevar's avatar
 
Sam Hocevar committed
187
    dvdcss->b_debug = 0;
188
    dvdcss->b_errors = 0;
Sam Hocevar's avatar
 
Sam Hocevar committed
189

190
191
192
193
194
    /*
     *  Find verbosity from DVDCSS_VERBOSE environment variable
     */
    if( psz_verbose != NULL )
    {
195
196
        int i = atoi( psz_verbose );

197
        if( i >= 2 ) dvdcss->b_debug = i;
198
        if( i >= 1 ) dvdcss->b_errors = 1;
199
200
201
202
203
    }

    /*
     *  Find method from DVDCSS_METHOD environment variable
     */
Sam Hocevar's avatar
 
Sam Hocevar committed
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
    if( psz_method != NULL )
    {
        if( !strncmp( psz_method, "key", 4 ) )
        {
            dvdcss->i_method = DVDCSS_METHOD_KEY;
        }
        else if( !strncmp( psz_method, "disc", 5 ) )
        {
            dvdcss->i_method = DVDCSS_METHOD_DISC;
        }
        else if( !strncmp( psz_method, "title", 5 ) )
        {
            dvdcss->i_method = DVDCSS_METHOD_TITLE;
        }
        else
        {
220
221
            print_error( dvdcss, "unknown decrypt method, please choose "
                                 "from 'title', 'key' or 'disc'" );
222
            free( dvdcss->psz_device );
Sam Hocevar's avatar
 
Sam Hocevar committed
223
224
225
226
227
            free( dvdcss );
            return NULL;
        }
    }

228
229
230
231
232
    /*
     *  If DVDCSS_CACHE was not set, try to guess a default value
     */
    if( psz_cache == NULL || psz_cache[0] == '\0' )
    {
233
#if defined(_WIN32_IE) && _WIN32_IE >= 0x500
234
235
236
237
        char psz_home[MAX_PATH];

        /* Cache our keys in
         * C:\Documents and Settings\$USER\Application Data\dvdcss\ */
238
239
        if (SHGetFolderPathA (NULL, CSIDL_APPDATA | CSIDL_FLAG_CREATE,
                              NULL, SHGFP_TYPE_CURRENT, psz_home ) == S_OK)
240
        {
241
            snprintf( psz_buffer, PATH_MAX, "%s\\dvdcss", psz_home );
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
            psz_buffer[PATH_MAX-1] = '\0';
            psz_cache = psz_buffer;
        }
#else
        char *psz_home = NULL;
#   ifdef HAVE_PWD_H
        struct passwd *p_pwd;

        /* Try looking in password file for home dir. */
        p_pwd = getpwuid(getuid());
        if( p_pwd )
        {
            psz_home = p_pwd->pw_dir;
        }
#   endif

        if( psz_home == NULL )
        {
            psz_home = getenv( "HOME" );
        }
262
263
264
265
        if( psz_home == NULL )
        {
            psz_home = getenv( "USERPROFILE" );
        }
266
267
268
269

        /* Cache our keys in ${HOME}/.dvdcss/ */
        if( psz_home )
        {
KO Myung-Hun's avatar
KO Myung-Hun committed
270
271
            int home_pos = 0;

272
#ifdef __OS2__
KO Myung-Hun's avatar
KO Myung-Hun committed
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
            if( *psz_home == '/' || *psz_home == '\\')
            {
                char *psz_unixroot = getenv("UNIXROOT");

                if( psz_unixroot &&
                    psz_unixroot[0] &&
                    psz_unixroot[1] == ':'  &&
                    psz_unixroot[2] == '\0')
                {
                    strcpy( psz_buffer, psz_unixroot );
                    home_pos = 2;
                }
            }
#endif
            snprintf( psz_buffer + home_pos, PATH_MAX - home_pos,
                      "%s/.dvdcss", psz_home );
289
290
291
292
293
294
            psz_buffer[PATH_MAX-1] = '\0';
            psz_cache = psz_buffer;
        }
#endif
    }

295
296
297
298
299
    /*
     *  Find cache dir from the DVDCSS_CACHE environment variable
     */
    if( psz_cache != NULL )
    {
300
        if( psz_cache[0] == '\0' || !strcmp( psz_cache, "off" ) )
301
302
303
304
        {
            psz_cache = NULL;
        }
        /* Check that we can add the ID directory and the block filename */
Sam Hocevar's avatar
Sam Hocevar committed
305
306
        else if( strlen( psz_cache ) + 1 + 32 + 1 + (KEY_SIZE * 2) + 10 + 1
                  > PATH_MAX )
307
        {
308
            print_error( dvdcss, "cache directory name is too long" );
309
310
311
312
            psz_cache = NULL;
        }
    }

313
314
315
    /*
     *  Open device
     */
316
    _dvdcss_check( dvdcss );
317
    i_ret = _dvdcss_open( dvdcss );
Sam Hocevar's avatar
 
Sam Hocevar committed
318
319
    if( i_ret < 0 )
    {
320
        free( dvdcss->psz_device );
Sam Hocevar's avatar
 
Sam Hocevar committed
321
322
323
        free( dvdcss );
        return NULL;
    }
324

325
    dvdcss->b_scrambled = 1; /* Assume the worst */
326
    dvdcss->b_ioctls = _dvdcss_use_ioctls( dvdcss );
Sam Hocevar's avatar
 
Sam Hocevar committed
327

328
    if( dvdcss->b_ioctls )
Sam Hocevar's avatar
 
Sam Hocevar committed
329
    {
330
        i_ret = _dvdcss_test( dvdcss );
331

332
        if( i_ret == -3 )
333
        {
334
335
336
            print_debug( dvdcss, "scrambled disc on a region-free RPC-II "
                                 "drive: possible failure, but continuing "
                                 "anyway" );
337
338
        }
        else if( i_ret < 0 )
Sam Hocevar's avatar
Sam Hocevar committed
339
340
        {
            /* Disable the CSS ioctls and hope that it works? */
341
342
            print_debug( dvdcss,
                         "could not check whether the disc was scrambled" );
Sam Hocevar's avatar
Sam Hocevar committed
343
344
345
346
            dvdcss->b_ioctls = 0;
        }
        else
        {
347
348
            print_debug( dvdcss, i_ret ? "disc is scrambled"
                                       : "disc is unscrambled" );
Sam Hocevar's avatar
Sam Hocevar committed
349
350
            dvdcss->b_scrambled = i_ret;
        }
Sam Hocevar's avatar
 
Sam Hocevar committed
351
352
    }

353
    memset( dvdcss->css.p_disc_key, 0, KEY_SIZE );
Sam Hocevar's avatar
 
Sam Hocevar committed
354
    /* If disc is CSS protected and the ioctls work, authenticate the drive */
355
    if( dvdcss->b_scrambled && dvdcss->b_ioctls )
Sam Hocevar's avatar
 
Sam Hocevar committed
356
    {
357
        i_ret = _dvdcss_disckey( dvdcss );
Sam Hocevar's avatar
 
Sam Hocevar committed
358
359
360

        if( i_ret < 0 )
        {
361
            print_debug( dvdcss, "could not get disc key" );
Sam Hocevar's avatar
 
Sam Hocevar committed
362
363
364
        }
    }

Sam Hocevar's avatar
Sam Hocevar committed
365
366
367
    /* If the cache is enabled, write the cache directory tag */
    if( psz_cache )
    {
368
369
        static const char psz_tag[] =
            "Signature: 8a477f597d28d172789f06886806bc55\r\n"
Sam Hocevar's avatar
Sam Hocevar committed
370
371
372
            "# This file is a cache directory tag created by libdvdcss.\r\n"
            "# For information about cache directory tags, see:\r\n"
            "#   http://www.brynosaurus.com/cachedir/\r\n";
373
        char psz_tagfile[PATH_MAX + 1 + 12 + 1];
Sam Hocevar's avatar
Sam Hocevar committed
374
375
376
        int i_fd;

        sprintf( psz_tagfile, "%s/CACHEDIR.TAG", psz_cache );
Sam Hocevar's avatar
Sam Hocevar committed
377
        i_fd = open( psz_tagfile, O_RDWR|O_CREAT, 0644 );
Sam Hocevar's avatar
Sam Hocevar committed
378
379
        if( i_fd >= 0 )
        {
380
            size_t len = strlen(psz_tag);
381
            if( write( i_fd, psz_tag, len ) < (long)len )
382
383
384
385
            {
                print_error( dvdcss,
                             "Error writing cache directory tag, continuing..\n" );
            }
Sam Hocevar's avatar
Sam Hocevar committed
386
387
388
389
            close( i_fd );
        }
    }

390
391
392
    /* If the cache is enabled, extract a unique disc ID */
    if( psz_cache )
    {
393
        uint8_t p_sector[DVDCSS_BLOCK_SIZE];
394
        char psz_key[1 + KEY_SIZE * 2 + 1];
Ivan Kalvachev's avatar
   
Ivan Kalvachev committed
395
396
        char *psz_title;
        uint8_t *psz_serial;
397
398
        int i;

399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
        /* We read sector 0. If it starts with 0x000001ba (BE), we are
         * reading a VOB file, and we should not cache anything. */

        i_ret = dvdcss->pf_seek( dvdcss, 0 );
        if( i_ret != 0 )
        {
            goto nocache;
        }

        i_ret = dvdcss->pf_read( dvdcss, p_sector, 1 );
        if( i_ret != 1 )
        {
            goto nocache;
        }

        if( p_sector[0] == 0x00 && p_sector[1] == 0x00
             && p_sector[2] == 0x01 && p_sector[3] == 0xba )
        {
            goto nocache;
        }

420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
        /* The data we are looking for is at sector 16 (32768 bytes):
         *  - offset 40: disc title (32 uppercase chars)
         *  - offset 813: manufacturing date + serial no (16 digits) */

        i_ret = dvdcss->pf_seek( dvdcss, 16 );
        if( i_ret != 16 )
        {
            goto nocache;
        }

        i_ret = dvdcss->pf_read( dvdcss, p_sector, 1 );
        if( i_ret != 1 )
        {
            goto nocache;
        }

        /* Get the disc title */
437
        psz_title = (char *)p_sector + 40;
Michael Roitzsch's avatar
   
Michael Roitzsch committed
438
        psz_title[32] = '\0';
439
440
441

        for( i = 0 ; i < 32 ; i++ )
        {
Michael Roitzsch's avatar
   
Michael Roitzsch committed
442
            if( psz_title[i] <= ' ' )
443
            {
Michael Roitzsch's avatar
   
Michael Roitzsch committed
444
                psz_title[i] = '\0';
445
446
                break;
            }
Michael Roitzsch's avatar
   
Michael Roitzsch committed
447
            else if( psz_title[i] == '/' || psz_title[i] == '\\' )
448
            {
Michael Roitzsch's avatar
   
Michael Roitzsch committed
449
                psz_title[i] = '-';
450
451
452
            }
        }

Michael Roitzsch's avatar
   
Michael Roitzsch committed
453
        /* Get the date + serial */
Ivan Kalvachev's avatar
   
Ivan Kalvachev committed
454
        psz_serial = p_sector + 813;
Michael Roitzsch's avatar
   
Michael Roitzsch committed
455
        psz_serial[16] = '\0';
456

Michael Roitzsch's avatar
   
Michael Roitzsch committed
457
458
459
460
        /* Check that all characters are digits, otherwise convert. */
        for( i = 0 ; i < 16 ; i++ )
        {
            if( psz_serial[i] < '0' || psz_serial[i] > '9' )
461
            {
462
                char psz_tmp[16 + 1];
Sam Hocevar's avatar
Sam Hocevar committed
463
464
                sprintf( psz_tmp,
                         "%.2x%.2x%.2x%.2x%.2x%.2x%.2x%.2x",
Michael Roitzsch's avatar
   
Michael Roitzsch committed
465
466
467
                         psz_serial[0], psz_serial[1], psz_serial[2],
                         psz_serial[3], psz_serial[4], psz_serial[5],
                         psz_serial[6], psz_serial[7] );
Sam Hocevar's avatar
Sam Hocevar committed
468
                memcpy( psz_serial, psz_tmp, 16 );
Michael Roitzsch's avatar
   
Michael Roitzsch committed
469
                break;
470
471
472
            }
        }

Sam Hocevar's avatar
Sam Hocevar committed
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
        /* Get disk key, since some discs have got same title, manufacturing
         * date and serial number, but different keys */
        if( dvdcss->b_scrambled )
        {
             psz_key[0] = '-';
             for( i = 0; i < KEY_SIZE; i++ )
             {
                 sprintf( &psz_key[1+i*2], "%.2x", dvdcss->css.p_disc_key[i] );
             }
             psz_key[1 + KEY_SIZE * 2] = '\0';
        }
        else
        {
             psz_key[0] = 0;
        }

489
490
491
492
493
        /* We have a disc name or ID, we can create the cache dir */
        i = sprintf( dvdcss->psz_cachefile, "%s", psz_cache );
        i_ret = mkdir( dvdcss->psz_cachefile, 0755 );
        if( i_ret < 0 && errno != EEXIST )
        {
494
            print_error( dvdcss, "failed creating cache directory" );
495
496
497
498
            dvdcss->psz_cachefile[0] = '\0';
            goto nocache;
        }

Sam Hocevar's avatar
Sam Hocevar committed
499
500
        i += sprintf( dvdcss->psz_cachefile + i, "/%s-%s%s", psz_title,
                      psz_serial, psz_key );
501
502
503
        i_ret = mkdir( dvdcss->psz_cachefile, 0755 );
        if( i_ret < 0 && errno != EEXIST )
        {
504
            print_error( dvdcss, "failed creating cache subdirectory" );
505
506
507
            dvdcss->psz_cachefile[0] = '\0';
            goto nocache;
        }
Christopher Richards's avatar
   
Christopher Richards committed
508
        i += sprintf( dvdcss->psz_cachefile + i, "/");
509
510
511
512

        /* Pointer to the filename we will use. */
        dvdcss->psz_block = dvdcss->psz_cachefile + i;

513
514
        print_debug( dvdcss, "using CSS key cache dir: %s",
                             dvdcss->psz_cachefile );
515
516
517
    }
    nocache:

518
#ifdef DVDCSS_RAW_OPEN
Michael Roitzsch's avatar
   
Michael Roitzsch committed
519
520
521
522
523
524
    if( psz_raw_device != NULL )
    {
        _dvdcss_raw_open( dvdcss, psz_raw_device );
    }
#endif

525
526
527
    /* Seek at the beginning, just for safety. */
    dvdcss->pf_seek( dvdcss, 0 );

Sam Hocevar's avatar
 
Sam Hocevar committed
528
529
530
    return dvdcss;
}

531
/**
532
 * \brief Return a string containing the latest error that occurred in the
533
534
535
536
537
538
 *        given \e libdvdcss instance.
 *
 * \param dvdcss a \e libdvdcss instance.
 * \return a null-terminated string containing the latest error message.
 *
 * This function returns a constant string containing the latest error that
539
 * occurred in \e libdvdcss. It can be used to format error messages at your
540
541
 * convenience in your application.
 */
542
LIBDVDCSS_EXPORT char * dvdcss_error ( dvdcss_t dvdcss )
Sam Hocevar's avatar
 
Sam Hocevar committed
543
544
545
546
{
    return dvdcss->psz_error;
}

547
548
549
550
551
/**
 * \brief Seek in the disc and change the current key if requested.
 *
 * \param dvdcss a \e libdvdcss instance.
 * \param i_blocks an absolute block offset to seek to.
552
 * \param i_flags #DVDCSS_NOFLAGS, optionally ORed with one of #DVDCSS_SEEK_KEY
553
554
555
556
557
558
559
560
561
 *        or #DVDCSS_SEEK_MPEG.
 * \return the new position in blocks, or a negative value in case an error
 *         happened.
 *
 * This function seeks to the requested position, in logical blocks.
 *
 * You typically set \p i_flags to #DVDCSS_NOFLAGS when seeking in a .IFO.
 *
 * If #DVDCSS_SEEK_MPEG is specified in \p i_flags and if \e libdvdcss finds it
562
 * reasonable to do so (i.e., if the dvdcss method is not "title"), the current
563
564
565
566
 * title key will be checked and a new one will be calculated if necessary.
 * This flag is typically used when reading data from a VOB.
 *
 * If #DVDCSS_SEEK_KEY is specified, the title key will be always checked,
567
 * even with the "title" method. This flag is typically used when seeking
568
569
 * in a new title.
 */
570
LIBDVDCSS_EXPORT int dvdcss_seek ( dvdcss_t dvdcss, int i_blocks, int i_flags )
Sam Hocevar's avatar
 
Sam Hocevar committed
571
572
573
{
    /* title cracking method is too slow to be used at each seek */
    if( ( ( i_flags & DVDCSS_SEEK_MPEG )
574
             && ( dvdcss->i_method != DVDCSS_METHOD_TITLE ) )
Sam Hocevar's avatar
 
Sam Hocevar committed
575
576
577
       || ( i_flags & DVDCSS_SEEK_KEY ) )
    {
        /* check the title key */
578
        if( _dvdcss_title( dvdcss, i_blocks ) )
Sam Hocevar's avatar
 
Sam Hocevar committed
579
580
581
582
583
        {
            return -1;
        }
    }

584
    return dvdcss->pf_seek( dvdcss, i_blocks );
Sam Hocevar's avatar
 
Sam Hocevar committed
585
586
}

587
588
589
590
591
592
/**
 * \brief Read from the disc and decrypt data if requested.
 *
 * \param dvdcss a \e libdvdcss instance.
 * \param p_buffer a buffer that will contain the data read from the disc.
 * \param i_blocks the amount of blocks to read.
593
 * \param i_flags #DVDCSS_NOFLAGS, optionally ORed with #DVDCSS_READ_DECRYPT.
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
 * \return the amount of blocks read, or a negative value in case an
 *         error happened.
 *
 * This function reads \p i_blocks logical blocks from the DVD.
 *
 * You typically set \p i_flags to #DVDCSS_NOFLAGS when reading data from a
 * .IFO file on the DVD.
 *
 * If #DVDCSS_READ_DECRYPT is specified in \p i_flags, dvdcss_read() will
 * automatically decrypt scrambled sectors. This flag is typically used when
 * reading data from a .VOB file on the DVD. It has no effect on unscrambled
 * discs or unscrambled sectors, and can be safely used on those.
 *
 * \warning dvdcss_read() expects to be able to write \p i_blocks *
 *          #DVDCSS_BLOCK_SIZE bytes in \p p_buffer.
 */
610
LIBDVDCSS_EXPORT int dvdcss_read ( dvdcss_t dvdcss, void *p_buffer,
611
612
                                          int i_blocks,
                                          int i_flags )
Sam Hocevar's avatar
 
Sam Hocevar committed
613
614
615
{
    int i_ret, i_index;

616
    i_ret = dvdcss->pf_read( dvdcss, p_buffer, i_blocks );
Sam Hocevar's avatar
 
Sam Hocevar committed
617
618

    if( i_ret <= 0
619
         || !dvdcss->b_scrambled
Sam Hocevar's avatar
 
Sam Hocevar committed
620
621
622
623
624
         || !(i_flags & DVDCSS_READ_DECRYPT) )
    {
        return i_ret;
    }

625
    if( ! memcmp( dvdcss->css.p_title_key, "\0\0\0\0\0", 5 ) )
Sam Hocevar's avatar
 
Sam Hocevar committed
626
    {
627
        /* For what we believe is an unencrypted title,
Sam Hocevar's avatar
Sam Hocevar committed
628
         * check that there are no encrypted blocks */
Sam Hocevar's avatar
 
Sam Hocevar committed
629
630
        for( i_index = i_ret; i_index; i_index-- )
        {
631
            if( ((uint8_t*)p_buffer)[0x14] & 0x30 )
Sam Hocevar's avatar
 
Sam Hocevar committed
632
            {
633
                print_error( dvdcss, "no key but found encrypted block" );
Sam Hocevar's avatar
 
Sam Hocevar committed
634
635
                /* Only return the initial range of unscrambled blocks? */
                /* or fail completely? return 0; */
Sam Hocevar's avatar
Sam Hocevar committed
636
                break;
Sam Hocevar's avatar
 
Sam Hocevar committed
637
            }
638
            p_buffer = (void *) ((uint8_t *)p_buffer + DVDCSS_BLOCK_SIZE);
Sam Hocevar's avatar
 
Sam Hocevar committed
639
640
        }
    }
641
    else
Sam Hocevar's avatar
 
Sam Hocevar committed
642
    {
643
644
        /* Decrypt the blocks we managed to read */
        for( i_index = i_ret; i_index; i_index-- )
Sam Hocevar's avatar
Sam Hocevar committed
645
646
647
        {
            _dvdcss_unscramble( dvdcss->css.p_title_key, p_buffer );
            ((uint8_t*)p_buffer)[0x14] &= 0x8f;
648
            p_buffer = (void *) ((uint8_t *)p_buffer + DVDCSS_BLOCK_SIZE);
Sam Hocevar's avatar
Sam Hocevar committed
649
        }
Sam Hocevar's avatar
 
Sam Hocevar committed
650
    }
651

Sam Hocevar's avatar
 
Sam Hocevar committed
652
653
654
    return i_ret;
}

655
656
657
658
659
660
661
662
/**
 * \brief Read from the disc into multiple buffers and decrypt data if
 *        requested.
 *
 * \param dvdcss a \e libdvdcss instance.
 * \param p_iovec a pointer to an array of iovec structures that will contain
 *        the data read from the disc.
 * \param i_blocks the amount of blocks to read.
663
 * \param i_flags #DVDCSS_NOFLAGS, optionally ORed with #DVDCSS_READ_DECRYPT.
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
 * \return the amount of blocks read, or a negative value in case an
 *         error happened.
 *
 * This function reads \p i_blocks logical blocks from the DVD and writes them
 * to an array of iovec structures.
 *
 * You typically set \p i_flags to #DVDCSS_NOFLAGS when reading data from a
 * .IFO file on the DVD.
 *
 * If #DVDCSS_READ_DECRYPT is specified in \p i_flags, dvdcss_readv() will
 * automatically decrypt scrambled sectors. This flag is typically used when
 * reading data from a .VOB file on the DVD. It has no effect on unscrambled
 * discs or unscrambled sectors, and can be safely used on those.
 *
 * \warning dvdcss_readv() expects to be able to write \p i_blocks *
 *          #DVDCSS_BLOCK_SIZE bytes in the buffers pointed by \p p_iovec.
 *          Moreover, all iov_len members of the iovec structures should be
 *          multiples of #DVDCSS_BLOCK_SIZE.
 */
683
LIBDVDCSS_EXPORT int dvdcss_readv ( dvdcss_t dvdcss, void *p_iovec,
684
685
                                           int i_blocks,
                                           int i_flags )
Sam Hocevar's avatar
 
Sam Hocevar committed
686
{
687
    struct iovec *_p_iovec = (struct iovec *)p_iovec;
Sam Hocevar's avatar
 
Sam Hocevar committed
688
689
690
691
    int i_ret, i_index;
    void *iov_base;
    size_t iov_len;

692
    i_ret = dvdcss->pf_readv( dvdcss, _p_iovec, i_blocks );
Sam Hocevar's avatar
 
Sam Hocevar committed
693
694

    if( i_ret <= 0
695
         || !dvdcss->b_scrambled
Sam Hocevar's avatar
 
Sam Hocevar committed
696
697
698
699
700
701
         || !(i_flags & DVDCSS_READ_DECRYPT) )
    {
        return i_ret;
    }

    /* Initialize loop for decryption */
702
703
    iov_base = _p_iovec->iov_base;
    iov_len = _p_iovec->iov_len;
Sam Hocevar's avatar
 
Sam Hocevar committed
704
705
706
707
708
709
710
711
712
713
714
715

    /* Decrypt the blocks we managed to read */
    for( i_index = i_ret; i_index; i_index-- )
    {
        /* Check that iov_len is a multiple of 2048 */
        if( iov_len & 0x7ff )
        {
            return -1;
        }

        while( iov_len == 0 )
        {
716
717
718
            _p_iovec++;
            iov_base = _p_iovec->iov_base;
            iov_len = _p_iovec->iov_len;
Sam Hocevar's avatar
 
Sam Hocevar committed
719
720
        }

721
        _dvdcss_unscramble( dvdcss->css.p_title_key, iov_base );
722
        ((uint8_t*)iov_base)[0x14] &= 0x8f;
Sam Hocevar's avatar
 
Sam Hocevar committed
723

724
        iov_base = (void *) ((uint8_t*)iov_base + DVDCSS_BLOCK_SIZE);
725
        iov_len -= DVDCSS_BLOCK_SIZE;
Sam Hocevar's avatar
 
Sam Hocevar committed
726
727
728
729
730
    }

    return i_ret;
}

731
732
733
734
735
736
737
/**
 * \brief Close the DVD and clean up the library.
 *
 * \param dvdcss a \e libdvdcss instance.
 * \return zero in case of success, a negative value otherwise.
 *
 * This function closes the DVD device and frees all the memory allocated
738
 * by \e libdvdcss. On return, the #dvdcss_t is invalidated and may not be
739
740
 * used again.
 */
741
LIBDVDCSS_EXPORT int dvdcss_close ( dvdcss_t dvdcss )
Sam Hocevar's avatar
 
Sam Hocevar committed
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
{
    dvd_title_t *p_title;
    int i_ret;

    /* Free our list of keys */
    p_title = dvdcss->p_titles;
    while( p_title )
    {
        dvd_title_t *p_tmptitle = p_title->p_next;
        free( p_title );
        p_title = p_tmptitle;
    }

    i_ret = _dvdcss_close( dvdcss );

    if( i_ret < 0 )
    {
        return i_ret;
    }

762
    free( dvdcss->psz_device );
Sam Hocevar's avatar
 
Sam Hocevar committed
763
764
765
766
767
    free( dvdcss );

    return 0;
}

768
769
770
771
772
773
774
775
776
777
778
779
/**
 * \brief Return 1 if the DVD is scrambled, 0 otherwise.
 *
 * \param dvdcss a \e libdvdcss instance.
 * \return 1 if the DVD is scrambled, 0 otherwise.
 *
 * This function returns whether the DVD is scrambled.
 */
LIBDVDCSS_EXPORT int dvdcss_is_scrambled ( dvdcss_t dvdcss )
{
    return dvdcss->b_scrambled;
}