[{"id":1947586,"web_url":"http://patchwork.ozlabs.org/comment/1947586/","msgid":"<20180704204407.GA22336@localhost.localdomain>","list_archive_url":null,"date":"2018-07-04T20:44:07","subject":"Re: [Qemu-devel] [PATCH] docs: add firmware.txt","submitter":{"id":195,"url":"http://patchwork.ozlabs.org/api/people/195/","name":"Eduardo Habkost","email":"ehabkost@redhat.com"},"content":"On Fri, Sep 01, 2017 at 12:53:31PM +0200, Gerd Hoffmann wrote:\n> Document how guest firmware is handled in qemu today.\n> \n> Reviewed-by: Laszlo Ersek \n> Signed-off-by: Gerd Hoffmann \n\nIs this document still valid? Should we apply this for QEMU 3.0?\n\n> ---\n> docs/firmware.txt | 49 +++++++++++++++++++++++++++++++++++++++++++++++++\n> 1 file changed, 49 insertions(+)\n> create mode 100644 docs/firmware.txt\n> \n> diff --git a/docs/firmware.txt b/docs/firmware.txt\n> new file mode 100644\n> index 0000000000..e242413344\n> --- /dev/null\n> +++ b/docs/firmware.txt\n> @@ -0,0 +1,49 @@\n> +\n> +prebuilt firmware in qemu\n> +=========================\n> +\n> +The process of building firmware isn't as easy as building qemu\n> +itself, for example because you must have cross compilers installed\n> +when building firmware for other architectures. So qemu ships\n> +prebuilt firmware binaries for convenience reasons.\n> +\n> +\n> +directories\n> +-----------\n> +\n> +pc-bios/\n> + Firmware binaries.\n> + Also other files like keymaps and logos which are copied to\n> + $prefix/share/qemu by \"make install\".\n> +\n> +pc-bios/optionrom/\n> + Firmware sources, part of the qemu project.\n> +\n> +roms/\n> + Firmware sources, third-party projects, as git submodules.\n> +\n> +\n> +third-party git repos\n> +---------------------\n> +\n> +For third party firmware sources it is recommended to have a git\n> +mirror on git.qemu.org. In case the firmware license is GPL the git\n> +mirror is mandatory for GPL compilance reasons: We ship binaries, so\n> +we must provide sources too.\n> +\n> +\n> +building the firmware\n> +---------------------\n> +\n> +Firmware builds should be done using rules in roms/Makefile. That\n> +serves as documentation how the firmware is built, and it also makes\n> +firmware updates easier for the maintainer.\n> +\n> +\"make -C roms\" prints a list of firmware build targets.\n> +\"make -C roms $target\" kicks a build.\n> +\n> +\n> +notes for specific firmwares\n> +----------------------------\n> +\n> +ipxe: see https://wiki.qemu.org/IpxeDownstreamForQemu\n> -- \n> 2.9.3\n> \n>","headers":{"Return-Path":"","X-Original-To":"incoming@patchwork.ozlabs.org","Delivered-To":"patchwork-incoming@bilbo.ozlabs.org","Authentication-Results":["ozlabs.org;\n\tspf=pass (mailfrom) smtp.mailfrom=nongnu.org\n\t(client-ip=2001:4830:134:3::11; helo=lists.gnu.org;\n\tenvelope-from=qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org;\n\treceiver=)","ozlabs.org;\n\tdmarc=fail (p=none dis=none) header.from=redhat.com"],"Received":["from lists.gnu.org (lists.gnu.org [IPv6:2001:4830:134:3::11])\n\t(using TLSv1 with cipher AES256-SHA (256/256 bits))\n\t(No client certificate requested)\n\tby ozlabs.org (Postfix) with ESMTPS id 41LXzY27sHz9s29\n\tfor ;\n\tThu, 5 Jul 2018 06:44:39 +1000 (AEST)","from localhost ([::1]:49195 helo=lists.gnu.org)\n\tby lists.gnu.org with esmtp (Exim 4.71) (envelope-from\n\t)\n\tid 1faode-0007OF-5G\n\tfor incoming@patchwork.ozlabs.org; Wed, 04 Jul 2018 16:44:34 -0400","from eggs.gnu.org ([2001:4830:134:3::10]:38300)\n\tby lists.gnu.org with esmtp (Exim 4.71)\n\t(envelope-from ) id 1faodN-0007Nx-Fs\n\tfor qemu-devel@nongnu.org; Wed, 04 Jul 2018 16:44:18 -0400","from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)\n\t(envelope-from ) id 1faodK-0006cD-9z\n\tfor qemu-devel@nongnu.org; Wed, 04 Jul 2018 16:44:17 -0400","from mx1.redhat.com ([209.132.183.28]:58890)\n\tby eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32)\n\t(Exim 4.71) (envelope-from ) id 1faodK-0006bl-1z\n\tfor qemu-devel@nongnu.org; Wed, 04 Jul 2018 16:44:14 -0400","from smtp.corp.redhat.com\n\t(int-mx07.intmail.prod.int.phx2.redhat.com [10.5.11.22])\n\t(using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits))\n\t(No client certificate requested)\n\tby mx1.redhat.com (Postfix) with ESMTPS id C8FDF87649;\n\tWed, 4 Jul 2018 20:44:12 +0000 (UTC)","from localhost (ovpn-116-35.gru2.redhat.com [10.97.116.35])\n\tby smtp.corp.redhat.com (Postfix) with ESMTP id 48D7B1001920;\n\tWed, 4 Jul 2018 20:44:09 +0000 (UTC)"],"Date":"Wed, 4 Jul 2018 17:44:07 -0300","From":"Eduardo Habkost ","To":"Gerd Hoffmann ,\n\tPeter Maydell ","Message-ID":"<20180704204407.GA22336@localhost.localdomain>","References":"<20170901105331.11783-1-kraxel@redhat.com>","MIME-Version":"1.0","Content-Type":"text/plain; charset=us-ascii","Content-Disposition":"inline","In-Reply-To":"<20170901105331.11783-1-kraxel@redhat.com>","X-Fnord":"you can see the fnord","User-Agent":"Mutt/1.9.2 (2017-12-15)","X-Scanned-By":"MIMEDefang 2.84 on 10.5.11.22","X-Greylist":"Sender IP whitelisted, not delayed by milter-greylist-4.5.16\n\t(mx1.redhat.com [10.5.110.26]);\n\tWed, 04 Jul 2018 20:44:12 +0000 (UTC)","X-detected-operating-system":"by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]\n\t[fuzzy]","X-Received-From":"209.132.183.28","Subject":"Re: [Qemu-devel] [PATCH] docs: add firmware.txt","X-BeenThere":"qemu-devel@nongnu.org","X-Mailman-Version":"2.1.21","Precedence":"list","List-Id":"","List-Unsubscribe":",\n\t","List-Archive":"","List-Post":"","List-Help":"","List-Subscribe":",\n\t","Cc":"qemu-devel@nongnu.org","Errors-To":"qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org","Sender":"\"Qemu-devel\"\n\t"}},{"id":1947698,"web_url":"http://patchwork.ozlabs.org/comment/1947698/","msgid":"<20180705064726.zswibgkefkrpybgp@sirius.home.kraxel.org>","list_archive_url":null,"date":"2018-07-05T06:47:26","subject":"Re: [Qemu-devel] [PATCH] docs: add firmware.txt","submitter":{"id":589,"url":"http://patchwork.ozlabs.org/api/people/589/","name":"Gerd Hoffmann","email":"kraxel@redhat.com"},"content":"On Wed, Jul 04, 2018 at 05:44:07PM -0300, Eduardo Habkost wrote:\n> On Fri, Sep 01, 2017 at 12:53:31PM +0200, Gerd Hoffmann wrote:\n> > Document how guest firmware is handled in qemu today.\n> > \n> > Reviewed-by: Laszlo Ersek \n> > Signed-off-by: Gerd Hoffmann \n> \n> Is this document still valid? Should we apply this for QEMU 3.0?\n\nI think so.\n\nThe effort to move the firmware to a separate repo is stalled due to\nENOTIME, and surely will not happen for 3.0. So it makes sense to just\nmerge the text as-is.\n\ncheers,\n Gerd","headers":{"Return-Path":"","X-Original-To":"incoming@patchwork.ozlabs.org","Delivered-To":"patchwork-incoming@bilbo.ozlabs.org","Authentication-Results":["ozlabs.org;\n\tspf=pass (mailfrom) smtp.mailfrom=nongnu.org\n\t(client-ip=2001:4830:134:3::11; helo=lists.gnu.org;\n\tenvelope-from=qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org;\n\treceiver=)","ozlabs.org;\n\tdmarc=fail (p=none dis=none) header.from=redhat.com"],"Received":["from lists.gnu.org (lists.gnu.org [IPv6:2001:4830:134:3::11])\n\t(using TLSv1 with cipher AES256-SHA (256/256 bits))\n\t(No client certificate requested)\n\tby ozlabs.org (Postfix) with ESMTPS id 41LpMb1WKhz9s29\n\tfor ;\n\tThu, 5 Jul 2018 16:47:55 +1000 (AEST)","from localhost ([::1]:50595 helo=lists.gnu.org)\n\tby lists.gnu.org with esmtp (Exim 4.71) (envelope-from\n\t)\n\tid 1fay3U-0000L4-VL\n\tfor incoming@patchwork.ozlabs.org; Thu, 05 Jul 2018 02:47:52 -0400","from eggs.gnu.org ([2001:4830:134:3::10]:45508)\n\tby lists.gnu.org with esmtp (Exim 4.71)\n\t(envelope-from ) id 1fay3A-0000KW-5P\n\tfor qemu-devel@nongnu.org; Thu, 05 Jul 2018 02:47:32 -0400","from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)\n\t(envelope-from ) id 1fay37-0000fF-2R\n\tfor qemu-devel@nongnu.org; Thu, 05 Jul 2018 02:47:32 -0400","from mx3-rdu2.redhat.com ([66.187.233.73]:33288\n\thelo=mx1.redhat.com)\n\tby eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32)\n\t(Exim 4.71) (envelope-from ) id 1fay36-0000dx-U1\n\tfor qemu-devel@nongnu.org; Thu, 05 Jul 2018 02:47:28 -0400","from smtp.corp.redhat.com\n\t(int-mx04.intmail.prod.int.rdu2.redhat.com [10.11.54.4])\n\t(using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits))\n\t(No client certificate requested)\n\tby mx1.redhat.com (Postfix) with ESMTPS id 61F1987AAD;\n\tThu, 5 Jul 2018 06:47:28 +0000 (UTC)","from sirius.home.kraxel.org (ovpn-116-27.ams2.redhat.com\n\t[10.36.116.27])\n\tby smtp.corp.redhat.com (Postfix) with ESMTP id 1274F2026D74;\n\tThu, 5 Jul 2018 06:47:28 +0000 (UTC)","by sirius.home.kraxel.org (Postfix, from userid 1000)\n\tid B9CEF17443; Thu, 5 Jul 2018 08:47:26 +0200 (CEST)"],"Date":"Thu, 5 Jul 2018 08:47:26 +0200","From":"Gerd Hoffmann ","To":"Eduardo Habkost ","Message-ID":"<20180705064726.zswibgkefkrpybgp@sirius.home.kraxel.org>","References":"<20170901105331.11783-1-kraxel@redhat.com>\n\t<20180704204407.GA22336@localhost.localdomain>","MIME-Version":"1.0","Content-Type":"text/plain; charset=us-ascii","Content-Disposition":"inline","In-Reply-To":"<20180704204407.GA22336@localhost.localdomain>","User-Agent":"NeoMutt/20180622","X-Scanned-By":"MIMEDefang 2.78 on 10.11.54.4","X-Greylist":["Sender IP whitelisted, not delayed by milter-greylist-4.5.16\n\t(mx1.redhat.com [10.11.55.1]);\n\tThu, 05 Jul 2018 06:47:28 +0000 (UTC)","inspected by milter-greylist-4.5.16 (mx1.redhat.com\n\t[10.11.55.1]); \n\tThu, 05 Jul 2018 06:47:28 +0000 (UTC) for IP:'10.11.54.4'\n\tDOMAIN:'int-mx04.intmail.prod.int.rdu2.redhat.com'\n\tHELO:'smtp.corp.redhat.com' FROM:'kraxel@redhat.com' RCPT:''"],"X-detected-operating-system":"by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]\n\t[fuzzy]","X-Received-From":"66.187.233.73","Subject":"Re: [Qemu-devel] [PATCH] docs: add firmware.txt","X-BeenThere":"qemu-devel@nongnu.org","X-Mailman-Version":"2.1.21","Precedence":"list","List-Id":"","List-Unsubscribe":",\n\t","List-Archive":"","List-Post":"","List-Help":"","List-Subscribe":",\n\t","Cc":"Peter Maydell , qemu-devel@nongnu.org","Errors-To":"qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org","Sender":"\"Qemu-devel\"\n\t"}}]