From owner-svn-src-all@freebsd.org Sun Jan 29 17:19:11 2017 Return-Path: Delivered-To: svn-src-all@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 57316CC78BC for ; Sun, 29 Jan 2017 17:19:11 +0000 (UTC) (envelope-from wlosh@bsdimp.com) Received: from mail-io0-x242.google.com (mail-io0-x242.google.com [IPv6:2607:f8b0:4001:c06::242]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (Client CN "smtp.gmail.com", Issuer "Google Internet Authority G2" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 26380A1C for ; Sun, 29 Jan 2017 17:19:11 +0000 (UTC) (envelope-from wlosh@bsdimp.com) Received: by mail-io0-x242.google.com with SMTP id m98so12485184iod.2 for ; Sun, 29 Jan 2017 09:19:11 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bsdimp-com.20150623.gappssmtp.com; s=20150623; h=mime-version:sender:in-reply-to:references:from:date:message-id :subject:to:cc; bh=QIYp/aEBEMdN1STA741IlSa8Xfj384cKLZLGjEjecR0=; b=sW4TizE2er0pQtCqGwhH7k7zJT82c2SKZpsXIucHVvYme4osBeh2fTQVWeTSa0da61 JLayyZHMsFA38RgsBsddS2kdcNipMsGInZIUaOTMML7i4jRhUDxRTafMDlFFcocbG4JN g8cG0L5tymCQ/nE381dm/QVjpyR0F9pZRVJ0DmEtqb6AVLDCdwg/2HMJeuyYtPAWe7ID SF1UlIylBIudsQtmixH4Edhv6BvZEltK41Fu2tADd2Wg/AljxpvdMKQNamwR1vOgQfBP CsE7xgpXB43Zd8aULgMMZCCukv7Z7HGp55KFUBw8BL5QkGDX5u5/I1QVUhWqMlZwKj0d 9tpA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:sender:in-reply-to:references:from :date:message-id:subject:to:cc; bh=QIYp/aEBEMdN1STA741IlSa8Xfj384cKLZLGjEjecR0=; b=ocAyv4BF+dHWWmC9Zhw8VE9m0IUgkPz6ZxQ7D+DUpBvwBC+bZL1iioPnYtVbIe9RK/ R9mT3sYxA/p+S7g++s6m+kkAIWhs9BT9cgoI7GIaHLuisXm2hdWpntn9/iC/Kt5W5tyq q619XliKAXgX1CwK+0dBKzJNZFWmQLIueA8He/MZksOscbzvAWFntsOuO89FKD7V+xwf Zf+TWbbjF3mC9JJV1kriuGTyhHXmAOLXNl+Cq0Y0bH8SG+Bt5AucjetveaOIWkknpJ35 UNr6plLyehILkKlPJ9D/qVWf8LvzBZFSu9nWUQvb0zfZoA9V+PYgGsgivqbSO5Qt+X0A rvuA== X-Gm-Message-State: AIkVDXLanIfCjSXssz4R66e1hCOjhSEIPOpLe7PmE8blnDEYOaB4pdf6Y81SNgDngz+DaD8eyCVxjQPqF7rtxQ== X-Received: by 10.107.20.13 with SMTP id 13mr15586498iou.0.1485710350311; Sun, 29 Jan 2017 09:19:10 -0800 (PST) MIME-Version: 1.0 Sender: wlosh@bsdimp.com Received: by 10.79.145.217 with HTTP; Sun, 29 Jan 2017 09:19:09 -0800 (PST) X-Originating-IP: [69.53.245.200] In-Reply-To: <20170129111117.209bd639@zapp> References: <201701282358.v0SNwHo6055555@repo.freebsd.org> <20170129111117.209bd639@zapp> From: Warner Losh Date: Sun, 29 Jan 2017 10:19:09 -0700 X-Google-Sender-Auth: LlwNXtdaZeM0SLXUbnH0k-rDaCc Message-ID: Subject: Re: svn commit: r312938 - head/share/man/man7 To: Andrew Turner Cc: Ngie Cooper , src-committers , "svn-src-all@freebsd.org" , "svn-src-head@freebsd.org" Content-Type: text/plain; charset=UTF-8 X-BeenThere: svn-src-all@freebsd.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: "SVN commit messages for the entire src tree \(except for " user" and " projects" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 29 Jan 2017 17:19:11 -0000 On Sun, Jan 29, 2017 at 4:11 AM, Andrew Turner wrote: > On Sat, 28 Jan 2017 23:58:17 +0000 (UTC) > Ngie Cooper wrote: > >> Author: ngie >> Date: Sat Jan 28 23:58:17 2017 >> New Revision: 312938 >> URL: https://svnweb.freebsd.org/changeset/base/312938 >> >> Log: >> Update TARGET/TARGET_ARCH examples to use arm64/aarch64 instead of >> i386/pc98 >> pc98 support was removed in r312910 >> >> Modified: >> head/share/man/man7/build.7 >> head/share/man/man7/release.7 >> >> Modified: head/share/man/man7/build.7 >> ============================================================================== >> --- head/share/man/man7/build.7 Sat Jan 28 23:51:03 >> 2017 (r312937) +++ head/share/man/man7/build.7 Sat Jan >> 28 23:58:17 2017 (r312938) @@ -24,7 +24,7 @@ >> .\" >> .\" $FreeBSD$ >> .\" >> -.Dd July 20, 2016 >> +.Dd January 28, 2017 >> .Dt BUILD 7 >> .Os >> .Sh NAME >> @@ -517,10 +517,10 @@ This is analogous to the >> .Dq Nm uname Fl m >> output. >> This is necessary to cross-build some target architectures. >> -For example, cross-building for PC98 machines requires >> -.Va TARGET_ARCH Ns = Ns Li i386 >> +For example, cross-building for ARM64 machines requires >> +.Va TARGET_ARCH Ns = Ns Li aarch64 >> and >> -.Va TARGET Ns = Ns Li pc98 . >> +.Va TARGET Ns = Ns Li arm64 . > > That's not quite correct. > > Now pc98 has been removed TARGET_ARCH is enough to specify the hardware > to support. TARGET can be used on many hardware platforms as it will > have a default TARGET_ARCH to use, e.g. on arm64 TARGET=arm64 is enough > as it implies TARGET_ARCH=aarch64, however to build armv6 you would > need to set TARGET_ARCH=armv6 as TARGET=arm implies TARGET_ARCH=arm. Correct. We no longer have any architectures where we have two kernel KPIs like we did on i386 with the radically different machines. This approach, however, has been a bit of a hassle. We inherited it from NetBSD when the pc98 port came in (NetBSD didn't have a pc98 port integrated into their tree, but had a boatload of m68k machines with different kernels). For a while we almost supported 3 different i386 architectures as there were efforts made to port to Sun's i386 roadrunner that never finished. It's unlikely, though not impossible, that we'll repeat this though. NetBSD did it to allow every MACHINE to have a GENERIC that will boot everywhere. Now that we've kinda swallowed that up into boot options and a tertiary loader that's different for different boot environments, it's less of a clear-cut case to have a separate MACHINE, especially since we've been moving to LINT and/or GENERIC on the MACHINE types that have multiple kernels. I'd recommend telling people to always set TARGET_ARCH with an aside saying its safer to set both TARGET and TARGET_ARCH to allow us the flexibility in the future to repeat this sort of situation should unforeseen circumstances warrant it. Since TARGET_ARCH is unique, for the moment and likely near term, that will be flexible enough for the developers and simple enough for the users. The safer advice will mean that the script writers will set them both. Warner