From patchwork Wed Sep 15 21:03:00 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Diane Meirowitz X-Patchwork-Id: 45061 Return-Path: X-Original-To: patchwork@sourceware.org Delivered-To: patchwork@sourceware.org Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 2EB653857C6A for ; Wed, 15 Sep 2021 21:04:19 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 2EB653857C6A DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gcc.gnu.org; s=default; t=1631739859; bh=R4T/HoIc6cU6EywHIiGjiDNqZftjK8wB0gY8TnRsxMc=; h=To:Subject:Date:List-Id:List-Unsubscribe:List-Archive:List-Post: List-Help:List-Subscribe:From:Reply-To:From; b=Q5j67itMHEbHDhQeD3WzFqVEnS2ihRi9f1U8qR/Isq0tv02eUllsYhCLf8BVMGicb P10cuMN5CotAtbcaXpP46/pPs3riiY4z7VGy1Bzr2h4/FS56ghiYJNqjC1Skatz6cL jXharmE5E4y6fLkj3sFCmIOiqY31m7y1mcQWYG8c= X-Original-To: gcc-patches@gcc.gnu.org Delivered-To: gcc-patches@gcc.gnu.org Received: from mx0a-00069f02.pphosted.com (mx0a-00069f02.pphosted.com [205.220.165.32]) by sourceware.org (Postfix) with ESMTPS id 79D11385780F for ; Wed, 15 Sep 2021 21:03:04 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org 79D11385780F Received: from pps.filterd (m0246629.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.16.1.2/8.16.1.2) with SMTP id 18FJxUDq011491 for ; Wed, 15 Sep 2021 21:03:03 GMT Received: from aserp3030.oracle.com (aserp3030.oracle.com [141.146.126.71]) by mx0b-00069f02.pphosted.com with ESMTP id 3b2pyge2aq-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Wed, 15 Sep 2021 21:03:03 +0000 Received: from pps.filterd (aserp3030.oracle.com [127.0.0.1]) by aserp3030.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 18FKuaB6080722 for ; Wed, 15 Sep 2021 21:03:02 GMT Received: from nam12-bn8-obe.outbound.protection.outlook.com (mail-bn8nam12lp2172.outbound.protection.outlook.com [104.47.55.172]) by aserp3030.oracle.com with ESMTP id 3b0jgf5vsb-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Wed, 15 Sep 2021 21:03:02 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=XHFI6ZDeXT1h0YSRzXq9EP8+1LEp7aGu0R2g56stE6rd21f11N5oxXkhFdeGKNIqT2jXT1LpeZ4OtLuQJpwng6cWbI9QvmhS1Ln2RjhpqFQli3n6GpvIuLIP2xNFm+FRfNLZLAyjw9SEA/06MFvoI869fVfs9iS+gQcXFfFqZs9CV90PffEN6nVFj25OeFDx9/BaQ7O8Mo/g/FVDhFA2Id2TIl67TtK0mxDpgkR7v6hTdjtoRvjkpWSjb/4gIuNzMNVZ99rkv/xLNec4efHlWo1KkhSTSVVLj2FegkZUv/C7IJpUtgP4shaovtNyMMTfw8BPqq2z5LxUKevZplI5og== 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=R4T/HoIc6cU6EywHIiGjiDNqZftjK8wB0gY8TnRsxMc=; b=fuJBt/lPo0KNH68XTnYimsrr7hEt8N4OYKqIwdOQmjxvuXMKWrE5IQ33A1RzzQ2kKG3nPVC/1Rx8UULyuKMBU61dWH1umRr1b3Ok8PZiCJr9SWvblREEyI3hXg2vww2ZxAVxye/VAcU0CFWBVeVh/ve68IJZH6myco4/Y4ynlfyIoWjGWM3hncc9QTGLC5aYWw/QYYMWK8I3dXKem9skrsKsWDcU9OzB33Mt1adwFbkgYezkxMY2UHtRS/VX3wIZkoTEHn5EXqsdo9NOhAafcTMDkPaG824VtHzSNLY5sFnWtc2XYPwZ/PIaJpsEJlHDTeAMMegMaUlaxdFu2nR6aw== 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 MN2PR10MB3693.namprd10.prod.outlook.com (2603:10b6:208:111::24) by BLAPR10MB5091.namprd10.prod.outlook.com (2603:10b6:208:30e::20) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4523.14; Wed, 15 Sep 2021 21:03:00 +0000 Received: from MN2PR10MB3693.namprd10.prod.outlook.com ([fe80::818d:52cb:d41a:3970]) by MN2PR10MB3693.namprd10.prod.outlook.com ([fe80::818d:52cb:d41a:3970%7]) with mapi id 15.20.4500.019; Wed, 15 Sep 2021 21:03:00 +0000 To: "gcc-patches@gcc.gnu.org" Subject: [PATCH] doc: improve -fsanitize=undefined description Thread-Topic: [PATCH] doc: improve -fsanitize=undefined description Thread-Index: AQHXqnUQdzhWLqCV0EahLC1s9EDcyw== Date: Wed, 15 Sep 2021 21:03:00 +0000 Message-ID: <81A13911-15A6-4410-97EB-63F30807A764@oracle.com> Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: x-ms-publictraffictype: Email x-ms-office365-filtering-correlation-id: 2d821837-cae9-405a-95ef-08d9788c3391 x-ms-traffictypediagnostic: BLAPR10MB5091: x-microsoft-antispam-prvs: x-ms-oob-tlc-oobclassifiers: OLM:6430; x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: yR9xjMqNBJ0hWAQR/SpxSHrmx7XltmoSDDl1tl2BAp8bN1XDQ89W2uAXcyG+Kv2x0OniXHPv0tGA4oXYd20Pu+8oMFsH9sfm8Mui5X3dPbzjLgzcEoCXqS8SOJ/YE8cEWzUtjrwsH4P39sFbThV2hbuS+D16yVw6yF/lpeE8zZl/WdSfZNQTfRl6jz0hq8HvyQotr11n266st8rOigiXZm2QI7+G+9mgkUjfBXiy5RUhGM6aJQtUQ3yup9E93RpoqMZX0uOfSEq0emVdgDoUEqJyl4DcM508XVOMe9H8GokDYDX80lMAd0dRqYo0X8DU9HJda6gLuxHzKTC/GyfDHnKnStRVqb4Xjp403bZAqg1H9nSQyoHkB1y83fbmxcc9XtCyyyMbnLsW5NuaI12wiK02V4yGXRyZBdsjHpcA5+CrAHVpybFmUWWNjYP2cUf6s9sHrF9u8JqYM+IoIxqDhwZ1J/zySOeBo9dg9R/ACe4kCe0RRmXYtnXSdoRlKWgS1k2JfnORpXJtCkFZso6QstH5SnUdtjpntUOucCZzcOBFz1H7TjjB5BUhX9XYWw6RIDHyHBW7L3UrWn7OSQ6aQA3x4s5NFQOlF2VQieZdNXV+YQvbIH3danM1lHGCKFHRPQJWNjXjH+4VPaGnAfvIGK+loBbUJcrLLnHxgo3gOgS2i2i0yXDhn2dtAfC1Rt4jXMhaFlDSR8dyJAWLGm+Tfd0+CxaNpGAw3oVwO295ambHhM9o9yjWpQxJ2/POwzTPBiFTMs/enQ35SgP5YCPfwlpganCObMRMSBf1rrA64aOHGFKsXglLkuOk/0ddt4IG5rgA4N5jibd3YQzc4nABUw== x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:MN2PR10MB3693.namprd10.prod.outlook.com; PTR:; CAT:NONE; SFS:(366004)(39860400002)(376002)(136003)(396003)(346002)(36756003)(38100700002)(33656002)(86362001)(8676002)(122000001)(38070700005)(2906002)(2616005)(316002)(6512007)(186003)(8936002)(5660300002)(478600001)(66946007)(76116006)(91956017)(6916009)(83380400001)(6506007)(4744005)(44832011)(6486002)(66446008)(66556008)(64756008)(71200400001)(66476007)(45980500001); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: =?utf-8?q?n6Veh/yzbw8UYuYhKSg+vFJ+DpgH?= =?utf-8?q?4hpiNp1cex+l1TyC2Q4YZAijD2QEqfKiL090xVI1Z7V28SL1azTcsxZUurt+lO4DZ?= =?utf-8?q?ym2D/5BHHObyszgesrjT/wMovd7n6OqWtf4yo2mT7ieP69P/qtZ2p19V3S/+Dvf8a?= =?utf-8?q?9kS1r+8yRvodk0x+ddGtZDjLmWc4OPe88azZtHocgocTnSRDqbToLXG53HybnUJTI?= =?utf-8?q?BVltVMBeqsLTpdV9sglOATf2gC7VntlwqAkJ6MhOw8atMIOtRQKxUEHjTppJmjfsl?= =?utf-8?q?AQ5vR/8IK/78G0H0wy2M94kbyi8IWD3byq7vOOqLMpPCfXX20URPWTTXnceG4jSUf?= =?utf-8?q?eg0EbEuS7KKkwkAYZ7mlyKXxQBE27U8RikUZyufLq2dWweQbqyOJnhLmbIf2PaOh0?= =?utf-8?q?Pz08I3NTk30UwdMBTL2Q2XjOmnV9zpit8zHtgLhXyCYwgKthG5v9BFrrXfwHZD2Fs?= =?utf-8?q?z2B3wcw/TBicz7fWvklazojnchUGT9K1Z5JNhWBqNrpHz0WtqZVamkQlpfoSognOd?= =?utf-8?q?92EZOJjxf2+0Hp1az+RfF/8GJepSy7SXTgYE3pyfj/G6/NljjxtWRb0/JeYmevuiA?= =?utf-8?q?0hza6ljpbbPz+MKDtdnTjNq5MJXGaBVfSW+NHtkJUbXTlqMbKcndQ8gfzmJTJhezP?= =?utf-8?q?9J0XaJ9cDZ/GDEHicTwREDmd3yLyY9oiPtfEuswk7KNXIT+ELTM+MhEAed8ziaZRY?= =?utf-8?q?FPhCGM1KhB0sIvMX8K1Drt4wBIXGkY5F/eQ9AIrrkxN3ZloAWqSqw20UYffCKbySn?= =?utf-8?q?CkAgp7uiUSs9SYxzrS83zZuSWTa7p6znTAeDOmUSVrVSc1kg6/9UN9Gm8LNi20oIg?= =?utf-8?q?XIuS0P29mo+9ZMdG6oYDOSV08HwL2kRjtLyyXl6U5AEAUL9lzIGhLzkBLBXX0bFuY?= =?utf-8?q?KHQK/d4Xsd5GJX+5khyPQW1/7/rCm0KAKDJYOoiNJBIw+EciTaGL3LpnWI1TG6amL?= =?utf-8?q?UwnbovqPvpy1ix0DQmb987n55XHrCvO5aH8cxW+zjtSAuzLczTFFiwmM+SyNphBGa?= =?utf-8?q?uzosDnDNra9i4vixk0q/fYHmuM5hT2/C9vXNm/YSW3ro6oWo1xBcLSQKqkrU3fYiO?= =?utf-8?q?UvVImZbOau1HuPKgh/KpX6EpnHRt4J4q/h7gKB/fMFarRRQHKE/mnbY9dlj/sVcd3?= =?utf-8?q?OacVbiyCXb4X9RcMb+iN0bs+t3e2MMRFpH/1mRR0OFKD0xidWlRKWXD5mnpd7qTmR?= =?utf-8?q?RXz4uHU/ledNQo4Kl40vl7ZthVVfpDQPf9APnTO9lvMaYPgUYeT9xrogQC/VEYeJs?= =?utf-8?q?WDCs/esnQ/vUUg+6f2D6SUwH5yR65DdLxiDWBRxB/6dsxkOUJDsZ0HDdgf8=3D?= x-ms-exchange-transport-forked: True Content-ID: <63302426FB950D4092613E74A539135C@namprd10.prod.outlook.com> MIME-Version: 1.0 X-OriginatorOrg: oracle.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-AuthSource: MN2PR10MB3693.namprd10.prod.outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: 2d821837-cae9-405a-95ef-08d9788c3391 X-MS-Exchange-CrossTenant-originalarrivaltime: 15 Sep 2021 21:03:00.4150 (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: be7maMMngY/dU2YYdyxQOkmXo/+Td5AVP2yn1gKzSIwv3Uqt33Cjuq2OWddvB/GiB8RU6C49MeZQJ5Cf+dSkA6i/fhlvMGt3ESPJxkXHNRc= X-MS-Exchange-Transport-CrossTenantHeadersStamped: BLAPR10MB5091 X-Proofpoint-Virus-Version: vendor=nai engine=6300 definitions=10108 signatures=668682 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=0 mlxscore=0 mlxlogscore=880 adultscore=0 bulkscore=0 spamscore=0 phishscore=0 malwarescore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2109030001 definitions=main-2109150120 X-Proofpoint-GUID: Pf9EO5AevDPYdIbN40rGHhmi210G-864 X-Proofpoint-ORIG-GUID: Pf9EO5AevDPYdIbN40rGHhmi210G-864 X-Spam-Status: No, score=-14.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_H3, RCVD_IN_MSPIKE_WL, 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-Patchwork-Original-From: Diane Meirowitz via Gcc-patches From: Diane Meirowitz Reply-To: Diane Meirowitz Errors-To: gcc-patches-bounces+patchwork=sourceware.org@gcc.gnu.org Sender: "Gcc-patches" doc: improve -fsanitize=undefined description gcc/ChangeLog: * doc/invoke.texi: add link to UndefinedBehaviorSanitizer documentation, mention UBSAN_OPTIONS, similar to what is done for AddressSanitizer. diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi index 78cfc100ac2..f022885edf8 100644 --- a/gcc/doc/invoke.texi +++ b/gcc/doc/invoke.texi @@ -15200,7 +15200,8 @@ The option cannot be combined with @option{-fsanitize=thread}. @opindex fsanitize=undefined Enable UndefinedBehaviorSanitizer, a fast undefined behavior detector. Various computations are instrumented to detect undefined behavior -at runtime. Current suboptions are: +at runtime. See @uref{https://clang.llvm.org/docs/UndefinedBehaviorSanitizer.html} for more details. The run-time behavior can be influenced using the +@env{UBSAN_OPTIONS} environment variable. Current suboptions are: @table @gcctabopt