diff options
author | Stefano Brivio <sbrivio@redhat.com> | 2021-08-19 20:22:40 +0200 |
---|---|---|
committer | Stefano Brivio <sbrivio@redhat.com> | 2021-09-01 17:00:27 +0200 |
commit | da20f57f19dc75f86b6313b3397218056782792e (patch) | |
tree | b5595ea797491b3a5e4dba7290bcfc2008a24b4c /qrap.1 | |
parent | 05432945bb53009d63d99c0c079e753eecb34bbc (diff) | |
download | passt-da20f57f19dc75f86b6313b3397218056782792e.tar passt-da20f57f19dc75f86b6313b3397218056782792e.tar.gz passt-da20f57f19dc75f86b6313b3397218056782792e.tar.bz2 passt-da20f57f19dc75f86b6313b3397218056782792e.tar.lz passt-da20f57f19dc75f86b6313b3397218056782792e.tar.xz passt-da20f57f19dc75f86b6313b3397218056782792e.tar.zst passt-da20f57f19dc75f86b6313b3397218056782792e.zip |
passt, qrap: Add man pages
Signed-off-by: Stefano Brivio <sbrivio@redhat.com>
Diffstat (limited to 'qrap.1')
-rw-r--r-- | qrap.1 | 77 |
1 files changed, 77 insertions, 0 deletions
@@ -0,0 +1,77 @@ +.TH qrap 1 + +.SH NAME +.B qrap +\- qemu wrapper connecting UNIX domain socket to file descriptor + +.SH SYNOPSIS +.B qrap +[\fIFDNUM\fR \fIQEMU_CMD\fR] [\fIQEMU_ARG\fR]... +.SH DESCRIPTION +\fBqrap\fR is a wrapper, designed specifically for usage with \fBqemu\fR(1) and +\fBpasst\fR(1), connecting a UNIX domain socket to a file descriptor, and +running \fBqemu\fR(1) with given arguments. + +A running instance of \fBpasst\fR(1) is probed checking for UNIX domain sockets, +answering a dummy ARP request, with names starting from +\fI/tmp/passt_1.socket\fR up to \fI/tmp/passt_64.socket\fR. + +If first and second arguments are not a socket number and a path, that is, +respectively, \fIFDNUM\fR and \fIQEMU_CMD\fR, \fBqrap\fR will try to locate a +qemu binary and patch the command line to specify a network device and a +\fInetdev\fR back-end for usage with \fBpasst\fR(1). + +If \fBqrap\fR patches the command line, it will remove any potentially +conflicting network device, that is, any \fI-netdev\fR or \fI-net\fR option, or +any \fI-device\fR option with argument starting with \fIvirtio-net-pci,\fR, +\fIvirtio-net-ccw,\fR, \fIe1000,\fR, \fIe1000e,\fR, or \fIrtl8139,\fR. + +.SH EXAMPLES + +.BR "Start qemu explicitly passing its command name and a socket number" +.RS +.nf +$ ./qrap 5 kvm test.qcow2 -m 1024 -display none -nodefaults -nographic -net socket,fd=5 -net nic,model=virtio +.fi +.RE + +.BR "Start qemu without command name and socket number, patching arguments" +.RS +.nf +$ ./qrap test.qcow2 -m 1024 -display none -nodefaults -nographic +.fi +.RE + +.SH NOTES + +This wrapper is temporary and needed only as long as \fBqemu\fR(1) does not +directly support a UNIX domain socket as \fInetdev\fR back-end. + +Out-of-tree patches for \fBqemu\fR(1) introducing support for a UNIX domain +socket back-end are available at: + + \fIhttps://passt.top/passt/tree/qemu\fR + +.SH AUTHOR + +Stefano Brivio <sbrivio@redhat.com> + +.SH REPORTING BUGS + +No public bug tracker is available at this time. For the moment being, report +issues to Stefano Brivio <sbrivio@redhat.com>. + +.SH COPYRIGHT + +Copyright (c) 2020-2021 Red Hat GmbH. + +\fBqrap\fR is free software: you can redistribute is and/or modify it under the +terms of the GNU Affero General Public License as published by the Free Software +Foundation, either version 3 of the License, or (at your option) any later +version. + +.SH SEE ALSO + +\fBqemu\fR(1), \fBpasst\fR(1). + +High-level documentation is available at https://passt.top/passt/about/. |