armvirt: new target
[openwrt/staging/yousong.git] / target / linux / armvirt / README
diff --git a/target/linux/armvirt/README b/target/linux/armvirt/README
new file mode 100644 (file)
index 0000000..e990381
--- /dev/null
@@ -0,0 +1,34 @@
+This is intended to be used with LEDE project to provide image for use with
+QEMU arm-softmmu virt machine.
+
+Run with qemu-system-arm
+
+       # boot with initramfs embedded in
+       qemu-system-arm -nographic -M virt -m 64 -kernel lede-armvirt-zImage-initramfs
+
+       # boot with accel=kvm
+       qemu-system-arm -nographic -M virt,accel=kvm -cpu host -m 64 -kernel lede-armvirt-zImage-initramfs
+
+       # boot with a separate rootfs
+       qemu-system-arm -nographic -M virt -m 64 -kernel lede-armvirt-zImage \
+         -drive file=lede-armvirt-root.ext4,format=raw,if=virtio -append 'root=/dev/vda rootwait'
+
+       # boot with local dir as rootfs
+       qemu-system-arm -nographic -M virt -m 64 -kernel lede-armvirt-zImage \
+         -fsdev local,id=rootdev,path=root-armvirt/,security_model=none \
+         -device virtio-9p-pci,fsdev=rootdev,mount_tag=/dev/root \
+         -append 'rootflags=trans=virtio,version=9p2000.L,cache=loose rootfstype=9p'
+
+Run with kvmtool
+
+       # start a named machine
+       lkvm run -k lede-armvirt-zImage -i lede-armvirt-rootfs.cpio --name armvirt0
+
+       # start with virtio-9p rootfs
+       lkvm run -k lede-armvirt-zImage -d root-armvirt/
+
+       # stop "armvirt0"
+       lkvm stop --name armvirt0
+
+       # stop all
+       lkvm stop --all