NAME
iTunes::Sid -- Apple iTunes SC Info common user database file interfaceSYNOPSIS
DESCRIPTION
This module allows reading and writing of Apple iTunes type
I<SC info.sid> databases, including the sidb and sidd files
used by iTunes for storage of keys and certificates.METHODS
- new
-
my $sid = iTunes::Sid( file => "sidb", $key => 'FIND', $iv => 'FIND' ); Create an iTunes::Sid object. The file => $filename named argument specifies a data file to be read. The $key and $iv arguments are for decryption, if needed. - DESTROY
-
Not to be called directly-- this cleans up circular references, if any. - ReadFile
-
Read a file in for parsing. - ParseBuffer
-
Parse the data in the buffer. - WriteFile
-
$sid->WriteFile( file => "sidb2", $key => 'FIND', $iv => 'FIND' ); Write the (possibly modified) file to the filename given. $key and $iv are as in the new() method. - WriteFileEncrypted
-
$sid->WriteFileEncrypted( file => "sidb2", $key => 'FIND', $iv => 'FIND' ); Write the (possibly modified) file to the filename given. The file is encrypted before writing (default is to use the key and iv used to decrypt originally). - ParseSidContainer
-
Parse a container in the buffer position given. - SidType
-
Return the iTunes::Sid file type (sidb or sidd, etc). - AtomTree
-
Return an html tree structure for the Sid. - DumpTree
-
Dump data tree to a file, or to standard output by default. - FindAtom
-
my @list = $sid->FindAtom("key "); Find any or all atoms in the sid of a given type. - encrypt
- decrypt
- mac
-
Get or set hardware ID (the MAC address OR a derived machine signature). - iv
-
Get or set iv. - key
-
Get or set key. - sid_version
-
Version of the sid file, from the vers atom. - find_veggie_for_userID
-
Find the veeggie table and special shuffle case for the key's key. - fetch_all_user_keys
-
Find and decode all the keys in the SC Info.sidb file. - write_all_user_keys_to_drms_dir
-
Write all the decoded keys to files in the user's .drms directory file for use by VLC and compatible media players.
PUBLIC FUNCTIONS (function interfaces only)
- check_encrypted_sid
-
my $ok_check = check_encrypted_sid( $encrypted_sid_buffer ); Check an encrypted sid (in memory) for correct form to attemy decryption. - process_encrypted
-
process_encrypted( $buf_ref, $key, $iv ); process_encrypted( $buf_ref, 'FIND', 'FIND' ); Process the memory referred to by the scalar reference $buf_ref to decrypt it using $key and $iv. Attempt to find $key and $iv if 'FIND' is specified, using iTunes 7 algorithms and local machine data. - get_sid_key
-
my $key = get_sid_key( $mac ); Using iTunes / QuickTime based algorithms based on characteristics of the local machine, try to calculate the shuffled key for AES cryptography . - get_sid_iv
-
my $iv = get_sid_iv(); Return the default iTunes / QuickTime based iv for SC Info databases.
SEE ALSO
BUGS
Lots. Windows Vista dual boot compatibility seems flawed.
AUTHOR
William Herrera ( wherrera@skylightview.com ).
SUPPORT
Questions, feature requests and bug reports should go to <wherrera@skylightview.com>.
NOTES
Regarding the US DMCA Law
The U.S. Digital Millenum Copyright Act states in section 102, part (f):
-----------------------------------------------------------------------
`(f) REVERSE ENGINEERING- (1) Notwithstanding the provisions of subsection
(a)(1)(A), a person who has lawfully obtained the right to use a copy
of a computer program may circumvent a technological measure that
effectively controls access to a particular portion of that program
for the sole purpose of identifying and analyzing those elements of
the program that are necessary to achieve interoperability of an
independently created computer program with other programs, and that
have not previously been readily available to the person engaging
in the circumvention, to the extent any such acts of identification
and analysis do not constitute infringement under this title.
`(2) Notwithstanding the provisions of subsections (a)(2) and (b),
a person may develop and employ technological means to circumvent a
technological measure, or to circumvent protection afforded by a
technological measure, in order to enable the identification and
analysis under paragraph (1), or for the purpose of enabling
interoperability of an independently created computer program with
other programs, if such means are necessary to achieve such
interoperability, to the extent that doing so does not constitute
infringement under this title.
`(3) The information acquired through the acts permitted under
paragraph (1), and the means permitted under paragraph (2), may be
made available to others if the person referred to in paragraph (1)
or (2), as the case may be, provides such information or means solely
for the purpose of enabling interoperability of an independently
created computer program with other programs, and to the extent
that doing so does not constitute infringement under this title or
violate applicable law other than this section.
----------------------------------------------------------------------Our take on why this code is an example of free and protected speech:
The portion of the DMCA quoted above allows usage of protected content to
enable interoperability beween Linux and other systems. Therefore, since
this package and related Perl code are primarily designed to allow Linux,
Solaris, and Unix systems to achieve interoperability with iTunes and the
iTunes Music Store, they ARE legal under the DMCA. We are somewhat
concerned about the word "solely" in the text above, since this package
works under OS X and Windows as well as Linux. For that reason, please
also see the COPYRIGHT below.COPYRIGHT
Copyright (c) 2008 William Herrera. All rights reserved.
Licensing Terms
a) The terms of Perl itself, plus the following:
b) UNDER NO CIRCUMSTANCES CAN THIS CODE BE USED FOR CIRCUMVENTION OF ANY
TECHNOLOGICAL MEASURE WHICH EFFECTIVELY CONTROLS A PROTECTED MEDIA WORK
UNDER THE DCMA (USA, 1998) OR EU COPYRIGHT DIRECTIVE (EUCD, ARTICLE 6,
OF 2001), UNDER ANY OPERATING SYSTEM PLATFORM SUPPORTED BY APPLE COMPUTER
CORPORATION FOR ITS ITUNES OR IPOD PLAYER SOFTWARE IN ANY APPLE CORPORATION
DISTRIBUTED BINARY FORMAT OF ITUNES FOR THE PLATFORM UNDER WHICH THAT MEDIA
IS TO BE PLAYED. AS OF 2008, PROHIBITED PLATFORMS INCLUDE THE IPOD, IPHONE,
APPLE OS X, AND MICROSOFT WINDOWS, BUT NOT LINUX, BSD, OR SOLARIS. UNDER NO
CIRCUMSTANCES CAN THE AUTHOR(S) OF THIS CODE BE HELD LIABLE FOR ANY
INFRINGEMENT INVOLVING THE PROHIBITED PLATFORMS ABOVE.
c) Use, storage, or distribution of this code implies that you accept that
its intended purpose is legal and legitimate under any applicable US or EU
law, as above, and agree that any and all risk as to the quality,
performance, and legality of this code lies with you.