diff --git "a/docs/zh/docs/StratoVirt/\350\231\232\346\213\237\346\234\272\351\205\215\347\275\256.md" "b/docs/zh/docs/StratoVirt/\350\231\232\346\213\237\346\234\272\351\205\215\347\275\256.md" index 144df34dcc6d807c0c7e7db5a735ec2ba73b7192..5a9ad6e91cf31598ef85d683c818e91a1488bf07 100644 --- "a/docs/zh/docs/StratoVirt/\350\231\232\346\213\237\346\234\272\351\205\215\347\275\256.md" +++ "b/docs/zh/docs/StratoVirt/\350\231\232\346\213\237\346\234\272\351\205\215\347\275\256.md" @@ -81,10 +81,10 @@ cmdline命令行配置参数请参见下表: | -m | 内存大小(字节单位)、内存大小M(M单位)、内存大小G(G单位) | 配置内存大小,范围[256M, 512G] | | -drive | id=rootfs,file=/path/to/rootfs[,readonly=false,direct=true,serial=serial_num,iothread=iothread1,iops=200] | 配置virtio-blk设备,[详细说明](#磁盘配置) | | -netdev | id=iface_id,netdev=tap0[,mac=mac_address,iothread=iothread2] | 配置virtio-net设备,[详细说明](#net配置) | -| -chardev | id=console_id,path=/path/to/socket | 配置virtio-console,[详细说明](#console) | -| -device | vsock,id=vsock_id,guest-cid=3 | 配置vhost-vsock,[详细说明](#vsock) | +| -chardev | -chardev backend,id=chardev_id[,path=path,server,nowait] | 配置chardev设备,[详细说明](#chardev设备配置) | +| -device | virtconsole,chardev=chardev_id,id=console_id | 配置vhost-console,[详细说明](#console设备配置) | | -api-channel | unix:/path/to/socket | 配置api-channel,运行前须保证socket文件不存在 | -| -serial | stdio | 配置串口设备 | +| -serial | -chardev:chardev_id 或 backend[,path=path,server,nowait] | 配置串口设备, [详细说明](#串口设备配置) | | -D | /path/to/logfile | 配置日志文件 | | -pidfile | /path/to/pidfile | 配置pid文件,必须和-daemonize一起使用。运行前须保证pid文件不存在 | | -disable-seccomp | NA | 关闭Seccomp,默认打开 | @@ -350,12 +350,12 @@ iothread配置细节见[iothread配置](#iothread配置) ### Console设备配置 -virtio-console是通用的串口设备,用于guest和host之间传送数据。console设备的配置有如下配置项: +virtio-console是通用的串口设备,用于guest和host之间传送数据。当只配console并通过console进行IO操作时,kernel命令行中配置console=hvc0(或hvc1..)。console设备的配置有如下配置项: - console_id: 唯一的设备id -- socket_path:virtio console文件路径 +- chardev: 重定向的chardev设备 -在启动stratovirt之前请确保console文件不存在。 +chardev配置详见[chardev设备配置](#chardev设备配置) @@ -368,6 +368,26 @@ vsock也是host和guest间通信的设备,类似于console,但具有更好 +### 串口设备配置 +串口是VM的遗留设备,用于guest和host之间传送数据。使用串口时,kernel命令行中配置console=ttyS0。但在AArch64平台上标准启动时,配置console=ttyAMA0。配置项: + +- chardev: 重定向的chardev设备 + +chardev配置详见[chardev设备配置](#chardev设备配置) + + + +### chardev设备配置 +来自来guest的IO被重定向到宿主机的chardev。chardev后端的类型可以是:stdio、pty、socket和file(仅输出)。配置项: + +- id: 唯一的设备id。 +- backend: 重定向的类型。 +- path: 设备文件路径。仅socket和file类型的设备需要此参数。 +- server: 作为服务器运行。仅socket类型的设备需要此参数。 +- nowait: 不要等待连接。仅socket类型的设备需要此参数。 + +在启动stratovirt之前请确保设备文件不存在。 + ### 大页配置