{"id":808621,"url":"http://patchwork.ozlabs.org/api/1.2/patches/808621/?format=json","web_url":"http://patchwork.ozlabs.org/project/qemu-devel/patch/20170901105331.11783-1-kraxel@redhat.com/","project":{"id":14,"url":"http://patchwork.ozlabs.org/api/1.2/projects/14/?format=json","name":"QEMU Development","link_name":"qemu-devel","list_id":"qemu-devel.nongnu.org","list_email":"qemu-devel@nongnu.org","web_url":"","scm_url":"","webscm_url":"","list_archive_url":"","list_archive_url_format":"","commit_url_format":""},"msgid":"<20170901105331.11783-1-kraxel@redhat.com>","list_archive_url":null,"date":"2017-09-01T10:53:31","name":"docs: add firmware.txt","commit_ref":null,"pull_url":null,"state":"new","archived":false,"hash":"43848ed6e4f4a042828c4167dd4a7335f1b3d4e0","submitter":{"id":589,"url":"http://patchwork.ozlabs.org/api/1.2/people/589/?format=json","name":"Gerd Hoffmann","email":"kraxel@redhat.com"},"delegate":null,"mbox":"http://patchwork.ozlabs.org/project/qemu-devel/patch/20170901105331.11783-1-kraxel@redhat.com/mbox/","series":[{"id":996,"url":"http://patchwork.ozlabs.org/api/1.2/series/996/?format=json","web_url":"http://patchwork.ozlabs.org/project/qemu-devel/list/?series=996","date":"2017-09-01T10:53:31","name":"docs: add firmware.txt","version":1,"mbox":"http://patchwork.ozlabs.org/series/996/mbox/"}],"comments":"http://patchwork.ozlabs.org/api/patches/808621/comments/","check":"pending","checks":"http://patchwork.ozlabs.org/api/patches/808621/checks/","tags":{},"related":[],"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=)","ext-mx09.extmail.prod.ext.phx2.redhat.com;\n\tdmarc=none (p=none dis=none) header.from=redhat.com","ext-mx09.extmail.prod.ext.phx2.redhat.com;\n\tspf=fail smtp.mailfrom=kraxel@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 3xkGMX3S2pz9rxl\n\tfor ;\n\tFri, 1 Sep 2017 20:54:16 +1000 (AEST)","from localhost ([::1]:34961 helo=lists.gnu.org)\n\tby lists.gnu.org with esmtp (Exim 4.71) (envelope-from\n\t)\n\tid 1dnjaY-0004z5-Kn\n\tfor incoming@patchwork.ozlabs.org; Fri, 01 Sep 2017 06:54:14 -0400","from eggs.gnu.org ([2001:4830:134:3::10]:50186)\n\tby lists.gnu.org with esmtp (Exim 4.71)\n\t(envelope-from ) id 1dnja5-0004wi-Fr\n\tfor qemu-devel@nongnu.org; Fri, 01 Sep 2017 06:53:50 -0400","from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)\n\t(envelope-from ) id 1dnja0-0008CR-O1\n\tfor qemu-devel@nongnu.org; Fri, 01 Sep 2017 06:53:45 -0400","from mx1.redhat.com ([209.132.183.28]:39106)\n\tby eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32)\n\t(Exim 4.71) (envelope-from ) id 1dnja0-0008CJ-HU\n\tfor qemu-devel@nongnu.org; Fri, 01 Sep 2017 06:53:40 -0400","from smtp.corp.redhat.com\n\t(int-mx06.intmail.prod.int.phx2.redhat.com [10.5.11.16])\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 81E34404333\n\tfor ; Fri, 1 Sep 2017 10:53:39 +0000 (UTC)","from sirius.home.kraxel.org (ovpn-116-70.ams2.redhat.com\n\t[10.36.116.70])\n\tby smtp.corp.redhat.com (Postfix) with ESMTP id 8C63E71C46;\n\tFri, 1 Sep 2017 10:53:37 +0000 (UTC)","by sirius.home.kraxel.org (Postfix, from userid 1000)\n\tid BF31A16A890; Fri, 1 Sep 2017 12:53:36 +0200 (CEST)"],"DMARC-Filter":"OpenDMARC Filter v1.3.2 mx1.redhat.com 81E34404333","From":"Gerd Hoffmann ","To":"qemu-devel@nongnu.org","Date":"Fri, 1 Sep 2017 12:53:31 +0200","Message-Id":"<20170901105331.11783-1-kraxel@redhat.com>","X-Scanned-By":"MIMEDefang 2.79 on 10.5.11.16","X-Greylist":"Sender IP whitelisted, not delayed by milter-greylist-4.5.16\n\t(mx1.redhat.com [10.5.110.38]);\n\tFri, 01 Sep 2017 10:53:39 +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":"[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":"Gerd Hoffmann ","Errors-To":"qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org","Sender":"\"Qemu-devel\"\n\t"},"content":"Document how guest firmware is handled in qemu today.\n\nReviewed-by: Laszlo Ersek \nSigned-off-by: Gerd Hoffmann \n---\n docs/firmware.txt | 49 +++++++++++++++++++++++++++++++++++++++++++++++++\n 1 file changed, 49 insertions(+)\n create mode 100644 docs/firmware.txt","diff":"diff --git a/docs/firmware.txt b/docs/firmware.txt\nnew file mode 100644\nindex 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","prefixes":[]}