Skip to content

Commit 1649fb2

Browse files
committed
READMEs updates
1 parent fec9ee6 commit 1649fb2

File tree

3 files changed

+285
-11
lines changed

3 files changed

+285
-11
lines changed

README-BUILD.md

Lines changed: 283 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -415,11 +415,244 @@ the build folder, it might be necessary to run a recursive `chown`.
415415

416416
## Actual configuration
417417

418-
The result of the `configure` step on CentOS 6, with most of the
419-
options disabled, is:
418+
The result of the `configure` step, is:
420419

421420
```console
422-
...
421+
422+
qemu 7.0.0
423+
424+
Directories
425+
Install prefix : /Users/ilg/Work/qemu-riscv-7.0.0-1/darwin-x64/install/qemu-riscv
426+
BIOS directory : share/qemu
427+
firmware path : /Users/ilg/Work/qemu-riscv-7.0.0-1/darwin-x64/install/qemu-riscv/share/qemu-firmware
428+
binary directory : bin
429+
library directory : lib
430+
module directory : lib/qemu
431+
libexec directory : libexec
432+
include directory : include
433+
config directory : /Users/ilg/Work/qemu-riscv-7.0.0-1/darwin-x64/install/qemu-riscv/etc
434+
local state directory : /Users/ilg/Work/qemu-riscv-7.0.0-1/darwin-x64/install/qemu-riscv/var
435+
Manual directory : share/man
436+
Doc directory : /Users/ilg/Work/qemu-riscv-7.0.0-1/darwin-x64/install/qemu-riscv/share/doc
437+
Build directory : /Users/ilg/Work/qemu-riscv-7.0.0-1/darwin-x64/build/qemu-7.0.0
438+
Source path : /Users/ilg/Work/qemu-riscv-7.0.0-1/darwin-x64/sources/qemu-7.0.0.git
439+
GIT submodules : ui/keycodemapdb tests/fp/berkeley-testfloat-3 tests/fp/berkeley-softfloat-3 dtc capstone slirp
440+
441+
Host binaries
442+
git : git
443+
make : make
444+
python : /Users/ilg/.local/xbb/bin/python3 (version: 3.9)
445+
sphinx-build : /Users/ilg/.local/xbb/bin/sphinx-build
446+
iasl : NO
447+
genisoimage :
448+
smbd : /usr/sbin/smbd
449+
450+
Configurable features
451+
Documentation : NO
452+
system-mode emulation : YES
453+
user-mode emulation : NO
454+
block layer : YES
455+
Install blobs : YES
456+
module support : NO
457+
fuzzing support : NO
458+
Audio drivers : coreaudio
459+
Trace backends : log
460+
D-Bus display : NO
461+
QOM debugging : NO
462+
vhost-kernel support : NO
463+
vhost-net support : NO
464+
vhost-crypto support : NO
465+
vhost-scsi support : NO
466+
vhost-vsock support : NO
467+
vhost-user support : NO
468+
vhost-user-blk server support: NO
469+
vhost-user-fs support : NO
470+
vhost-vdpa support : NO
471+
build guest agent : NO
472+
473+
Compilation
474+
host CPU : x86_64
475+
host endianness : little
476+
C compiler : clang -m64 -mcx16
477+
Host C compiler : clang -m64 -mcx16
478+
C++ compiler : clang++ -m64 -mcx16
479+
Objective-C compiler : clang -m64 -mcx16
480+
CFLAGS : -ffunction-sections -fdata-sections -pipe -m64 -O2 -mmacosx-version-min=10.13 -w -I/Users/ilg/Work/qemu-riscv-7.0.0-1/darwin-x64/install/libs/include -O2 -g
481+
CXXFLAGS : -ffunction-sections -fdata-sections -pipe -m64 -O2 -mmacosx-version-min=10.13 -w -I/Users/ilg/Work/qemu-riscv-7.0.0-1/darwin-x64/install/libs/include -I/Users/ilg/Work/qemu-riscv-7.0.0-1/darwin-x64/install/libs/include -O2 -g
482+
OBJCFLAGS : -I/Users/ilg/Work/qemu-riscv-7.0.0-1/darwin-x64/install/libs/include -O2 -g
483+
LDFLAGS : -ffunction-sections -fdata-sections -pipe -m64 -O2 -mmacosx-version-min=10.13 -w -L/Users/ilg/Work/qemu-riscv-7.0.0-1/darwin-x64/install/libs/lib -O2 -v -Wl,-macosx_version_min,10.13 -Wl,-headerpad_max_install_names -Wl,-dead_strip -I/Users/ilg/Work/qemu-riscv-7.0.0-1/darwin-x64/install/libs/include -I/Users/ilg/Work/qemu-riscv-7.0.0-1/darwin-x64/install/libs/include
484+
QEMU_CFLAGS : -DOS_OBJECT_USE_OBJC=0 -D_GNU_SOURCE -D_FILE_OFFSET_BITS=64 -D_LARGEFILE_SOURCE -Wstrict-prototypes -Wredundant-decls -Wundef -Wwrite-strings -Wmissing-prototypes -fno-strict-aliasing -fno-common -fwrapv -Wold-style-declaration -Wold-style-definition -Wtype-limits -Wformat-security -Wformat-y2k -Winit-self -Wignored-qualifiers -Wempty-body -Wnested-externs -Wendif-labels -Wexpansion-to-defined -Wimplicit-fallthrough=2 -Wno-initializer-overrides -Wno-missing-include-dirs -Wno-shift-negative-value -Wno-string-plus-int -Wno-typedef-redefinition -Wno-tautological-type-limit-compare -Wno-psabi -fstack-protector-strong
485+
QEMU_CXXFLAGS : -D__STDC_LIMIT_MACROS -D__STDC_CONSTANT_MACROS -D__STDC_FORMAT_MACROS -DOS_OBJECT_USE_OBJC=0 -D_GNU_SOURCE -D_FILE_OFFSET_BITS=64 -D_LARGEFILE_SOURCE -Wundef -Wwrite-strings -fno-strict-aliasing -fno-common -fwrapv -Wtype-limits -Wformat-security -Wformat-y2k -Winit-self -Wignored-qualifiers -Wempty-body -Wendif-labels -Wexpansion-to-defined -Wimplicit-fallthrough=2 -Wno-initializer-overrides -Wno-missing-include-dirs -Wno-shift-negative-value -Wno-string-plus-int -Wno-typedef-redefinition -Wno-tautological-type-limit-compare -Wno-psabi -fstack-protector-strong
486+
QEMU_OBJCFLAGS : -Wold-style-definition -Wtype-limits -Wformat-security -Wformat-y2k -Winit-self -Wignored-qualifiers -Wempty-body -Wnested-externs -Wendif-labels -Wexpansion-to-defined -Wno-initializer-overrides -Wno-missing-include-dirs -Wno-shift-negative-value -Wno-string-plus-int -Wno-typedef-redefinition -Wno-tautological-type-limit-compare -Wno-psabi
487+
QEMU_LDFLAGS : -fstack-protector-strong
488+
profiler : NO
489+
link-time optimization (LTO) : NO
490+
PIE : YES
491+
static build : NO
492+
malloc trim support : NO
493+
membarrier : NO
494+
debug stack usage : NO
495+
mutex debugging : NO
496+
memory allocator : system
497+
avx2 optimization : NO
498+
avx512f optimization : NO
499+
gprof enabled : NO
500+
gcov : NO
501+
thread sanitizer : NO
502+
CFI support : NO
503+
strip binaries : NO
504+
sparse : NO
505+
mingw32 support : NO
506+
507+
Targets and accelerators
508+
KVM support : NO
509+
HAX support : NO
510+
HVF support : NO
511+
WHPX support : NO
512+
NVMM support : NO
513+
Xen support : NO
514+
TCG support : YES
515+
TCG backend : native (x86_64)
516+
TCG plugins : YES
517+
TCG debug enabled : NO
518+
target list : riscv32-softmmu riscv64-softmmu
519+
default devices : YES
520+
out of process emulation : NO
521+
522+
Block layer support
523+
coroutine backend : sigaltstack
524+
coroutine pool : YES
525+
Block whitelist (rw) :
526+
Block whitelist (ro) :
527+
Use block whitelist in tools : NO
528+
VirtFS support : YES
529+
build virtiofs daemon : NO
530+
Live block migration : YES
531+
replication support : YES
532+
bochs support : YES
533+
cloop support : YES
534+
dmg support : YES
535+
qcow v1 support : YES
536+
vdi support : YES
537+
vvfat support : YES
538+
qed support : YES
539+
parallels support : YES
540+
FUSE exports : NO
541+
542+
Crypto
543+
TLS priority : "NORMAL"
544+
GNUTLS support : NO
545+
libgcrypt : NO
546+
nettle : YES 3.7.3
547+
XTS : YES
548+
AF_ALG support : NO
549+
rng-none : NO
550+
Linux keyring : NO
551+
552+
Dependencies
553+
Cocoa support : YES
554+
SDL support : NO
555+
SDL image support : NO
556+
GTK support : NO
557+
pixman : YES 0.40.0
558+
VTE support : NO
559+
slirp support : internal
560+
libtasn1 : NO
561+
PAM : YES
562+
iconv support : YES
563+
curses support : YES
564+
virgl support : NO
565+
curl support : NO
566+
Multipath support : NO
567+
VNC support : YES
568+
VNC SASL support : YES
569+
VNC JPEG support : YES 9.5.0
570+
VNC PNG support : YES 1.6.37
571+
CoreAudio support : YES
572+
JACK support : NO
573+
brlapi support : NO
574+
vde support : YES
575+
netmap support : NO
576+
l2tpv3 support : NO
577+
Linux AIO support : NO
578+
Linux io_uring support : NO
579+
ATTR/XATTR support : NO
580+
RDMA support : NO
581+
PVRDMA support : NO
582+
fdt support : internal
583+
libcap-ng support : NO
584+
bpf support : NO
585+
spice protocol support : NO
586+
rbd support : NO
587+
smartcard support : NO
588+
U2F support : NO
589+
libusb : YES 1.0.26
590+
usb net redir : NO
591+
OpenGL support : NO
592+
GBM : NO
593+
libiscsi support : NO
594+
libnfs support : NO
595+
seccomp support : NO
596+
GlusterFS support : NO
597+
TPM support : YES
598+
libssh support : YES 0.9.6
599+
lzo support : YES
600+
snappy support : NO
601+
bzip2 support : YES
602+
lzfse support : NO
603+
zstd support : YES 1.5.2
604+
NUMA host support : NO
605+
capstone : internal
606+
libpmem support : NO
607+
libdaxctl support : NO
608+
libudev : NO
609+
FUSE lseek : NO
610+
selinux : NO
611+
612+
User defined options
613+
Native files : config-meson.cross
614+
bindir : /Users/ilg/Work/qemu-riscv-7.0.0-1/darwin-x64/install/qemu-riscv/bin
615+
datadir : /Users/ilg/Work/qemu-riscv-7.0.0-1/darwin-x64/install/qemu-riscv/share
616+
debug : true
617+
includedir : /Users/ilg/Work/qemu-riscv-7.0.0-1/darwin-x64/install/qemu-riscv/include
618+
libdir : /Users/ilg/Work/qemu-riscv-7.0.0-1/darwin-x64/install/qemu-riscv/lib
619+
libexecdir : /Users/ilg/Work/qemu-riscv-7.0.0-1/darwin-x64/install/qemu-riscv/libexec
620+
localedir : /Users/ilg/Work/qemu-riscv-7.0.0-1/darwin-x64/install/qemu-riscv/share/locale
621+
localstatedir : /Users/ilg/Work/qemu-riscv-7.0.0-1/darwin-x64/install/qemu-riscv/var
622+
mandir : /Users/ilg/Work/qemu-riscv-7.0.0-1/darwin-x64/install/qemu-riscv/share/man
623+
optimization : 2
624+
prefix : /Users/ilg/Work/qemu-riscv-7.0.0-1/darwin-x64/install/qemu-riscv
625+
sysconfdir : /Users/ilg/Work/qemu-riscv-7.0.0-1/darwin-x64/install/qemu-riscv/etc
626+
werror : false
627+
b_coverage : false
628+
b_lto : false
629+
b_pie : true
630+
audio_drv_list : default
631+
capstone : auto
632+
cfi : false
633+
cocoa : enabled
634+
curses : enabled
635+
default_devices : true
636+
docdir : /Users/ilg/Work/qemu-riscv-7.0.0-1/darwin-x64/install/qemu-riscv/share/doc
637+
fdt : auto
638+
gtk : disabled
639+
guest_agent : disabled
640+
hvf : disabled
641+
iasl :
642+
libssh : enabled
643+
lzo : enabled
644+
nettle : enabled
645+
qemu_firmwarepath : /Users/ilg/Work/qemu-riscv-7.0.0-1/darwin-x64/install/qemu-riscv/share/qemu-firmware
646+
qemu_suffix : qemu
647+
sdl : disabled
648+
slirp : auto
649+
smbd :
650+
sphinx_build :
651+
tcg : enabled
652+
tools : disabled
653+
trace_file : trace
654+
vde : enabled
655+
xen : disabled
423656
```
424657

425658
## Testing
@@ -433,7 +666,9 @@ program from there. For example on macOS the output should
433666
look like:
434667

435668
```console
436-
$ ...
669+
$ .../bin/qemu-system-riscv32 --version
670+
xPack QEMU emulator version 7.0.0 (v7.0.0)
671+
Copyright (c) 2003-2022 Fabrice Bellard and the QEMU Project developers
437672
```
438673

439674
## Installed folders
@@ -442,7 +677,50 @@ After install, the package should create a structure like this (macOS files;
442677
only the first two depth levels are shown):
443678

444679
```console
445-
$ tree -L 2 ...
680+
$ tree -L 2 /Users/ilg/Library/xPacks/@xpack-dev-tools/qemu-arm/7.0.0-1.1/.content
681+
/Users/ilg/Library/xPacks/@xpack-dev-tools/qemu-arm/7.0.0-1.1/.content
682+
├── README.md
683+
├── bin
684+
│   ├── qemu-system-riscv32
685+
│   └── qemu-system-riscv64
686+
├── distro-info
687+
│   ├── CHANGELOG.md
688+
│   ├── licenses
689+
│   ├── patches
690+
│   └── scripts
691+
├── include
692+
│   └── qemu-plugin.h
693+
├── libexec
694+
│   ├── libcrypto.1.1.dylib
695+
│   ├── libffi.8.dylib
696+
│   ├── libgio-2.0.0.dylib
697+
│   ├── libglib-2.0.0.dylib
698+
│   ├── libgmodule-2.0.0.dylib
699+
│   ├── libgobject-2.0.0.dylib
700+
│   ├── libiconv.2.dylib
701+
│   ├── libintl.8.dylib
702+
│   ├── libjpeg.9.dylib
703+
│   ├── liblzo2.2.dylib
704+
│   ├── libncursesw.6.dylib
705+
│   ├── libnettle.8.4.dylib
706+
│   ├── libnettle.8.dylib -> libnettle.8.4.dylib
707+
│   ├── libpixman-1.0.40.0.dylib
708+
│   ├── libpixman-1.0.dylib -> libpixman-1.0.40.0.dylib
709+
│   ├── libpng16.16.dylib
710+
│   ├── libssh.4.8.7.dylib
711+
│   ├── libssh.4.dylib -> libssh.4.8.7.dylib
712+
│   ├── libusb-1.0.0.dylib
713+
│   ├── libvdeplug.3.dylib
714+
│   ├── libz.1.2.12.dylib
715+
│   ├── libz.1.dylib -> libz.1.2.12.dylib
716+
│   ├── libzstd.1.5.2.dylib
717+
│   └── libzstd.1.dylib -> libzstd.1.5.2.dylib
718+
└── share
719+
├── applications
720+
├── icons
721+
└── qemu
722+
723+
11 directories, 29 files
446724
```
447725

448726
## Uninstall

README-RELEASE.md

Lines changed: 1 addition & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -64,11 +64,7 @@ recreate the archives with the correct file.
6464

6565
### Update qemu.git
6666

67-
In the qemu.git fork:
68-
69-
- TODO
70-
- update the `xpack-riscv-develop` branch
71-
- add a `v7.0.0-1-xpack-riscv` tag
67+
Currently not necessary.
7268

7369
### Update the version specific code
7470

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -128,7 +128,7 @@ be added only as pre-release strings, separated by a dash,
128128
like `7.0.0-1`. When published as a npm package, the version gets
129129
a fifth number, like `7.0.0-1.1`.
130130

131-
Since adherance of third party packages to semver is not guaranteed,
131+
Since adherence of third party packages to semver is not guaranteed,
132132
it is recommended to use semver expressions like `^7.0.0` and `~7.0.0`
133133
with caution, and prefer exact matches, like `7.0.0-1.1`.
134134

0 commit comments

Comments
 (0)