1qrap(1) General Commands Manual qrap(1)
2
3
4
6 qrap - temporary qemu wrapper connecting UNIX domain socket to file de‐
7 scriptor
8
9
11 qrap [FDNUM QEMU_CMD] [QEMU_ARG]...
12
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
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
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
49 Stefano Brivio <sbrivio@redhat.com>
50
51
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
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)