From nobody Fri Nov 14 19:47:12 2025 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass(p=none dis=none) header.from=linaro.org ARC-Seal: i=1; a=rsa-sha256; t=1761670418; cv=none; d=zohomail.com; s=zohoarc; b=LvbSroXS3XmhTAqlicqzO5k5ZhMtr6u6la4o8iLdOfBpK4jcC3neh9IGceZtaab4oqX3pr/k2BsNY3NXhswiHHxFkHgtPUsjC1EoRz+QXikwApECn/TRhQ/bCeyOscBFRAaxVg6tUUVDYl8no/3ELeqjKaT5rTXITi9zIZxACNA= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1761670418; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=duXUtx8IpByXEhpH/TMjxuTeIVkxc2UAHVlNdpXFF+8=; b=hlSBCJJfv6PY+ACrNvF5Qm9b0otC5ZymksJsbAbVwOciMTYAOM1NGpdVm4bZgCkPQfc4cYKRx37Wt9xiu2uCnTto8tFQ936mlIqRB42mbqi5R7ribUHP2X5CF6xVLZ38ywrWxQjoPruxvKkuwxwEL5MlvXQskG0+zeNXpYZvc9Y= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass header.from= (p=none dis=none) Return-Path: Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 1761670418445351.0036228877301; Tue, 28 Oct 2025 09:53:38 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1vDmwG-0005kU-Jr; Tue, 28 Oct 2025 12:52:53 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1vDmwB-0005k6-Mc for qemu-devel@nongnu.org; Tue, 28 Oct 2025 12:52:48 -0400 Received: from mail-wr1-x42e.google.com ([2a00:1450:4864:20::42e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1vDmw8-0006aL-RC for qemu-devel@nongnu.org; Tue, 28 Oct 2025 12:52:47 -0400 Received: by mail-wr1-x42e.google.com with SMTP id ffacd0b85a97d-429a0d1c31aso60713f8f.1 for ; Tue, 28 Oct 2025 09:52:41 -0700 (PDT) Received: from orth.archaic.org.uk (orth.archaic.org.uk. [2001:8b0:1d0::2]) by smtp.gmail.com with ESMTPSA id ffacd0b85a97d-429952df3c7sm20909318f8f.40.2025.10.28.09.52.36 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 28 Oct 2025 09:52:37 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; t=1761670358; x=1762275158; darn=nongnu.org; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to; bh=duXUtx8IpByXEhpH/TMjxuTeIVkxc2UAHVlNdpXFF+8=; b=NKbapBLTMuuEVJdJJzacI7Tx9BiNbNkqXi3Q8BrumQyOtoEQ2/TS64+PF3LjriQozQ abqeUTa7YVYqt0WML37JAD0YncnoAK/YERZ06jhm6WuvlO0puMJefjRseCSLomSa3Nv+ jT38PZ5KjhS8W9IEG9mtTgIa1irT9zaQ2kjBPaXWbPNCTXySijbUozCbli3/mz2FlIfB 0Qc6K+Vl8jt2Hi0EpRTcynmetqBwNrTFwzvEoGnBzh6yVOLx0fxWOxRydvR9E3pMQHMu C/g0yvdswItRbyP9zVM46Crdz2waP44qogdONaR8pmveqoUyCblU7lZqTegbougKHafl 4ozw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1761670358; x=1762275158; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=duXUtx8IpByXEhpH/TMjxuTeIVkxc2UAHVlNdpXFF+8=; b=D+F8UbS7eCyqGCf5993thiXn9PRrgt7ZD5HZAb0UVltGxkWMYDhsqmKwPxG4/2KBiV XWckyqwFmOSPA0GsI+MRnqXMNlhceSh6cNljBQTs85Nd68R72MRi7r+Nv3mQ5fCijLiH 4/NOyqraf+Nr2ojB5DikwfS6tq9MhUvvqc9dpJke2bk8xJh6evMBASWTZPpXOmimK8Y2 MKDrOfJa/b1xN2lYYIYOVEHRVOR2LDEhmBy6TIKm0ZTAqacGtbn3ZdUWTM4kKHSLmsmp jC+L3c6LPSS8T6DiSW9dht3GhKksm601MakBwSaDuAxRnd9DLEj/TGvodUN0m6RrYv2b UFmw== X-Gm-Message-State: AOJu0YwdCOvQUB00oKbmgBp7lM0T9RTgbl2+J432PtwQad8brb1kxw2w Nu/d/gdVmND0SyrU69u+p/zD9fFAObi2axdZEOBMZSaNUolR6BHZRsXI720gbqQnI7UfIJVuk70 Edxb9 X-Gm-Gg: ASbGncuQDJ51VwrrOr7vxPcSwG05zbW/62ROKM4d70cX/7/kDAT5KaeW4pyhHuGZToE uktx3ylksbfzdPqbKA31CCztCGAoS3Ljsrv3nQJ7tBaHBFM7ARAz/k/6q8j41rh8W0bLDWicIdh /oMDs/t6LYEq5EiafqAUPloDE3qduwc5AyBxGxYoXNCfb8EYAIk8QOZiePJw0vlUARw1cTectrL PTALe2anmGRsyeZIOtupFSWKXh9F8myPvBE6AOtJxRqjpgIHSxT4aiIc8YYqQDY9lQVsK8eZbUb apYbvtmGmuH7rBtLA9R17ALJAYb/0eSZ2o2RjHxPhEcPcRkP2gH4I5nPHGhv2AjBgm1xG2pJSEA G6+2r1QlyaUAar/H1LBDXRwttMXJoSjUQEU7uP78Rs3EemZ6nRKN0YebtaS4eL31Bx4X5RXBVNP U4FkpzpA== X-Google-Smtp-Source: AGHT+IFleQPq9YzE/C+DENiGSpAwOXKcjuN+nus4dBFOkFMIW77zkci8w0ZiX0IABInAbcnxPmnO5g== X-Received: by 2002:a05:6000:2001:b0:429:8912:e28b with SMTP id ffacd0b85a97d-429a81a8340mr3563588f8f.4.1761670357877; Tue, 28 Oct 2025 09:52:37 -0700 (PDT) From: Peter Maydell To: qemu-devel@nongnu.org Cc: Paolo Bonzini , Alexander Bulekov , Bandan Das , Stefan Hajnoczi , Fabiano Rosas , Darren Kenny , Qiuhao Li Subject: [PATCH] docs/devel/testing/fuzzing: Note that you can get qtest to read from a file Date: Tue, 28 Oct 2025 16:52:35 +0000 Message-ID: <20251028165236.3327658-1-peter.maydell@linaro.org> X-Mailer: git-send-email 2.43.0 MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists.gnu.org; Received-SPF: pass client-ip=2a00:1450:4864:20::42e; envelope-from=peter.maydell@linaro.org; helo=mail-wr1-x42e.google.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, 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: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: qemu-devel-bounces+importer=patchew.org@nongnu.org X-ZohoMail-DKIM: pass (identity @linaro.org) X-ZM-MESSAGEID: 1761670421502154100 Content-Type: text/plain; charset="utf-8" It is possible to get qtest to read fuzzer reproducers from a file rather than directly from stdio; this is useful when you want to run QEMU under gdb to debug the failure. Document how to do this, which was previously only written down in the commit message for 5b18a6bf44b9 ("chardev: Allow setting file chardev input file on the command line"). Signed-off-by: Peter Maydell Reviewed-by: Fabiano Rosas Reviewed-by: Manos Pitsidianakis --- I got bored of looking up the commit message in the git log every time :-) --- docs/devel/testing/fuzzing.rst | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/docs/devel/testing/fuzzing.rst b/docs/devel/testing/fuzzing.rst index c3ac084311b..c43f815f320 100644 --- a/docs/devel/testing/fuzzing.rst +++ b/docs/devel/testing/fuzzing.rst @@ -263,6 +263,15 @@ generic-fuzz target. =20 - Report the bug and send a patch with the C reproducer upstream =20 +QEMU can also read the reproducer directly from a file rather than +from standard input:: + + $QEMU_PATH $QEMU_ARGS -qtest chardev:repro \ + -chardev file,id=3Drepro,path=3D/dev/null,input-path=3D/tmp/reproduc= er + +This is useful if you want to run QEMU under a debugger to investigate +the failure. + Implementation Details / Fuzzer Lifecycle ----------------------------------------- =20 --=20 2.43.0