Commit a39ce4fd authored by TANIGUCHI Takaki's avatar TANIGUCHI Takaki

Imported Upstream version 0.72

parents
This diff is collapsed.
This diff is collapsed.
Mnoho poděkování patří následujícím lidem (v alfabetickém pořadí):
Harald Bögeholz (hwb@heise.de)
poskytl řadu podstatných diskuzí o obnově dat na CD/DVD
a opravě chyb Reed-Solomon.
"Adaptivní strategie čtení" v programu dvdisaster je založena na
na jeho doporučeních a nápadech; implementoval podobnou strategii
předtím a publikoval ji v čísle 16/2005 německého periodika "c't".
Julian Einwag (julian@einwag.de).
provides and maintains the Mac OS X / Darwin port.
Igor Gorbounov (igorbounov@topazelectro.ru)
provides and maintains the Russian translation.
Andrei Grecu (andrei.grecu@aon.at)
provided an algorithm for recovering defective CD sectors
from multiple incomplete RAW reading attempts.
Phil Karn
napsal vynikající knihovnu pro tvorbu a dekódování kódu Reed-Solomon.
Tento projekt si vzal hodně inspirace - a dokonce kódu -
z jeho knihovny, kterou lze nalézt na http://www.ka9q.net/code/fec/
Protože byl kód optimalizován a zkrácen pro speciální potřeby
programu dvdisaster, měli byste ziskat originální věc, máte-li
zájem na zabudování RS kódů do vaší aplikace.
Daniel Nylander (info@danielnylander.se)
provides and maintains the Swedish translation.
Andrea Polverini (polve@polve.com)
poskytuje a udržuje italský překlad.
Luboš Staněk (lubek@users.sourceforge.net)
poskytuje a udržuje český překlad.
Sergey Svishchev (svs@ropnet.ru)
provided the NetBSD port.
Mnoho dalších lidí poskytlo další doporučení a chybové zprávy;
podrobnosti viz soubor CHANGELOG.
Vielen Dank an die folgenden Personen (in alphabetischer Reihenfolge):
Harald Bögeholz (hwb@heise.de)
für viele tiefgehende Diskussionen über CD/DVD-Datenrettung
und Reed-Solomon-Fehlerkorrektur.
Die "angepaßte Lese-Strategie" in dvdisaster geht auf seine
Anregungen und Ideen zurück; er hatte zuvor schon eine ähnliche
Strategie entwickelt und in Ausgabe 16/2005 der c't veröffentlicht.
Julian Einwag (julian@einwag.de)
erstellt und pflegt die Mac OS X / Darwin - spezifischen Anpassungen.
Igor Gorbounov (igorbounov@topazelectro.ru)
erstellt und pflegt die russische Übersetzung.
Andrei Grecu (andrei.grecu@aon.at)
hat den Algorithmus zum Wiederherstellen von defekten CD-Sektoren
aus mehreren Leseversuchen entwickelt.
Phil Karn
hat eine hervorragende Bibliothek zum Erzeugen und Dekodieren
von Reed-Solomon-Kodes geschrieben. Dieses Projekt verdankt seiner
Bibliothek viel Inspiration - und auch einigen Programmcode.
Weil der Programmkode für dvdisaster angepaßt und optimiert worden
ist, sollten Sie sich unter http://www.ka9q.net/code/fec/ die
Originalversion von Phils Bibliothek herunterladen, wenn Sie
Reed-Solomon-Kode in Ihren eigenen Programmen verwenden möchten.
Daniel Nylander (info@danielnylander.se)
erstellt und pflegt die schwedische Übersetzung.
Andrea Polverini (polve@polve.com)
erstellt und pflegt die italienische Übersetzung.
Luboš Staněk (lubek@users.sourceforge.net)
erstellt und pflegt die tschechische Übersetzung.
Sergey Svishchev (svs@ropnet.ru)
hat die NetBSD-spezifischen Anpassungen vorgenommen.
Viele andere Personen haben weitere Anregungen und Fehlerberichte
geliefert; schauen Sie auch in den Änderungsbericht für weitere
Einzelheiten darüber.
\ No newline at end of file
Many thanks to the following people (in alphabetical order):
Harald Bögeholz (hwb@heise.de)
provided a lot of insightful discussions on CD/DVD data
recovery and Reed-Solomon error correction.
The "adaptive read strategy" in dvdisaster is based upon his
suggestions and ideas; he had implemented a similar strategy
before and published in issue 16/2005 of the german periodical "c't".
Julian Einwag (julian@einwag.de).
provides and maintains the Mac OS X / Darwin port.
Igor Gorbounov (igorbounov@topazelectro.ru)
provides and maintains the Russian translation.
Andrei Grecu (andrei.grecu@aon.at)
provided an algorithm for recovering defective CD sectors
from multiple incomplete RAW reading attempts.
Phil Karn
wrote an excellent library for creating and decoding Reed-Solomon
codes. This project draws a lot of inspiration - and even code -
from his library which can be found at http://www.ka9q.net/code/fec/
Since the code was optimized and trimmed down for dvdisaster´s
special needs, you should get the original thing if you're
interested in incorporating RS codes into your application.
Daniel Nylander (info@danielnylander.se)
provides and maintains the Swedish translation.
Andrea Polverini (polve@polve.com)
provides and maintains the Italian translation.
Luboš Staněk (lubek@users.sourceforge.net)
provides and maintains the Czech translation.
Sergey Svishchev (svs@ropnet.ru)
provided the NetBSD port.
A lot of other people provided additional suggestions and bug reports;
see the CHANGELOG file for details.
all:
@echo
@echo "Please create a Makefile by entering \"bash configure\" first"
@echo
This diff is collapsed.
Installation of the dvdisaster source code distribution
=======================================================
[don't edit - generated from documentation/install.template]
Contents
1. Required tools and libraries
1.1 C compiler, make and other build tools
1.2 Gtk+ and localozation support
2. Operating system specific issues
2.1 Windows
2.1.1 Getting the GNU environment for Windows
2.2 Mac OS X / Darwin
2.3 FreeBSD
2.3.1 Loading the atapicam kernel module by hand
2.3.2 (Optionally) loading the atapicam kernel module permanently
2.3.3 (Optionally) recompiling the kernel
3. Compiling the source code
3.1 Unpacking the source code archive
3.2 Configuring the package
3.3 Compiling the package
4. Installation
4.1 Installation of the program
4.2 Removing an installation
5. Program documentation
=======================================================
1. Required tools and libraries
===============================
1.1 C compiler, make and other build tools
------------------------------------------
dvdisaster requires the usual GNU development tools for compiling
C programs. You must have gcc, GNU make, the bash shell and the
GNU fileutils and textutils packages installed. Other versions
of these tools will not work and patches for them will not be accepted.
FreeBSD, Linux and NetBSD typically come with suitable packages on
their installation media. Sometimes these packages are not installed
completely by default; you may need to install their development versions
also. The additional packages are usually suffixed with "-devel" or "-dev".
1.2 Gtk+ and localization support
---------------------------------
Depending on your operating system you will also need:
- The gettext library http://www.gnu.org/software/gettext/
- The iconv library (only for Windows) http://www.gnu.org/software/libiconv/
- The pkgconfig tool http://www.freedesktop.org/software/pkgconfig/releases
- The GTK+ library version 2.2 or better, http://www.gtk.org
including all auxiliary libraries.
Again, the freeware Unices should have suitable packages on their distribution media.
2. Operating system specific issues
===================================
2.1 Windows
-----------
2.1.1 Getting the GNU environment for Windows
For Windows the GNU tools are available in the MingW framework:
See http://www.mingw.org.
Building under Cygwin is not supported.
The Gtk+ project offers pre-compiled Windows versions of their libraries;
see http://www.gimp.org/~tml/gimp/win32/downloads.html for details.
You'll need both the normal and "-devel" versions of the libraries.
2.2 Mac OS X / Darwin
---------------------
dvdisaster was ported by Julian Einwag to Darwin,
the Unix foundation of Mac OS X.
Currently dvdisaster needs to be built and run as an X11 application under Mac OS X;
see http://developer.apple.com/opensource/tools/runningX11.html for more information.
An Aqua compatible version of the Gtk+ library is under development, but not
yet stable. As soon as this changes, dvdisaster will be able to run under
Mac OS X without using X11.
2.3 FreeBSD
-----------
2.3.1 Loading the atapicam kernel module by hand (tested on FreeBSD 7.1)
FreeBSD does not pre-install an uniform CD-ROM driver for SCSI and ATAPI drives
(as is the case in Linux and Windows). Therefore dvdisaster can not
use any ATAPI drives in an out-of-the-box FreeBSD installation.
To manually load the required kernel module, do:
root@freebsd# kldload atapicam
Use the follwing command to see if any CD/DVD/BD drives became
available:
root@freebsd# camcontrol devlist
<NAME OF YOUR DRIVE> at scbus1 target 0 lun 0 (pass0,cd0)
2.3.2 (Optionally) loading the atapicam kernel module permanently
If the above step works you can load the kernel module at boot
time by adding the line
atapicam_load="YES"
at the end of /boot/loader.conf.local
2.3.3 (Optionally) recompiling the kernel
If the atapicam kernel module is not available (check the contents
of /boot/kernel) you will need to recompile the kernel with the following
additional device line in the kernel configuration:
device atapicam
The devices ata, scbus, cd, and pass are also required,
but are included by default in FreeBSD 6.0 and later.
3. Compiling the source code
============================
It is recommended to compile the source code as a normal
user, not root. In the following instructions, user@host>
denotes the shell prompt.
3.1 Unpacking the source code archive
-------------------------------------
Please change into a directory which is writeable
for you and unpack the source code archive:
user@host> cd /var/tmp
user@host> tar xjf dvdisaster-0.72.rc2.tar.bz2
Then change into the newly created directory:
user@host> cd /var/tmp/dvdisaster-0.72.rc2
3.2. Configuring the package
----------------------------
Please note that the dvdisaster configure script is not
generated by GNU autoconf, but should behave in a similar way.
Call the configuration script in the usual way:
user@host> ./configure
The script will possibly print some errors about missing libraries.
Type "configure --help" to learn about pointing configure
to the correct path of already installed libraries.
The "--help" option will also give information about some
options which are useful if you plan to install the package
to a certain location.
Please note that the ==buildroot=DIR option is mainly useful for
package maintainers, but will mess up things when trying a direct
install via "make install".
3.3 Compiling the package
-------------------------
When the configuration script finishes without error messages,
compile the source code into the executable program:
user@host> gmake
On some systems, GNU make must be invoked as "make".
Invoke the program for a quick test:
user@linux> ./dvdisaster
user