Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/xpack-dev-tools/qemu-riscv-xpack
A binary distribution of QEMU RISC-V
https://github.com/xpack-dev-tools/qemu-riscv-xpack
Last synced: about 2 months ago
JSON representation
A binary distribution of QEMU RISC-V
- Host: GitHub
- URL: https://github.com/xpack-dev-tools/qemu-riscv-xpack
- Owner: xpack-dev-tools
- License: mit
- Created: 2021-12-10T21:22:38.000Z (about 3 years ago)
- Default Branch: xpack
- Last Pushed: 2024-10-15T16:30:50.000Z (2 months ago)
- Last Synced: 2024-10-16T22:26:03.592Z (2 months ago)
- Language: MDX
- Homepage: https://xpack-dev-tools.github.io/qemu-riscv-xpack/
- Size: 1.02 MB
- Stars: 6
- Watchers: 4
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README-LONG.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/xpack-dev-tools/qemu-riscv-xpack/blob/xpack/package.json)
[](https://github.com/xpack-dev-tools/qemu-riscv-xpack/releases/)
[](https://www.npmjs.com/package/@xpack-dev-tools/qemu-riscv/)
[](https://github.com/xpack-dev-tools/qemu-riscv-xpack/blob/xpack/LICENSE)
# The xPack QEMU RISC-V
A standalone cross-platform (Windows/macOS/Linux) **QEMU RISC-V**
binary distribution, intended for reproducible builds.
In addition to the the binary archives and the package meta data,
this project also includes the build scripts.
## Overview
This open source project is hosted on GitHub as
[`xpack-dev-tools/qemu-riscv-xpack`](https://github.com/xpack-dev-tools/qemu-riscv-xpack)
and provides the platform specific binaries for the
[xPack QEMU RISC-V](https://xpack.github.io/qemu-riscv/).
This distribution is based on an older release of the official
[QEMU](https://www.qemu.org).
The binaries can be installed automatically as **binary xPacks** or manually as
**portable archives**.
## Release schedule
This distribution plans to follow the official QEMU major releases,
possibly with intermediate releases if necessary.
## User info
This section is intended as a shortcut for those who plan
to use the QEMU RISC-V binaries. For full details please read the
[xPack QEMU RISC-V](https://xpack.github.io/qemu-riscv/) pages.
### Easy install
The easiest way to install QEMU RISC-V is using the **binary xPack**, available as
[`@xpack-dev-tools/qemu-riscv`](https://www.npmjs.com/package/@xpack-dev-tools/qemu-riscv)
from the [`npmjs.com`](https://www.npmjs.com) registry.
#### Prerequisites
A recent [xpm](https://xpack.github.io/xpm/),
which is a portable [Node.js](https://nodejs.org/) command line application
that complements [npm](https://docs.npmjs.com)
with several extra features specific to
**C/C++ projects**.
It is recommended to install/update to the latest version with:
```sh
npm install --location=global xpm@latest
```
For details please follow the instructions in the
[xPack install](https://xpack.github.io/install/) page.
#### Install
With the `xpm` tool available, installing
the latest version of the package and adding it as
a development dependency for a project is quite easy:
```sh
cd my-project
xpm init # Add a package.json if not already present
xpm install @xpack-dev-tools/qemu-riscv@latest --verbose
ls -l xpacks/.bin
```
This command will:
- install the latest available version,
into the central xPacks store, if not already there
- add symbolic links to the central store
(or `.cmd` forwarders on Windows) into
the local `xpacks/.bin` folder.
The central xPacks store is a platform dependent
location in the home folder;
check the output of the `xpm` command for the actual
folder used on your platform.
This location is configurable via the environment variable
`XPACKS_STORE_FOLDER`; for more details please check the
[xpm folders](https://xpack.github.io/xpm/folders/) page.
For xPacks aware tools, like the **Eclipse Embedded C/C++ plug-ins**,
it is also possible to install QEMU globally, in the user home folder:
```sh
xpm install --global @xpack-dev-tools/qemu-riscv@latest --verbose
```
Eclipse will automatically
identify binaries installed with
`xpm` and provide a convenient method to manage paths.
After install, the package should create a structure like this (macOS files;
only the first two depth levels are shown):
```console
$ tree -L 2 /Users/ilg/Library/xPacks/@xpack-dev-tools/qemu-riscv/8.2.2-1.1/.content/
/Users/ilg/Library/xPacks/@xpack-dev-tools/qemu-riscv/8.2.2-1.1/.content/
├── README.md
├── bin
│ ├── qemu-system-riscv32
│ └── qemu-system-riscv64
├── distro-info
│ └── licenses
├── include
│ ├── fdt.h
│ ├── libfdt.h
│ ├── libfdt_env.h
│ └── qemu-plugin.h
├── lib
│ ├── libfdt.a
│ └── pkgconfig
├── libexec
│ ├── libbz2.1.0.8.dylib
│ ├── libcrypto.1.1.dylib
│ ├── libffi.8.dylib
│ ├── libgio-2.0.0.dylib
│ ├── libglib-2.0.0.dylib
│ ├── libgmodule-2.0.0.dylib
│ ├── libgmp.10.dylib
│ ├── libgobject-2.0.0.dylib
│ ├── libhogweed.6.8.dylib
│ ├── libhogweed.6.dylib -> libhogweed.6.8.dylib
│ ├── libiconv.2.dylib
│ ├── libintl.8.dylib
│ ├── libjpeg.9.dylib
│ ├── liblzo2.2.dylib
│ ├── libncursesw.6.dylib
│ ├── libnettle.8.8.dylib
│ ├── libnettle.8.dylib -> libnettle.8.8.dylib
│ ├── libpcre2-8.0.dylib
│ ├── libpixman-1.0.dylib
│ ├── libpng16.16.dylib
│ ├── libssh.4.9.6.dylib
│ ├── libssh.4.dylib -> libssh.4.9.6.dylib
│ ├── libusb-1.0.0.dylib
│ ├── libvdeplug.3.dylib
│ ├── libz.1.3.1.dylib
│ ├── libz.1.dylib -> libz.1.3.1.dylib
│ ├── libzstd.1.5.5.dylib
│ └── libzstd.1.dylib -> libzstd.1.5.5.dylib
└── share
├── applications
├── icons
└── qemu
12 directories, 36 files
```
No other files are installed in any system folders or other locations.
#### Uninstall
The binaries are distributed as portable archives; thus they do not need
to run a setup and do not require an uninstall; simply removing the
folder is enough.
To remove the links created by xpm in the current project:
```sh
cd my-project
xpm uninstall @xpack-dev-tools/qemu-riscv
```
To completely remove the package from the central xPack store:
```sh
xpm uninstall --global @xpack-dev-tools/qemu-riscv
```
### Manual install
For all platforms, the **xPack QEMU RISC-V**
binaries are released as portable
archives that can be installed in any location.
The archives can be downloaded from the
GitHub [Releases](https://github.com/xpack-dev-tools/qemu-riscv-xpack/releases/)
page.
For more details please read the
[Install](https://xpack.github.io/qemu-riscv/install/) page.
### Versioning
The version strings used by the QEMU project are three number strings
like `8.2.2`; to this string the xPack distribution adds a four number,
but since semver allows only three numbers, all additional ones can
be added only as pre-release strings, separated by a dash,
like `8.2.2-1`. When published as a npm package, the version gets
a fifth number, like `8.2.2-1.1`.
Since adherence of third party packages to semver is not guaranteed,
it is recommended to use semver expressions like `^8.2.2` and `~8.2.2`
with caution, and prefer exact matches, like `8.2.2-1.1`.
## Maintainer info
For maintainer info, please see the
[README-MAINTAINER](https://github.com/xpack-dev-tools/qemu-riscv-xpack/blob/xpack/README-MAINTAINER.md).
## Support
The quick advice for getting support is to use the GitHub
[Discussions](https://github.com/xpack-dev-tools/qemu-riscv-xpack/discussions/).
For more details please read the
[Support](https://xpack.github.io/qemu-riscv/support/) page.
## License
Unless otherwise stated, the content is released under the terms of the
[MIT License](https://opensource.org/licenses/mit/),
with all rights reserved to
[Liviu Ionescu](https://github.com/ilg-ul).
The binary distributions include several open-source components; the
corresponding licenses are available in the installed
`distro-info/licenses` folder.
## Download analytics
- GitHub [`xpack-dev-tools/qemu-riscv-xpack`](https://github.com/xpack-dev-tools/qemu-riscv-xpack/) repo
- latest xPack release
[](https://github.com/xpack-dev-tools/qemu-riscv-xpack/releases/)
- all xPack releases [](https://github.com/xpack-dev-tools/qemu-riscv-xpack/releases/)
- [individual file counters](https://somsubhra.github.io/github-release-stats/?username=xpack-dev-tools&repository=qemu-riscv-xpack) (grouped per release)
- npmjs.com [`@xpack-dev-tools/qemu-riscv`](https://www.npmjs.com/package/@xpack-dev-tools/qemu-riscv/) xPack
- latest release, per month
[](https://www.npmjs.com/package/@xpack-dev-tools/qemu-riscv/)
[](https://www.npmjs.com/package/@xpack-dev-tools/qemu-riscv/)
- all releases [](https://www.npmjs.com/package/@xpack-dev-tools/qemu-riscv/)
Credit to [Shields IO](https://shields.io) for the badges and to
[Somsubhra/github-release-stats](https://github.com/Somsubhra/github-release-stats)
for the individual file counters.