rmmc --- readonly(or remote, reduced) multimedia commands patch for iSCSI Enterprise Target

contact 

rmmc - readonly(or remote, reduced) multimedia
    commands patch for iSCSI Enterprise Target
                             Junjiro Okajima
                    http://www2.ttcn.ne.jp/~rmmc/
                               July 27, 2005
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
                                    Abstract
This is a patch for iSCSI Enterprise Target (http:/iscsitarget.sourceforge.
net/) which is developed on the SourceForge.net. This patch adds a feature to
support SCSI MMC command set(partial) for CD/DVD drives. With this patch,
iSCSI Target can open/share the virtual CD/DVD drives on the network, and
iSCSI Initiator can handle them as if they were connected to the local machine.
NFS and Samba share the *files*, but iSCSI share the *devices or drives*.
                                                                            1
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
                                    Features
Features this patch adds,,,
  o  receive and response to the SCSI commands which are needed to access
     the CD/DVD drive.
  o  effective transmission with the sendfile method.
  o  CSS authentication per a iSCSI connection.
  o  sending the DVD contents with encrypted. this software never decrypt the
     contents.
  o  statistics per a iSCSI connection.
                                                                            2
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
                       Requirement(Server, iSCSI Target)
---------------------------------------------------------------------------|
     OS,      ||
              |Linux-2.6.11  or  later,  iSCSI  Enterprise  Target  version
   Software   |
              |0.4.10(r1185), css-auth library
--------------|------------------------------------------------------------|
     Disk     |large capacity will be necessary in order to store the im-
              |ages of CD/DVD media. a DVD media will be a size of 4 -
              |8 GB. a RAID system is better to keep the responsibility
              |under the heavy load.
--------------|------------------------------------------------------------
     NIC     | playing mpeg-2 requires 5 - 10Mbps per a client.
-------------|-------------------------------------------------------------|
     CPU,     |
              |basically, it is not required powerful CPU. it is tested on
   Memory     ||
              |Intel Celeron(coppermine) 500MHz with 64MB with two
              |iSCSI initiators.
--------------|------------------------------------------------------------
Both of the server and client doesn't require the SCSI/iSCSI controllers(ie. hardware).
                                                                            3
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
                      Requirement(Client, iSCSI Initiator)
Only iSCSI Initiator and DVD player software are necessary
------------------------------------------------------------------------------------
          OS          |  currently tested MS Windows XP SP2 only.
----------------------|-------------------------------------------------------------
 DVD player software |   currently tested MS Windows Media Player only.
---------------------|--------------------------------------------------------------
     iSCSI initiator     |currently tested MS iSCSI Initiator only.
-------------------------|----------------------------------------------------------
Both of the server and client doesn't require the SCSI/iSCSI controllers(ie. hardware).
                                                                            4
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
                                    Warning
It is strictly prohibited to copy the copyright protected contents, and this soft-
ware don't want to violate the right of the copyright owner.
                                                                            5

You may need additional library, css-auth library. This library is located on many places on the internet so you will be able to get easily. Put it under the iet directory, ie. next to 'include', 'user' and 'kernel.'

But don't forget that the un-allowed copying the copyright protected contents is illegal. And I don't want to use this software to break the law.

rmmc patch

After you have succeeded the installation of plain(un-patched) IET-0.4.8 or later, and put the css-auth library mentioned above, you can use this rmmc patch.

  1. patch it as usual(by patch command).
  2. re-build IET entirely. rmmcgen command is built under usr sub dir.
  3. rmmcgen can be run on linux with a dvd drive. load the media and mount it wherever you like.
  4. run rmmcgen command. it will produce two files, one is the dvd image file, and the other is the auxulary information. as you know, the image file will be 4 - 8 GB size. these filenames are 'img', and 'img.aux' by default. Once again, the un-allowed copying the copyright protected contents is illegal.
  5. add the 'Lun' line in your ietd.conf. the syntax is very simliar to fileio type. but the 'Type' parameter is 'rmmcio' instead of 'fileio'. and the target type ('Type' line) is 1 instead of 0. 'Path' parameter should be the path of 'img' file. there is no parameter for 'img.aux' since rmmc patch automatically find the 'img.aux' under the same directory to 'img' file.
  6. and there is another parameter specifying a media type, called 'media=DVDROM'.
  7. if your image file is not generated by rmmcgen command, and it is an iso image file(ie. cdrom image), you should put the parameter 'media=CDROM'.
  8. invoke IET.
  9. then your iscsi initiator will be able to find the virtual dvd drive. After succesful login, you can play the movie or the contents of the media.

statistics patch

under re-construction.

iet-0.4.12

iet-0.4.11

iet-0.4.10

iet-0.4.9

iet-0.4.8

iet-0.4.7