growisofs: no mkisofs options are permitted with =, aborting

[Marc Fonvieille]

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