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 E76A4385743E for ; Thu, 9 Sep 2021 21:37:06 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org E76A4385743E Received: from pps.filterd (m0246632.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.16.1.2/8.16.1.2) with SMTP id 189LTSYi009918 for ; Thu, 9 Sep 2021 21:37:06 GMT Received: from userp3020.oracle.com (userp3020.oracle.com [156.151.31.79]) by mx0b-00069f02.pphosted.com with ESMTP id 3ayfe92821-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Thu, 09 Sep 2021 21:37:06 +0000 Received: from pps.filterd (userp3020.oracle.com [127.0.0.1]) by userp3020.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 189LYstt025355 for ; Thu, 9 Sep 2021 21:37:05 GMT Received: from nam12-mw2-obe.outbound.protection.outlook.com (mail-mw2nam12lp2042.outbound.protection.outlook.com [104.47.66.42]) by userp3020.oracle.com with ESMTP id 3axst62f03-4 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Thu, 09 Sep 2021 21:37:05 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=cbRMxFI9Q5jh3cHCi20bB+KOGE0Gg6uhxtRsy2qP5suWFBfmt6JxGFSxj3/PvhoDCNsSy/rOiHfPu1FKkoCiA02a2Ll2ti+lG4ZtxnImzu00zxIaslgNvcGF8TsEMX/IY7RoVDy+VAz8NKjTRLXLF0Hq4SsJAGI6E9iT24lpMr3lEDMg+gHbyBQU0HsuT3grYExHNYELoPzbqwB108Awd8PKMDCeAl5PH/npBpHT4LMg/fkfPY9G6hyblgpEV/vz+a7tr8eoz/b7lcPBITDDHAdHyuVCAFK73NCWeVXqWvm6iI7evxqgkFVasEh6EE93+mkidRnlzrPGbQgPoe4s+A== 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; bh=fFL59ehuSBETMnTlb9gRR9LQMTut2qC82ZN55XPe5RM=; b=JZK8zx2H3w/smhaktDEEjCXGkRpI8Zg9LSOhQ0zp5UzClg3zkKBkUZFYd9xpXgS7d1FDgvhfLPQho4iyAbIQRx2tdlWkDbXzf349qEg1e3QiGn1mYoEjY707zMCrXsf9pBOmb6ZS7hpoWRzONTMYD7KLXxEGVyCGAXw2Ozx/3beLjc03/GAxJJfL/XS4zZfz9qY5WxXYku0xXiMhRXOdKQFPoLap5nHyFUASt4rO+CuDu1WuY5j2KZkiywIoMNEzQ0X/Ygkyg/BFZp+CATK0dg0JA8D2piNRqbJGis1Rmgt8lsysh0TJQnL3IfOxQSZ4epQiIqrgVj1d8UIbvGjZIw== 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 Received: from SA2PR10MB4458.namprd10.prod.outlook.com (2603:10b6:806:f8::24) by SN6PR10MB2607.namprd10.prod.outlook.com (2603:10b6:805:4e::24) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4500.17; Thu, 9 Sep 2021 21:37:03 +0000 Received: from SA2PR10MB4458.namprd10.prod.outlook.com ([fe80::1493:70de:28e4:3d3e]) by SA2PR10MB4458.namprd10.prod.outlook.com ([fe80::1493:70de:28e4:3d3e%4]) with mapi id 15.20.4500.017; Thu, 9 Sep 2021 21:37:03 +0000 From: David Faust To: gcc-patches@gcc.gnu.org Subject: [PATCH 3/3] doc: document BPF -mcpu and related options Date: Thu, 9 Sep 2021 14:36:45 -0700 Message-Id: <20210909213645.11605-4-david.faust@oracle.com> X-Mailer: git-send-email 2.31.1 In-Reply-To: <20210909213645.11605-1-david.faust@oracle.com> References: <20210909213645.11605-1-david.faust@oracle.com> Content-Transfer-Encoding: 8bit Content-Type: text/plain X-ClientProxiedBy: SN4PR0401CA0042.namprd04.prod.outlook.com (2603:10b6:803:2a::28) To SA2PR10MB4458.namprd10.prod.outlook.com (2603:10b6:806:f8::24) MIME-Version: 1.0 Received: from sequence.us.oracle.com (2606:b400:8301:1041::12) by SN4PR0401CA0042.namprd04.prod.outlook.com (2603:10b6:803:2a::28) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4500.14 via Frontend Transport; Thu, 9 Sep 2021 21:37:02 +0000 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 9799ddea-3406-43d4-d2ee-08d973d9f68b X-MS-TrafficTypeDiagnostic: SN6PR10MB2607: X-Microsoft-Antispam-PRVS: X-MS-Oob-TLC-OOBClassifiers: OLM:1332; X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: /Xt+s1/U+SZ6+mwmJdU8opNMXpdniw8bQ2YPoF/vcbWxZBfF90h+ZKJS/R1fHT+yu8h9GTrODG0W2v7YM5aRfHib/HsNjsciQpuZpAgAM+BmJeh2CQH+JgIHu2C3t0Z3Vgic4C1G5zto8OmGQju8gYFg+EyEwaL7Nj1vGXXDKjGLK8SZBfHT0C6JxuAONy4jp9vaaftWuRDG8G6RwFnKhAoy7OJokiWTAteQEHl1c+0uGVmvvjGWdVxVZDsnfjYI+ava768wt8W9MAgLIEHeeP4uE7B0JtMHiQDyOMw9i5T0H4KRlKznoVP6GuPnT2v7x1k6mpl+YRu3D6WWtZVfT9gmM3Bhbb+cCeR+dLjuAQRgR3VW3CIvlTdjPmOODGhY2PV0DBeEt8JT6F4EhK/Y7ySEHI8D16VqLUNRuejq8fL4Y01ZwGShL49gsMuIxhsIPOwK+J39Kk1omWU2z4c9KyXBaqqN5kfq6KlVdaLBCdshmXkyLcgdeV1pCdFNHeCSzJrJHQUsmPP86Xl0bfiQh0PttuFZkNBIEj6PuC5fq3lnIk6wbsQ62FZbEjCxu7uwbMUpw3pQgkBPaX9LWcE5Up/j0uSgUWxmWbYDcVWAjdWElVK2XAeNBNfFWFRtMlaZirOR6xvjtBL6RBn6QDHbsQ== X-Forefront-Antispam-Report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:SA2PR10MB4458.namprd10.prod.outlook.com; PTR:; CAT:NONE; SFS:(39860400002)(396003)(346002)(376002)(136003)(366004)(2616005)(36756003)(316002)(86362001)(6666004)(52116002)(7696005)(478600001)(66946007)(66476007)(8676002)(38100700002)(8936002)(2906002)(83380400001)(44832011)(1076003)(186003)(5660300002)(6916009)(66556008)(6486002); DIR:OUT; SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?2Tjpyy1h75cHHtLM46unaDjCOBrqIdxMRdqOotGwviWsKwr1NF0Sju3XSEBf?= =?us-ascii?Q?0Cb51x8Hhbx1swt/9KRXQgAIDB4bB+J2+KNLUoTIVm1w+Y5fUAhZ2yr/5xlZ?= =?us-ascii?Q?q+EjMMeyaZpVvZCTKCUWpfLlwLhgWKVgEEgju/EVHkXq6IroMf2J6pCxyix8?= =?us-ascii?Q?UH/kUFIPjOgDVJQ/832bV4NuflXDLRhzdoD0hvXmsN88dU1T+Gqd+OwBnkJg?= =?us-ascii?Q?bMQIwxOdTk82fMt1OH/muEZXTEMmMJTYyC1iN/mPOAc9Jd8LJ8a7hfsbWOcj?= =?us-ascii?Q?+eEw4jH4RT6QVSrg0IUx3HT9CCv1H0Ofa73WaBjssv485CqR2mFSOlfx0G75?= =?us-ascii?Q?OolC4R86XVjv2gtDn3ikHxgMdl4gQsetv5nd/hseGt0CAobRbYp2F/UNNLz0?= =?us-ascii?Q?OJsK34b2QZ1ZsWqKPwO7vEWZ6IQdvNWpt4wwXDUr+0lw/MLR/+zgaNsaBYcg?= =?us-ascii?Q?f0z1GHXS0K51HFThdvVBLchpAnBCueHE3kVOx/YVQ4sXHlSEZR1Y0O6FzAvZ?= =?us-ascii?Q?Shf6fbba95XBzWRYmRLC+0wBo5jNnxxIY0Vj4RBauN4LM0P9yyQNfqYalOJx?= =?us-ascii?Q?7Y8E36XaPaMJRKqYPirdRpxTGxLtG+ITVDIwuNtGtX3oIEpNCsidSFPyvw4X?= =?us-ascii?Q?xJeVAFUqQY5uehh7L0o8yCxECh5fNBkGlPInN/BiTOHWJuaguhy+1OCU9EPS?= =?us-ascii?Q?m93lun6lUh3oTQOXSLODeYzq0R5OQQDHuaGI1N86Jdl/J+C79K7aD0y+RLLK?= =?us-ascii?Q?1Jrv4VVdZoIiNxz9+pVOLa5SMdiX95OLo1FYSndCohlP8VAcmjsJhpk54Pg5?= =?us-ascii?Q?dEt2BoRLjjljrrv4fypqsrjOBOoGvZcokIOByihpgf7Sp63fPNogC/tad/A9?= =?us-ascii?Q?4cUEweTdqZn93gukKeQluLuDo6y2BINaKEsQVt+2PbFlA4r3j6a9ppJzIxB2?= =?us-ascii?Q?3dypWvvx2k8uiauhQjVc2vw6IsY2rlhJji4BnN8PkvhH3SL1ZJ3nHKPNaJwV?= =?us-ascii?Q?1WRVujqs8Fl437cmvnEAYxwWT/2uy6ep1J9c5wKamEm86hUS4wHezrbDpQ9M?= =?us-ascii?Q?SjvDFk947OyhW8pPrAqMe6ZTPEufnhaCkcUDwBHL8ynqCF9G5ZaqG+3Q+VxB?= =?us-ascii?Q?nQbOUtnh/qLMfcUdl5wXNvh6Itu4FdYdJXuN+mhjMzSq/4CQhaiiIfNZSssj?= =?us-ascii?Q?xNOyDw5hQHsuUEK3boymEDzPoAiCuTs8gDYV8ldT7mcwMz49Oz6CQWhS1P6R?= =?us-ascii?Q?871OSG1kCq2gCNGJlHWLNTQszWo2tzIX3Z41fIyzfHxcgvAR19CXD3+7OKlG?= =?us-ascii?Q?0sv1oYCcSkxiEyxTGrvB4pB7yKfUCfEB0ApOkcGZbjKnkA=3D=3D?= X-OriginatorOrg: oracle.com X-MS-Exchange-CrossTenant-Network-Message-Id: 9799ddea-3406-43d4-d2ee-08d973d9f68b X-MS-Exchange-CrossTenant-AuthSource: SA2PR10MB4458.namprd10.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 09 Sep 2021 21:37:03.2376 (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: hLP04KviHogkFD+5Qo5IpN6dXv8mYVTsCVfj5tZej/PyPuRv3THjaa6iFK6Yk7FsX1ooNKdBn64ronGtn0nzKQ== X-MS-Exchange-Transport-CrossTenantHeadersStamped: SN6PR10MB2607 X-Proofpoint-Virus-Version: vendor=nai engine=6300 definitions=10102 signatures=668682 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 phishscore=0 bulkscore=0 mlxlogscore=999 malwarescore=0 spamscore=0 mlxscore=0 suspectscore=0 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2109030001 definitions=main-2109090132 X-Proofpoint-GUID: UZmvZFrHMvsnG_I10j_pcweLEFpsP2pn X-Proofpoint-ORIG-GUID: UZmvZFrHMvsnG_I10j_pcweLEFpsP2pn X-Spam-Status: No, score=-13.2 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, GIT_PATCH_0, MSGID_FROM_MTA_HEADER, RCVD_IN_DNSWL_LOW, RCVD_IN_MSPIKE_H2, SPF_HELO_NONE, SPF_NONE, TXREP autolearn=ham autolearn_force=no version=3.4.4 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on server2.sourceware.org X-BeenThere: gcc-patches@gcc.gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Gcc-patches mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 09 Sep 2021 21:37:08 -0000 This commit adds documentation for the new BPF options -mcpu, -mjmpext, -mjmp32, and -malu32. gcc/ChangeLog: * doc/invoke.texi: Document BPF -mcpu, -mjmpext, -mjmp32 and -malu32 options. --- gcc/doc/invoke.texi | 39 ++++++++++++++++++++++++++++++++++++++- 1 file changed, 38 insertions(+), 1 deletion(-) diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi index d4b3a66ee4f..66f69cf161f 100644 --- a/gcc/doc/invoke.texi +++ b/gcc/doc/invoke.texi @@ -904,7 +904,8 @@ Objective-C and Objective-C++ Dialects}. @emph{eBPF Options} @gccoptlist{-mbig-endian -mlittle-endian -mkernel=@var{version} --mframe-limit=@var{bytes} -mxbpf -mco-re -mno-co-re} +-mframe-limit=@var{bytes} -mxbpf -mco-re -mno-co-re +-mjmpext -mjmp32 -malu32 -mcpu=@var{version}} @emph{FR30 Options} @gccoptlist{-msmall-model -mno-lsim} @@ -22636,6 +22637,42 @@ Generate code for a big-endian target. @opindex mlittle-endian Generate code for a little-endian target. This is the default. +@item -mjmpext +@opindex mjmpext +Enable generation of extra conditional-branch instructions. +Enabled for CPU v2 and above. + +@item -mjmp32 +@opindex mjmp32 +Enable 32-bit jump instructions. Enabled for CPU v3 and above. + +@item -malu32 +@opindex malu32 +Enable 32-bit ALU instructions. Enabled for CPU v3 and above. + +@item -mcpu=@var{version} +@opindex mcpu +This specifies which version of the eBPF ISA to target. Newer versions +may not be supported by all kernels. The default is @samp{v3}. + +Supported values for @var{version} are: + +@table @samp +@item v1 +The first stable eBPF ISA with no special features or extensions. + +@item v2 +Supports the jump extensions, as in @option{-mjmpext}. + +@item v3 +All features of v2, plus: +@itemize @minus +@item 32-bit jump operations, as in @option{-mjmp32} +@item 32-bit ALU operations, as in @option{-malu32} +@end itemize + +@end table + @item -mco-re @opindex mco-re Enable BPF Compile Once - Run Everywhere (CO-RE) support. Requires and -- 2.33.0