From owner-svn-src-head@freebsd.org Sun Jan 29 17:19:11 2017 Return-Path: Delivered-To: svn-src-head@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 58CE4CC78BD for ; Sun, 29 Jan 2017 17:19:11 +0000 (UTC) (envelope-from wlosh@bsdimp.com) Received: from mail-io0-x241.google.com (mail-io0-x241.google.com [IPv6:2607:f8b0:4001:c06::241]) (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 26345A1B for ; Sun, 29 Jan 2017 17:19:11 +0000 (UTC) (envelope-from wlosh@bsdimp.com) Received: by mail-io0-x241.google.com with SMTP id c80so12501805iod.1 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=MWrNuqiSVUDsT2qSNTDLIqW86czAC2z8/pvjiZPrcRGBfE4eZT3E5w/GVo4XsdTNsV 7Ylo7aDfVmCk8wULg+HO4OWSeI1w8Xogy9y2bbjk7iLel7xlOPNAtdTov7K1HC7/AfHC m7d1mgQcTrlbOpI8ysK4Z28nOE9ou5et9DHO9aFEFHU3At9J7AggqAtxwy1qZ9YCiJNG 1PA59Sh4d07GGlE7nzfT9WtNoSRfk5U3rxG8gH4Hf4e7VCHesM8UrwzIHFS9//0rmGe9 aMSICYsKmywPzewUh26H1B6i9t9kby2VyEydy9zqm1TZl66MZaiD6exBFRgBuWT+mh0e iWLA== X-Gm-Message-State: AIkVDXKM3CDpPfEqdXgvxHgIa8D+yFX+O9gOv/zabBFmzCDBWQGI+2n7o0qgm7HZ7i4+gqwTGoQ3BkJstprzDg== 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-head@freebsd.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: SVN commit messages for the src tree for head/-current 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