Skip site navigation (1)Skip section navigation (2)
Date:      Tue, 2 Aug 2005 19:06:31 +0200
From:      Marc Fonvieille <blackend@freebsd.org>
To:        Chuck Swiger <cswiger@mac.com>
Cc:        Marc Fonvieille <blackend@freebsd.org>, freebsd-questions@freebsd.org
Subject:   Re: growisofs: no mkisofs options are permitted with =, aborting
Message-ID:  <20050802170631.GG595@gothic.blackend.org>
In-Reply-To: <42EF9FD5.7060204@mac.com>
References:  <20050801203145.GA830@twelvegates.homeip.net> <20050802002003.GX75379@wantadilla.lemis.com> <20050802050818.GA69657@localhost.local> <42EF03C2.6060209@mac.com> <20050802054603.GA69870@localhost.local> <42EF8819.5000306@mac.com> <20050802154435.GF595@gothic.blackend.org> <42EF9FD5.7060204@mac.com>

next in thread | previous in thread | raw e-mail | index | archive | help
On Tue, Aug 02, 2005 at 12:31:17PM -0400, Chuck Swiger wrote:
> 
> The Handbook has good documentation on using dvd+rw-tools as well as other 
> software, and I would second the recomendation that people take a look at 
> it if they want to burn CD's or DVD's.
> 
> You are welcome to hold the opinion that the documentation is complete, but:
> 
> 13-sec% cd /usr/ports/sysutils/dvd+rw-tools && make extract > /dev/null
> 14-sec% grep luke work/dvd+rw-tools-5.21.4.10.8/growisofs.c
>  * - undocumented -use-the-force-luke flag to overwrite the media
>  * - extended syntax for -use-the-force-luke option, it's now possible
>  *   to engage DVD-R[W] dummy mode by -use-the-force-luke=[tty,]dummy
>  * - complement -use-the-force-luke=dao[:size] to arrange for piping
>  * - implement -use-the-force-luke=seek:N -Z /dev/dvd=image to arrange
>  *   -use-the-force-luke=seek:N it's easier to maintain "tar-formatted"
>  * - -use-the-force-luke=tracksize:size option by suggestion from K3b;
>  * - -use-the-force-luke=wrvfy for WRITE AND VERIFY(10);
>  * - -use-the-force-luke=4gms to allow ISO9660 directory structures
>  * - more sane sanity check for -use-the-force-luke=tracksize:N;
>  * - -use-the-force-luke=break:size to set Layer Break position for
>  * - -use-the-force-luke=noload to leave tray ejected at the end;
>             else if (!strncmp(opt,"-use-the-force-luke",19))
> 
> ...or consult the manpage, again:
> 
>       "There're   several   undocumented   options   commonly   denoted   
>       with
>        -use-the-force-luke prefix. Some of them serve debugging purposes. 
>        Some
>        require  certain  knowledge  about  recording process or even OS 
>        kernel
>        internals and as being such can induce confusing behaviour. Some are 
>        to
>        be  used in very specific situations better recognized by front-ends 
>        or
>        automated scripts. Rationale behind leaving these options  
>        undocumented
>        is  that  those  few users who would actually need to use them 
>        directly
>        can as well consult the source code  or  obtain  specific  
>        instructions
>        elsewhere."
>

I don't see the problem, the text above clearly explain the reason.
And according to questions on freebsd-questions@,, the main problem is
the fact no one read the "existing" documentation;  For example, a recent
thread about DVD burning speed/DMA issue... with the solution documented
in many places...

However I can understand your point of view regarding the fact the
manual page do not even mention briefly the "invisible" options.  A
volunteer should write a patch against the manual page and send it to
Andy.

Marc



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20050802170631.GG595>