From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from out-170.mta1.migadu.com (out-170.mta1.migadu.com [95.215.58.170]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 9AAE420C010 for ; Sun, 8 Jun 2025 14:32:28 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=95.215.58.170 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1749393151; cv=none; b=T34AHQYFo2pAeeq1LDXxTnjWy+2rRl1zZLtyn9DgFD+WNnHcSksMEP4iafR+WUTo8geCy+v35y+moTulFcI0SsGNLl8yJjaGsI+OkyWPZdi9MTBI8ZA0Ai2LpTwDolbwQg3TJft9XAIinaCTPLO4tP+t0Yb6YYC8386OApcA4X0= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1749393151; c=relaxed/simple; bh=H0PThwnqughyGQkOdqDlsMIblLKvsgoeeYY5tjXdJKQ=; h=Message-ID:Date:MIME-Version:Subject:To:Cc:References:From: In-Reply-To:Content-Type; b=SU99ZGMCyHGmrOXJnhC7/dkA15lw1j0wCqLo250J7vlLG5XwHvAYABqY0LADaAvUW8roUCLsA54qebU1EIwY20AvEGpt5umh5HCGjv09LNcJyBsAf4QSOJ2MerdH2mP7kbAS2TgIC5RMO/Ezp4+0KB+NioC72ddsu3edsPQRFCg= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=linux.dev; spf=pass smtp.mailfrom=linux.dev; dkim=pass (1024-bit key) header.d=linux.dev header.i=@linux.dev header.b=lBPJ766E; arc=none smtp.client-ip=95.215.58.170 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=linux.dev Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=linux.dev Authentication-Results: smtp.subspace.kernel.org; dkim=pass (1024-bit key) header.d=linux.dev header.i=@linux.dev header.b="lBPJ766E" Message-ID: DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linux.dev; s=key1; t=1749393136; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=GWGpWO4XZip3DDSvOV06d85tUhqZHEdZ1brs1WQyrzs=; b=lBPJ766EukbyvQ1Uy3PN+0uY9B4zWhk2+1hmw7Di08Jm1Y96qWA61F7pvalbdATyGGFTHL hbl+V/kkq9+xiuymQsk5Q4TyXFAuaRPkdh4pFjTOsp5ujCYfabn5iVm7Cw9L0/ZeRRsYco cJ7JVRJ2crhdwuZPWrcGZsmDV7WNd7w= Date: Sun, 8 Jun 2025 07:32:02 -0700 Precedence: bulk X-Mailing-List: linux-doc@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Subject: Re: [PATCH bpf-next] Documentation: Enhance readability in BPF docs Content-Language: en-GB To: Eslam Khafagy Cc: skhan@linuxfoundation.org, David Vernet , Alexei Starovoitov , Daniel Borkmann , Andrii Nakryiko , Martin KaFai Lau , Eduard Zingerman , Song Liu , John Fastabend , KP Singh , Stanislav Fomichev , Hao Luo , Jiri Olsa , Jonathan Corbet , Dave Thaler , "open list:BPF [DOCUMENTATION] (Related to Standardization)" , "open list:BPF [DOCUMENTATION] (Related to Standardization)" , "open list:DOCUMENTATION" , open list References: <20250607222434.227890-1-eslam.medhat1993@gmail.com> X-Report-Abuse: Please report any abuse attempt to abuse@migadu.com and include these headers. From: Yonghong Song In-Reply-To: <20250607222434.227890-1-eslam.medhat1993@gmail.com> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-Migadu-Flow: FLOW_OUT On 6/7/25 3:24 PM, Eslam Khafagy wrote: > The phrase "dividing -1" is one I find confusing. E.g., > "INT_MIN dividing -1" sounds like "-1 / INT_MIN" rather than the inverse. > "divided by" instead of "dividing" assuming the inverse is meant. > > Signed-off-by: Eslam Khafagy Acked-by: Yonghong Song > --- > Documentation/bpf/standardization/instruction-set.rst | 4 ++-- > 1 file changed, 2 insertions(+), 2 deletions(-) > > diff --git a/Documentation/bpf/standardization/instruction-set.rst b/Documentation/bpf/standardization/instruction-set.rst > index ac950a5bb6ad..39c74611752b 100644 > --- a/Documentation/bpf/standardization/instruction-set.rst > +++ b/Documentation/bpf/standardization/instruction-set.rst > @@ -350,8 +350,8 @@ Underflow and overflow are allowed during arithmetic operations, meaning > the 64-bit or 32-bit value will wrap. If BPF program execution would > result in division by zero, the destination register is instead set to zero. > Otherwise, for ``ALU64``, if execution would result in ``LLONG_MIN`` > -dividing -1, the destination register is instead set to ``LLONG_MIN``. For > -``ALU``, if execution would result in ``INT_MIN`` dividing -1, the > +divided by -1, the destination register is instead set to ``LLONG_MIN``. For > +``ALU``, if execution would result in ``INT_MIN`` divided by -1, the > destination register is instead set to ``INT_MIN``. > > If execution would result in modulo by zero, for ``ALU64`` the value of