"Fossies" - the Fresh Open Source Software Archive

Member "dvdisaster-0.79.5/documentation/install.template" (25 Oct 2015, 6962 Bytes) of archive /linux/misc/dvdisaster-0.79.5.tar.gz:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file. See also the latest Fossies "Diffs" side-by-side code changes reports for "install.template": 0.79.3_vs_0.79.5 or 0.72.6_vs_0.79.5.

    1 Installation of the dvdisaster source code distribution
    2 =======================================================
    3 [don't edit - generated from documentation/install.template]
    4 
    5 Contents
    6 
    7 1. Required tools and libraries
    8 1.1 C compiler, make and other build tools
    9 1.2 Gtk+ and localozation support
   10 
   11 2. Operating system specific issues
   12 2.1 FreeBSD
   13 2.1.1 Required packages
   14 2.2 NetBSD
   15 2.2.1 Required packages
   16 
   17 3. Compiling the source code
   18 3.1 Unpacking the source code archive
   19 3.2 Configuring the package
   20 3.3 Compiling the package
   21 
   22 4. Installation
   23 4.1 Installation of the program
   24 4.2 Removing an installation
   25 
   26 5 Running the program
   27 5.1 Program documentation
   28 5.2 FreeBSD hints
   29 5.3 NetBSD hints
   30 
   31 =======================================================
   32 
   33 1. Required tools and libraries
   34 ===============================
   35 
   36 1.1 C compiler, make and other build tools
   37 ------------------------------------------
   38 
   39 dvdisaster requires the usual GNU development tools for compiling 
   40 C programs. You must have gcc, GNU make, the bash shell and the
   41 GNU fileutils and textutils packages installed.
   42 Using other compilers and tools is currently not tested,
   43 recommended or supported in any way. Patches for them will
   44 not be accepted.
   45 
   46 FreeBSD, Linux and NetBSD typically come with suitable packages on 
   47 their installation media. Sometimes these packages are not installed
   48 completely by default; you may need to install their development versions
   49 also. The additional packages are usually suffixed with "-devel" or "-dev".
   50 
   51 See Section 3.2 for information on configuring the build process,
   52 and for specifying the compiler.
   53 
   54 
   55 1.2 Gtk+ and localization support
   56 ---------------------------------
   57 
   58 Depending on your operating system you will also need:
   59 
   60 - The gettext library			http://www.gnu.org/software/gettext/
   61 - The pkgconfig tool			http://www.freedesktop.org/software/pkgconfig/releases
   62 - The GTK+ library version 2.2 or better,    http://www.gtk.org
   63   including all auxiliary libraries.
   64 
   65 Again, the supported Unices should have suitable packages on their distribution media.
   66 
   67 
   68 2. Operating system specific issues
   69 ===================================
   70 
   71 2.1 FreeBSD
   72 -----------
   73 
   74 2.1.1 Required packages
   75 
   76 For your convenience, building dvdisaster required
   77 the following packages under FreeBSD 10.1:
   78 
   79 # pkg install bash
   80 # pkg install gmake
   81 # pkg install gettext
   82 # pkg install gcc
   83 # pkg install pkgconf
   84 # pkg install gtk2
   85 
   86 2.2 NetBSD
   87 ----------
   88 
   89 2.2.1 Required packages
   90 
   91 For your convenience, building dvdisaster required
   92 the following packages under NetBSD 9.0:
   93 
   94 # pkg_add bash
   95 # pkg_add gmake
   96 # pkg_add pkg-config
   97 # pkg_add gtk2+
   98 
   99 
  100 3. Compiling the source code
  101 ============================
  102 
  103 It is recommended to compile the source code as a normal
  104 user, not root. In the following instructions, user@host>
  105 denotes the shell prompt.
  106 
  107 3.1 Unpacking the source code archive
  108 -------------------------------------
  109 
  110 Please change into a directory which is writeable
  111 for you and unpack the source code archive:
  112 
  113 user@host> cd /var/tmp
  114 user@host> tar xjf @@PKGNAME.tar.bz2
  115 
  116 Then change into the newly created directory:
  117 
  118 user@host> cd /var/tmp/@@PKGNAME
  119 
  120 3.2. Configuring the package
  121 ----------------------------
  122 
  123 Please note that the dvdisaster configure script is not 
  124 generated by GNU autoconf, but should behave in a similar way.
  125 
  126 Call the configuration script in the usual way:
  127 
  128 user@host> ./configure
  129 
  130 The script will possibly print some errors about missing libraries.
  131 Type "configure --help" to learn about pointing configure 
  132 to the correct path of already installed libraries.
  133 
  134 The "--help" option will also give information about some
  135 options which are useful if you plan to install the package
  136 to a certain location.
  137 
  138 Please note that the --buildroot=DIR option is mainly useful for
  139 package maintainers, but will mess up things when trying a direct
  140 install via "make install".
  141 
  142 If your gcc compiler resides in an unusual place, specify it
  143 by setting the CC environment variable for the ./configure
  144 script. Example (may be helpful for FreeBSD):
  145 
  146 CC=/usr/local/bin/gcc48 ./configure
  147 
  148 Please note that changing CC at a later time, e.g. when doing
  149 the make step, has no effect.
  150 
  151 After ./configure has been run, do a "make show" to review
  152 the settings obtained by the configuration.
  153 
  154 3.3 Compiling the package
  155 -------------------------
  156 
  157 When the configuration script finishes without error messages,
  158 compile the source code into the executable program:
  159 
  160 user@host> gmake
  161 
  162 On some systems, GNU make must be invoked as "make".
  163 
  164 Invoke the program for a quick test:
  165 
  166 user@linux> ./dvdisaster
  167 
  168 After a short moment the main window should open an the program
  169 is ready for use. Working with the program from the current 
  170 directory (e.g. without installation) is okay.
  171 
  172 
  173 4. Installation
  174 ===============
  175 
  176 4.1 Installation of the program
  177 -------------------------------
  178 
  179 To install the program and documentation permanently
  180 on your system, become root and do:
  181 
  182 root@host# gmake install
  183 
  184 Before doing the install, please review the output of the "configure" script
  185 or type "gmake show" to learn about the target directories of the installation.
  186 Enter "bash configure --help" to get information on changing the installation
  187 paths.
  188 
  189 4.2. Removing an installation
  190 -----------------------------
  191 
  192 During the installation process a shell script is created
  193 which can be used to remove dvdisaster from your system:
  194 
  195 root@host# dvdisaster-uninstall.sh
  196 
  197 In order to remove the source code distribution,
  198 please remove the directory you have created as described
  199 in section 3.1:
  200 
  201 user@host> cd /var/tmp
  202 user@host> rm -rf @@PKGNAME
  203 
  204 5. Running the program
  205 ======================
  206 
  207 5.1 Program documentation
  208 -------------------------
  209 
  210 The online documentation is located in the
  211 sub directory documentation/manual.pdf
  212 You can also press the respective toolbar button 
  213 in dvdisaster to view the online docs.
  214 
  215 5.2 FreeBSD hints
  216 -----------------
  217 
  218 Running as an unpriviledged user
  219 
  220 If you want to run dvdisaster as an unpriviledged
  221 user (which is recommended), make sure that the
  222 respective user is member of the "operator" group
  223 and that he has read _and_ write permission on the
  224 optical drive, e.g. /dev/pass1.
  225 
  226 Use camcontrol to find out which passthrough device
  227 is assigned to your drive:
  228 
  229 root@freebsd# camcontrol devlist
  230 <NAME OF YOUR DRIVE>  at scbus1 target 0 lun 0 (pass0,cd0)
  231 
  232 
  233 Avoid copy-on-write filesystems
  234 
  235 dvdisaster assumes that ISO images are laid out
  236 sequentially on the hard disk, and that it can
  237 rewrite sectors in place. Therefore avoid
  238 processing images on ZFS volumes, as reading and
  239 recovering defective images may lead to serious
  240 fragmentation and performance hits.
  241 
  242 
  243 5.3 NetBSD hints
  244 ----------------
  245 
  246 Running as an unpriviledged user
  247 
  248 If you want to run dvdisaster as an unpriviledged
  249 user (which is recommended), make sure that the
  250 respective user is member of the "operator" group
  251 and that he has read _and_ write permission on the
  252 optical drive, e.g. /dev/rcd0d.
  253 
  254 
  255 
  256 Enjoy using dvdisaster!
  257 
  258