Linuxコマンド - chroot

QEMU-User-Staticのインストール

QEMU-User-Staticは、クロスアーキテクチャの開発者にとって重要なツールである。
これにより、ユーザはchroot環境を作成して、クロスコンパイルされたプログラムを実行することができる。

例えば、ユーザはシステムレベルのエミュレーションのオーバーヘッド無しに、AArch64の実行ファイルを実行することができる。

パッケージ管理システムからインストール

sudo zypper install qemu-arm qemu-linux-user qemu-uefi-aarch64

ソースコードからインストール

ここでは、ARMおよびAArch64向けのQEMU-User-Staticのインストール手順を示す。
なお、他のアーキテクチャにおいても、同様の手順でインストールすることができる。

QEMUのビルドに必要なライブラリをインストールする。

sudo zypper install flex bison automake gcc gcc-c++ make glibc glibc-utils glibc-devel-static glib2-devel glibc-utils ncurses-devel libxml2-devel \
                    glibc-devel-static glibc-devel-static-32bit glib2-devel glib2-devel-static glib2-devel-32bit \
                    zlib-devel zlib-devel-32bit zlib-devel-static zlib-devel-static-32bit libpcap-devel-static readline-devel-static xfsprogs-devel \
                    pcre-devel-static pcre2-devel pcre2-devel-static gmp-devel perl-Text-Markdown 

                    # 以下の依存関係のライブラリは不要の可能性がある
                    gtk3-devel libgnutls-devel libnettle-devel libseccomp-devel liburing-devel libgbm-devel glusterfs-devel \
                    libjpeg8-devel libpng16-devel libpulse-devel alsa-devel libjack-devel spice-protocol-devel libspice-server-devel \
                    libxkbcommon-devel libxkbcommon-x11-devel libcap-devel libcap-ng-devel libpcap-devel libcurl-devel libudev-devel virglrenderer-devel \
                    libiscsi-devel libzstd-devel libnfs-devel libvdeplug-devel brlapi-devel libSDL2-devel libSDL2_image-devel librados-devel \
                    lzfse-devel libmpath0 libcacard-devel lzo-devel snappy-devel libgcrypt-devel libu2f-server-devel libu2f-host-devel \
                    usbredir-devel libusb-1_0-devel libpmem-devel libkeyutils1 keyutils-devel libselinux-devel fuse-devel fuse3-devel libbpf-devel \
                    libbd_swap-devel libcapstone-devel libslirp-devel libfdt-devel sphinx libsphinxclient-devel  numad libnuma1 numactl libnuma-devel \
                    librbd-devel rdma-core-devel libnet-devel libfvde-devel libdmmp-devel multipath-tools-devel libssh-devel libssh2-devel \
                    rpcbind rpcgen readline-devel libyajl-devel libpciaccess-devel device-mapper-devel libtirpc-devel libnl3-devel libpixman-1-0-devel \
                    libxslt-devel python3-docutils capstone libcapstone4 libcapstone-devel python3-capstone 

QEMUのソースコードをダウンロードする。

• QEMUの公式Webサイトから、ソースコードをダウンロードする場合

  QEMUの公式Webサイトにアクセスして、ソースコードをダウンロードする。

  ダウンロードしたファイルを解凍する。

  tar xf qemu-<バージョン>.tar.xz

  cd qemu-<バージョン>

  
  

• Gitからソースコードをダウンロードする場合

  git clone git://git.qemu.org/qemu.git

  cd qemu

  git submodule update --init --recursive

QEMUをQEMU-User-Staticとして、ビルドおよびインストールする。

mkdir build && cd build

--disable-systemオプションを指定する時、softmmuターゲットが無効になる。
ただし、softmmuターゲットがいくつかの共有ライブラリに依存していることは知られている。
--staticオプションを指定した場合、これらのsoftmmuターゲットはリンクエラーを引き起こす。

../configure --prefix=<QEMU-User-Staticのインストールディレクトリ> \
             --enable-linux-user --static \
             --disable-system --disable-brlapi --disable-cap-ng --disable-capstone  \
             --disable-curl --disable-curses --disable-docs --disable-gcrypt --disable-gnutls \
             --disable-gtk --disable-guest-agent --disable-guest-agent-msi --disable-libiscsi \
             --disable-libnfs --disable-mpath --disable-nettle --disable-opengl --disable-pie \
             --disable-sdl --disable-spice --disable-tools --disable-vte --disable-werror \
             --disable-debug-info --disable-glusterfs \
             --disable-blobs  # QEMU 7.x以前の場合 (QEMU 8.0以降は不要)
             --extra-ldflags=-latomic \
             --target-list=aarch64-linux-user,arm-linux-user \
             # 以下のオプションは任意である
             --cross-prefix=$(info)-                        \
             --host-cc=clang \
             --host=$(clang --print-target-triple)          \
             --build=$(TARGETPLATFORM= TARGETPAIR= clang --print-target-triple) \
             --cc=clang                 \
             --disable-system           \  # ArmおよびAArch64のみをインストールする場合は、--target-list=arm-linux-user,armeb-linux-user,aarch64-linux-userオプションを指定する

make -j $(nproc) または ninja -C .
make install     または ninja -C . install

QEMU-User-Staticの設定スクリプトをコピーする。

mkdir /<QEMU-User-Staticのインストールディレクトリ>/sbin
cp /<QEMUのソースコードがあるディレクトリ>/scripts/qemu-binfmt-conf.sh  /<QEMU-User-Staticのインストールディレクトリ>/sbin

QEMU-User-Staticの設定スクリプトを、以下に示すように編集する。

vi /<QEMU-User-Staticのインストールディレクトリ>/sbin/qemu-binfmt-conf.sh

# /<QEMU-User-Staticのインストールディレクトリ>/sbin/qemu-binfmt-conf.shファイル

# 278行目あたり
## 編集前
echo ":qemu-$cpu:M::$magic:$mask:$qemu:$flags"
## 編集後
echo ":qemu-$cpu:M::$magic:$mask:$qemu:P$flags"

# 319行目あたり
## 編集前
qemu="$QEMU_PATH/qemu-$cpu"
## 編集後
qemu="$QEMU_PATH/qemu-$cpu-binfmt"

# 321行目あたり
## 編集前
qemu="$QEMU_PATH/qemu-i386"
## 編集後
qemu="$QEMU_PATH/qemu-i386-binfmt"

# 337行目あたり
## 編集前
QEMU_PATH=/usr/local/bin
# 編集後
QEMU_PATH=/usr/bin

次に、QEMU-User-Staticに必要なBinfmtを、pkgs.orgのWebサイトからダウンロードする。
Binfmtは、QEMU-User-Staticのバージョンと異なっていても問題無い。
ダウンロードしたファイルを展開する。

rpm2cpio qemu-linux-user-<バージョン>.x86_64.rpm | cpio -id 

展開したディレクトリに移動して、ARMおよびAArch64のBinfmtファイルを/<QEMU-User-Staticのインストールディレクトリ>/binディレクトリにコピーする。

cd qemu-linux-user-<バージョン>.x86_64/usr/bin
cp qemu-binfmt qemu-arm-binfmt qemu-aarch64-binfmt /<QEMU-User-Staticのインストールディレクトリ>/bin

~/.profileファイル等に環境変数PATHを追記する。

vi ~/.profile

# ~/.profileファイル等

export PATH="/<QEMU-User-Staticのインストールディレクトリ>/bin:/<QEMU-User-Staticのインストールディレクトリ>/sbin:$PATH"

例 : openSUSE Tumbleweed (PinePhone)

x86またはx64のPCを使用している場合、ARMバイナリのQEMU変換を設定する。
もし、ARM PCを使用している場合は、この操作は行わない。

# パッケージ管理システムからインストールしている場合
sudo /usr/sbin/qemu-binfmt-conf.sh

# ソースコードからインストールしている場合
sudo /<QEMU-User-Staticのインストールディレクトリ>/sbin/qemu-binfmt-conf.sh

イメージファイルのルートファイルシステムにおいて、オフセットを確認する。
この時、raw2拡張子の開始位置と1セクタのサイズを乗算して、ルートファイルシステムのオフセットを求める。

sudo fdisk -l <openSUSE Tumbleweedのイメージファイル名>.raw

openSUSE Tumbleweedのイメージファイルをマウントする。
以下の例では、/mntディレクトリにマウントしている。

sudo mount -t btrfs -o loop,offset=<ルートファイルシステムのオフセット  例: raw2拡張子の開始位置と1セクタのサイズを乗算した値> <openSUSE Tumbleweedのイメージファイル名>.raw /mnt

sudo mount --bind /sys  /mnt/sys  && sudo mount --make-rslave /mnt/sys  && \
sudo mount --bind /dev  /mnt/dev  && sudo mount --make-rslave /mnt/dev  && \
sudo mount --bind /proc /mnt/proc && sudo mount --make-rslave /mnt/proc && \
sudo mount --bind /dev/pts /mnt/dev/pts
# または
sudo mount --rbind /sys  /mnt/sys  && sudo mount --make-rslave /mnt/sys  && \
sudo mount --rbind /dev  /mnt/dev  && sudo mount --make-rslave /mnt/dev  && \
sudo mount --rbind /proc /mnt/proc && sudo mount --make-rslave /mnt/proc && \
sudo mount --rbind /dev/pts /mnt/dev/pts

sudo cp /run/netconfig/resolv.conf /mnt/etc/

AArch64命令セットをエミュレートするために必要なファイルを、openSUSE Tumbleweed (PinePhone)のマウント先ディレクトリにコピーする。

# パッケージ管理システムからインストールしている場合
sudo cp /usr/bin/qemu-aarch64-binfmt /usr/bin/qemu-aarch64 /mnt/usr/bin/

# ソースコードからインストールしている場合
sudo cp /<QEMU-User-Staticのインストールディレクトリ>/bin/qemu-aarch64-binfmt /<QEMU-User-Staticのインストールディレクトリ>/bin/qemu-aarch64 /mnt/usr/bin/

openSUSE Tumbleweed (PinePhone)の環境にchrootする。

sudo chroot /mnt qemu-aarch64 /bin/bash

以下の例のようなコマンドを実行して、正常に動作するかどうかを確認する。
(root権限で実行されるため、sudoは不要)

zypper ref
zypper dup
zypper in nano

openSUSE Tumbleweed (PinePhone)の環境を終了する場合は、ターミナルからexitコマンドを実行した後、
openSUSE Tumbleweed (PinePhone)のイメージファイルをアンマウントする。

sudo umount -dfl /mnt/sys     && \
sudo umount -dfl /mnt/dev/pts && \
sudo umount -dfl /mnt/dev     && \
sudo umount -dfl /mnt/proc    && \
sudo umount -dfl /mnt

例 : Manjaro ARM (PinePhone)

x86またはx64のPCを使用している場合、ARMバイナリのQEMU変換を設定する。
もし、ARM PCを使用している場合は、この操作は行わない。

# パッケージ管理システムからインストールしている場合
sudo /usr/sbin/qemu-binfmt-conf.sh

# ソースコードからインストールしている場合
sudo /<QEMU-User-Staticのインストールディレクトリ>/sbin/qemu-binfmt-conf.sh

イメージファイルのルートファイルシステムにおいて、オフセットを確認する。
この時、img拡張子の開始位置と1セクタのサイズを乗算して、ルートファイルシステムのオフセットを求める。

sudo fdisk -l <Manjaro ARMのイメージファイル名>.img

Manjaro ARMのイメージファイルをマウントする。
以下の例では、/mntディレクトリにマウントしている。

sudo mount -t ext4 -o loop,offset=<ルートファイルシステムのオフセット  例: img拡張子の開始位置と1セクタのサイズを乗算した値> <Manjaro ARMのイメージファイル名>.img /mnt

sudo mount --bind /sys  /mnt/sys  && sudo mount --make-rslave /mnt/sys  && \
sudo mount --bind /dev  /mnt/dev  && sudo mount --make-rslave /mnt/dev  && \
sudo mount --bind /proc /mnt/proc && sudo mount --make-rslave /mnt/proc && \
sudo mount --bind /dev/pts /mnt/dev/pts
# または
sudo mount --rbind /sys  /mnt/sys  && sudo mount --make-rslave /mnt/sys  && \
sudo mount --rbind /dev  /mnt/dev  && sudo mount --make-rslave /mnt/dev  && \
sudo mount --rbind /proc /mnt/proc && sudo mount --make-rslave /mnt/proc && \
sudo mount --rbind /dev/pts /mnt/dev/pts

sudo cp /run/netconfig/resolv.conf /mnt/etc/

AArch64命令セットをエミュレートするために必要なファイルを、Manjaro ARM (PinePhone)のマウント先ディレクトリにコピーする。

# パッケージ管理システムからインストールしている場合
sudo cp /usr/bin/qemu-aarch64-binfmt /usr/bin/qemu-aarch64 /mnt/usr/bin/

# ソースコードからインストールしている場合
sudo cp /<QEMU-User-Staticのインストールディレクトリ>/bin/qemu-aarch64-binfmt /<QEMU-User-Staticのインストールディレクトリ>/bin/qemu-aarch64 /mnt/usr/bin/

Manjaro ARM (PinePhone)の環境にchrootする。

sudo chroot /mnt qemu-aarch64 /bin/bash

以下の例のようなコマンドを実行して、正常に動作するかどうかを確認する。
(root権限で実行されるため、sudoは不要)

pcman -Syyu
pacman -S --needed nano

※注意
システムをアップデートする時、以下に示すようなエラーが発生する場合がある。

error: <インストールするパッケージ名>: signature from "Arch Linux ARM Build System <builder@archlinuxarm.org>" is unknown trust

この時、/etc/pacman.confファイルを以下に示すように編集する。

sudo vi /etc/pacman.conf

 # 42行目あたり
 
 #SigLevel    = Required DatabaseOptional  # コメントアウトする
 SigLevel    = Optional TrustAll           # 追記する

Manjaro ARM (PinePhone)の環境を終了する場合は、ターミナルからexitコマンドを実行した後、
Manjaro ARM (PinePhone)のイメージファイルをアンマウントする。

sudo umount -dfl /mnt/sys     && \
sudo umount -dfl /mnt/dev/pts && \
sudo umount -dfl /mnt/dev     && \
sudo umount -dfl /mnt/proc    && \
sudo umount -dfl /mnt

例 : Raspbian OS (AArch64)

x86またはx64のPCを使用している場合、ARMバイナリのQEMU変換を設定する。
もし、ARM PCを使用している場合は、この操作は行わない。

# パッケージ管理システムからインストールしている場合
sudo /usr/sbin/qemu-binfmt-conf.sh

# ソースコードからインストールしている場合
sudo /<QEMU-User-Staticのインストールディレクトリ>/sbin/qemu-binfmt-conf.sh

イメージファイルのルートファイルシステムにおいて、オフセットを確認する。
この時、img3拡張子の開始位置と1セクタのサイズを乗算して、ルートファイルシステムのオフセットを求める。

sudo fdisk -l <Raspbian OS (AArch64)のイメージファイル名>.img

Raspbian OS (AArch64)のイメージファイルをマウントする。
以下の例では、/mntディレクトリにマウントしている。

sudo mount -t ext4 -o loop,offset=<ルートファイルシステムのオフセット  例: img3拡張子の開始位置と1セクタのサイズを乗算した値> <Raspbian OS (AArch64)のイメージファイル名>.raw /mnt

AArch64命令セットを動作させるために必要なライブラリを、Raspbian OS (AArch64)のマウント先ディレクトリにコピーする。

# パッケージ管理システムからインストールしている場合
sudo cp /usr/bin/qemu-aarch64-binfmt /usr/bin/qemu-aarch64 /mnt/bin/

# ソースコードからインストールしている場合
sudo cp /<QEMU-User-Staticのインストールディレクトリ>/bin/qemu-aarch64-binfmt /<QEMU-User-Staticのインストールディレクトリ>/bin/qemu-aarch64 /mnt/usr/bin/

chrootコマンドを実行して、Raspbian OS (AArch64)を起動する。

sudo chroot /mnt qemu-aarch64 /bin/bash

終了する場合は、Raspbian OS (AArch64)のイメージファイルをアンマウントする。

sudo umount -fl /mnt