Mercurial > mplayer.hg
annotate libdvdcss/libdvdcss.c @ 24015:b636b5de36f3
Add <application> tag around MEncoder
author | reimar |
---|---|
date | Wed, 08 Aug 2007 13:13:12 +0000 |
parents | 1fb5f0b13a1a |
children | 2273bfbb8e40 |
rev | line source |
---|---|
20613 | 1 /* libdvdcss.c: DVD reading library. |
2 * | |
3 * Authors: Stéphane Borel <stef@via.ecp.fr> | |
4 * Samuel Hocevar <sam@zoy.org> | |
5 * Håkan Hjort <d95hjort@dtek.chalmers.se> | |
6 * | |
7 * Copyright (C) 1998-2002 VideoLAN | |
8 * $Id$ | |
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., 59 Temple Place - Suite 330, Boston, MA 02111, USA. | |
23 */ | |
24 | |
25 /** | |
26 * \mainpage libdvdcss developer documentation | |
27 * | |
28 * \section intro Introduction | |
29 * | |
30 * \e libdvdcss is a simple library designed for accessing DVDs like a block | |
31 * device without having to bother about the decryption. The important features | |
32 * are: | |
33 * \li portability: currently supported platforms are GNU/Linux, FreeBSD, | |
34 * NetBSD, OpenBSD, BSD/OS, BeOS, Windows 95/98, Windows NT/2000, MacOS X, | |
35 * Solaris, HP-UX and OS/2. | |
36 * \li adaptability: unlike most similar projects, libdvdcss doesn't require | |
37 * the region of your drive to be set and will try its best to read from | |
38 * the disc even in the case of a region mismatch. | |
39 * \li simplicity: a DVD player can be built around the \e libdvdcss API using | |
40 * no more than 4 or 5 library calls. | |
41 * | |
42 * \e libdvdcss is free software, released under the General Public License. | |
43 * This ensures that \e libdvdcss remains free and used only with free | |
44 * software. | |
45 * | |
46 * \section api The libdvdcss API | |
47 * | |
48 * The complete \e libdvdcss programming interface is documented in the | |
49 * dvdcss.h file. | |
50 * | |
51 * \section env Environment variables | |
52 * | |
53 * Some environment variables can be used to change the behaviour of | |
54 * \e libdvdcss without having to modify the program which uses it. These | |
55 * variables are: | |
56 * | |
57 * \li \b DVDCSS_VERBOSE: sets the verbosity level. | |
58 * - \c 0 outputs no messages at all. | |
59 * - \c 1 outputs error messages to stderr. | |
60 * - \c 2 outputs error messages and debug messages to stderr. | |
61 * | |
62 * \li \b DVDCSS_METHOD: sets the authentication and decryption method | |
63 * that \e libdvdcss will use to read scrambled discs. Can be one | |
64 * of \c title, \c key or \c disc. | |
65 * - \c key is the default method. \e libdvdcss will use a set of | |
66 * calculated player keys to try and get the disc key. This can fail | |
67 * if the drive does not recognize any of the player keys. | |
68 * - \c disc is a fallback method when \c key has failed. Instead of | |
69 * using player keys, \e libdvdcss will crack the disc key using | |
70 * a brute force algorithm. This process is CPU intensive and requires | |
71 * 64 MB of memory to store temporary data. | |
72 * - \c title is the fallback when all other methods have failed. It does | |
73 * not rely on a key exchange with the DVD drive, but rather uses a | |
74 * crypto attack to guess the title key. On rare cases this may fail | |
75 * because there is not enough encrypted data on the disc to perform | |
76 * a statistical attack, but in the other hand it is the only way to | |
77 * decrypt a DVD stored on a hard disc, or a DVD with the wrong region | |
78 * on an RPC2 drive. | |
79 * | |
80 * \li \b DVDCSS_RAW_DEVICE: specify the raw device to use. Exact usage will | |
81 * depend on your operating system, the Linux utility to set up raw devices | |
82 * is \c raw(8) for instance. Please note that on most operating systems, | |
83 * using a raw device requires highly aligned buffers: Linux requires a | |
84 * 2048 bytes alignment (which is the size of a DVD sector). | |
85 * | |
86 * \li \b DVDCSS_CACHE: specify a directory in which to store title key | |
87 * values. This will speed up descrambling of DVDs which are in the | |
88 * cache. The DVDCSS_CACHE directory is created if it does not exist, | |
89 * and a subdirectory is created named after the DVD's title or | |
90 * manufacturing date. If DVDCSS_CACHE is not set or is empty, \e libdvdcss | |
91 * will use the default value which is "${HOME}/.dvdcss/" under Unix and | |
92 * "C:\Documents and Settings\$USER\Application Data\dvdcss\" under Win32. | |
93 * The special value "off" disables caching. | |
94 */ | |
95 | |
96 /* | |
97 * Preamble | |
98 */ | |
99 #include "config.h" | |
100 | |
101 #include <stdio.h> | |
102 #include <stdlib.h> | |
103 #include <string.h> | |
104 #include <sys/types.h> | |
105 #include <sys/stat.h> | |
106 #ifdef HAVE_SYS_PARAM_H | |
107 # include <sys/param.h> | |
108 #endif | |
109 #ifdef HAVE_PWD_H | |
110 # include <pwd.h> | |
111 #endif | |
112 #include <fcntl.h> | |
113 #include <errno.h> | |
114 | |
115 #ifdef HAVE_UNISTD_H | |
116 # include <unistd.h> | |
117 #endif | |
118 | |
119 #ifdef HAVE_LIMITS_H | |
120 # include <limits.h> | |
121 #endif | |
122 | |
123 #ifdef HAVE_DIRECT_H | |
124 # include <direct.h> | |
125 #endif | |
126 | |
127 #include "dvdcss/dvdcss.h" | |
128 | |
129 #include "common.h" | |
130 #include "css.h" | |
131 #include "libdvdcss.h" | |
132 #include "ioctl.h" | |
133 #include "device.h" | |
134 | |
135 /** | |
136 * \brief Symbol for version checks. | |
137 * | |
138 * The name of this symbol contains the library major number, which makes it | |
139 * easy to check which \e libdvdcss development headers are installed on the | |
140 * system with tools such as autoconf. | |
141 * | |
142 * The variable itself contains the exact version number of the library, | |
143 * which can be useful for specific feature needs. | |
144 */ | |
145 LIBDVDCSS_EXPORT char * dvdcss_interface_2; | |
146 char * dvdcss_interface_2 = VERSION; | |
147 | |
148 /** | |
149 * \brief Open a DVD device or directory and return a dvdcss instance. | |
150 * | |
151 * \param psz_target a string containing the target name, for instance | |
152 * "/dev/hdc" or "E:". | |
153 * \return a handle to a dvdcss instance or NULL on error. | |
154 * | |
155 * Initialize the \e libdvdcss library and open the requested DVD device or | |
156 * directory. \e libdvdcss checks whether ioctls can be performed on the disc, | |
157 * and when possible, the disc key is retrieved. | |
158 * | |
159 * dvdcss_open() returns a handle to be used for all subsequent \e libdvdcss | |
160 * calls. If an error occurred, NULL is returned. | |
161 */ | |
162 LIBDVDCSS_EXPORT dvdcss_t dvdcss_open ( char *psz_target ) | |
163 { | |
164 char psz_buffer[PATH_MAX]; | |
165 int i_ret; | |
166 | |
167 char *psz_method = getenv( "DVDCSS_METHOD" ); | |
168 char *psz_verbose = getenv( "DVDCSS_VERBOSE" ); | |
169 char *psz_cache = getenv( "DVDCSS_CACHE" ); | |
170 #ifndef WIN32 | |
171 char *psz_raw_device = getenv( "DVDCSS_RAW_DEVICE" ); | |
172 #endif | |
173 | |
174 dvdcss_t dvdcss; | |
175 | |
176 /* | |
177 * Allocate the library structure | |
178 */ | |
179 dvdcss = malloc( sizeof( struct dvdcss_s ) ); | |
180 if( dvdcss == NULL ) | |
181 { | |
182 return NULL; | |
183 } | |
184 | |
185 /* | |
186 * Initialize structure with default values | |
187 */ | |
188 #ifndef WIN32 | |
189 dvdcss->i_raw_fd = -1; | |
190 #endif | |
191 dvdcss->p_titles = NULL; | |
192 dvdcss->psz_device = (char *)strdup( psz_target ); | |
193 dvdcss->psz_error = "no error"; | |
194 dvdcss->i_method = DVDCSS_METHOD_KEY; | |
195 dvdcss->psz_cachefile[0] = '\0'; | |
196 dvdcss->b_debug = 0; | |
197 dvdcss->b_errors = 0; | |
198 | |
199 /* | |
200 * Find verbosity from DVDCSS_VERBOSE environment variable | |
201 */ | |
202 if( psz_verbose != NULL ) | |
203 { | |
204 int i = atoi( psz_verbose ); | |
205 | |
206 if( i >= 2 ) dvdcss->b_debug = i; | |
207 if( i >= 1 ) dvdcss->b_errors = 1; | |
208 } | |
209 | |
210 /* | |
211 * Find method from DVDCSS_METHOD environment variable | |
212 */ | |
213 if( psz_method != NULL ) | |
214 { | |
215 if( !strncmp( psz_method, "key", 4 ) ) | |
216 { | |
217 dvdcss->i_method = DVDCSS_METHOD_KEY; | |
218 } | |
219 else if( !strncmp( psz_method, "disc", 5 ) ) | |
220 { | |
221 dvdcss->i_method = DVDCSS_METHOD_DISC; | |
222 } | |
223 else if( !strncmp( psz_method, "title", 5 ) ) | |
224 { | |
225 dvdcss->i_method = DVDCSS_METHOD_TITLE; | |
226 } | |
227 else | |
228 { | |
229 print_error( dvdcss, "unknown decrypt method, please choose " | |
230 "from 'title', 'key' or 'disc'" ); | |
231 free( dvdcss->psz_device ); | |
232 free( dvdcss ); | |
233 return NULL; | |
234 } | |
235 } | |
236 | |
237 /* | |
238 * If DVDCSS_CACHE was not set, try to guess a default value | |
239 */ | |
240 if( psz_cache == NULL || psz_cache[0] == '\0' ) | |
241 { | |
242 #ifdef HAVE_DIRECT_H | |
243 typedef HRESULT( WINAPI *SHGETFOLDERPATH ) | |
244 ( HWND, int, HANDLE, DWORD, LPTSTR ); | |
245 | |
246 # define CSIDL_FLAG_CREATE 0x8000 | |
247 # define CSIDL_APPDATA 0x1A | |
248 # define SHGFP_TYPE_CURRENT 0 | |
249 | |
250 char psz_home[MAX_PATH]; | |
251 HINSTANCE p_dll; | |
252 SHGETFOLDERPATH p_getpath; | |
253 | |
254 *psz_home = '\0'; | |
255 | |
256 /* Load the shfolder dll to retrieve SHGetFolderPath */ | |
257 p_dll = LoadLibrary( "shfolder.dll" ); | |
258 if( p_dll ) | |
259 { | |
260 p_getpath = (void*)GetProcAddress( p_dll, "SHGetFolderPathA" ); | |
261 if( p_getpath ) | |
262 { | |
263 /* Get the "Application Data" folder for the current user */ | |
264 if( p_getpath( NULL, CSIDL_APPDATA | CSIDL_FLAG_CREATE, | |
265 NULL, SHGFP_TYPE_CURRENT, psz_home ) == S_OK ) | |
266 { | |
267 FreeLibrary( p_dll ); | |
268 } | |
269 else | |
270 { | |
271 *psz_home = '\0'; | |
272 } | |
273 } | |
274 FreeLibrary( p_dll ); | |
275 } | |
276 | |
277 /* Cache our keys in | |
278 * C:\Documents and Settings\$USER\Application Data\dvdcss\ */ | |
279 if( *psz_home ) | |
280 { | |
281 snprintf( psz_buffer, PATH_MAX, "%s/dvdcss", psz_home ); | |
282 psz_buffer[PATH_MAX-1] = '\0'; | |
283 psz_cache = psz_buffer; | |
284 } | |
285 #else | |
286 char *psz_home = NULL; | |
287 # ifdef HAVE_PWD_H | |
288 struct passwd *p_pwd; | |
289 | |
290 /* Try looking in password file for home dir. */ | |
291 p_pwd = getpwuid(getuid()); | |
292 if( p_pwd ) | |
293 { | |
294 psz_home = p_pwd->pw_dir; | |
295 } | |
296 # endif | |
297 | |
298 if( psz_home == NULL ) | |
299 { | |
300 psz_home = getenv( "HOME" ); | |
301 } | |
302 if( psz_home == NULL ) | |
303 { | |
304 psz_home = getenv( "USERPROFILE" ); | |
305 } | |
306 | |
307 /* Cache our keys in ${HOME}/.dvdcss/ */ | |
308 if( psz_home ) | |
309 { | |
310 snprintf( psz_buffer, PATH_MAX, "%s/.dvdcss", psz_home ); | |
311 psz_buffer[PATH_MAX-1] = '\0'; | |
312 psz_cache = psz_buffer; | |
313 } | |
314 #endif | |
315 } | |
316 | |
317 /* | |
318 * Find cache dir from the DVDCSS_CACHE environment variable | |
319 */ | |
320 if( psz_cache != NULL ) | |
321 { | |
322 if( psz_cache[0] == '\0' || !strcmp( psz_cache, "off" ) ) | |
323 { | |
324 psz_cache = NULL; | |
325 } | |
326 /* Check that we can add the ID directory and the block filename */ | |
327 else if( strlen( psz_cache ) + 1 + 32 + 1 + (KEY_SIZE * 2) + 10 + 1 | |
328 > PATH_MAX ) | |
329 { | |
330 print_error( dvdcss, "cache directory name is too long" ); | |
331 psz_cache = NULL; | |
332 } | |
333 } | |
334 | |
335 /* | |
336 * Open device | |
337 */ | |
338 _dvdcss_check( dvdcss ); | |
339 i_ret = _dvdcss_open( dvdcss ); | |
340 if( i_ret < 0 ) | |
341 { | |
342 free( dvdcss->psz_device ); | |
343 free( dvdcss ); | |
344 return NULL; | |
345 } | |
346 | |
347 dvdcss->b_scrambled = 1; /* Assume the worst */ | |
348 dvdcss->b_ioctls = _dvdcss_use_ioctls( dvdcss ); | |
349 | |
350 if( dvdcss->b_ioctls ) | |
351 { | |
352 i_ret = _dvdcss_test( dvdcss ); | |
353 if( i_ret < 0 ) | |
354 { | |
355 /* Disable the CSS ioctls and hope that it works? */ | |
356 print_debug( dvdcss, | |
357 "could not check whether the disc was scrambled" ); | |
358 dvdcss->b_ioctls = 0; | |
359 } | |
360 else | |
361 { | |
362 print_debug( dvdcss, i_ret ? "disc is scrambled" | |
363 : "disc is unscrambled" ); | |
364 dvdcss->b_scrambled = i_ret; | |
365 } | |
366 } | |
367 | |
368 /* If disc is CSS protected and the ioctls work, authenticate the drive */ | |
369 if( dvdcss->b_scrambled && dvdcss->b_ioctls ) | |
370 { | |
371 i_ret = _dvdcss_disckey( dvdcss ); | |
372 | |
373 if( i_ret < 0 ) | |
374 { | |
375 _dvdcss_close( dvdcss ); | |
376 free( dvdcss->psz_device ); | |
377 free( dvdcss ); | |
378 return NULL; | |
379 } | |
380 } | |
381 | |
382 /* If the cache is enabled, write the cache directory tag */ | |
383 if( psz_cache ) | |
384 { | |
385 char *psz_tag = "Signature: 8a477f597d28d172789f06886806bc55\r\n" | |
386 "# This file is a cache directory tag created by libdvdcss.\r\n" | |
387 "# For information about cache directory tags, see:\r\n" | |
388 "# http://www.brynosaurus.com/cachedir/\r\n"; | |
389 char psz_tagfile[PATH_MAX + 1 + 12 + 1]; | |
390 int i_fd; | |
391 | |
392 sprintf( psz_tagfile, "%s/CACHEDIR.TAG", psz_cache ); | |
393 i_fd = open( psz_tagfile, O_RDWR|O_CREAT, 0644 ); | |
394 if( i_fd >= 0 ) | |
395 { | |
396 write( i_fd, psz_tag, strlen(psz_tag) ); | |
397 close( i_fd ); | |
398 } | |
399 } | |
400 | |
401 /* If the cache is enabled, extract a unique disc ID */ | |
402 if( psz_cache ) | |
403 { | |
404 uint8_t p_sector[DVDCSS_BLOCK_SIZE]; | |
405 char psz_debug[PATH_MAX + 30]; | |
406 char psz_key[1 + KEY_SIZE * 2 + 1]; | |
23708 | 407 char *psz_title; |
408 uint8_t *psz_serial; | |
20613 | 409 int i; |
410 | |
411 /* We read sector 0. If it starts with 0x000001ba (BE), we are | |
412 * reading a VOB file, and we should not cache anything. */ | |
413 | |
414 i_ret = dvdcss->pf_seek( dvdcss, 0 ); | |
415 if( i_ret != 0 ) | |
416 { | |
417 goto nocache; | |
418 } | |
419 | |
420 i_ret = dvdcss->pf_read( dvdcss, p_sector, 1 ); | |
421 if( i_ret != 1 ) | |
422 { | |
423 goto nocache; | |
424 } | |
425 | |
426 if( p_sector[0] == 0x00 && p_sector[1] == 0x00 | |
427 && p_sector[2] == 0x01 && p_sector[3] == 0xba ) | |
428 { | |
429 goto nocache; | |
430 } | |
431 | |
432 /* The data we are looking for is at sector 16 (32768 bytes): | |
433 * - offset 40: disc title (32 uppercase chars) | |
434 * - offset 813: manufacturing date + serial no (16 digits) */ | |
435 | |
436 i_ret = dvdcss->pf_seek( dvdcss, 16 ); | |
437 if( i_ret != 16 ) | |
438 { | |
439 goto nocache; | |
440 } | |
441 | |
442 i_ret = dvdcss->pf_read( dvdcss, p_sector, 1 ); | |
443 if( i_ret != 1 ) | |
444 { | |
445 goto nocache; | |
446 } | |
447 | |
448 /* Get the disc title */ | |
449 psz_title = (char *)p_sector + 40; | |
450 psz_title[32] = '\0'; | |
451 | |
452 for( i = 0 ; i < 32 ; i++ ) | |
453 { | |
454 if( psz_title[i] <= ' ' ) | |
455 { | |
456 psz_title[i] = '\0'; | |
457 break; | |
458 } | |
459 else if( psz_title[i] == '/' || psz_title[i] == '\\' ) | |
460 { | |
461 psz_title[i] = '-'; | |
462 } | |
463 } | |
464 | |
465 /* Get the date + serial */ | |
23708 | 466 psz_serial = p_sector + 813; |
20613 | 467 psz_serial[16] = '\0'; |
468 | |
469 /* Check that all characters are digits, otherwise convert. */ | |
470 for( i = 0 ; i < 16 ; i++ ) | |
471 { | |
472 if( psz_serial[i] < '0' || psz_serial[i] > '9' ) | |
473 { | |
474 char psz_tmp[16 + 1]; | |
475 sprintf( psz_tmp, | |
23707
552963611d77
Fix CSS format strings, they could print more than two digits for
reimar
parents:
20613
diff
changeset
|
476 "%.2"PRIx8"%.2"PRIx8"%.2"PRIx8"%.2"PRIx8"%.2"PRIx8"%.2"PRIx8"%.2"PRIx8"%.2"PRIx8"", |
20613 | 477 psz_serial[0], psz_serial[1], psz_serial[2], |
478 psz_serial[3], psz_serial[4], psz_serial[5], | |
479 psz_serial[6], psz_serial[7] ); | |
480 memcpy( psz_serial, psz_tmp, 16 ); | |
481 break; | |
482 } | |
483 } | |
484 | |
485 /* Get disk key, since some discs have got same title, manufacturing | |
486 * date and serial number, but different keys */ | |
487 if( dvdcss->b_scrambled ) | |
488 { | |
489 psz_key[0] = '-'; | |
490 for( i = 0; i < KEY_SIZE; i++ ) | |
491 { | |
23707
552963611d77
Fix CSS format strings, they could print more than two digits for
reimar
parents:
20613
diff
changeset
|
492 sprintf( &psz_key[1+i*2], "%.2"PRIx8, dvdcss->css.p_disc_key[i] ); |
20613 | 493 } |
494 psz_key[1 + KEY_SIZE * 2] = '\0'; | |
495 } | |
496 else | |
497 { | |
498 psz_key[0] = 0; | |
499 } | |
500 | |
501 /* We have a disc name or ID, we can create the cache dir */ | |
502 i = sprintf( dvdcss->psz_cachefile, "%s", psz_cache ); | |
503 #if !defined( WIN32 ) || defined( SYS_CYGWIN ) | |
504 i_ret = mkdir( dvdcss->psz_cachefile, 0755 ); | |
505 #else | |
506 i_ret = mkdir( dvdcss->psz_cachefile ); | |
507 #endif | |
508 if( i_ret < 0 && errno != EEXIST ) | |
509 { | |
510 print_error( dvdcss, "failed creating cache directory" ); | |
511 dvdcss->psz_cachefile[0] = '\0'; | |
512 goto nocache; | |
513 } | |
514 | |
515 i += sprintf( dvdcss->psz_cachefile + i, "/%s-%s%s", psz_title, | |
516 psz_serial, psz_key ); | |
517 #if !defined( WIN32 ) || defined( SYS_CYGWIN ) | |
518 i_ret = mkdir( dvdcss->psz_cachefile, 0755 ); | |
519 #else | |
520 i_ret = mkdir( dvdcss->psz_cachefile ); | |
521 #endif | |
522 if( i_ret < 0 && errno != EEXIST ) | |
523 { | |
524 print_error( dvdcss, "failed creating cache subdirectory" ); | |
525 dvdcss->psz_cachefile[0] = '\0'; | |
526 goto nocache; | |
527 } | |
528 i += sprintf( dvdcss->psz_cachefile + i, "/"); | |
529 | |
530 /* Pointer to the filename we will use. */ | |
531 dvdcss->psz_block = dvdcss->psz_cachefile + i; | |
532 | |
533 sprintf( psz_debug, "using CSS key cache dir: %s", | |
534 dvdcss->psz_cachefile ); | |
535 print_debug( dvdcss, psz_debug ); | |
536 } | |
537 nocache: | |
538 | |
539 #ifndef WIN32 | |
540 if( psz_raw_device != NULL ) | |
541 { | |
542 _dvdcss_raw_open( dvdcss, psz_raw_device ); | |
543 } | |
544 #endif | |
545 | |
546 /* Seek at the beginning, just for safety. */ | |
547 dvdcss->pf_seek( dvdcss, 0 ); | |
548 | |
549 return dvdcss; | |
550 } | |
551 | |
552 /** | |
553 * \brief Return a string containing the latest error that occurred in the | |
554 * given \e libdvdcss instance. | |
555 * | |
556 * \param dvdcss a \e libdvdcss instance. | |
557 * \return a null-terminated string containing the latest error message. | |
558 * | |
559 * This function returns a constant string containing the latest error that | |
560 * occurred in \e libdvdcss. It can be used to format error messages at your | |
561 * convenience in your application. | |
562 */ | |
563 LIBDVDCSS_EXPORT char * dvdcss_error ( dvdcss_t dvdcss ) | |
564 { | |
565 return dvdcss->psz_error; | |
566 } | |
567 | |
568 /** | |
569 * \brief Seek in the disc and change the current key if requested. | |
570 * | |
571 * \param dvdcss a \e libdvdcss instance. | |
572 * \param i_blocks an absolute block offset to seek to. | |
573 * \param i_flags #DVDCSS_NOFLAGS, optionally ored with one of #DVDCSS_SEEK_KEY | |
574 * or #DVDCSS_SEEK_MPEG. | |
575 * \return the new position in blocks, or a negative value in case an error | |
576 * happened. | |
577 * | |
578 * This function seeks to the requested position, in logical blocks. | |
579 * | |
580 * You typically set \p i_flags to #DVDCSS_NOFLAGS when seeking in a .IFO. | |
581 * | |
582 * If #DVDCSS_SEEK_MPEG is specified in \p i_flags and if \e libdvdcss finds it | |
583 * reasonable to do so (ie, if the dvdcss method is not "title"), the current | |
584 * title key will be checked and a new one will be calculated if necessary. | |
585 * This flag is typically used when reading data from a VOB. | |
586 * | |
587 * If #DVDCSS_SEEK_KEY is specified, the title key will be always checked, | |
588 * even with the "title" method. This is equivalent to using the now | |
589 * deprecated dvdcss_title() call. This flag is typically used when seeking | |
590 * in a new title. | |
591 */ | |
592 LIBDVDCSS_EXPORT int dvdcss_seek ( dvdcss_t dvdcss, int i_blocks, int i_flags ) | |
593 { | |
594 /* title cracking method is too slow to be used at each seek */ | |
595 if( ( ( i_flags & DVDCSS_SEEK_MPEG ) | |
596 && ( dvdcss->i_method != DVDCSS_METHOD_TITLE ) ) | |
597 || ( i_flags & DVDCSS_SEEK_KEY ) ) | |
598 { | |
599 /* check the title key */ | |
600 if( _dvdcss_title( dvdcss, i_blocks ) ) | |
601 { | |
602 return -1; | |
603 } | |
604 } | |
605 | |
606 return dvdcss->pf_seek( dvdcss, i_blocks ); | |
607 } | |
608 | |
609 /** | |
610 * \brief Read from the disc and decrypt data if requested. | |
611 * | |
612 * \param dvdcss a \e libdvdcss instance. | |
613 * \param p_buffer a buffer that will contain the data read from the disc. | |
614 * \param i_blocks the amount of blocks to read. | |
615 * \param i_flags #DVDCSS_NOFLAGS, optionally ored with #DVDCSS_READ_DECRYPT. | |
616 * \return the amount of blocks read, or a negative value in case an | |
617 * error happened. | |
618 * | |
619 * This function reads \p i_blocks logical blocks from the DVD. | |
620 * | |
621 * You typically set \p i_flags to #DVDCSS_NOFLAGS when reading data from a | |
622 * .IFO file on the DVD. | |
623 * | |
624 * If #DVDCSS_READ_DECRYPT is specified in \p i_flags, dvdcss_read() will | |
625 * automatically decrypt scrambled sectors. This flag is typically used when | |
626 * reading data from a .VOB file on the DVD. It has no effect on unscrambled | |
627 * discs or unscrambled sectors, and can be safely used on those. | |
628 * | |
629 * \warning dvdcss_read() expects to be able to write \p i_blocks * | |
630 * #DVDCSS_BLOCK_SIZE bytes in \p p_buffer. | |
631 */ | |
632 LIBDVDCSS_EXPORT int dvdcss_read ( dvdcss_t dvdcss, void *p_buffer, | |
633 int i_blocks, | |
634 int i_flags ) | |
635 { | |
636 int i_ret, i_index; | |
637 | |
638 i_ret = dvdcss->pf_read( dvdcss, p_buffer, i_blocks ); | |
639 | |
640 if( i_ret <= 0 | |
641 || !dvdcss->b_scrambled | |
642 || !(i_flags & DVDCSS_READ_DECRYPT) ) | |
643 { | |
644 return i_ret; | |
645 } | |
646 | |
647 if( ! memcmp( dvdcss->css.p_title_key, "\0\0\0\0\0", 5 ) ) | |
648 { | |
649 /* For what we believe is an unencrypted title, | |
650 * check that there are no encrypted blocks */ | |
651 for( i_index = i_ret; i_index; i_index-- ) | |
652 { | |
653 if( ((uint8_t*)p_buffer)[0x14] & 0x30 ) | |
654 { | |
655 print_error( dvdcss, "no key but found encrypted block" ); | |
656 /* Only return the initial range of unscrambled blocks? */ | |
657 /* or fail completely? return 0; */ | |
658 break; | |
659 } | |
660 p_buffer = (void *) ((uint8_t *)p_buffer + DVDCSS_BLOCK_SIZE); | |
661 } | |
662 } | |
663 else | |
664 { | |
665 /* Decrypt the blocks we managed to read */ | |
666 for( i_index = i_ret; i_index; i_index-- ) | |
667 { | |
668 _dvdcss_unscramble( dvdcss->css.p_title_key, p_buffer ); | |
669 ((uint8_t*)p_buffer)[0x14] &= 0x8f; | |
670 p_buffer = (void *) ((uint8_t *)p_buffer + DVDCSS_BLOCK_SIZE); | |
671 } | |
672 } | |
673 | |
674 return i_ret; | |
675 } | |
676 | |
677 /** | |
678 * \brief Read from the disc into multiple buffers and decrypt data if | |
679 * requested. | |
680 * | |
681 * \param dvdcss a \e libdvdcss instance. | |
682 * \param p_iovec a pointer to an array of iovec structures that will contain | |
683 * the data read from the disc. | |
684 * \param i_blocks the amount of blocks to read. | |
685 * \param i_flags #DVDCSS_NOFLAGS, optionally ored with #DVDCSS_READ_DECRYPT. | |
686 * \return the amount of blocks read, or a negative value in case an | |
687 * error happened. | |
688 * | |
689 * This function reads \p i_blocks logical blocks from the DVD and writes them | |
690 * to an array of iovec structures. | |
691 * | |
692 * You typically set \p i_flags to #DVDCSS_NOFLAGS when reading data from a | |
693 * .IFO file on the DVD. | |
694 * | |
695 * If #DVDCSS_READ_DECRYPT is specified in \p i_flags, dvdcss_readv() will | |
696 * automatically decrypt scrambled sectors. This flag is typically used when | |
697 * reading data from a .VOB file on the DVD. It has no effect on unscrambled | |
698 * discs or unscrambled sectors, and can be safely used on those. | |
699 * | |
700 * \warning dvdcss_readv() expects to be able to write \p i_blocks * | |
701 * #DVDCSS_BLOCK_SIZE bytes in the buffers pointed by \p p_iovec. | |
702 * Moreover, all iov_len members of the iovec structures should be | |
703 * multiples of #DVDCSS_BLOCK_SIZE. | |
704 */ | |
705 LIBDVDCSS_EXPORT int dvdcss_readv ( dvdcss_t dvdcss, void *p_iovec, | |
706 int i_blocks, | |
707 int i_flags ) | |
708 { | |
709 struct iovec *_p_iovec = (struct iovec *)p_iovec; | |
710 int i_ret, i_index; | |
711 void *iov_base; | |
712 size_t iov_len; | |
713 | |
714 i_ret = dvdcss->pf_readv( dvdcss, _p_iovec, i_blocks ); | |
715 | |
716 if( i_ret <= 0 | |
717 || !dvdcss->b_scrambled | |
718 || !(i_flags & DVDCSS_READ_DECRYPT) ) | |
719 { | |
720 return i_ret; | |
721 } | |
722 | |
723 /* Initialize loop for decryption */ | |
724 iov_base = _p_iovec->iov_base; | |
725 iov_len = _p_iovec->iov_len; | |
726 | |
727 /* Decrypt the blocks we managed to read */ | |
728 for( i_index = i_ret; i_index; i_index-- ) | |
729 { | |
730 /* Check that iov_len is a multiple of 2048 */ | |
731 if( iov_len & 0x7ff ) | |
732 { | |
733 return -1; | |
734 } | |
735 | |
736 while( iov_len == 0 ) | |
737 { | |
738 _p_iovec++; | |
739 iov_base = _p_iovec->iov_base; | |
740 iov_len = _p_iovec->iov_len; | |
741 } | |
742 | |
743 _dvdcss_unscramble( dvdcss->css.p_title_key, iov_base ); | |
744 ((uint8_t*)iov_base)[0x14] &= 0x8f; | |
745 | |
746 iov_base = (void *) ((uint8_t*)iov_base + DVDCSS_BLOCK_SIZE); | |
747 iov_len -= DVDCSS_BLOCK_SIZE; | |
748 } | |
749 | |
750 return i_ret; | |
751 } | |
752 | |
753 /** | |
754 * \brief Close the DVD and clean up the library. | |
755 * | |
756 * \param dvdcss a \e libdvdcss instance. | |
757 * \return zero in case of success, a negative value otherwise. | |
758 * | |
759 * This function closes the DVD device and frees all the memory allocated | |
760 * by \e libdvdcss. On return, the #dvdcss_t is invalidated and may not be | |
761 * used again. | |
762 */ | |
763 LIBDVDCSS_EXPORT int dvdcss_close ( dvdcss_t dvdcss ) | |
764 { | |
765 dvd_title_t *p_title; | |
766 int i_ret; | |
767 | |
768 /* Free our list of keys */ | |
769 p_title = dvdcss->p_titles; | |
770 while( p_title ) | |
771 { | |
772 dvd_title_t *p_tmptitle = p_title->p_next; | |
773 free( p_title ); | |
774 p_title = p_tmptitle; | |
775 } | |
776 | |
777 i_ret = _dvdcss_close( dvdcss ); | |
778 | |
779 if( i_ret < 0 ) | |
780 { | |
781 return i_ret; | |
782 } | |
783 | |
784 free( dvdcss->psz_device ); | |
785 free( dvdcss ); | |
786 | |
787 return 0; | |
788 } | |
789 | |
790 /* | |
791 * Deprecated. See dvdcss_seek(). | |
792 */ | |
793 #undef dvdcss_title | |
794 LIBDVDCSS_EXPORT int dvdcss_title ( dvdcss_t dvdcss, int i_block ) | |
795 { | |
796 return _dvdcss_title( dvdcss, i_block ); | |
797 } | |
798 |