%global _empty_manifest_terminate_build 0
Name: python-tuxrun
Version: 0.43.1
Release: 1
Summary: Command line tool for testing Linux under QEMU
License: None
URL: https://tuxsuite.com/
Source0: https://mirrors.aliyun.com/pypi/web/packages/8e/32/64a6527d44228aec120170e436d1bc36dc65ae463e98d0b16db611c0b400/tuxrun-0.43.1.tar.gz
BuildArch: noarch
Requires: python3-jinja2
Requires: python3-requests
Requires: python3-PyYAML
%description
[](https://gitlab.com/Linaro/tuxrun/pipelines)
[](https://gitlab.com/Linaro/tuxrun/commits/master)
[](https://pypi.org/project/tuxrun/)
[](https://github.com/psf/black)
[](https://gitlab.com/Linaro/tuxrun/blob/master/LICENSE)
[Documentation](https://tuxrun.org/) - [Repository](https://gitlab.com/Linaro/tuxrun) - [Issues](https://gitlab.com/Linaro/tuxrun/-/issues)
TuxRun, by [Linaro](https://www.linaro.org/), is a command line tool for
testing Linux on QEMU or FVP, using curated test suites. TuxRun is a part of
[TuxSuite](https://tuxsuite.com), a suite of tools and services to help with
Linux kernel development.
[[_TOC_]]
# About TuxRun
Testing the Linux kernel is as simple as using QEMU but it gets complicated
when you want to support the following combinations:
- Architectures (arm64, armv5, armv7, i386, mips32, mips32el, mips64, mips64el,
ppc32, ppc64, ppc64le, riscv64, s390, sh4, sparc64, x86_64)
- Emulation systems (QEMU or FVP)
- Tests (every test suite has dependencies on the rootfs)
Each of those items requires specific configuration and root file systems. In
order to allow for reproducible tests, TuxRun uses containers runtimes (Docker
or Podman).
# Installing TuxRun
There are several options for installing TuxRun:
- [From PyPI](docs/install-pypi.md)
- [Run uninstalled](docs/run-uninstalled.md)
# Using TuxRun
To use TuxRun, compile your own linux kernel for arm64, for example using
[TuxMake](https://tuxmake.org).
Then call tuxrun:
```shell
tuxrun --device qemu-arm64 --kernel /path/to/Image
```
TuxRun will automatically start qemu-system with the right arguments and the
right root filesystem.
# Known issues
Known issues when booting on different virtual platforms.
- [From issues](docs/issues.md)
# Examples
Boot test a mipsel kernel at https://mykernel.org/vmlinux:
```shell
tuxrun --device qemu-mips32el \
--kernel https://mykernel.org/vmlinux
```
Running *ltp-smoke*:
```shell
tuxrun --device qemu-mips32el \
--kernel https://mykernel.org/vmlinux \
--test ltp-smoke
```
Using a custom root file system
```shell
tuxrun --device qemu-mips32el \
--kernel https://mykernel.org/vmlinux \
--rootfs https://mykernel.org/rootfs.tar.xz
```
%package -n python3-tuxrun
Summary: Command line tool for testing Linux under QEMU
Provides: python-tuxrun
BuildRequires: python3-devel
BuildRequires: python3-setuptools
BuildRequires: python3-pip
%description -n python3-tuxrun
[](https://gitlab.com/Linaro/tuxrun/pipelines)
[](https://gitlab.com/Linaro/tuxrun/commits/master)
[](https://pypi.org/project/tuxrun/)
[](https://github.com/psf/black)
[](https://gitlab.com/Linaro/tuxrun/blob/master/LICENSE)
[Documentation](https://tuxrun.org/) - [Repository](https://gitlab.com/Linaro/tuxrun) - [Issues](https://gitlab.com/Linaro/tuxrun/-/issues)
TuxRun, by [Linaro](https://www.linaro.org/), is a command line tool for
testing Linux on QEMU or FVP, using curated test suites. TuxRun is a part of
[TuxSuite](https://tuxsuite.com), a suite of tools and services to help with
Linux kernel development.
[[_TOC_]]
# About TuxRun
Testing the Linux kernel is as simple as using QEMU but it gets complicated
when you want to support the following combinations:
- Architectures (arm64, armv5, armv7, i386, mips32, mips32el, mips64, mips64el,
ppc32, ppc64, ppc64le, riscv64, s390, sh4, sparc64, x86_64)
- Emulation systems (QEMU or FVP)
- Tests (every test suite has dependencies on the rootfs)
Each of those items requires specific configuration and root file systems. In
order to allow for reproducible tests, TuxRun uses containers runtimes (Docker
or Podman).
# Installing TuxRun
There are several options for installing TuxRun:
- [From PyPI](docs/install-pypi.md)
- [Run uninstalled](docs/run-uninstalled.md)
# Using TuxRun
To use TuxRun, compile your own linux kernel for arm64, for example using
[TuxMake](https://tuxmake.org).
Then call tuxrun:
```shell
tuxrun --device qemu-arm64 --kernel /path/to/Image
```
TuxRun will automatically start qemu-system with the right arguments and the
right root filesystem.
# Known issues
Known issues when booting on different virtual platforms.
- [From issues](docs/issues.md)
# Examples
Boot test a mipsel kernel at https://mykernel.org/vmlinux:
```shell
tuxrun --device qemu-mips32el \
--kernel https://mykernel.org/vmlinux
```
Running *ltp-smoke*:
```shell
tuxrun --device qemu-mips32el \
--kernel https://mykernel.org/vmlinux \
--test ltp-smoke
```
Using a custom root file system
```shell
tuxrun --device qemu-mips32el \
--kernel https://mykernel.org/vmlinux \
--rootfs https://mykernel.org/rootfs.tar.xz
```
%package help
Summary: Development documents and examples for tuxrun
Provides: python3-tuxrun-doc
%description help
[](https://gitlab.com/Linaro/tuxrun/pipelines)
[](https://gitlab.com/Linaro/tuxrun/commits/master)
[](https://pypi.org/project/tuxrun/)
[](https://github.com/psf/black)
[](https://gitlab.com/Linaro/tuxrun/blob/master/LICENSE)
[Documentation](https://tuxrun.org/) - [Repository](https://gitlab.com/Linaro/tuxrun) - [Issues](https://gitlab.com/Linaro/tuxrun/-/issues)
TuxRun, by [Linaro](https://www.linaro.org/), is a command line tool for
testing Linux on QEMU or FVP, using curated test suites. TuxRun is a part of
[TuxSuite](https://tuxsuite.com), a suite of tools and services to help with
Linux kernel development.
[[_TOC_]]
# About TuxRun
Testing the Linux kernel is as simple as using QEMU but it gets complicated
when you want to support the following combinations:
- Architectures (arm64, armv5, armv7, i386, mips32, mips32el, mips64, mips64el,
ppc32, ppc64, ppc64le, riscv64, s390, sh4, sparc64, x86_64)
- Emulation systems (QEMU or FVP)
- Tests (every test suite has dependencies on the rootfs)
Each of those items requires specific configuration and root file systems. In
order to allow for reproducible tests, TuxRun uses containers runtimes (Docker
or Podman).
# Installing TuxRun
There are several options for installing TuxRun:
- [From PyPI](docs/install-pypi.md)
- [Run uninstalled](docs/run-uninstalled.md)
# Using TuxRun
To use TuxRun, compile your own linux kernel for arm64, for example using
[TuxMake](https://tuxmake.org).
Then call tuxrun:
```shell
tuxrun --device qemu-arm64 --kernel /path/to/Image
```
TuxRun will automatically start qemu-system with the right arguments and the
right root filesystem.
# Known issues
Known issues when booting on different virtual platforms.
- [From issues](docs/issues.md)
# Examples
Boot test a mipsel kernel at https://mykernel.org/vmlinux:
```shell
tuxrun --device qemu-mips32el \
--kernel https://mykernel.org/vmlinux
```
Running *ltp-smoke*:
```shell
tuxrun --device qemu-mips32el \
--kernel https://mykernel.org/vmlinux \
--test ltp-smoke
```
Using a custom root file system
```shell
tuxrun --device qemu-mips32el \
--kernel https://mykernel.org/vmlinux \
--rootfs https://mykernel.org/rootfs.tar.xz
```
%prep
%autosetup -n tuxrun-0.43.1
%build
%py3_build
%install
%py3_install
install -d -m755 %{buildroot}/%{_pkgdocdir}
if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi
if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi
if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi
if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi
pushd %{buildroot}
if [ -d usr/lib ]; then
find usr/lib -type f -printf "\"/%h/%f\"\n" >> filelist.lst
fi
if [ -d usr/lib64 ]; then
find usr/lib64 -type f -printf "\"/%h/%f\"\n" >> filelist.lst
fi
if [ -d usr/bin ]; then
find usr/bin -type f -printf "\"/%h/%f\"\n" >> filelist.lst
fi
if [ -d usr/sbin ]; then
find usr/sbin -type f -printf "\"/%h/%f\"\n" >> filelist.lst
fi
touch doclist.lst
if [ -d usr/share/man ]; then
find usr/share/man -type f -printf "\"/%h/%f.gz\"\n" >> doclist.lst
fi
popd
mv %{buildroot}/filelist.lst .
mv %{buildroot}/doclist.lst .
%files -n python3-tuxrun -f filelist.lst
%dir %{python3_sitelib}/*
%files help -f doclist.lst
%{_docdir}/*
%changelog
* Fri Jun 09 2023 Python_Bot - 0.43.1-1
- Package Spec generated