Revision f67e3ffd qemu-options.hx

b/qemu-options.hx
551 551
DEFHEADING(File system options:)
552 552

  
553 553
DEF("fsdev", HAS_ARG, QEMU_OPTION_fsdev,
554
    "-fsdev fsdriver,id=id,path=path,[security_model={mapped|passthrough|none}]\n"
555
    "       [,writeout=immediate][,readonly]\n",
554
    "-fsdev fsdriver,id=id[,path=path,][security_model={mapped|passthrough|none}]\n"
555
    " [,writeout=immediate][,readonly][,sock_fd=sock_fd]\n",
556 556
    QEMU_ARCH_ALL)
557 557

  
558 558
STEXI
559 559

  
560
@item -fsdev @var{fsdriver},id=@var{id},path=@var{path},[security_model=@var{security_model}][,writeout=@var{writeout}][,readonly]
560
@item -fsdev @var{fsdriver},id=@var{id},path=@var{path},[security_model=@var{security_model}][,writeout=@var{writeout}][,readonly][,sock_fd=@var{sock_fd}]
561 561
@findex -fsdev
562 562
Define a new file system device. Valid options are:
563 563
@table @option
564 564
@item @var{fsdriver}
565 565
This option specifies the fs driver backend to use.
566
Currently "local" and "handle" file system drivers are supported.
566
Currently "local", "handle" and "proxy" file system drivers are supported.
567 567
@item id=@var{id}
568 568
Specifies identifier for this device
569 569
@item path=@var{path}
......
580 580
interact with other unix tools. "none" security model is same as
581 581
passthrough except the sever won't report failures if it fails to
582 582
set file attributes like ownership. Security model is mandatory
583
only for local fsdriver. Other fsdrivers (like handle) don't take
583
only for local fsdriver. Other fsdrivers (like handle, proxy) don't take
584 584
security model as a parameter.
585 585
@item writeout=@var{writeout}
586 586
This is an optional argument. The only supported value is "immediate".
......
590 590
@item readonly
591 591
Enables exporting 9p share as a readonly mount for guests. By default
592 592
read-write access is given.
593
@item sock_fd=@var{sock_fd}
594
Enables proxy filesystem driver to use passed socket descriptor for
595
communicating with virtfs-proxy-helper. Usually a helper like libvirt
596
will create socketpair and pass one of the fds as sock_fd
593 597
@end table
594 598

  
595 599
-fsdev option is used along with -device driver "virtio-9p-pci".
......
610 614

  
611 615
DEF("virtfs", HAS_ARG, QEMU_OPTION_virtfs,
612 616
    "-virtfs local,path=path,mount_tag=tag,security_model=[mapped|passthrough|none]\n"
613
    "        [,writeout=immediate][,readonly]\n",
617
    "        [,writeout=immediate][,readonly][,sock_fd=sock_fd]\n",
614 618
    QEMU_ARCH_ALL)
615 619

  
616 620
STEXI
617 621

  
618
@item -virtfs @var{fsdriver},path=@var{path},mount_tag=@var{mount_tag},security_model=@var{security_model}[,writeout=@var{writeout}][,readonly]
622
@item -virtfs @var{fsdriver}[,path=@var{path}],mount_tag=@var{mount_tag}[,security_model=@var{security_model}][,writeout=@var{writeout}][,readonly][,sock_fd=@var{sock_fd}]
619 623
@findex -virtfs
620 624

  
621 625
The general form of a Virtual File system pass-through options are:
622 626
@table @option
623 627
@item @var{fsdriver}
624 628
This option specifies the fs driver backend to use.
625
Currently "local" and "handle" file system drivers are supported.
629
Currently "local", "handle" and "proxy" file system drivers are supported.
626 630
@item id=@var{id}
627 631
Specifies identifier for this device
628 632
@item path=@var{path}
......
639 643
interact with other unix tools. "none" security model is same as
640 644
passthrough except the sever won't report failures if it fails to
641 645
set file attributes like ownership. Security model is mandatory only
642
for local fsdriver. Other fsdrivers (like handle) don't take security
646
for local fsdriver. Other fsdrivers (like handle, proxy) don't take security
643 647
model as a parameter.
644 648
@item writeout=@var{writeout}
645 649
This is an optional argument. The only supported value is "immediate".
......
649 653
@item readonly
650 654
Enables exporting 9p share as a readonly mount for guests. By default
651 655
read-write access is given.
656
@item sock_fd
657
Enables proxy filesystem driver to use passed 'sock_fd' as the socket
658
descriptor for interfacing with virtfs-proxy-helper
652 659
@end table
653 660
ETEXI
654 661

  

Also available in: Unified diff