tests/qemu-iotests/common.qemu

6 # Each instance can choose, at launch, to use either the QMP or the
9 # All instances are cleaned up via _cleanup_qemu, including killing the
15 # it under the terms of the GNU General Public License as published by
16 # the Free Software Foundation; either version 2 of the License, or
19 # This program is distributed in the hope that it will be useful,
20 # but WITHOUT ANY WARRANTY; without even the implied warranty of
21 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
24 # You should have received a copy of the GNU General Public License
44 # Override QEMU_COMM_TIMEOUT for a timeout different than the
47 # $1: The handle to use
48 # $2+ All remaining arguments comprise the string to search for
49 #    in the response.
57 # will not be echoed out, but instead collected in the $QEMU_EVENTS
58 # variable. The _wait_event function can later be used to receive
59 # the cached events.
65 # If $success_or_failure is set, the meaning of the arguments is
67 # $2: A string to search for in the response; if found, this indicates
69 # $3: A string to search for in the response; if found, this indicates
70 #     failure and the test is either aborted (if $qemu_error_no_exit
148         exit 1  # Timeout or wrong match mean the test failed
153 # Sends QMP or HMP command to QEMU, and waits for the expected response
156 # $2:       String of the QMP command to send
158 #             String that the QEMU response should contain. If it is a null
161 # Set qemu_cmd_repeat to the number of times to repeat the cmd
163 # then the command is only sent once.
166 # echo the command before sending it the first time.
168 # If $qemu_error_no_exit is set, then even if the expected response
172 # If $success_or_failure is set, then the last two strings are the
173 # strings the response will be scanned for.  The first of the two
174 # indicates success, the latter indicates failure.  Failure is handled
215         exit 1 #Timeout means the test failed
223 # $1:       Name of the QMP event to check for
225 # Checks if the named QMP event that was previously captured
226 # into $QEMU_EVENTS. When matched, the QMP event will be echoed
227 # and the $matched variable set to 1.
261 # $2:       Name of the QMP event to wait for
263 # Checks if the named QMP even was previously captured
264 # into $QEMU_EVENTS. If none are present, then waits for the
265 # event to arrive on the QMP channel. When matched, the QMP
285             exit 1 #Timeout means the test failed
294 #                    to use the QEMU HMP monitor for communication.
295 #                    Otherwise, the default of QMP is used.
373 # Silently kills the QEMU process
375 # If $wait is set to anything other than the empty string, the process will not
377 # $wait is empty, the process will be killed and all output will be suppressed.