[don’t edit - generated from documentation/install.template]
Required tools and libraries 1.1 C compiler, make and other build tools 1.2 Gtk+ and localozation support
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
Compiling the source code 3.1 Unpacking the source code archive 3.2 Configuring the package 3.3 Compiling the package
Installation 4.1 Installation of the program 4.2 Removing an installation
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”.
Depending on your operating system you will also need:
Again, the freeware Unices should have suitable packages on their distribution media.
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.
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.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
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
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:
The devices ata, scbus, cd, and pass are also required, but are included by default in FreeBSD 6.0 and later.
It is recommended to compile the source code as a normal user, not root. In the following instructions, user@host> denotes the shell prompt.
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 @@PKGNAME.tar.bz2
Then change into the newly created directory:
user@host> cd /var/tmp/@@PKGNAME
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:
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”.
When the configuration script finishes without error messages, compile the source code into the executable program:
On some systems, GNU make must be invoked as “make”.
Invoke the program for a quick test:
user@linux> ./dvdisaster user@windows>./dvdisaster-win
After a short moment the main window should open an the program is ready for use. Working with the program from the current directory (e.g. without installation) is okay.
On windows two program version are provided as it is not possible to have the same binary operate in command line and window mode there. dvdisaster.exe is the command line version, while dvdisaster-win.exe provides the graphical user interface.
To install the program and documentation permanently on your system, become root and do:
root@host# gmake install
Before doing the install, please review the output of the “configure” script or type “gmake show” to learn about the target directories of the installation. Enter “bash configure –help” to get information on changing the installation paths.
During the installation process a shell script is created which can be used to remove dvdisaster from your system:
In order to remove the source code distribution, please remove the directory you have created as described in section 3.1:
user@host> cd /var/tmp user@host> rm -rf @@PKGNAME
The online documentation is located in the sub directory documentation/en. You can also press the respective toolbar button in dvdisaster to view the online docs.
Enjoy using dvdisaster!