From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mx0b-00069f02.pphosted.com (mx0b-00069f02.pphosted.com [205.220.177.32]) by sourceware.org (Postfix) with ESMTPS id DA32B3858D37 for ; Thu, 27 Jul 2023 21:41:33 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org DA32B3858D37 Authentication-Results: sourceware.org; dmarc=pass (p=none dis=none) header.from=oracle.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=oracle.com Received: from pps.filterd (m0333520.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.17.1.19/8.17.1.19) with ESMTP id 36RFOErp004114 for ; Thu, 27 Jul 2023 21:41:33 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=from : to : cc : subject : date : message-id : content-transfer-encoding : content-type : mime-version; s=corp-2023-03-30; bh=3cXz5SFWNRGE3L7XLjenRYuvpBrotXI83ZXSXc3Tzks=; b=IiZmDIdJalV1j/USjhhZVAGEhtjpTUPtZWjtvQwVC6N1loSsJaLYxhiXD6toM4AQOLU1 0nbpibSIM588Hl5/TFW1X9axD7YoFZcNB6H07/4qt73/iiBmeWfCwHoPPM7jaUTzHmT6 o5ZafDcwMQwIqTvtObURRO6I19eUX2ZcIlfcKM1/IsJ7hWXpEnKMepIuW6l+PsKYX30E duMKIF+FHJQn7e3a+JJm4+7ufozfDxSqPdXIQQICr+98AGq9E2EpWhmcrJeF++Q/uAg7 GKsBlCGMOmn/TY3e2dgoSpcARH1qvYS1XE2QKcWe+EdQTHhdLgXgPASBTZT63I9CGoAz 8Q== Received: from iadpaimrmta01.imrmtpd1.prodappiadaev1.oraclevcn.com (iadpaimrmta01.appoci.oracle.com [130.35.100.223]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 3s075dauyc-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Thu, 27 Jul 2023 21:41:33 +0000 Received: from pps.filterd (iadpaimrmta01.imrmtpd1.prodappiadaev1.oraclevcn.com [127.0.0.1]) by iadpaimrmta01.imrmtpd1.prodappiadaev1.oraclevcn.com (8.17.1.19/8.17.1.19) with ESMTP id 36RL260H030472 for ; Thu, 27 Jul 2023 21:41:32 GMT Received: from nam02-sn1-obe.outbound.protection.outlook.com (mail-sn1nam02lp2043.outbound.protection.outlook.com [104.47.57.43]) by iadpaimrmta01.imrmtpd1.prodappiadaev1.oraclevcn.com (PPS) with ESMTPS id 3s05jegu14-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Thu, 27 Jul 2023 21:41:32 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=GWEQ1bp1lNt/D0veLHuMI43TrVT1gldSEdK9WI5faEXPK0ofBu2dByyqZOFE0kj3Jwh6ikULjcR5r9TMOiJt/mN51RFc3RGkjmxOVw3Yg6EwgeMyfamrWymtGISkNuozULoUiT11iHCQkSvX7su4z+LwMRrikZDdrInk+I9iu9veRk4ExNob1rIHvvhDW4H7VwQ38tcoGrGzZe5tc2Pf2MSkweBQAHzM2Igzg7F1DR7p8hdE5cDE4A3XsHZ6XiUCo6rFkpVmKk1qOxzCsSnjbIlOa0aGQImPOxF9XvtI622uxodcZgf1/ZBAycbhQTdcaFvJKv+jZB4DxOJHCl4nNQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=3cXz5SFWNRGE3L7XLjenRYuvpBrotXI83ZXSXc3Tzks=; b=Gzp1YGgTVx+VhnQDdg4KCejqGlMRI6EqTGebOMSV1ntO9QaGguK7R/fsHByYUx/Ctz4mZ8HONKrr1MNfh20DJLFHUReab9tNRes95JXeqN8cLTKwCXjtwIkbzmX/pQmuNQ73DQlIsL/W3Pzj5Voemt9LLvYcJDY7DNHLbVBepp+5rDN0+AD67cWn3r3o7+j2FiMJnmJgZ/OGcKmbQQ4vWmaj3b7oem94G7QaFhzrDMDtCDLOQqUT0kfBNe+SNCHLZEYwraYHhZ6A+/Uivz4KZmGK83yqUMz0jNZHaRkxp705m2X/R+Y40/mpHh2TbS7sDjBahb1zgFX1jc4GJJc0mg== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=oracle.com; dmarc=pass action=none header.from=oracle.com; dkim=pass header.d=oracle.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.onmicrosoft.com; s=selector2-oracle-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=3cXz5SFWNRGE3L7XLjenRYuvpBrotXI83ZXSXc3Tzks=; b=phMQJ5qdcxmChtkRFGPOAvDTPjoJQh0mG8u9Dyp4aL5QClLrY8DYMbEfcmveTUCsYpXRmUpsuVpBjfAzYDJmP3TMIoubvRrZk0NFG+XXvMr2dsQ5AJ6EOXsZRPaphNCwLunE6eLcnIuWl4k36sLJmtqq5MrdUM7q8k/vmqlA6fw= Received: from MN2PR10MB3213.namprd10.prod.outlook.com (2603:10b6:208:131::33) by IA0PR10MB7578.namprd10.prod.outlook.com (2603:10b6:208:491::15) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6609.24; Thu, 27 Jul 2023 21:41:30 +0000 Received: from MN2PR10MB3213.namprd10.prod.outlook.com ([fe80::827f:8665:2052:16c5]) by MN2PR10MB3213.namprd10.prod.outlook.com ([fe80::827f:8665:2052:16c5%4]) with mapi id 15.20.6631.026; Thu, 27 Jul 2023 21:41:30 +0000 From: David Faust To: gcc-patches@gcc.gnu.org Cc: jose.marchesi@oracle.com Subject: [PATCH] bpf: minor doc cleanup for command-line options Date: Thu, 27 Jul 2023 14:41:20 -0700 Message-ID: <20230727214120.18783-1-david.faust@oracle.com> X-Mailer: git-send-email 2.41.0 Content-Transfer-Encoding: 8bit Content-Type: text/plain X-ClientProxiedBy: DM6PR13CA0039.namprd13.prod.outlook.com (2603:10b6:5:134::16) To MN2PR10MB3213.namprd10.prod.outlook.com (2603:10b6:208:131::33) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: MN2PR10MB3213:EE_|IA0PR10MB7578:EE_ X-MS-Office365-Filtering-Correlation-Id: 4c44bee9-6040-4a92-0d18-08db8eea3d22 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: gdyRBqUUNimZOJZ7rpjJPYsuUAhpA13NOcte9AqwmzsAgF2/rjOjADlmLzAR8NhWlf2arwO+I5dHHeRC59J2AtWVEDhSMBJ21C4KWakVOCXRMC73ZpKiVABozwMMIqhPjMhit2pZzl2p7eH9PeQLJMUjlLdtiLmLw0KKkmN/dfklY45GznAu6ZWrsvaTo3+xOWGlH8TI7F9qVmIHYtLPqIM0qOKxPFs09AFQCV64qpsELifum3WCTOE3cjGCCLZY4tU3fcjlEx2Hk9/EOZ4vGQXrAqFN+wZ1ybfr0ppchy3kTFflF7iOsKZ13yhAqA2lniByLFE9ikV0mMtE1Nyk/hFIi4vVtFM7i1O+nA7xnyWgNs67qtzSYy1Lm8vPQStJXKl8k+FhPpAOj8YD3wzmG5QDzHKvUaHaQaggUQv6XE6kV/NcuRa7lDajgx19onaedCY7UGxgb0djGjQw7UXkGamOJWt+0YPrXl9iQHT2cIr5Eb30FygK1CGNeqvai3wdXQ0RIssQh42UtdM9V+oaz8ltZAXWSdq4VR5VYyrk5vRe8Qq2D9ZPlSvmQfVcrbZu X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:MN2PR10MB3213.namprd10.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230028)(136003)(39860400002)(396003)(366004)(376002)(346002)(451199021)(83380400001)(2616005)(2906002)(38100700002)(478600001)(6486002)(107886003)(66946007)(6916009)(4326008)(6506007)(41300700001)(1076003)(186003)(66556008)(316002)(66476007)(6512007)(5660300002)(36756003)(8936002)(8676002)(86362001)(44832011)(6666004);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?R3GftFHOy/Un9YdX9/emA8h3I4aSVhEzNhJ6v1YYmdREI8e4CXWW5hm7m3Ao?= =?us-ascii?Q?Kj3XcYDfnc3yQNwAflv37GXZEz4NarVXtySdU/P1RoYyrbNdDjpKNwwo8sq3?= =?us-ascii?Q?BqocZVr4bHhjmGQHAA+r8ImWBtnEp4wfQDT7SkAFtYEJqSTcYcha76ygIAZl?= =?us-ascii?Q?ZTPweBTMnAyRcYKNJZoDOsRDORO7t8sCl9u4jxKaouXk32RteZDxVJOnF4UH?= =?us-ascii?Q?nzwnEVKeD/7VxMv+W515JuOfABLxdLdj0PWqdhLfy83176O+pWLoXmhImoBX?= =?us-ascii?Q?JaOU9Bx34CMyespg3TXh2+B/tjA8IOMvqPAq5AJpcHGBoJkjJfXP9uSUeDCF?= =?us-ascii?Q?s7mdscjLbhnCkd59wZ5fu1ugxcByK1xMsxX9g5azawboAOQuMFTTKgRIKqaD?= =?us-ascii?Q?+UCyAKZQ5cKhIDIqHFU/bS3ZlLkL7VjoS7PNcduVW8K1igg35Yyq4J4hi7D5?= =?us-ascii?Q?wGbYLxUFekP2RAWq5r03kcKYRuwAT9oemzMTn3mZDkNWZOYRBQJt+34rVZsM?= =?us-ascii?Q?kDaZ4JXofAy0aCEnQWtW2VBtwCuIMCZ0k4K4gzqXiu0vwQsFkVh61UYZg/Z1?= =?us-ascii?Q?2/klsqjZKe9uaEcQeVxnprVcFJenbxrTszOS3AOaVKPIBgHmwiaRM71HPEZT?= =?us-ascii?Q?dp+UtemEhHKvPWqa6vgs2ReKh73UishZ+CwYk18XKOhfg4GikgXnNsPBt2bd?= =?us-ascii?Q?fuCX5Kdg5BlhMQlgEtEBFpFwkT6LdHb2ABcgl5t/NH/VBADdZ03CzE0I8ewA?= =?us-ascii?Q?FBm8nHsSExlnAZPSM/GN6au7bVA+MhCfNAQ29kDsxsop6GjPwb8NFrIR87as?= =?us-ascii?Q?NXkFm/0Igc852X/w5t+jBN5Tis4qa0fn08YdWoJDPKbuOwdgTx0BW05SVd7X?= =?us-ascii?Q?THmXWxANpu7sq7MGN+aaEgXeZcx2ACrHq87vWQqgDQb+ZTT8NRcQ8CMF7TkA?= =?us-ascii?Q?5He5s9o9NN72p5LhGA1KA/0dTBnOVhGD/jHEpuSIZ309p2M7RL1tuwhVVg2x?= =?us-ascii?Q?OcsFHCmaxcpnbK9sAfDKIYRyCv7wucFWrQisSSO0G0bzxT86NCeNH6DdyIxE?= =?us-ascii?Q?v1Fg6itRkfFmj6OyeffBewBDirgEzhBSpgI+/WWSUbAtZ+1VdQXwpTlNf/x1?= =?us-ascii?Q?GnPdv9NSWv7g/NsW6IpDwpf/04nIUrudl5FsbNBAe074Zj0AgRexkBEb/3ew?= =?us-ascii?Q?/kAm4rX7blOkQ++FtrDId3Pcz6vUDNb02aHsrvPkUP72EQxrA7kxL+YSan3U?= =?us-ascii?Q?9BHKTwVFuN228a335dxKVaZ3D541Hkj6BbKpuo0eYZFEGcQ3FUeVSDSIGwrf?= =?us-ascii?Q?HK/m+FbEqjpbumzZr4mYgNeRGV4n3uOkJQeCX60MesB3oSOE2ZvgNyI7f1Lo?= =?us-ascii?Q?vNJZA2IVQ3gwaqeiSDVfs8H3JDp2KrotDQjdv2ylG7nTt7BCtLsBKZW1s2dV?= =?us-ascii?Q?XujGx15FVorku+Y0mdK5VKfsV6aClu4m+HjB1Ai+psZfwMGHNTSHk1VYHFUc?= =?us-ascii?Q?rAomrmGkV5wmY+oOdaJzkwwDq6JnFz8NNIqM+XqCF9EtlWUDBMj1TL47kIkl?= =?us-ascii?Q?pETgPsYncCd5E+R8GjMPGT0Qvf9++8reMkoQ/vaW3Y9qmbgItcJkH+ncKRiA?= =?us-ascii?Q?F9+Wc6kFPP7Lv8AR37xVPTY=3D?= X-MS-Exchange-AntiSpam-ExternalHop-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-ExternalHop-MessageData-0: /dqOzjRSbbs0t1/x374UmCLCUvdYn7ol65PmOvc73QsJvmFgu6S/tq0bKYCOFHAU1VQ2bp52YFeOD6rs8rIni0QvaUyjtA6/g9NlYUlZHxkZMwggKZIj2YAPZDsVif+xWacxSsotbsp233QgVESuswX1HW8UiNPdC6X+oiRxKLrUuTe4NSTxxMPMVonpepu0LjNQcA0wtc866OPzH+yOmQVLEnquie3HVlq8rfOWPplw+5mFO+ME05shujk2hBpTwU//ZyBW/uwGgjXxFpFcKAmZ/GU4ZXMPKA91hRK4eUwXcqyqGWkmykp2PZ0MD7qjwiNFJkH3xbGN65JLRBaLYuMWFTo1+3+/Fc4ADYLNVchyixY7Tv3ImBMVc/SDO1qX/RpfooKw9NdBMuNl2p8J/nEUYdHc86a7Tx57nV+eP/0LkuZOMrDyMWCY0Cg+8dCXvzniN+PZj4DizV3GGbwjvlTqcSvKhlbE7JaIIsdoPSwpX9MECGR7xeq6sZqM0u9PUlyCbepKYGPI6dr8Yp9RgvZpnDoVx1RJmWQsayzULlaDOiQWluNEUocCZsz3O92cFAmZKHuCzwW6NwYXvUddkKXeQ+O4kzDdCVF3VX21QoBAH3e47BSQZYrUxLaZjBdDPxCmxX7J5orTRfumzsk9BnGqCTkwWvthoZuVu4p8+x8k2dqmNRA5weVuJrzjSeztXGXHxpw1fhId7Iqb6+NmyqexcYuXDZCBJKQvyzq5Os3SwffiTdhqC2F/LB5FOiOI X-OriginatorOrg: oracle.com X-MS-Exchange-CrossTenant-Network-Message-Id: 4c44bee9-6040-4a92-0d18-08db8eea3d22 X-MS-Exchange-CrossTenant-AuthSource: MN2PR10MB3213.namprd10.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 27 Jul 2023 21:41:30.5316 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 4e2c6054-71cb-48f1-bd6c-3a9705aca71b X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: HYjZt1aXNfn1uaKrQYhaZTPv6iNN0/W75O1RIrZ3hEuh6eV398YPCe4A/hDZxnh3RdRQ3UH0JeIuubdiTuRmpQ== X-MS-Exchange-Transport-CrossTenantHeadersStamped: IA0PR10MB7578 X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.254,Aquarius:18.0.957,Hydra:6.0.591,FMLib:17.11.176.26 definitions=2023-07-27_10,2023-07-26_01,2023-05-22_02 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 mlxlogscore=999 spamscore=0 adultscore=0 suspectscore=0 phishscore=0 malwarescore=0 mlxscore=0 bulkscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2306200000 definitions=main-2307270197 X-Proofpoint-ORIG-GUID: 3zohdw_GOqdKXrbadoRLrtzfh5y_LO6o X-Proofpoint-GUID: 3zohdw_GOqdKXrbadoRLrtzfh5y_LO6o X-Spam-Status: No, score=-13.4 required=5.0 tests=BAYES_00,DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,GIT_PATCH_0,RCVD_IN_DNSWL_LOW,RCVD_IN_MSPIKE_H5,RCVD_IN_MSPIKE_WL,SPF_HELO_NONE,SPF_NONE,TXREP,T_SCC_BODY_TEXT_LINE autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on server2.sourceware.org List-Id: This patch makes some minor cleanups to eBPF options documented in invoke.texi: - Delete some vestigal docs for removed -mkernel option - Add -mbswap and -msdiv to the option summary - Note the negative versions of several options - Note that -mcpu=v4 also enables -msdiv. gcc/ * doc/invoke.texi (Option Summary): Remove -mkernel eBPF option. Add -mbswap and -msdiv eBPF options. (eBPF Options): Remove -mkernel. Add -mno-{jmpext, jmp32, alu32, v3-atomics, bswap, sdiv}. Document that -mcpu=v4 also enables -msdiv. --- gcc/doc/invoke.texi | 48 ++++++++++++++++++++++----------------------- 1 file changed, 23 insertions(+), 25 deletions(-) diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi index e0fd7bd5b72..91113dd5821 100644 --- a/gcc/doc/invoke.texi +++ b/gcc/doc/invoke.texi @@ -945,9 +945,10 @@ Objective-C and Objective-C++ Dialects}. -mmemory-latency=@var{time}} @emph{eBPF Options} -@gccoptlist{-mbig-endian -mlittle-endian -mkernel=@var{version} +@gccoptlist{-mbig-endian -mlittle-endian -mframe-limit=@var{bytes} -mxbpf -mco-re -mno-co-re -mjmpext --mjmp32 -malu32 -mv3-atomics -mcpu=@var{version} -masm=@var{dialect}} +-mjmp32 -malu32 -mv3-atomics -mbswap -msdiv -mcpu=@var{version} +-masm=@var{dialect}} @emph{FR30 Options} @gccoptlist{-msmall-model -mno-lsim} @@ -24674,18 +24675,6 @@ the value that can be specified should be less than or equal to @samp{32767}. Defaults to whatever limit is imposed by the version of the Linux kernel targeted. -@opindex mkernel -@item -mkernel=@var{version} -This specifies the minimum version of the kernel that will run the -compiled program. GCC uses this version to determine which -instructions to use, what kernel helpers to allow, etc. Currently, -@var{version} can be one of @samp{4.0}, @samp{4.1}, @samp{4.2}, -@samp{4.3}, @samp{4.4}, @samp{4.5}, @samp{4.6}, @samp{4.7}, -@samp{4.8}, @samp{4.9}, @samp{4.10}, @samp{4.11}, @samp{4.12}, -@samp{4.13}, @samp{4.14}, @samp{4.15}, @samp{4.16}, @samp{4.17}, -@samp{4.18}, @samp{4.19}, @samp{4.20}, @samp{5.0}, @samp{5.1}, -@samp{5.2}, @samp{latest} and @samp{native}. - @opindex mbig-endian @item -mbig-endian Generate code for a big-endian target. @@ -24696,30 +24685,38 @@ Generate code for a little-endian target. This is the default. @opindex mjmpext @item -mjmpext -Enable generation of extra conditional-branch instructions. +@itemx -mno-jmpext +Enable or disable generation of extra conditional-branch instructions. Enabled for CPU v2 and above. @opindex mjmp32 @item -mjmp32 -Enable 32-bit jump instructions. Enabled for CPU v3 and above. +@itemx -mno-jmp32 +Enable or disable generation of 32-bit jump instructions. +Enabled for CPU v3 and above. @opindex malu32 @item -malu32 -Enable 32-bit ALU instructions. Enabled for CPU v3 and above. +@itemx -mno-alu32 +Enable or disable generation of 32-bit ALU instructions. +Enabled for CPU v3 and above. + +@opindex mv3-atomics +@item -mv3-atomics +@itemx -mno-v3-atomics +Enable or disable instructions for general atomic operations introduced +in CPU v3. Enabled for CPU v3 and above. @opindex mbswap @item -mbswap -Enable byte swap instructions. Enabled for CPU v4 and above. +@itemx -mno-bswap +Enable or disable byte swap instructions. Enabled for CPU v4 and above. @opindex msdiv @item -msdiv -Enable signed division and modulus instructions. Enabled for CPU v4 -and above. - -@opindex mv3-atomics -@item -mv3-atomics -Enable instructions for general atomic operations introduced in CPU v3. -Enabled for CPU v3 and above. +@itemx -mno-sdiv +Enable or disable signed division and modulus instructions. Enabled for +CPU v4 and above. @opindex mcpu @item -mcpu=@var{version} @@ -24747,6 +24744,7 @@ All features of v2, plus: All features of v3, plus: @itemize @minus @item Byte swap instructions, as in @option{-mbswap} +@item Signed division and modulus instructions, as in @option{-msdiv} @end itemize @end table -- 2.40.1