2007-07-31 10:18:30 +00:00
|
|
|
------------------------------------------------------------------------------
|
|
|
|
libburnia.pykix.org
|
|
|
|
------------------------------------------------------------------------------
|
|
|
|
This all is under GPL.
|
|
|
|
(See GPL reference, our clarification and commitment at the end of this text)
|
|
|
|
------------------------------------------------------------------------------
|
|
|
|
libburnia.pykix.org
|
|
|
|
By Mario Danic <mario.danic@gmail.com> and Thomas Schmitt <scdbackup@gmx.net>
|
2007-07-31 10:19:43 +00:00
|
|
|
Copyright (C) 2006-2007 Mario Danic, Thomas Schmitt
|
2007-07-31 10:18:30 +00:00
|
|
|
|
|
|
|
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.
|
|
|
|
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.
|
|
|
|
|
2007-07-31 10:19:43 +00:00
|
|
|
This libburnia.pykix.org toplevel README (C) 2006-2007 Thomas Schmitt
|
2007-07-31 10:18:30 +00:00
|
|
|
------------------------------------------------------------------------------
|
|
|
|
|
|
|
|
Build and Installation
|
|
|
|
|
|
|
|
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
|
|
|
|
./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
|
|
|
|
make
|
|
|
|
|
|
|
|
To make the libraries accessible for running resp. developing applications
|
|
|
|
make install
|
|
|
|
|
|
|
|
|
|
|
|
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
|
|
|
|
See README file there.
|
|
|
|
|
|
|
|
|
|
|
|
------------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
|
|
Overview of libburnia.pykix.org
|
|
|
|
|
|
|
|
libburnia.pykix.org is an open-source software project for reading, mastering
|
2007-07-31 10:19:43 +00:00
|
|
|
and writing optical discs.
|
|
|
|
For now this means only CD media and all single layer DVD media except DVD+R.
|
2007-07-31 10:18:30 +00:00
|
|
|
|
|
|
|
The project comprises of several more or less interdependent parts which
|
|
|
|
together strive to be a usable foundation for application development.
|
|
|
|
These are libraries, language bindings, and middleware binaries which emulate
|
|
|
|
classical (and valuable) Linux tools.
|
|
|
|
|
|
|
|
Our scope is currently Linux 2.4 and 2.6 only. For ports to other systems
|
|
|
|
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.
|
|
|
|
|
2007-07-31 10:19:43 +00:00
|
|
|
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
|
2007-07-31 10:18:30 +00:00
|
|
|
prove that usability, and in order to allow you to explore libburnia's scope
|
|
|
|
by help of existing cdrecord frontends.
|
|
|
|
|
|
|
|
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).
|
2007-07-31 10:19:43 +00:00
|
|
|
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.
|
2007-07-31 10:18:30 +00:00
|
|
|
|
|
|
|
- libisofs is the library to pack up hard disk files and directories into a
|
2007-07-31 10:19:43 +00:00
|
|
|
ISO 9660 disk image. This may then be brought to media via libburn.
|
2007-07-31 10:18:30 +00:00
|
|
|
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
|
2007-07-31 10:19:43 +00:00
|
|
|
the services traditionally provided by cdrecord. Additionally it
|
|
|
|
provides libburn's DVD capabilities, where only -sao is compatible
|
|
|
|
with cdrecord.
|
2007-07-31 10:18:30 +00:00
|
|
|
cdrskin does not contain any bytes copied from cdrecord's sources.
|
|
|
|
Many bytes have been copied from the message output of cdrecord
|
|
|
|
runs, though.
|
2007-07-31 10:19:43 +00:00
|
|
|
See cdrskin/README and man cdrskin/cdrskin.1 for more.
|
2007-07-31 10:18:30 +00:00
|
|
|
|
|
|
|
- test is a collection of application gestures and examples given by the
|
|
|
|
authors of the library features. The main API example for libburn
|
|
|
|
is test/libburner.c .
|
|
|
|
Explore these examples if you look for inspiration.
|
|
|
|
|
|
|
|
We plan to be a responsive upstream. Bear with us. We are still practicing.
|
|
|
|
|
|
|
|
|
|
|
|
------------------------------------------------------------------------------
|
|
|
|
Project history as far as known to me:
|
|
|
|
|
|
|
|
- Founded in 2002 as it seems. See mailing list archives
|
|
|
|
http://lists.freedesktop.org/archives/libburn/
|
|
|
|
The site of this founder team is reachable and offers download of a
|
|
|
|
(somewhat outdated) tarball and from CVS :
|
|
|
|
http://icculus.org/burn/
|
|
|
|
Copyright holders and most probably founders:
|
|
|
|
Derek Foreman and Ben Jansens.
|
|
|
|
|
|
|
|
- I came to using libburn in 2005. Founded the cdrskin project and submitted
|
|
|
|
necessary patches which were accepted or implemented better. Except one
|
|
|
|
remaining patch which prevented cdrskin from using vanilla libburn from CVS.
|
|
|
|
The cdrskin project site is reachable and offers download of the heavily
|
|
|
|
patched (elsewise outdated) tarball under the name cdrskin-0.1.2 :
|
|
|
|
http://scdbackup.sourceforge.net/cdrskin_eng.html
|
|
|
|
It has meanwhile moved to use vanilla libburn.pykix.org , though.
|
|
|
|
Version 0.1.4 constitutes the first release of this kind.
|
|
|
|
|
2007-07-31 10:19:43 +00:00
|
|
|
- In July 2006 our team mate Mario Danic announced a revival of libburn
|
2007-07-31 10:18:30 +00:00
|
|
|
which by about nearly everybody else was perceived as unfriendly fork.
|
|
|
|
Derek Foreman four days later posted a message which expressed his
|
|
|
|
discontent.
|
|
|
|
The situation first caused me to publically regret it and then - after i
|
|
|
|
got the opportunity to move in with cdrskin - gave me true reason to
|
|
|
|
personally apologize to Derek Foreman, Ben Jansens and the contibutors at
|
|
|
|
icculus.org/burn. Posted to both projects:
|
|
|
|
http://lists.freedesktop.org/archives/libburn/2006-August/000446.html
|
|
|
|
http://mailman-mail1.webfaction.com/pipermail/libburn-hackers/2006-August/000024.html
|
|
|
|
|
|
|
|
- Mid August 2006 project cdrskin established a branch office in
|
|
|
|
libburn.pykix.org so that all maintainers of our tools have one single place
|
|
|
|
to get the current (at least slightely) usable coordinated versions of
|
|
|
|
everything.
|
|
|
|
Project cdrskin will live forth independendly for a while but it is committed
|
|
|
|
to stay in sync with libburn.pykix.org (or some successor, if ever).
|
|
|
|
cdrskin is also committed to support icculus.org/burn if the pending fork
|
|
|
|
is made reality by content changes in that project. It will cease to maintain
|
|
|
|
a patched version of icculus.org/burn though. Precondition for a new
|
|
|
|
release of cdrskin on base of icculus.org/burn would be the pending
|
|
|
|
"whitelist patch" therefore.
|
|
|
|
I would rather prefer if both projects find consense and merge, or at least
|
|
|
|
cooperate. I have not given up hope totally, yet.
|
|
|
|
I, personally, will honor any approach.
|
|
|
|
|
|
|
|
- 2nd September 2006 the decision is made to strive for a consolidation of
|
|
|
|
copyright and a commitment to GPL in a reasonable and open minded way.
|
|
|
|
This is to avoid long term problems with code of unknown origin and
|
|
|
|
with finding consense among the not so clearly defined group of copyright
|
|
|
|
claimers and -holders.
|
|
|
|
libisofs is already claimed sole copyright Mario Danic.
|
|
|
|
cdrskin and libburner are already claimed sole copyright Thomas Schmitt.
|
|
|
|
Rewrites of other components will follow and concluded by claiming full
|
|
|
|
copyright within the group of libburn.pykix.org-copyright holders.
|
|
|
|
|
|
|
|
- 16th September 2006 feature freeze for release of libburn-0.2.2 .
|
|
|
|
|
|
|
|
- 20th September 2006 release of libburn-0.2.2 .
|
|
|
|
|
|
|
|
- 26th October 2006 feature freeze for cdrskin-0.2.4 based on libburn-0.2.3 .
|
|
|
|
This version of cdrskin is much more cdrecord compatible in repect
|
|
|
|
to drive addressing and audio features.
|
|
|
|
|
|
|
|
- 30th October 2006 release of cdrskin-0.2.4 .
|
|
|
|
|
|
|
|
- 13th November 2006 splitting releases of libburn+cdrskin from libisofs.
|
|
|
|
|
|
|
|
- 24th November 2006 release of libburn-0.2.6 and cdrskin-0.2.6 . cdrskin has
|
|
|
|
become suitable for unaware frontends as long as they perform only the core
|
|
|
|
of cdrecord use cases (including open-ended input streams, audio, and
|
|
|
|
multi-session).
|
|
|
|
|
|
|
|
- 28th November 2006 the umbrella project which encloses both, libisofs and
|
|
|
|
libburn, is now called libburnia. For the origin of this name, see
|
|
|
|
http://en.wikipedia.org/wiki/Liburnians .
|
|
|
|
|
2007-07-31 10:19:43 +00:00
|
|
|
- 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.
|
|
|
|
|
2007-07-31 10:18:30 +00:00
|
|
|
|
|
|
|
------------------------------------------------------------------------------
|
|
|
|
|
|
|
|
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
|
2007-07-31 10:19:43 +00:00
|
|
|
the Free Software Foundation. To be exact: version 2 of that License.
|
2007-07-31 10:18:30 +00:00
|
|
|
|
|
|
|
This program is distributed in the hope that it will be useful,
|
|
|
|
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.
|
|
|
|
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
|
|
along with this program; if not, write to the Free Software
|
|
|
|
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
|
|
|
|
|
|
|
------------------------------------------------------------------------------
|
|
|
|
Clarification in my name and in the name of Mario Danic, upcoming copyright
|
|
|
|
holders on toplevel of libburnia. To be fully in effect after the remaining
|
|
|
|
other copyrighted code has been replaced by ours and by copyright-free
|
|
|
|
contributions of our friends:
|
|
|
|
------------------------------------------------------------------------------
|
|
|
|
|
|
|
|
We, the copyright holders, agree on the interpretation that
|
|
|
|
dynamical linking of our libraries constitutes "use of" and
|
|
|
|
not "derivation from" our work in the sense of GPL, provided
|
|
|
|
those libraries are compiled from our unaltered code.
|
|
|
|
|
|
|
|
Thus you may link our libraries dynamically with applications
|
|
|
|
which are not under GPL. You may distribute our libraries and
|
|
|
|
application tools in binary form, if you fulfill the usual
|
|
|
|
condition of GPL to offer a copy of the source code -altered
|
|
|
|
or unaltered- under GPL.
|
|
|
|
|
|
|
|
We ask you politely to use our work in open source spirit
|
|
|
|
and with the due reference to the entire open source community.
|
|
|
|
|
|
|
|
If there should really arise the case where above clarification
|
|
|
|
does not suffice to fulfill a clear and neat request in open source
|
|
|
|
spirit that would otherwise be declined for mere formal reasons,
|
|
|
|
only in that case we will duely consider to issue a special license
|
|
|
|
covering only that special case.
|
|
|
|
It is the open source idea of responsible freedom which will be
|
|
|
|
decisive and you will have to prove that you exhausted all own
|
|
|
|
means to qualify for GPL.
|
|
|
|
|
|
|
|
For now we are firmly committed to maintain one single license: GPL.
|
|
|
|
|
|
|
|
signed: Mario Danic, Thomas Schmitt
|
|
|
|
|