v86-system

v86-system v0.4.0
Command-line v86 runner with QEMU-compatible flags

Usage:
  v86-system [options]

Memory options:
  -m SIZE               Set memory size (default: 512M)

Storage options:
  -hda FILE             Primary hard disk image
  -hdb FILE             Secondary hard disk image
  -fda FILE             Floppy disk A image
  -fdb FILE             Floppy disk B image
  -cdrom FILE           CD-ROM image

Boot options:
  -boot ORDER           Boot order (a,b,c,d,n) (default: c)
  -kernel FILE          Linux kernel image (bzImage)
  -initrd FILE          Initial ramdisk image
  -append STRING        Kernel command line

System options:
  -bios FILE            BIOS image file (default: seabios)
  -acpi                 Enable ACPI (default: off)
  -fastboot             Enable fast boot

Network options:
  -netdev CONFIG        Network device configuration

VirtFS options:
  -virtfs CONFIG        VirtFS configuration

Standard options:
  -h, --help            Show help
  -v, --version         Show version

Examples:
  v86-system -hda disk.img
  v86-system -m 1G -hda disk.img -cdrom boot.iso
  v86-system -kernel vmlinuz -initrd initrd.img -append "console=ttyS0"
  v86-system -hda disk.img -netdev user,type=virtio,relay_url=ws://localhost:8777

Install

npm i -g v86-system

QEMU Flag Mappings

| QEMU Flag | V86 Option | Description | |-----------|------------|-------------| | -m SIZE | memory_size | Memory size (supports K, M, G, T suffixes) | | -hda FILE | hda | Primary hard disk | | -hdb FILE | hdb | Secondary hard disk | | -cdrom FILE | cdrom | CD-ROM image | | -fda FILE | fda | Floppy disk A | | -fdb FILE | fdb | Floppy disk B | | -kernel FILE | bzimage | Linux kernel image | | -initrd FILE | initrd | Initial ramdisk | | -append STRING | cmdline | Kernel command line | | -bios FILE | bios | BIOS image | | -acpi | acpi | Enable ACPI | | -netdev user,CONFIG | net_device | Enable user-mode networking | | -virtfs proxy,URL | filesystem.proxy_url | VirtFS 9P WebSocket proxy |

Examples

Basic VM with memory and disk

v86-system -m 1G -hda disk.img

Boot from CD-ROM

v86-system -m 512M -hda disk.img -cdrom install.iso -boot d

Linux kernel boot

v86-system -kernel vmlinuz -initrd initrd.img -append "console=ttyS0 root=/dev/sda1"

Network options

v86-system -hda disk.img -netdev user,type=virtio,relay_url=ws://localhost:8777

Boot from 9P (over WebSocket)

v86-system -kernel vmlinuz -virtfs proxy,ws://localhost:7654 -append "console=ttyS0 rw root=host9p rootfstype=9p rootflags=trans=virtio,version=9p2000.L,aname=rootfs"

This assumes a 9P2000 WebSocket server is running with a root filesystem under rootfs.

License

MIT