rust-raspberrypi-OS-tutorials/docker/rustembedded-osdev-utils/Makefile

## SPDX-License-Identifier: MIT OR Apache-2.0
##
## Copyright (c) 2019-2021 Andre Richter <andre.o.richter@gmail.com>

# Reference followed: https://www.docker.com/blog/getting-started-with-docker-for-arm-on-linux

TAG := 2021.12

default: build_local

build_local:
	cp ../../Gemfile .
	docker build                                           \
	    --tag rustembedded/osdev-utils:$(TAG)              \
	    --build-arg VCS_REF=`git rev-parse --short HEAD` .
	rm Gemfile

buildx_push:
	cp ../../Gemfile .
	docker buildx build                                    \
	    --push                                             \
	    --platform linux/arm64/v8,linux/amd64              \
	    --tag rustembedded/osdev-utils:$(TAG)              \
	    --build-arg VCS_REF=`git rev-parse --short HEAD` .
	rm Gemfile
Add VCS ref to docker image 2019-12-25 17:32:52 +00:00			`## SPDX-License-Identifier: MIT OR Apache-2.0`
			`##`
Update copyright year 2021-01-01 10:28:32 +00:00			`## Copyright (c) 2019-2021 Andre Richter <andre.o.richter@gmail.com>`
Add VCS ref to docker image 2019-12-25 17:32:52 +00:00
Support for multi-arch Docker images 2021-11-22 21:37:13 +00:00			`# Reference followed: https://www.docker.com/blog/getting-started-with-docker-for-arm-on-linux`
Add VCS ref to docker image 2019-12-25 17:32:52 +00:00
Refactor memory subsystem code This patch refactors big chunks of the memory subsystem code. Most of all, it does away with the the design being based around the raw pointer type "*const Page". While raw pointers to an actual page seemed like a compelling idea, in practice it turned out difficult. Rust feels a bit inconsistent with respect to raw pointers. While it is safe to create them out of nowhere (only dereferencing is unsafe), it gets weird when multi-threading comes into picture. For example, wrapping them into synchronization primitives caused issues because they don't implement Send. For this reason, we switch to the PageAddress type which is based on usize, which makes things a lot easier. Other changes/benefits include: - Gets rid of unsafe code in the removed PageSlice type. - Decouple the translation table code and MMIO VA allocation. - For the translation table tool, make better use of what the ELF format already provides with respect to memory segmentation and translation. For example, the tool now queries the ELF file for VA->PA translations and other segment attributes. This has also the added benefit of reduced BSP code and more generic code in the tool. - Packs rbelftools in the Docker image now (used by translation table tool). - In tutorials 14/15/16, rearrange the PA and VA layout. 2021-12-02 19:44:12 +00:00			`TAG := 2021.12`
Support for multi-arch Docker images 2021-11-22 21:37:13 +00:00
			`default: build_local`

			`build_local:`
			`cp ../../Gemfile .`
			`docker build \`
			`--tag rustembedded/osdev-utils:$(TAG) \`
Refactor memory subsystem code This patch refactors big chunks of the memory subsystem code. Most of all, it does away with the the design being based around the raw pointer type "*const Page". While raw pointers to an actual page seemed like a compelling idea, in practice it turned out difficult. Rust feels a bit inconsistent with respect to raw pointers. While it is safe to create them out of nowhere (only dereferencing is unsafe), it gets weird when multi-threading comes into picture. For example, wrapping them into synchronization primitives caused issues because they don't implement Send. For this reason, we switch to the PageAddress type which is based on usize, which makes things a lot easier. Other changes/benefits include: - Gets rid of unsafe code in the removed PageSlice type. - Decouple the translation table code and MMIO VA allocation. - For the translation table tool, make better use of what the ELF format already provides with respect to memory segmentation and translation. For example, the tool now queries the ELF file for VA->PA translations and other segment attributes. This has also the added benefit of reduced BSP code and more generic code in the tool. - Packs rbelftools in the Docker image now (used by translation table tool). - In tutorials 14/15/16, rearrange the PA and VA layout. 2021-12-02 19:44:12 +00:00			--build-arg VCS_REF=`git rev-parse --short HEAD` .
Support for multi-arch Docker images 2021-11-22 21:37:13 +00:00			`rm Gemfile`

			`buildx_push:`
Introducing Minipush, a raspbootcom replacement. Gets rid of compiled C++, uses Ruby 💎 2020-01-14 19:45:41 +00:00			`cp ../../Gemfile .`
Support for multi-arch Docker images 2021-11-22 21:37:13 +00:00			`docker buildx build \`
			`--push \`
			`--platform linux/arm64/v8,linux/amd64 \`
			`--tag rustembedded/osdev-utils:$(TAG) \`
			--build-arg VCS_REF=`git rev-parse --short HEAD` .
Introducing Minipush, a raspbootcom replacement. Gets rid of compiled C++, uses Ruby 💎 2020-01-14 19:45:41 +00:00			`rm Gemfile`