Mario Danic
13 years ago
1 changed files with 51 additions and 26 deletions
Split View
Diff Options
-
+51 -26README
+ 51
- 26
README
View File
| @@ -1,25 +1,25 @@ | |||
| ------------------------------------------------------------------------------ | |||
| libburnia.pykix.org | |||
| libburnia-project.org | |||
| ------------------------------------------------------------------------------ | |||
| This all is under GPL. | |||
| (See GPL reference, our clarification and commitment at the end of this text) | |||
| ------------------------------------------------------------------------------ | |||
| libburnia.pykix.org | |||
| libburnia-project.org | |||
| By Mario Danic <mario.danic@gmail.com> and Thomas Schmitt <scdbackup@gmx.net> | |||
| Copyright (C) 2006 Mario Danic, Thomas Schmitt | |||
| Copyright (C) 2006-2007 Mario Danic, Thomas Schmitt | |||
| Still containing parts of | |||
| Libburn. By Derek Foreman <derek@signalmarketing.com> and | |||
| Ben Jansens <xor@orodu.net> | |||
| Copyright (C) 2002-2006 Derek Foreman and Ben Jansens | |||
| These parts are to be replaced by own code of above libburnia.pykix.org | |||
| copyright holders and then libburnia.pykix.org is to be their sole copyright. | |||
| These parts are to be replaced by own code of above libburnia-project.org | |||
| copyright holders and then libburnia-project.org is to be their sole copyright. | |||
| This is done to achieve the right to issue the clarification and the | |||
| commitment as written at the end of this text. | |||
| The rights and merits of the Libburn-copyright holders Derek Foreman and | |||
| Ben Jansens will be duely respected. | |||
| This libburnia.pykix.org toplevel README (C) 2006 Thomas Schmitt | |||
| This libburnia-project.org toplevel README (C) 2006-2007 Thomas Schmitt | |||
| ------------------------------------------------------------------------------ | |||
| Build and Installation | |||
| @@ -27,16 +27,16 @@ This libburnia.pykix.org toplevel README (C) 2006 Thomas Schmitt | |||
| Our build system is based on autotools. For preparing the build of a SVN | |||
| snapshot you will need autotools of at least version 1.7. | |||
| Check out from SVN by | |||
| svn co http://libburnia-svn.pykix.org/libburn/trunk libburn_pykix | |||
| go into directory libburn_pykix and apply autotools by | |||
| svn co http://svn.libburnia-project.org/libburn/trunk libburn | |||
| go into directory libburn and apply autotools by | |||
| ./bootstrap | |||
| Alternatively you may unpack a release tarball for which you do not need | |||
| autotools installed. | |||
| To build a libburnia.pykix.org subproject it should be sufficient to go | |||
| into its toplevel directory (here: "libburn_pykix") and execute | |||
| ./configure | |||
| To build a libburnia-project.org subproject it should be sufficient to go | |||
| into its toplevel directory (here: "libburn") and execute | |||
| ./configure --prefix=/usr | |||
| make | |||
| To make the libraries accessible for running resp. developing applications | |||
| @@ -44,17 +44,18 @@ To make the libraries accessible for running resp. developing applications | |||
| The other half of the project, libisofs, is hosted in the libburnia SVN, too: | |||
| svn co http://libburnia-svn.pykix.org/libisofs/trunk libisofs_pykix | |||
| svn co http://svn.libburnia-project.org/libisofs/trunk libisofs | |||
| See README file there. | |||
| ------------------------------------------------------------------------------ | |||
| Overview of libburnia.pykix.org | |||
| Overview of libburnia-project.org | |||
| libburnia.pykix.org is an open-source software project for reading, mastering | |||
| and writing optical discs. For now this means only CD-R and CD-RW. | |||
| libburnia-project.org is an open-source software project for reading, mastering | |||
| and writing optical discs. | |||
| For now this means only CD media and all single layer DVD media except DVD+R. | |||
| The project comprises of several more or less interdependent parts which | |||
| together strive to be a usable foundation for application development. | |||
| @@ -66,10 +67,10 @@ we would need : login on a development machine resp. a live OS on CD or DVD, | |||
| advise from a system person about the equivalent of Linux sg or FreeBSD CAM, | |||
| volunteers for testing of realistic use cases. | |||
| We do have a workable code base for burning data CDs, though. The burn API is | |||
| quite comprehensively documented and can be used to build a presentable | |||
| application. | |||
| We do have a functional binary which emulates parts of cdrecord in order to | |||
| We have a workable code base for burning CD and most single layer DVD. | |||
| The burn API is quite comprehensively documented and can be used to build a | |||
| presentable application. | |||
| We have a functional binary which emulates parts of cdrecord in order to | |||
| prove that usability, and in order to allow you to explore libburnia's scope | |||
| by help of existing cdrecord frontends. | |||
| @@ -78,20 +79,25 @@ The project components (list subject to growth, hopefully): | |||
| - libburn is the library by which preformatted data get onto optical media. | |||
| It uses either /dev/sgN (e.g. on kernel 2.4 with ide-scsi) or | |||
| /dev/hdX (e.g. on kernel 2.6). | |||
| libburn is the foundation of our cdrecord emulation. | |||
| libburn is the foundation of our cdrecord emulation. Its code is | |||
| independent of cdrecord. Its DVD capabilities are learned from | |||
| studying the code of dvd+rw-tools and MMC-5 specs. No code but only | |||
| the pure SCSI knowledge has been taken from dvd+rw-tools, though. | |||
| - libisofs is the library to pack up hard disk files and directories into a | |||
| ISO 9660 disk image. This may then be brought to CD via libburn. | |||
| ISO 9660 disk image. This may then be brought to media via libburn. | |||
| libisofs is to be the foundation of our upcoming mkisofs emulation. | |||
| - cdrskin is a limited cdrecord compatibility wrapper for libburn. | |||
| Cdrecord is a powerful GPL'ed burn program included in Joerg | |||
| Schilling's cdrtools. cdrskin strives to be a second source for | |||
| the services traditionally provided by cdrecord. | |||
| the services traditionally provided by cdrecord. Additionally it | |||
| provides libburn's DVD capabilities, where only -sao is compatible | |||
| with cdrecord. | |||
| cdrskin does not contain any bytes copied from cdrecord's sources. | |||
| Many bytes have been copied from the message output of cdrecord | |||
| runs, though. | |||
| See cdrskin/README for more. | |||
| See cdrskin/README and man cdrskin/cdrskin.1 for more. | |||
| - test is a collection of application gestures and examples given by the | |||
| authors of the library features. The main API example for libburn | |||
| @@ -121,7 +127,7 @@ Project history as far as known to me: | |||
| It has meanwhile moved to use vanilla libburn.pykix.org , though. | |||
| Version 0.1.4 constitutes the first release of this kind. | |||
| - In Juli 2006 our team mate Mario Danic announced a revival of libburn | |||
| - In July 2006 our team mate Mario Danic announced a revival of libburn | |||
| which by about nearly everybody else was perceived as unfriendly fork. | |||
| Derek Foreman four days later posted a message which expressed his | |||
| discontent. | |||
| @@ -178,13 +184,32 @@ Project history as far as known to me: | |||
| libburn, is now called libburnia. For the origin of this name, see | |||
| http://en.wikipedia.org/wiki/Liburnians . | |||
| - 16th January 2007 release of libburn-0.3.0 and cdrskin-0.3.0 . Now the scope | |||
| is widened to a first class of DVD media: overwriteable single layer types | |||
| DVD-RAM, DVD+RW, DVD-RW. This is not a cdrecord emulation but rather inspired | |||
| by dvd+rw-tools' "poor man" writing facility for this class of media. | |||
| Taking a bow towards Andy Polyakov. | |||
| - 11th February 2007 version 0.3.2 covers sequential DVD-RW and DVD-R with | |||
| multi-session and with DAO. | |||
| - 12th March 2007 version 0.3.4 supports DVD+R and thus covers all single layer | |||
| DVD media. Code for double layer DVD+/-R is implemented but awaits a tester | |||
| yet. | |||
| - 23th April 2007 version 0.3.6 follows the unanimous opinion of Linux kernel | |||
| people that one should not use /dev/sg on kernel 2.6. | |||
| - 31st July 2007 version 0.3.8 marks the first anniversary of libburn revival. | |||
| We look back on improved stability, a substantially extended list of media | |||
| and write modes, and better protection against typical user mishaps. | |||
| ------------------------------------------------------------------------------ | |||
| This program is free software; you can redistribute it and/or modify | |||
| 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. | |||
| the Free Software Foundation. To be exact: version 2 of that License. | |||
| This program is distributed in the hope that it will be useful, | |||
| but WITHOUT ANY WARRANTY; without even the implied warranty of | |||