{"id":2229965,"url":"http://patchwork.ozlabs.org/api/1.1/patches/2229965/?format=json","web_url":"http://patchwork.ozlabs.org/project/qemu-devel/patch/20260429003130.15164-4-farosas@suse.de/","project":{"id":14,"url":"http://patchwork.ozlabs.org/api/1.1/projects/14/?format=json","name":"QEMU Development","link_name":"qemu-devel","list_id":"qemu-devel.nongnu.org","list_email":"qemu-devel@nongnu.org","web_url":"","scm_url":"","webscm_url":""},"msgid":"<20260429003130.15164-4-farosas@suse.de>","date":"2026-04-29T00:31:30","name":"[v1,3/3] docs/devel/qtest: Mention environment variables usage","commit_ref":null,"pull_url":null,"state":"new","archived":false,"hash":"724447563f562be2c19da3ce4bb91f12a139ab18","submitter":{"id":85343,"url":"http://patchwork.ozlabs.org/api/1.1/people/85343/?format=json","name":"Fabiano Rosas","email":"farosas@suse.de"},"delegate":null,"mbox":"http://patchwork.ozlabs.org/project/qemu-devel/patch/20260429003130.15164-4-farosas@suse.de/mbox/","series":[{"id":501965,"url":"http://patchwork.ozlabs.org/api/1.1/series/501965/?format=json","web_url":"http://patchwork.ozlabs.org/project/qemu-devel/list/?series=501965","date":"2026-04-29T00:31:27","name":"tests/qtest: Tweak env variables","version":1,"mbox":"http://patchwork.ozlabs.org/series/501965/mbox/"}],"comments":"http://patchwork.ozlabs.org/api/patches/2229965/comments/","check":"pending","checks":"http://patchwork.ozlabs.org/api/patches/2229965/checks/","tags":{},"headers":{"Return-Path":"","X-Original-To":"incoming@patchwork.ozlabs.org","Delivered-To":"patchwork-incoming@legolas.ozlabs.org","Authentication-Results":["legolas.ozlabs.org;\n\tdkim=pass (1024-bit key;\n unprotected) header.d=suse.de header.i=@suse.de header.a=rsa-sha256\n header.s=susede2_rsa header.b=fGxTxLB+;\n\tdkim=pass header.d=suse.de header.i=@suse.de header.a=ed25519-sha256\n header.s=susede2_ed25519 header.b=l1HxIocI;\n\tdkim=pass (1024-bit key) header.d=suse.de header.i=@suse.de\n header.a=rsa-sha256 header.s=susede2_rsa header.b=es0ZIBSi;\n\tdkim=neutral header.d=suse.de header.i=@suse.de header.a=ed25519-sha256\n header.s=susede2_ed25519 header.b=LbuULDtd;\n\tdkim-atps=neutral","legolas.ozlabs.org;\n spf=pass (sender SPF authorized) smtp.mailfrom=nongnu.org\n (client-ip=209.51.188.17; helo=lists1p.gnu.org;\n envelope-from=qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org;\n receiver=patchwork.ozlabs.org)","smtp-out2.suse.de;\n\tnone"],"Received":["from lists1p.gnu.org (lists1p.gnu.org [209.51.188.17])\n\t(using TLSv1.2 with cipher ECDHE-ECDSA-AES256-GCM-SHA384 (256/256 bits))\n\t(No client certificate requested)\n\tby legolas.ozlabs.org (Postfix) with ESMTPS id 4g4ytk66kZz1yK5\n\tfor ; Wed, 29 Apr 2026 10:32:29 +1000 (AEST)","from localhost ([::1] helo=lists1p.gnu.org)\n\tby lists1p.gnu.org with esmtp (Exim 4.90_1)\n\t(envelope-from )\n\tid 1wHsqW-0001gu-58; Tue, 28 Apr 2026 20:32:09 -0400","from eggs.gnu.org ([2001:470:142:3::10])\n by lists1p.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)\n (Exim 4.90_1) (envelope-from ) id 1wHsqG-0001gG-AV\n for qemu-devel@nongnu.org; Tue, 28 Apr 2026 20:31:54 -0400","from smtp-out2.suse.de ([195.135.223.131])\n by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128)\n (Exim 4.90_1) (envelope-from ) id 1wHsqE-0004TG-GL\n for qemu-devel@nongnu.org; Tue, 28 Apr 2026 20:31:51 -0400","from imap1.dmz-prg2.suse.org (unknown [10.150.64.97])\n (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)\n key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest\n SHA256)\n (No client certificate requested)\n by smtp-out2.suse.de (Postfix) with ESMTPS id DAB785BD3F;\n Wed, 29 Apr 2026 00:31:46 +0000 (UTC)","from imap1.dmz-prg2.suse.org (localhost [127.0.0.1])\n (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)\n key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest\n SHA256)\n (No client certificate requested)\n by imap1.dmz-prg2.suse.org (Postfix) with ESMTPS id 7F1F2593B0;\n Wed, 29 Apr 2026 00:31:45 +0000 (UTC)","from dovecot-director2.suse.de ([2a07:de40:b281:106:10:150:64:167])\n by imap1.dmz-prg2.suse.org with ESMTPSA id wBCAE3FR8WnseQAAD6G6ig\n (envelope-from ); Wed, 29 Apr 2026 00:31:45 +0000"],"DKIM-Signature":["v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.de;\n s=susede2_rsa;\n t=1777422707;\n h=from:from:reply-to:date:date:message-id:message-id:to:to:cc:cc:\n mime-version:mime-version:\n content-transfer-encoding:content-transfer-encoding:\n in-reply-to:in-reply-to:references:references;\n bh=7yrUkbZNWew6IlzmI2K/hGv+XpOXNKvdqUV5wLhXxTc=;\n b=fGxTxLB+qTT4zTCiYGIdFCAnJp5A1r2U5NzFhEq2eCgyjeiUAM8aGSxnceNX4olHrTqtWh\n 064v+1/p8OxWahnQ0ianCmp/7Xk18bVKDLEhOf2JRtE/x8RYt4JabXEpJKcDAGOz3MtQSM\n fYtpiGlVD/mwJK0JMHoK5xuVj1HR1lk=","v=1; a=ed25519-sha256; c=relaxed/relaxed; d=suse.de;\n s=susede2_ed25519; t=1777422707;\n h=from:from:reply-to:date:date:message-id:message-id:to:to:cc:cc:\n mime-version:mime-version:\n content-transfer-encoding:content-transfer-encoding:\n in-reply-to:in-reply-to:references:references;\n bh=7yrUkbZNWew6IlzmI2K/hGv+XpOXNKvdqUV5wLhXxTc=;\n b=l1HxIocIQ6tsK866Y8T98imotCeRVfZ2yzywhik6aimdcE40W6UPDscEpPL+7vxyagDYfW\n ociaM475IWX7UODA==","v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.de;\n s=susede2_rsa;\n t=1777422706;\n h=from:from:reply-to:date:date:message-id:message-id:to:to:cc:cc:\n mime-version:mime-version:\n content-transfer-encoding:content-transfer-encoding:\n in-reply-to:in-reply-to:references:references;\n bh=7yrUkbZNWew6IlzmI2K/hGv+XpOXNKvdqUV5wLhXxTc=;\n b=es0ZIBSiysrMijkYeSd4zRSRfcPGp/xe2Qac53ZEF16PUO7zXUSGrfu+j/2beGDfJSU7SQ\n eeB9gscXAutL+P4owquk5u+VupWVqmBzTM5u4TVahVDxTbch9/GGCaAyDeXEgtQEV/1Q05\n GHWvdLx1ikHhpEDFDTiekdG91eV047c=","v=1; a=ed25519-sha256; c=relaxed/relaxed; d=suse.de;\n s=susede2_ed25519; t=1777422706;\n h=from:from:reply-to:date:date:message-id:message-id:to:to:cc:cc:\n mime-version:mime-version:\n content-transfer-encoding:content-transfer-encoding:\n in-reply-to:in-reply-to:references:references;\n bh=7yrUkbZNWew6IlzmI2K/hGv+XpOXNKvdqUV5wLhXxTc=;\n b=LbuULDtd5PpmtCzP5gXUPTw93VB4aSdkJvpAFqfF391UmDVfX3R3YFrSsEr/xwkwcFnKO+\n nJ1mUgLnoZHraVBA=="],"From":"Fabiano Rosas ","To":"qemu-devel@nongnu.org","Cc":"Peter Maydell ,\n Laurent Vivier , Paolo Bonzini ,\n Pierrick Bouvier ","Subject":"[PATCH v1 3/3] docs/devel/qtest: Mention environment variables usage","Date":"Tue, 28 Apr 2026 21:31:30 -0300","Message-ID":"<20260429003130.15164-4-farosas@suse.de>","X-Mailer":"git-send-email 2.51.0","In-Reply-To":"<20260429003130.15164-1-farosas@suse.de>","References":"<20260429003130.15164-1-farosas@suse.de>","MIME-Version":"1.0","Content-Transfer-Encoding":"8bit","X-Spam-Score":"-2.80","X-Spamd-Result":"default: False [-2.80 / 50.00]; BAYES_HAM(-3.00)[99.99%];\n NEURAL_HAM_LONG(-1.00)[-1.000]; MID_CONTAINS_FROM(1.00)[];\n R_MISSING_CHARSET(0.50)[]; NEURAL_HAM_SHORT(-0.20)[-1.000];\n MIME_GOOD(-0.10)[text/plain]; TO_MATCH_ENVRCPT_ALL(0.00)[];\n FROM_HAS_DN(0.00)[]; ARC_NA(0.00)[]; MIME_TRACE(0.00)[0:+];\n TO_DN_SOME(0.00)[];\n DBL_BLOCKED_OPENRESOLVER(0.00)[suse.de:mid,suse.de:email,imap1.dmz-prg2.suse.org:helo];\n RCVD_VIA_SMTP_AUTH(0.00)[]; FROM_EQ_ENVFROM(0.00)[];\n RCVD_COUNT_TWO(0.00)[2]; FUZZY_RATELIMITED(0.00)[rspamd.com];\n DKIM_SIGNED(0.00)[suse.de:s=susede2_rsa,suse.de:s=susede2_ed25519];\n RCPT_COUNT_FIVE(0.00)[5]; RCVD_TLS_ALL(0.00)[]","Received-SPF":"pass client-ip=195.135.223.131; envelope-from=farosas@suse.de;\n helo=smtp-out2.suse.de","X-Spam_score_int":"-43","X-Spam_score":"-4.4","X-Spam_bar":"----","X-Spam_report":"(-4.4 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1,\n DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1,\n RCVD_IN_DNSWL_MED=-2.3, SPF_HELO_NONE=0.001,\n SPF_PASS=-0.001 autolearn=ham autolearn_force=no","X-Spam_action":"no action","X-BeenThere":"qemu-devel@nongnu.org","X-Mailman-Version":"2.1.29","Precedence":"list","List-Id":"qemu development ","List-Unsubscribe":",\n ","List-Archive":"","List-Post":"","List-Help":"","List-Subscribe":",\n ","Errors-To":"qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org","Sender":"qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org"},"content":"Document the QTEST_ environment variables. Only include the ones used\nby QTest itself, don't document test-specific variables as they are\nmore prone to change.\n\nSuggested-by: Peter Maydell \nSigned-off-by: Fabiano Rosas \n---\n docs/devel/testing/qtest.rst | 33 +++++++++++++++++++++++++++++++++\n 1 file changed, 33 insertions(+)","diff":"diff --git a/docs/devel/testing/qtest.rst b/docs/devel/testing/qtest.rst\nindex 73ef7702b7..0aac0f0aaf 100644\n--- a/docs/devel/testing/qtest.rst\n+++ b/docs/devel/testing/qtest.rst\n@@ -91,3 +91,36 @@ libqtest API reference\n ----------------------\n \n .. kernel-doc:: tests/qtest/libqtest.h\n+\n+\n+QTest valid environment variables\n+---------------------------------\n+\n+A few environment variables are used to point QTest at artifacts to be\n+used in the tests, mostly QEMU binaries or to control the behavior of\n+the tests. Environment variables are set automatically by the build\n+system, but it can be useful to alter them when running tests\n+manually. The following are the environment variables recognized by\n+QTest, not including test-specific ones:\n+\n+QTEST_QEMU_BINARY - The QEMU binary itself\n+\n+QTEST_QEMU_ARGS - Extra arguments for the QEMU command line\n+\n+QTEST_QEMU_IMG - The qemu-img binary\n+\n+QTEST_QEMU_STORAGE_DAEMON_BINARY - The qemu-storage-daemon binary\n+\n+QTEST_STOP - Instruct QTest to stop the QEMU process with SIGSTOP before continuing execution.\n+\n+QTEST_LOG - Comma-separated list of log domains to allow verbose logging. Basic log domains include:\n+\n+\t qmp - controls verbose output of QMP command invocations.\n+\n+\t qtest - controls verbose ouput of qtest operations.\n+\n+\t test - controls verbose output of tests.\n+\n+\t A dash '-' used in front of a log domain has the effect of\n+\t enabling verbose logging for all other domains while\n+\t keeping it disabled for the specified domain.\n","prefixes":["v1","3/3"]}