freebsd-ports/sysutils/dvdisaster/files/DEVICES.html.in
Kai Knoblich 37406deaa6 sysutils/dvdisaster: Update to 0.79.5
* Pass maintainership to submitter
* Switch to new MASTER_SITES as the previous one ceased to exist
* Switch to GCC as upstream officially supports GCC only (it still compiles
  with CLANG if appropriate patching of the GNUMakefile is used. But the
  chances are somewhat higher that it might introduce subtle errors during
  runtime because some valid statements are optimized out by CLANG)
* Add desktop and icon file
* Add missing library dependencies
* Add additional documentation that describes how dvdisaster accesses
  optical drives with FreeBSD
* Add more information to pkg-message and make it dynamic
* Include two patches from Debian that fix the missing language fields with
  .po files. [1]
* Remove debug options that are not really useful for end users
* Remove redundant configure script arguments
* Remove redundant do-configure target
* Sort pkg-plist

While I'm here:

* Fix the license
* Simplify the makefile targets further by using only option helpers and
  thus remove the need for <bsd.port.{pre,post}.mk>

Changelog since 0.72.6 (summary):

The most prominent feature of this version is that the multithreaded RS03
codec reached production quality, and all required features have been
implemented.

A few things will be added with the next releases:

* Adaptive reading is currently disabled as it does not support RS03 yet and
  would crash or misbehave on RS03 error correction data
* A heuristic for an exhaustive re-discovery of RS03 structures in a badly
  damaged medium is missing in the decoder

But these things should not keep you from using RS03, as the encoder is
complete and future decoder enhancements do not affect already created RS03
data.

0.79.4 (07-10-2012 / not released)

* Optical drives would only be detected for /dev/pass[0-9] on FreeBSD. Fixed
  to work with arbitrary /dev/pass numbers.
* Blocked menu selection when any other action is in progress
* Made actions properly shut down (e.g. remove incomplete ecc data) when
  closing the window or pushing the "Quit" button.
* Changed sources for clean compile on gcc 4.4.3
* Added #include <zlib.h> for libpng 1.5 compatibility
* Introduced internal Image object for unified access to optical media and
  on disk ISO images; lots of internal changes and fixes due to that
* Added --ignore-iso-size option
* Fixed bug in pngpack
* Added remaining patches for Czech online manual.
* More comprehensive and unified version information for banner, --version,
  log window and log file to aid in working on bug reports
* Hardcoded icons to defeat theming
* Changed glib.h include for compatibility with glib 2.32
* Removed Darwin / Mac OS X support
* Synced with dvdisaster 0.72.4 fixes
* Completed RS01 and RS03 specification in the papers subdir

0.79.3 (21-11-2010)

* Fixed and documented -n command line options for RS02.
* Reworked configure for current NetBSD release

PR:		236423
Submitted by:	Bob Eager <bob@eager.cx>
Approved by:	tcberner (mentor)
Obtained from:	Debian [1]
Differential Revision:	https://reviews.freebsd.org/D19807
2019-04-07 21:00:25 +00:00

80 lines
2.7 KiB
HTML

<h1>Useful hints for dvdisaster</h1>
<h2>Device access</h2>
<p>dvdisaster tries to read <code>/dev/pass*</code> to list available optical drives,
so it will not detect any available drives if the user running
dvdisaster does not have permissions to read <code>/dev/pass*</code>.</p>
<p>The solution is to create the file <code>/etc/devfs.rules</code>, containing
something like the following.</p>
<pre><code> [localrules=10]
add path 'pass*' mode 0775 group mygroup
</code></pre>
<p>You also need to add this line to <code>/etc/rc.conf</code>:</p>
<pre><code> devfs_system_ruleset="localrules"
</code></pre>
<p>You can use anything you like for <code>localrules</code>, and the number does not have to be <code>10</code>.
See <code>devfs.rules(5)</code> for more details.</p>
<p>If <code>/etc/devfs.rules</code> already exists, add the line starting <code>add</code> to the section for the ruleset
mentioned in <code>/etc/rc.conf</code>.</p>
<p>For this to take effect, either reboot, or issue the command:</p>
<pre><code> # service devfs restart
</code></pre>
<p>as root.</p>
<h2>Missing optical drives</h2>
<p>The most common problem encountered is that dvdisaster does not detect
optical drives on older versions of FreeBSD.</p>
<p>FreeBSD 9.x does not pre-install a uniform CD-ROM driver for SCSI and
ATAPI drives, thus it cannot use any ATAPI drives in an out-of-the-box
FreeBSD 9.x installation. Normally, this can be fixed by loading a
kernel module called <code>atapicam</code>.</p>
<h3>Loading the <code>atapicam</code> kernel module by hand</h3>
<p>To manually load the required kernel module, issue the command:</p>
<pre><code> # kldload atapicam
</code></pre>
<p>To see if any optical drives are available:</p>
<pre><code> # camcontrol devlist
&lt;NAME OF YOUR DRIVE&gt; at scbus1 target 0 lun 0 (pass0,cd0)
</code></pre>
<h3>Loading the <code>atapicam</code> kernel module permanently</h3>
<p>If the above step works, the module can be loaded automatically at boot time by adding
the line:</p>
<pre><code> atapicam_load="YES"
</code></pre>
<p>to the file <code>/boot/loader.conf</code>.</p>
<h3>Building the <code>atapicam</code> module</h3>
<p>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:</p>
<pre><code> device atapicam
</code></pre>
<p>This will actually build the module into the kernel. To build it separately,
see <code>make.conf(5)</code>.</p>
<p>The devices <code>ata</code>, <code>scbus</code>, <code>cd</code>, and <code>pass</code> are also required, but are included by
default in FreeBSD 6.0 and later.</p>