Burgner README


The Burgner project aims to be a complete free burning suite,
totally rewritten from scratch: it does not include any code from
cdrtools (cdrecord and mkisofs) nor cdrdao, and is not a
front-end for these tools.

It is fully object-oriented (it uses glib's GObject), entirely written
in C, and released under the GNU GPL license (libraries and tools).

Features:
	- can generate *ISO9660* images, with the *RockRidge* and
	  *ElTorito* extensions (these extensions are obviously
	  optional), *directories relocating* (infinite directory level
	  with RockRidge), with various optimizations (inodes caching,
	  optimal file system's items arranging, etc.).

	- can burn CD-DA and CD-ROM tracks.

	- can burn CD-EXTRA ! (CD that contains audio and data, but that
	  seems to be "audio-only" CDs in CD players (no first void
	  track). See below.

	- fully asynchronous and event-oriented API, to be easily used by a
	  GTK+/GNOME application.


It depends on:
	o glib-2.0 >= 2.0;
	o gobject-2.0 >= 2.0 (included in the glib package);
	o gnome-vfs-2.0 >= 2.0.


It is (for now) divided in 5 parts:
	- libburgnerutils: a library containing a few utility routines
		and objects, needed by the other parts of Burgner.

	- libburgnerscsi: a library to manipulate Scsi-like devices,
	  like SCSI devices, and IDE ones. To work for each system, it uses
	  "plugins" which do low-level I/O. For now, the last linux
	  scsi driver and the linux CDROM driver (instable) are supported,
	  but plugins for others drivers, may be written easily.

	- libburgnermmc: a more a less high level library, based on the
	  libburgnerscsi, to manipulate CD burners.

	- libburgnerisofs: a library to generate ISO9660 file-systems.

	- burgner-mkisofs and burgner-cdrecord: little command-line
	  tools to generate ISO9660 file systems and burn them. See
	  burgner-cdrecord --help and burgner-mkisofs --help for more
	  informations.

Usage:
	- to generate a ISO9660 image, type:
		$ burgner-mkisofs [options] files...
		e.g. :
		$ burgner-mkisofs -r --cache-inodes --with-optimize
		--output image.iso --eltorito-media-image
		/path/to/boot_image --eltorito-bootable ~/Documents/*

	- to burn it, type:
		$ burgner-cdrecord -d file://linux-scsi-3/path/to/device
		--data <track> --eject --speed <speed> -v
		e.g. :
		$ burgner-cdrecord -d file://linux-scsi-3/dev/sg0
		--data image.iso --eject --speed 48 -v

	- to burn an audio CD, type:
		$ burgner-cdrecord -d file://linux-scsi-3/path/to/device
		--audio wav_file_1.wav --audio wav_file_2.wav ... --audio
		wav_file_n.wav --eject --speed <speed> -v
		e.g. :
		$ burgner-cdrecord -d file://linux-scsi-3/dev/sg0
		--audio track01.wav --audio track02.wav --eject --speed
		48 -v

    Temporary solutions:
	- to blank a disc, type:
		$ burgner-scsi-test -d
		file://linux-scsi-3/path/to/device --blank <blank_type>
		e.g. :
		$ burgner-scsi-test -d file://linux-scsi-3/dev/sg0
		--blank minimal
		Note: this only send a 'BLANK' command to the drive, so
		the disc must be inserted, and this may not work
		immediatly (you may have to run the command a second
		time for the blanking to begin).

	- to list available devices, type:
		$ burgner-scsi-test --list-all-devices

	- to burn a CD-EXTRA, burn your audio tracks first, allowing a
	  next session:
	  	$ burgner-cdrecord -d file://linux-scsi-3/dev/??
		--audio track01.wav --audio track02.wav --eject --speed
		48 --session allow_next -v

	+ then get the Next Writable Address (NWA):
		$ burgner-scsi-test -d file://linux-scsi-3/dev/??
		--get-nwa

		This will give you a number (the NWA) alone in a line.

	+ generate your data image, giving burgner-mkisofs the NWA with
	  the --first-sector-lba option:
	  	$ burgner-mkisofs [ your options ... ]
		--first-sector-address [NWA]

	+ That's all!


Future: Unfortunately, I won't have enough time to maintain Burgner from
the beginning of September. So I am looking for new maintainers/coders
for Burgner, and will try to make Burgner a GNU project. Nevertheless I
will be able to answer new maintainers' questions.


--

Burgner homepage: http://burgner.tuxfamily.org
E-Mail: burgner AT tuxfamily DOT org

