From owner-freebsd-stable@freebsd.org  Mon Apr 26 16:53:05 2021
Return-Path: <owner-freebsd-stable@freebsd.org>
Delivered-To: freebsd-stable@mailman.nyi.freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1])
 by mailman.nyi.freebsd.org (Postfix) with ESMTP id B6C505E78FB;
 Mon, 26 Apr 2021 16:53:05 +0000 (UTC) (envelope-from jhb@FreeBSD.org)
Received: from smtp.freebsd.org (smtp.freebsd.org
 [IPv6:2610:1c1:1:606c::24b:4])
 (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)
 key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256
 client-signature RSA-PSS (4096 bits) client-digest SHA256)
 (Client CN "smtp.freebsd.org", Issuer "R3" (verified OK))
 by mx1.freebsd.org (Postfix) with ESMTPS id 4FTWDK4hPCz3rR6;
 Mon, 26 Apr 2021 16:53:05 +0000 (UTC) (envelope-from jhb@FreeBSD.org)
Received: from John-Baldwins-MacBook-Pro.local (ralph.baldwin.cx
 [66.234.199.215])
 (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits))
 (Client did not present a certificate) (Authenticated sender: jhb)
 by smtp.freebsd.org (Postfix) with ESMTPSA id 379EE221E2;
 Mon, 26 Apr 2021 16:53:05 +0000 (UTC) (envelope-from jhb@FreeBSD.org)
Subject: Re: Despite the documentation, "etcupdate extract" handles -D destdir
 (and its contribution to the default workdir)
To: Mark Millard <marklmi@yahoo.com>,
 freebsd-current <freebsd-current@freebsd.org>,
 FreeBSD-STABLE Mailing List <freebsd-stable@freebsd.org>
References: <189610CE-CFE1-45D5-852B-D47603935F6F.ref@yahoo.com>
 <189610CE-CFE1-45D5-852B-D47603935F6F@yahoo.com>
From: John Baldwin <jhb@FreeBSD.org>
Message-ID: <22d663bf-e3b4-9fc6-b6ec-0bd8f7ea6eb1@FreeBSD.org>
Date: Mon, 26 Apr 2021 09:53:01 -0700
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.14; rv:78.0)
 Gecko/20100101 Thunderbird/78.9.0
MIME-Version: 1.0
In-Reply-To: <189610CE-CFE1-45D5-852B-D47603935F6F@yahoo.com>
Content-Type: text/plain; charset=utf-8; format=flowed
Content-Language: en-US
Content-Transfer-Encoding: 7bit
X-BeenThere: freebsd-stable@freebsd.org
X-Mailman-Version: 2.1.34
Precedence: list
List-Id: Production branch of FreeBSD source code <freebsd-stable.freebsd.org>
List-Unsubscribe: <https://lists.freebsd.org/mailman/options/freebsd-stable>, 
 <mailto:freebsd-stable-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-stable/>
List-Post: <mailto:freebsd-stable@freebsd.org>
List-Help: <mailto:freebsd-stable-request@freebsd.org?subject=help>
List-Subscribe: <https://lists.freebsd.org/mailman/listinfo/freebsd-stable>,
 <mailto:freebsd-stable-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Mon, 26 Apr 2021 16:53:05 -0000

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