Received: by 2002:ab2:6a05:0:b0:1f8:1780:a4ed with SMTP id w5csp2731391lqo; Tue, 14 May 2024 07:37:42 -0700 (PDT) X-Forwarded-Encrypted: i=3; AJvYcCU9ElYV31PO9WJYYYOfVjlxNZLYUomCYpS3MJsvW7yLGzOTT5f+1zB8lHUXmDl+g6rEpjNJOIIwUe6noR5BWWomuhPtzFdlcXwkgD6NxQ== X-Google-Smtp-Source: AGHT+IGNVjtYyjCrIwwL7M6fXDg4vfqKzFVE9R91Xfe0azUUe6+7DnWNmTnaFkadFyR7WoucKGk4 X-Received: by 2002:a17:902:c402:b0:1eb:e40:3f74 with SMTP id d9443c01a7336-1ef432a092emr182431985ad.32.1715697462222; Tue, 14 May 2024 07:37:42 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1715697462; cv=pass; d=google.com; s=arc-20160816; b=AMxsmH5Twc3fmQvJKYmFfipZRELjCAcuy9zeM6taCCQVPsUGn8AYHKdTGG9FWNDNVH LdTUMG9vhyncK1Nxw9gdpv7BUuxdILm0sUUmPbWjXCRVs9pfm7KpZ/JfW3pAm+dqtB9R HKepSohIDe91/MrkybHms98Q7WayyREY+qEFgtNv15yisHHz6uVuetaxIAmhmua03EJc rW252UfoE8WHZj1+lyaFCLEUC3rucrF9Cs6D1XVPgPX1zJLHQz7mNAuMP+0F0nfiKjPZ 01KMSwrBFWbw8aIFwUUUJooqsuC3qiIdZV6zp/nPBvb6bYOpqcj+ntGGXScpjwWIA2Vp 9a+w== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-language:thread-index:content-transfer-encoding :mime-version:list-unsubscribe:list-subscribe:list-id:precedence :message-id:date:subject:in-reply-to:references:cc:to:from :dkim-signature; bh=Iq8lh+ioOW1FpEAVtAaznZbqqApHq44z6sdGCsyHXFA=; fh=W9UZKduJdyOrH4fUeQbLvt5RCc0Kx8K7uHbDrNF3+Tw=; b=aGTMzLtgdVvJp05wUsLBa/v5x8SFiPdsrDvSeYK1rI2CVJPHj82sK8WWtNOdVyRfiG cyLN0kLIqkwGh/2XSWoD5fTFl2eqH8rffk4oNZBRoZWQUhtRaSresRkTLEjnhla3Yy7Y 61CkJF5KOgt5kUYj1A7ivThdvgALbNPwGmbT8UBvms1cPwsZJMLmH6Oenxd24HQPU/Kx klqCct8uzHnBCtVBxnoEOuKUoCW/IDQWtyIZcgUpfzovhstACBJlaPxYQMEMxx1kC2v4 Zuax//PrRcQ9T+rPGDU9xPXGg7rVj0H8Z017Rsygap3gx1S+cWqbQumd31uYiD6p8bkf xfmA==; dara=google.com ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@googlemail.com header.s=20230601 header.b=H435RsdL; arc=pass (i=1 spf=pass spfdomain=googlemail.com dkim=pass dkdomain=googlemail.com dmarc=pass fromdomain=googlemail.com); spf=pass (google.com: domain of linux-kernel+bounces-178813-linux.lists.archive=gmail.com@vger.kernel.org designates 147.75.48.161 as permitted sender) smtp.mailfrom="linux-kernel+bounces-178813-linux.lists.archive=gmail.com@vger.kernel.org"; dmarc=pass (p=QUARANTINE sp=QUARANTINE dis=NONE) header.from=googlemail.com Return-Path: Received: from sy.mirrors.kernel.org (sy.mirrors.kernel.org. [147.75.48.161]) by mx.google.com with ESMTPS id d9443c01a7336-1ef0c15e33bsi118408525ad.529.2024.05.14.07.37.41 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 14 May 2024 07:37:42 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel+bounces-178813-linux.lists.archive=gmail.com@vger.kernel.org designates 147.75.48.161 as permitted sender) client-ip=147.75.48.161; Authentication-Results: mx.google.com; dkim=pass header.i=@googlemail.com header.s=20230601 header.b=H435RsdL; arc=pass (i=1 spf=pass spfdomain=googlemail.com dkim=pass dkdomain=googlemail.com dmarc=pass fromdomain=googlemail.com); spf=pass (google.com: domain of linux-kernel+bounces-178813-linux.lists.archive=gmail.com@vger.kernel.org designates 147.75.48.161 as permitted sender) smtp.mailfrom="linux-kernel+bounces-178813-linux.lists.archive=gmail.com@vger.kernel.org"; dmarc=pass (p=QUARANTINE sp=QUARANTINE dis=NONE) header.from=googlemail.com Received: from smtp.subspace.kernel.org (wormhole.subspace.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by sy.mirrors.kernel.org (Postfix) with ESMTPS id 541A5B22962 for ; Tue, 14 May 2024 14:34:12 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 89C2817EB89; Tue, 14 May 2024 14:34:00 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=googlemail.com header.i=@googlemail.com header.b="H435RsdL" Received: from mail-pj1-f41.google.com (mail-pj1-f41.google.com [209.85.216.41]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 51B9317BB10; Tue, 14 May 2024 14:33:58 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.216.41 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1715697239; cv=none; b=O1g4xahHGzfDeKFN/xRu2bbUpBiOddG68h6XtH3aNTV7oRxpUPuUGUK545aCYAUAiKYTvzbjPLeXOfW+PQZvogSZhkOThidZutfxO7E/xwxhAnGkbFXtYqw0Sjd36wCD7buYLZCJSTQHzG3LtTL/P56mcLusmrjxbj/KBUgM+3Q= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1715697239; c=relaxed/simple; bh=9JQ7eiNNZ64JRDb74RE//xWnDSJqnxv76sc+EBu6IA8=; h=From:To:Cc:References:In-Reply-To:Subject:Date:Message-ID: MIME-Version:Content-Type; b=R+LO2KeAI3vsTTvaHU386GjGEM4Qn+JT6M5Bv8HfY2xdXvWsMVxUFPsgTTZtu2pf2yy3j9zfcEmnVaZQ17jQCkRWAfdCuDXgzLBy+0RUeiGQuRadFIdnosalBl5eVr8XxtRiysZgNfSoklapVSZG28DvZ4pBMz7wMu1G/7X+hZ4= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=googlemail.com; spf=pass smtp.mailfrom=googlemail.com; dkim=pass (2048-bit key) header.d=googlemail.com header.i=@googlemail.com header.b=H435RsdL; arc=none smtp.client-ip=209.85.216.41 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=googlemail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=googlemail.com Received: by mail-pj1-f41.google.com with SMTP id 98e67ed59e1d1-2b33d011e5dso3826319a91.0; Tue, 14 May 2024 07:33:58 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=googlemail.com; s=20230601; t=1715697238; x=1716302038; darn=vger.kernel.org; h=content-language:thread-index:content-transfer-encoding :mime-version:message-id:date:subject:in-reply-to:references:cc:to :from:from:to:cc:subject:date:message-id:reply-to; bh=Iq8lh+ioOW1FpEAVtAaznZbqqApHq44z6sdGCsyHXFA=; b=H435RsdLm2f3aWzBHUyl3FV2C0V6TjQf3L5YKhN/k9XZBIeih7bLkBi0qeyrbkN+VR JDGhTAz333DMQlhsJU5H7txZUhvWdqdLz1tijafE1ypbUQ/GB8u8t9fpO5hkqcp3o0Og jed9UBPhWaLQLQFY1gvUGwNLBlXEEySdmPHvyc5yDXpoE1wwtY36anyg37klIX1pUmqi 58N2jx01DOAV2Y7Eue+kfWxaDJIC1QbafO1IWSEx1Nv/1bc3ume+HDQWXWqG2D/ZVHtW qoblsBrHXfSbRQtQZKze5FnTCmvaH2rM5p26Gq8mIUNnz1FXbRXeQSu9E+vPPDqxT/NA JqhQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1715697238; x=1716302038; h=content-language:thread-index:content-transfer-encoding :mime-version:message-id:date:subject:in-reply-to:references:cc:to :from:x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=Iq8lh+ioOW1FpEAVtAaznZbqqApHq44z6sdGCsyHXFA=; b=dHPU0h9KrY3Lr2A0FaxL/6xhjg1189bjxohlKkv7zVn5pJRf4aVfp9zvgb6VPJ+Ap1 mlYSAGvmKPvVknL3XQ+DwxjAqmrGnTqWfKDce7iYvTIZ4ZOL6uU2+T88gCrmvvg7gDNi 1Yl/dUTZsmJCGDbgGm4GiN0qf2bcZwelZETnCdRh1HMmf42OwdCsS1QUd5CYlID6r6FG aNW6IeK2wSJlZGMHOMurqgvGK1Ly65C9iUp8PzjMjRqEBdU9FUL4G4P4ICQuBXGH+8S6 G98qQaeIb2Yzeb8zKJTYNGetRLm/HFGNKfFfdlEGfU3fEYztnHE7GwhIywV55X21Q6zl QJCQ== X-Forwarded-Encrypted: i=1; AJvYcCVarU/u4KasBfN3WX4GUGZR1oICgtpr4wtQKNb9oc7yix8ugXxBmjUEQEGJJqP1Zp+hQB7gj64/S/o6wgToc7P1oNSqr13bA5Q7r3Q4Im3hkXvL+LMxu4F1n9Cwp+E35gbFcovR1SL0yQnINVIykOg68L2ndi+1jMZezKVU X-Gm-Message-State: AOJu0YxJYrzv+P8OWfrYVuiW6Elmx0tW//7tYb1bZSNOpos7Vzw4SWml 1Wg2QhvwX9HyMCBk7YnHxf+pQWjeiQHZqlU1hDxfrbjfBFCEMHXG X-Received: by 2002:a17:90a:7103:b0:2b6:215b:e236 with SMTP id 98e67ed59e1d1-2b6c76f97b7mr19309942a91.23.1715697237523; Tue, 14 May 2024 07:33:57 -0700 (PDT) Received: from ArmidaleLaptop ([50.204.89.30]) by smtp.gmail.com with ESMTPSA id 98e67ed59e1d1-2b99c5eea97sm976337a91.52.2024.05.14.07.33.56 (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Tue, 14 May 2024 07:33:57 -0700 (PDT) From: dthaler1968@googlemail.com X-Google-Original-From: To: "'Puranjay Mohan'" , "'David Vernet'" , "'Alexei Starovoitov'" , "'Daniel Borkmann'" , "'Andrii Nakryiko'" , "'Martin KaFai Lau'" , "'Eduard Zingerman'" , "'Song Liu'" , "'Yonghong Song'" , "'John Fastabend'" , "'KP Singh'" , "'Stanislav Fomichev'" , "'Hao Luo'" , "'Jiri Olsa'" , "'Jonathan Corbet'" , "'Dave Thaler'" , "'Will Hawkins'" , , , , Cc: References: <20240514130303.113607-1-puranjay@kernel.org> In-Reply-To: <20240514130303.113607-1-puranjay@kernel.org> Subject: RE: [PATCH bpf] bpf, docs: Fix the description of 'src' in ALU instructions Date: Tue, 14 May 2024 08:33:55 -0600 Message-ID: <019c01daa60b$c08873b0$41995b10$@gmail.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Outlook 16.0 Thread-Index: AQMgS3ITkG+5x2/Y13ejOoDX0Q3k4K8LgGnA Content-Language: en-us Puranjay Mohan wrote: > An ALU instruction's source operand can be the value in the source register or the > 32-bit immediate value encoded in the instruction. This is controlled by the 's' bit of > the 'opcode'. > > The current description explicitly uses the phrase 'value of the source register' > when defining the meaning of 'src'. > > Change the description to use 'source operand' in place of 'value of the source > register'. > > Signed-off-by: Puranjay Mohan Acked-by: Dave Thaler > --- > Documentation/bpf/standardization/instruction-set.rst | 5 +++-- > 1 file changed, 3 insertions(+), 2 deletions(-) > > diff --git a/Documentation/bpf/standardization/instruction-set.rst > b/Documentation/bpf/standardization/instruction-set.rst > index a5ab00ac0b14..2e17b365388e 100644 > --- a/Documentation/bpf/standardization/instruction-set.rst > +++ b/Documentation/bpf/standardization/instruction-set.rst > @@ -292,8 +292,9 @@ Arithmetic instructions ``ALU`` uses 32-bit wide > operands while ``ALU64`` uses 64-bit wide operands for otherwise identical > operations. ``ALU64`` instructions belong to the > base64 conformance group unless noted otherwise. > -The 'code' field encodes the operation as below, where 'src' and 'dst' refer -to the > values of the source and destination registers, respectively. > +The 'code' field encodes the operation as below, where 'src' refers to > +the the source operand and 'dst' refers to the value of the destination > +register. > > ===== ===== ======= > ========================================================== > name code offset description > -- > 2.40.1