1qrap(1)                     General Commands Manual                    qrap(1)
2
3
4

NAME

6       qrap - temporary qemu wrapper connecting UNIX domain socket to file de‐
7       scriptor
8
9

SYNOPSIS

11       qrap [FDNUM QEMU_CMD] [QEMU_ARG]...
12

DESCRIPTION

14       qrap is a wrapper, designed specifically for  usage  with  qemu(1)  and
15       passt(1),  connecting  a  UNIX  domain socket to a file descriptor, and
16       running qemu(1) with given arguments.
17
18       A running instance of passt(1) is probed checking for UNIX domain sock‐
19       ets,   answering   a  dummy  ARP  request,  with  names  starting  from
20       /tmp/passt_1.socket up to /tmp/passt_64.socket.
21
22       If first and second arguments are not a socket number  and  a  command,
23       that  is,  respectively,  FDNUM and QEMU_CMD, qrap will try to locate a
24       qemu executable in PATH and patch the command line to specify a network
25       device and a netdev back-end for usage with passt(1).
26
27       If  qrap  patches the command line, it will remove any potentially con‐
28       flicting network device, that is, any -netdev or -net  option,  or  any
29       -device option with argument starting with virtio-net-pci,, virtio-net-
30       ccw,, e1000,, e1000e,, or rtl8139,.
31
32

EXAMPLES

34       Start qemu explicitly passing its command name and a socket number
35              $ ./qrap 5 kvm test.qcow2 -m 1024 -display none -nodefaults -nographic -net socket,fd=5 -net nic,model=virtio
36
37       Start qemu without command name and socket number, patching arguments
38              $ ./qrap test.qcow2 -m 1024 -display none -nodefaults -nographic
39
40

NOTES

42       This wrapper is temporary: qemu commit 13c6be96618c ("net: stream:  add
43       unix  socket")  introduces native AF_UNIX socket support, and it should
44       be included in qemu starting from the 7.2 release. It  will  be  around
45       for a little bit longer to give users enough time to switch.
46
47

AUTHOR

49       Stefano Brivio <sbrivio@redhat.com>
50
51

REPORTING BUGS

53       No  public bug tracker is available at this time. For the moment being,
54       report issues to Stefano Brivio <sbrivio@redhat.com>.
55
56

58       Copyright (c) 2020-2021 Red Hat GmbH.
59
60       qrap is free software: you can redistribute is and/or modify  it  under
61       the  terms of the GNU Affero General Public License as published by the
62       Free Software Foundation, either version 3 of the License, or (at  your
63       option) any later version.
64
65

SEE ALSO

67       qemu(1), passt(1).
68
69       High-level         documentation         is         available        at
70       https://passt.top/passt/about/.
71
72
73
74                                                                       qrap(1)
Impressum