Merge tag 'xen-virtio-fix-1-tag' of https://gitlab.com/sstabellini/qemu into staging

[mirror_qemu.git] / target / loongarch / README

diff --git a/target/loongarch/README b/target/loongarch/README
index 4dcd0f1682cd7b6ba2977eb53a8d4ecc2cdd8deb..0b9dc0d40a04d1da3e925c79ca94b7ac0728c51e 100644 (file)
--- a/target/loongarch/README
+++ b/target/loongarch/README
@@ -11,54 +11,42 @@
 
 - System emulation
 
-  Mainly emulate a virt 3A5000 board and ls7a bridge that is not exactly the same as the host.
-  3A5000 support multiple interrupt cascading while here we just emulate the extioi interrupt
-  cascading. LS7A1000 host bridge support multiple devices, such as sata, gmac, uart, rtc
-  and so on. But we just realize the rtc. Others use the qemu common devices. It does not affect
-  the general use. We also introduced the emulation of devices at docs/system/loongarch/loongson3.rst.
+  You can reference docs/system/loongarch/loongson3.rst to get the information about system emulation of LoongArch.
 
-  This version only supports running binary files in ELF format, and does not depend on BIOS and kernel file.
-  You can compile the test program with 'make & make check-tcg' and run the test case with the following command:
+- Linux-user emulation
 
-  1. Install LoongArch cross-tools on X86 machines.
+  We already support Linux user emulation. We can use LoongArch cross-tools to build LoongArch executables on X86 machines,
+  and We can also use qemu-loongarch64 to run LoongArch executables.
 
-    Download cross-tools.
+  1. Config cross-tools env.
 
-      wget https://github.com/loongson/build-tools/releases/latest/download/loongarch64-clfs-20211202-cross-tools.tar.xz
+     see System emulation.
 
-      tar -vxf loongarch64-clfs-20211202-cross-tools.tar.xz -C /opt
+  2. Test tests/tcg/multiarch.
 
-    Config cross-tools env.
+     ./configure  --static  --prefix=/usr  --disable-werror --target-list="loongarch64-linux-user" --enable-debug
 
-      . setenv.sh
+     cd build
 
-      setenv.sh:
+     make && make check-tcg
 
-          #!/bin/sh
-          set -x
-          CC_PREFIX=/opt/cross-tools
+  3. Run LoongArch system basic command with loongarch-clfs-system.
 
-          export PATH=$CC_PREFIX/bin:$PATH
-          export LD_LIBRARY_PATH=$CC_PREFIX/lib:$LD_LIBRARY_PATH
-          export LD_LIBRARY_PATH=$CC_PREFIX/loongarch64-unknown-linux-gnu/lib/:$LD_LIBRARY_PATH
-          set +x
+     - Config clfs env.
 
-  2. Test tests/tcg/multiarch.
+       wget https://github.com/loongson/build-tools/releases/download/2022.05.29/loongarch64-clfs-system-5.0.tar.bz2
 
-    ./configure --disable-rdma --disable-pvrdma --prefix=/usr  \
-            --target-list="loongarch64-softmmu"  \
-            --disable-libiscsi --disable-libnfs --disable-libpmem \
-            --disable-glusterfs --enable-libusb --enable-usb-redir \
-            --disable-opengl --disable-xen --enable-spice --disable-werror \
-            --enable-debug --disable-capstone --disable-kvm --enable-profiler
+       tar -vxf loongarch64-clfs-system-5.0.tar.bz2 -C /opt/clfs
 
-    cd  build/
+       cp /opt/clfs/lib64/ld-linux-loongarch-lp64d.so.1  /lib64
 
-    make && make check-tcg
+       export LD_LIBRARY_PATH="/opt/clfs/lib64"
 
-    or
+     - Run LoongArch system basic command.
 
-    ./build/qemu-system-loongarch64 -machine virt -m 4G -cpu Loongson-3A5000 -smp 1 -kernel build/tests/tcg/loongarch64-softmmu/hello -monitor none -display none -chardev file,path=hello.out,id=output -serial chardev:output
+       ./qemu-loongarch64  /opt/clfs/usr/bin/bash
+       ./qemu-loongarch64  /opt/clfs/usr/bin/ls
+       ./qemu-loongarch64  /opt/clfs/usr/bin/pwd
 
 - Note.
   We can get the latest LoongArch documents or LoongArch tools at https://github.com/loongson/