Thomas Schmitt 2020-07-04 15:09:33 +00:00
parent 2b9b61c13d
commit fa58ee885a

145
home.md Normal file

@ -0,0 +1,145 @@
# Welcome to libburnia project
### NEWS
* **Mon Nov 25 2019** Bug fix release 1.5.2.pl01 of
[libburn](http://files.libburnia-project.org/releases/libburn-1.5.2.pl01.tar.gz)
is ready on [release page](Releases). cdrskin did not properly burn multiple
tracks. Track 1 was slow and burning stalled before track 2. Regression
introduced by 1.5.0.
* **Sat Oct 27 2019** Release 1.5.2 is ready on [release page](Releases).
The libraries are now ready for building out-of-source.
[libisofs](http://files.libburnia-project.org/releases/libisofs-1.5.2.tar.gz)
got minor API extensions.
[libburn](http://files.libburnia-project.org/releases/libburn-1.5.2.pl01.tar.gz)
got a bug fixed which spoiled burn runs on some MATSHITA laptop drives. It
is now able to list all features which the drive announces.
[xorriso and libisoburn](http://files.libburnia-project.org/releases/libisoburn-1.5.2.tar.gz)
xorriso can now set GPT type GUIDs with appended partitions and the ISO
partition.
All three libraries got some rarely triggered bugs fixed.
* **Thu Aug 1 2019** we celebrate 13 years of libburnia project.
* **Fri Oct 28 2016** We moved from `Trac/svn/bzr` to `GitLab/git`.
* **Sun Mar 20 2016** The wiki article
[about problems with concurrent burns](Concurrentlinuxsr)
describes two workarounds for the poor throughput which can be observed
on Linux if libburn operates more than one drive at a time.
### ABOUT
libburnia is a project for [reading](Reading), [mastering](Mastering)
and [writing](Writing) optical discs. Currently it is
comprised of libraries named [libisofs](Libisofs), [libburn](Libburn),
[libisoburn](Libisoburn), a cdrecord emulator named [cdrskin](Cdrskin),
and an integrated multi-session tool named [xorriso](Xorriso).
The software runs on GNU/Linux, FreeBSD, Solaris, NetBSD, OpenBSD.
It is base of the
[GNU xorriso](http://www.gnu.org/software/xorriso/xorriso_eng.html) package.
### LICENCE
The source code for the libburnia project is distributed under the terms
of the
[GNU General Public License version 2 or later (GPLv2+)](https://www.gnu.org/licenses/gpl-2.0.html).
Be aware that linking libisoburn with GPLv3+ library `libreadline-6`
will automatically change the license of the resulting `libisoburn.so`
and `xorriso` binary to GPLv3+.
### SOURCE CODE
The current release tarballs are available at [Releases Page](Releases).
The project lives in a [git](https://git-scm.com/) repository hosted on
[https://dev.lovelyhq.com/libburnia](https://dev.lovelyhq.com/groups/libburnia).
You can check-out the latest unstable versions using:
```
git clone https://dev.lovelyhq.com/libburnia/libburn.git
git clone https://dev.lovelyhq.com/libburnia/libisofs.git
git clone https://dev.lovelyhq.com/libburnia/libisoburn.git
```
### [Browse git online](https://dev.lovelyhq.com/groups/libburnia).
For building the libraries and binaries from git you will need `autotools`
of at least version 1.7.
### DOCUMENTATION
Wiki page with [Frequently Asked Questions](Faq).
**Current development version:**
Manual pages of command line programs:
* [man 1 cdrskin](http://scdbackup.sourceforge.net/man_1_cdrskin_devel.html)
* [man 1 xorriso](http://www.gnu.org/software/xorriso/man_1_xorriso_devel.html)
* [man 1 xorrisofs](http://www.gnu.org/software/xorriso/man_1_xorrisofs_devel.html)
* [man 1 xorrecord](http://www.gnu.org/software/xorriso/man_1_xorrecord_devel.html)
The APIs of the libraries are documented in their C header files:
* [libburn/libburn.h](https://dev.lovelyhq.com/libburnia/libburn/raw/HEAD/libburn/libburn.h)
* [libisofs/libisofs.h](https://dev.lovelyhq.com/libburnia/libisofs/raw/HEAD/libisofs/libisofs.h)
* [libisoburn/libisoburn.h](https://dev.lovelyhq.com/libburnia/libisoburn/raw/HEAD/libisoburn/libisoburn.h)
* [libisoburn/xorriso.h](https://dev.lovelyhq.com/libburnia/libisoburn/raw/HEAD/xorriso/xorriso.h)
Example programs:
* [libburn/test/libburner](https://dev.lovelyhq.com/libburnia/libburn/raw/HEAD/test/libburner.c)
demonstrates fundamental API gestures for burning, blanking and formatting
optical media.
* [libburn/test/telltoc](https://dev.lovelyhq.com/libburnia/libburn/raw/HEAD/test/telltoc.c)
demonstrates fundamental API gestures for inquiring the state of optical media.
* [libisofs/demo/demo](https://dev.lovelyhq.com/libburnia/libisofs/raw/HEAD/demo/demo.c)
demonstrates fundamental API gestures of libisofs.
* [libisoburn/frontend/frontend_pipes_xorriso](https://dev.lovelyhq.com/libburnia/libisoburn/raw/HEAD/frontend/frontend_pipes_xorriso.c)
demonstrates `xorriso` as dialog slave under control of a C program.
* [libisoburn/frontend/sh_on_named_pipes.sh](https://dev.lovelyhq.com/libburnia/libisoburn/raw/HEAD/frontend/sh_on_named_pipes.sh)
demonstrates `xorriso` as dialog slave under control of a bash script.
* [libisoburn/frontend/xorriso-tcltk](https://dev.lovelyhq.com/libburnia/libisoburn/raw/HEAD/frontend/xorriso-tcltk)
demonstrates `xorriso` as dialog slave under GUI control of a Tcl/Tk script.
See also [mini introduction](https://dev.lovelyhq.com/libburnia/libisoburn/blob/master/frontend/README-tcltk).
`README` files:
* [libburn](https://dev.lovelyhq.com/libburnia/libburn/raw/HEAD/README)
* [libisofs](https://dev.lovelyhq.com/libburnia/libisofs/raw/HEAD/README)
* [libisoburn](https://dev.lovelyhq.com/libburnia/libisoburn/raw/HEAD/README)
* [GNU xorriso](https://dev.lovelyhq.com/libburnia/libisoburn/raw/HEAD/xorriso/README_gnu_xorriso)
### CONTRIBUTION
We welcome and consider any sorts of contribution although not all can
be accepted, of course. If you want to contribute to libburnia project
development, then report experiences, propose new features, or post patches
for discussion on
[bug-xorriso at gnu dot org](https://lists.gnu.org/mailman/listinfo/bug-xorriso).
### MAILING LISTS
Please send support requests and proposals to
[bug-xorriso at gnu dot org](https://lists.gnu.org/mailman/listinfo/bug-xorriso) - Public mailing list of GNU xorriso.
### DONATIONS
Any donations made to the libburnia project would greatly assist
its progress by helping us to acquire drives and media. If you would
like to donate, please mail us:
* mario.danic [at] gmail [dot] com, Cc: scdbackup [at] gmx [dot] net.
### DEVELOPERS
Thomas Schmitt - scdbackup [at] gmx [dot] net - Current main developer
Mario Đanić - mario [at] libburnia-project [dot] org - Founder, webmaster, developer