From mboxrd@z Thu Jan 1 00:00:00 1970 X-GM-THRID: 6658915524700798976 X-Received: by 2002:a1c:cb8d:: with SMTP id b135mr571797wmg.22.1550490245706; Mon, 18 Feb 2019 03:44:05 -0800 (PST) X-BeenThere: isar-users@googlegroups.com Received: by 2002:a7b:cd99:: with SMTP id y25ls704522wmj.2.gmail; Mon, 18 Feb 2019 03:44:05 -0800 (PST) X-Google-Smtp-Source: AHgI3IZ6e3rge2zDydP+4qUNZzLLx1icA8pMsnTHYho/e0BDtRQrKxw1SlcS9RpGwYkzNG8ME88J X-Received: by 2002:a7b:c207:: with SMTP id x7mr1548669wmi.5.1550490245288; Mon, 18 Feb 2019 03:44:05 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1550490245; cv=none; d=google.com; s=arc-20160816; b=L4zn9Q9AtBum8xeFT8stSNbMGXjaljvnXS0LLrA/JjPjikYzvWPpwCLfxwBUJdk/5+ 5pb3fmp9n1hsdnqoVgD4FqK/a3r7YlwInDL5C7lhzJBZVofWlLy+Ugiy9WkSl1R2o45L puj8H7trIcaw1MZm9swSLmcvdElneQ7diZuyiEGd124qQUTs73bq4nUYpHwbDnVpBP4O me1ryDt9yG1yaKZB+TGBMYkiCe54S17C5qtaI5ceYFYCts15DOOEisZR64J49AeazCfE Ies3synYQRnomg8eoexT3z6xmw1THsg7Z676kxFqOMvnbHbKvbFPVUZyP+bdMtvmmS1w XZWA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:content-language:in-reply-to:mime-version :user-agent:date:message-id:organization:from:references:to:subject; bh=VGPtHtjohQN+VusZd5ktZMy3mIrGhlwtq24LYC5UADA=; b=dm9mUttZEgKAMVpBIKBR9ePPwtfm7xp98tVmfRb+hkyLxGnH760cnZB56mU9lI1suj 0sddPqsssu6sKHtTyMsr04Reo+B4TcnYjO5480N5l0d3LezWIOUxV4pRSIOLXfim3Kvb 36gRxcopfzNEE+hBFIVW0HtTwLrQ8q1WH5q2rPCXgwtsXeF097sUv95ULLXJkUBoQIvx n+PiQDCeB8UPo+6JV7wJTMBWfOwTy2bwr9ko/WnkF9eB/Yoty648495u0q7FgUoeqz7U 87/bMOBmyogM6byar8IEeuYXVRkze9S1B1OcVD/K8HBHQNUsAFqeQwmr63pMz3pZvLMQ L0Iw== ARC-Authentication-Results: i=1; gmr-mx.google.com; spf=pass (google.com: domain of mosipov@ilbers.de designates 85.214.156.166 as permitted sender) smtp.mailfrom=mosipov@ilbers.de Return-Path: Received: from shymkent.ilbers.de (shymkent.ilbers.de. [85.214.156.166]) by gmr-mx.google.com with ESMTPS id 109si654020wrb.0.2019.02.18.03.44.05 for (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Mon, 18 Feb 2019 03:44:05 -0800 (PST) Received-SPF: pass (google.com: domain of mosipov@ilbers.de designates 85.214.156.166 as permitted sender) client-ip=85.214.156.166; Authentication-Results: gmr-mx.google.com; spf=pass (google.com: domain of mosipov@ilbers.de designates 85.214.156.166 as permitted sender) smtp.mailfrom=mosipov@ilbers.de Received: from [192.168.50.163] (d51A48A80.access.telenet.be [81.164.138.128]) (authenticated bits=0) by shymkent.ilbers.de (8.15.2/8.15.2/Debian-8) with ESMTPSA id x1IBi4t5013614 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Mon, 18 Feb 2019 12:44:04 +0100 Subject: Re: [PATCH] doc: Improve docs To: Baurzhan Ismagulov , isar-users@googlegroups.com References: <20190217103301.3348-1-ibr@radix50.net> From: "Maxim Yu. Osipov" Organization: ilbers GmbH Message-ID: <16d01578-4eb5-16fd-dabd-cfc455d629ab@ilbers.de> Date: Mon, 18 Feb 2019 12:44:09 +0100 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:60.0) Gecko/20100101 Thunderbird/60.4.0 MIME-Version: 1.0 In-Reply-To: <20190217103301.3348-1-ibr@radix50.net> Content-Type: text/plain; charset=utf-8; format=flowed Content-Language: en-US Content-Transfer-Encoding: 7bit X-Spam-Status: No, score=-1.0 required=5.0 tests=ALL_TRUSTED,URIBL_BLOCKED autolearn=unavailable autolearn_force=no version=3.4.2 X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on shymkent.ilbers.de X-TUID: QvbmJnw0DKzI On 2/17/19 11:33 AM, Baurzhan Ismagulov wrote: > From: Baurzhan Ismagulov Rebased and applied to the 'next', Thanks, Maxim. > Signed-off-by: Baurzhan Ismagulov > --- > doc/edk2_build.md | 59 +++++++++++++++++++++++++++++++++++++++--------------- > doc/user_manual.md | 17 ++++++++++++---- > 2 files changed, 56 insertions(+), 20 deletions(-) > > diff --git a/doc/edk2_build.md b/doc/edk2_build.md > index 64c90ff..f33d381 100644 > --- a/doc/edk2_build.md > +++ b/doc/edk2_build.md > @@ -1,12 +1,20 @@ > # Building Tianocore UEFI Firmware > > -## Install Build Dependencies > +A binary `ovmf` package is available in Debian Jessie, Stretch, and sid, but it > +doesn't seem to be recent enough for testing images generated by Isar. > + > +## Get the Sources > + > +``` > +git clone https://github.com/tianocore/edk2 > +cd edk2 > +git checkout 3858b4a1ff09d3243fea8d07bd135478237cb8f7 > +``` > > -Install the following packages with `sudo apt-get install`: > +## Install Build Dependencies > > ``` > -uuid-dev # /usr/include/uuid/uuid.h > -acpica-tools # /usr/bin/iasl > +sudo apt-get install acpica-tools g++ make nasm python uuid-dev > ``` > > ## Build BaseTools > @@ -14,31 +22,50 @@ acpica-tools # /usr/bin/iasl > * `BaseTools/Source/C/Makefiles/header.makefile`: Remove `-Werror` > * `make -C BaseTools` > > - > ## Initialize Build Environment > > -`. edksetup.sh` > +`. ./edksetup.sh` > > -## Build IA32 Firmware > +## Build X64 Firmware > + > +Usable with qemu-system-x86_64. > > -* `Conf/target.txt`: Edit as follows: > +Edit `Conf/target.txt` as follows: > ``` > -ACTIVE_PLATFORM = OvmfPkg/OvmfPkgIa32.dsc > +ACTIVE_PLATFORM = OvmfPkg/OvmfPkgX64.dsc > TARGET = RELEASE > -TARGET_ARCH = IA32 > +TARGET_ARCH = X64 > TOOL_CHAIN_TAG = GCC49 > MAX_CONCURRENT_THREAD_NUMBER = 8 > ``` > -* `build` > > -## Build X64 Firmware > +``` > +build > +``` > + > +Tested on Stretch. > + > +## Build IA32 Firmware > > -* `Conf/target.txt`: Edit as follows: > +Usable with qemu-system-i386 or qemu-system-x86_64. If the X64 version works > +for you, skip this section. > + > +Edit `Conf/target.txt` as follows: > ``` > -ACTIVE_PLATFORM = OvmfPkg/OvmfPkgX64.dsc > +ACTIVE_PLATFORM = OvmfPkg/OvmfPkgIa32.dsc > TARGET = RELEASE > -TARGET_ARCH = X64 > +TARGET_ARCH = IA32 > TOOL_CHAIN_TAG = GCC49 > MAX_CONCURRENT_THREAD_NUMBER = 8 > ``` > -* `build` > + > +``` > +build > +``` > + > +Tested on Jessie. > + > +## TODO > + > +* Test sid `ovmf` later than 2018-08-07. If it doesn't work, provide an updated > + package. > diff --git a/doc/user_manual.md b/doc/user_manual.md > index ff4939c..24e3cc7 100644 > --- a/doc/user_manual.md > +++ b/doc/user_manual.md > @@ -57,23 +57,32 @@ The supported host system is >= stretch. > > Install the following packages: > ``` > +binfmt-support > +debootstrap > dosfstools > -git > dpkg-dev > +git > +mtools > parted > python3 > python3-distutils # host >= buster > -qemu > +qemu # start_vm > qemu-user-static > -binfmt-support > -sudo > reprepro > +sudo > ``` > > Notes: > > * BitBake requires Python 3.4+. > * The python3 package is required for the correct `alternatives` setting. > +* If you'd like to run bitbake in a container (chroot, docker, etc.), install > + the above in the container, and also perform `sudo apt-get install > + binfmt-support qemu-user-static` on the host that should run the container. > +* If you install `binfmt-support` after `qemu-user-static`, perform `sudo > + apt-get install --reinstall qemu-user-static` to register binary formats > + handled by QEMU (check e.g. `qemu-arm` in `/usr/sbin/update-binfmts > + --display`). > > ### Setup Sudo > > -- Maxim Osipov ilbers GmbH Maria-Merian-Str. 8 85521 Ottobrunn Germany +49 (151) 6517 6917 mosipov@ilbers.de http://ilbers.de/ Commercial register Munich, HRB 214197 General Manager: Baurzhan Ismagulov