freebsd stable - Apr 2021 - Despite the documentation, "etcupdate extract" handles -D destdir (and its contribution to the default workdir)

# etcupdate -?
Illegal option -?

usage: etcupdate [-npBF] [-d workdir] [-r | -s source | -t tarball]
                 [-A patterns] [-D destdir] [-I patterns] [-L logfile]
                 [-M options]
       etcupdate build [-B] [-d workdir] [-s source] [-L logfile] [-M options]
                 <tarball>
       etcupdate diff [-d workdir] [-D destdir] [-I patterns] [-L logfile]
       etcupdate extract [-B] [-d workdir] [-s source | -t tarball] [-L logfile]
                 [-M options]
       etcupdate resolve [-p] [-d workdir] [-D destdir] [-L logfile]
       etcupdate status [-d workdir] [-D destdir]

The "etcupdate extract" material does not show -D destdir as valid.


# man etcupdate
. . .
SYNOPSIS
     etcupdate [-npBF] [-d workdir] [-r | -s source | -t tarball]
               [-A patterns] [-D destdir] [-I patterns] [-L logfile]
               [-M options]
     etcupdate build [-B] [-d workdir] [-s source] [-L logfile] [-M options]
               tarball
     etcupdate diff [-d workdir] [-D destdir] [-I patterns] [-L logfile]
     etcupdate extract [-B] [-d workdir] [-s source | -t tarball] [-L logfile]
               [-M options]
     etcupdate resolve [-p] [-d workdir] [-D destdir] [-L logfile]
     etcupdate status [-d workdir] [-D destdir]
. . .

Again the "etcupdate extract" material does not show -D destdir as
valid.

But I used it:

# etcupdate extract -D usr/obj/DESTDIRs/13_0R-CA7-for-chroot

and it created and filled in the workdir:

/usr/obj/DESTDIRs/13_0R-CA7-for-chroot/var/db/etcupdate/


I have not checked on if "etcupdate build" has a similar issue
vs. not.

==Mark Millard
marklmi at yahoo.com
( dsl-only.net went
away in early 2018-Mar)

On 4/24/21 12:22 PM, Mark Millard via freebsd-current
wrote:
> # etcupdate -?
> Illegal option -?
> 
> usage: etcupdate [-npBF] [-d workdir] [-r | -s source | -t tarball]
>                   [-A patterns] [-D destdir] [-I patterns] [-L logfile]
>                   [-M options]
>         etcupdate build [-B] [-d workdir] [-s source] [-L logfile] [-M
options]
>                   <tarball>
>         etcupdate diff [-d workdir] [-D destdir] [-I patterns] [-L logfile]
>         etcupdate extract [-B] [-d workdir] [-s source | -t tarball] [-L
logfile]
>                   [-M options]
>         etcupdate resolve [-p] [-d workdir] [-D destdir] [-L logfile]
>         etcupdate status [-d workdir] [-D destdir]
> 
> The "etcupdate extract" material does not show -D destdir as
valid.
Thanks, it was a documentation oversight I've just fixed.  It is definitely
supposed to work and is quite useful for cross-builds (e.g. I use it frequently
to update rootfs images I use with qemu for RISC-V or MIPS that I run under
qemu, or when updating the SD-card for my RPI that I cross-build on an x86
host).

-- 
John Baldwin