From patchwork Wed Mar 23 11:27:11 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: =?utf-8?q?Alex_Benn=C3=A9e?= X-Patchwork-Id: 553746 Delivered-To: patch@linaro.org Received: by 2002:a05:7000:1248:0:0:0:0 with SMTP id z8csp3336148mag; Wed, 23 Mar 2022 05:12:31 -0700 (PDT) X-Google-Smtp-Source: ABdhPJxacMgb4dtnPCFiBexOOLm8TwQMZf+lG/D+wZGPES54QMqdMh1eMKa7+DtZDbZ1Iv8KtzMG X-Received: by 2002:ac8:7d83:0:b0:2e1:eca2:afb0 with SMTP id c3-20020ac87d83000000b002e1eca2afb0mr23871259qtd.521.1648037551008; Wed, 23 Mar 2022 05:12:31 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1648037551; cv=none; d=google.com; s=arc-20160816; b=DTXEH7CgZ8Nq53UFc4CQs3nrIe372TUqdcdYSBJVp1/A0Qu+X0PyBQeQw8OI2mDKej V/yzahMFpqx/0zE+C9aGyu4+j0NtEw321BrZ2ztuSjvwPmzQ6WnJHnDtgYVakGGONeWW 4/0E8oxPXcC3LQvdlWMFjJGSmFcUAmlTg0jUmGnoLY4KEfAf7uZgLc8DVkFxWbWOigux yCDv1ikEioGpeW+b3WHZxDiAW+EHQQgoEjeDdi8jmCr70T+QHdlpmvoQcJi7eqXg7kzb WeoCiIkRWZfWka/xC9S6MkYX77n+8VgxbmOFHQxuSBbXfEXnjMkCiwc68Gg+niocABSQ DTHQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:cc:list-subscribe:list-help:list-post:list-archive :list-unsubscribe:list-id:precedence:content-transfer-encoding :mime-version:references:in-reply-to:message-id:date:subject:to:from :dkim-signature; bh=VGuGTUMcrHWD5fZbjeenyrXuekOw3qU1F/rK5dradzM=; b=eH8kIAl/B6psjdMZk2cUaBMqZbMIonWW52nqx1ah2aq5Y69FCGhtdYjar6GNdL9hIw plmQM0X6T+Mk301zAl2dd4xmta7E24FLw21KpBHmy+lexP6ndfhzLuLHf79R8tfh4ooY NqUk4ALvbXAAoENDgHvwbrDSltqu5UypBd9ES5XMvYj1twyJwJkktZpqb03bv7UvJmKK z/fC79cUZ9wJUdvD8/oj2z8iJ73d3tYSjFsldBhiUlnPGBNUmwUiX9uA4p4ryg0YzsMl 9tq0SnGdq7cV14wK1swxhN7vk8NAkrwmt3nSeWnu3U0YW0yHxFAIXL5MkS6up7MgnyTa DvKw== ARC-Authentication-Results: i=1; mx.google.com; dkim=fail header.i=@linaro.org header.s=google header.b=EYZBL5OZ; spf=pass (google.com: domain of qemu-devel-bounces+patch=linaro.org@nongnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom="qemu-devel-bounces+patch=linaro.org@nongnu.org"; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=linaro.org Return-Path: Received: from lists.gnu.org (lists.gnu.org. [209.51.188.17]) by mx.google.com with ESMTPS id s4-20020a05620a254400b0067e4be238fasi3643944qko.319.2022.03.23.05.12.30 for (version=TLS1_2 cipher=ECDHE-ECDSA-CHACHA20-POLY1305 bits=256/256); Wed, 23 Mar 2022 05:12:30 -0700 (PDT) Received-SPF: pass (google.com: domain of qemu-devel-bounces+patch=linaro.org@nongnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; Authentication-Results: mx.google.com; dkim=fail header.i=@linaro.org header.s=google header.b=EYZBL5OZ; spf=pass (google.com: domain of qemu-devel-bounces+patch=linaro.org@nongnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom="qemu-devel-bounces+patch=linaro.org@nongnu.org"; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=linaro.org Received: from localhost ([::1]:44356 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nWzqo-00024L-FD for patch@linaro.org; Wed, 23 Mar 2022 08:12:30 -0400 Received: from eggs.gnu.org ([209.51.188.92]:39106) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nWz9A-000200-QM for qemu-devel@nongnu.org; Wed, 23 Mar 2022 07:27:25 -0400 Received: from [2a00:1450:4864:20::42e] (port=34711 helo=mail-wr1-x42e.google.com) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1nWz99-000650-Cd for qemu-devel@nongnu.org; Wed, 23 Mar 2022 07:27:24 -0400 Received: by mail-wr1-x42e.google.com with SMTP id m30so1676820wrb.1 for ; Wed, 23 Mar 2022 04:27:22 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=VGuGTUMcrHWD5fZbjeenyrXuekOw3qU1F/rK5dradzM=; b=EYZBL5OZnfr+PQrwx7hUyiL5F3cEDKc9ejGFzlOemnngW3aFKqdbaJTpi/szUjHywk hkIqP50nYLlcNL6RNE6xTNRjOtQz2G5Cezxlu1we4SDqEAjdJ7WyOHTy1KBFtxTPEc5d 3PLW4TVh4rbW75Exork1AXadnixPZNHv8y7J46J/eugeoQG8b3BX8gZA3oKRS4iuHtf1 LhqSkRg0xGSMGyOA/gEIZcwyhPX8HmZLqMLIg6CwDdQYVVz6pB+NwnrR0nf4bu1soTBl 5QDqiXGbsURGwnzLSqCIPj/Rr+VPZA/VqxEyzBlZe//H9/VLqmSLlrOdzCWPM9AxxzO8 +9/Q== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=VGuGTUMcrHWD5fZbjeenyrXuekOw3qU1F/rK5dradzM=; b=T1EbJprycrBm5ulKdb/o8ekDhy1phWOrkR4w5ypm0EGL7RCx+uT3iXeOciU+EzOw+O DTM+t+YUBLf0hk2glCoWMFtO2kYyQQzH9ECUB5XYMNYAP2e7MC4aHk/lYCdYLnWprHNb //WSnM4IWyVny2mf66JhacYSCfAX1OMf4q9UqcTC0j/i6rd2BauZ7HyhVX0Fw5eAdgap 64xlfmNBFF+CVb/kX8TyPNV1xD6pnjoafCTfrMwol4xkMfVmhegaZVYxW70h+nRNRcfL AZJ4Wqxelx4jfAWsIuzE66Txywhx9FJjgKYalWzClw/5fXDzjWGpMsaHQKb3+GDqZt0g c0ug== X-Gm-Message-State: AOAM532qVRpo1+xyNhAsTc51e93+WOPCbyJvX6F+R8Scc201KXsZ81CM lKwdCfYnEfGs1sJ7zHQilglJag== X-Received: by 2002:a5d:40c8:0:b0:205:2a3b:c2c with SMTP id b8-20020a5d40c8000000b002052a3b0c2cmr6692149wrq.13.1648034842126; Wed, 23 Mar 2022 04:27:22 -0700 (PDT) Received: from zen.linaroharston ([51.148.130.216]) by smtp.gmail.com with ESMTPSA id r15-20020a5d6c6f000000b002040552e88esm11655757wrz.29.2022.03.23.04.27.14 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 23 Mar 2022 04:27:17 -0700 (PDT) Received: from zen.lan (localhost [127.0.0.1]) by zen.linaroharston (Postfix) with ESMTP id 1BA711FFC0; Wed, 23 Mar 2022 11:27:12 +0000 (GMT) From: =?utf-8?q?Alex_Benn=C3=A9e?= To: peter.maydell@linaro.org Subject: [PULL 8/8] docs/tcg-plugins: document QEMU_PLUGIN behaviour Date: Wed, 23 Mar 2022 11:27:11 +0000 Message-Id: <20220323112711.440376-9-alex.bennee@linaro.org> X-Mailer: git-send-email 2.30.2 In-Reply-To: <20220323112711.440376-1-alex.bennee@linaro.org> References: <20220323112711.440376-1-alex.bennee@linaro.org> MIME-Version: 1.0 X-Host-Lookup-Failed: Reverse DNS lookup failed for 2a00:1450:4864:20::42e (failed) Received-SPF: pass client-ip=2a00:1450:4864:20::42e; envelope-from=alex.bennee@linaro.org; helo=mail-wr1-x42e.google.com X-Spam_score_int: -6 X-Spam_score: -0.7 X-Spam_bar: / X-Spam_report: (-0.7 / 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, PDS_HP_HELO_NORDNS=0.659, RCVD_IN_DNSWL_NONE=-0.0001, RDNS_NONE=0.793, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=no 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: , Cc: Christoph Muellner , Mahmoud Mandour , =?utf-8?q?Alex_Benn=C3=A9e?= , qemu-devel@nongnu.org, Alexandre Iooss Errors-To: qemu-devel-bounces+patch=linaro.org@nongnu.org Sender: "Qemu-devel" From: Christoph Muellner QEMU plugins can be loaded via command line arguments or via the QEMU_PLUGIN environment variable. Currently, only the first method is documented. Let's document QEMU_PLUGIN. As drive-by cleanup, this patch fixes the path to the plugins in the same section of the documentation. Signed-off-by: Christoph Muellner Message-Id: <20220316181412.1550044-1-cmuellner@linux.com> [AJB: fixed some minor typos] Signed-off-by: Alex Bennée diff --git a/docs/devel/tcg-plugins.rst b/docs/devel/tcg-plugins.rst index f93ef4fe52..a7cc44aa20 100644 --- a/docs/devel/tcg-plugins.rst +++ b/docs/devel/tcg-plugins.rst @@ -27,13 +27,18 @@ Once built a program can be run with multiple plugins loaded each with their own arguments:: $QEMU $OTHER_QEMU_ARGS \ - -plugin tests/plugin/libhowvec.so,inline=on,count=hint \ - -plugin tests/plugin/libhotblocks.so + -plugin contrib/plugin/libhowvec.so,inline=on,count=hint \ + -plugin contrib/plugin/libhotblocks.so Arguments are plugin specific and can be used to modify their behaviour. In this case the howvec plugin is being asked to use inline ops to count and break down the hint instructions by type. +Linux user-mode emulation also evaluates the environment variable +``QEMU_PLUGIN``:: + + QEMU_PLUGIN="file=contrib/plugins/libhowvec.so,inline=on,count=hint" $QEMU + Writing plugins ---------------