From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mx0a-00069f02.pphosted.com (mx0a-00069f02.pphosted.com [205.220.165.32]) by sourceware.org (Postfix) with ESMTPS id 21D36385842B for ; Wed, 27 Apr 2022 15:51:49 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org 21D36385842B Received: from pps.filterd (m0246627.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.17.1.5/8.17.1.5) with ESMTP id 23REpA5q015535 for ; Wed, 27 Apr 2022 15:51:48 GMT Received: from iadpaimrmta01.imrmtpd1.prodappiadaev1.oraclevcn.com (iadpaimrmta01.appoci.oracle.com [130.35.100.223]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 3fmb9asf9g-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Wed, 27 Apr 2022 15:51:47 +0000 Received: from pps.filterd (iadpaimrmta01.imrmtpd1.prodappiadaev1.oraclevcn.com [127.0.0.1]) by iadpaimrmta01.imrmtpd1.prodappiadaev1.oraclevcn.com (8.16.1.2/8.16.1.2) with SMTP id 23RFon5u019239 for ; Wed, 27 Apr 2022 15:51:46 GMT Received: from nam12-bn8-obe.outbound.protection.outlook.com (mail-bn8nam12lp2169.outbound.protection.outlook.com [104.47.55.169]) by iadpaimrmta01.imrmtpd1.prodappiadaev1.oraclevcn.com with ESMTP id 3fp5ym54rq-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Wed, 27 Apr 2022 15:51:46 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=cryZ6UuM3vk03C/Vc7z5m/EENBPHfeGVE2QUWyYIVj7KDfQV5L3oXNoJRQjpu2MsR4sAZupw5YqeZP85cLv2OVUXklqmauUkLMosmIPokxA3yQnkd5O3vPyC3TJN3v+Fwt4NtfsOkm2YBloM3rP0AH//sBt1Ve9NPBJNs3X6Ec0iNTJDBuGUh2JVN0Qiia3oVsqpXczGOUKzeZGmv/renTpGjgqK/+WGxcl7pCUti4uNyE3KVt/sNQg4nE5k2ar0nU9CkZKCMOPYb0/XrsBdGkC51nMTiyxuKcfXlErlLWiSWwuxOTu7dsSRDWzF/dSbWK321W3qjmo+qiIhPwHEYA== 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=iqYNbIdV48rH802XWfyXtYPyagQkyZfaMTYTb1eVjVg=; b=SkcdFWevqrlnIrvwXACP6ZY3I2mdYlb9Cn1C9Rou6QLyYyBaBjNqRmFuIQnS1opmYVZP8ctq93dNuW46BVRq+Ojr+wgTMCjnW/rkhyW9AJJlHqG9HHDAqlOTnKMX+wrYEpWUK/xQ0LGzDqgxRWr3sqVSTtRYRtbdUAQtiJ27CRtWfsoNoargJkyHis57GtF5w1v4/Thq+2pKi3IVz2vPXDmfakcvG78ujd8Z+qNwjZRFGScBAbNekdyZmtOoi4CfSF29shiC5HcmtwKXhpaeBoBVNv9tbY0z3cYFqoL2RiSni3U/hepA7QLFT8nfSD2QGti+MtaKZeyY+UOFHniG0Q== 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 SA2PR10MB4715.namprd10.prod.outlook.com (2603:10b6:806:fb::10) by DM6PR10MB4300.namprd10.prod.outlook.com (2603:10b6:5:221::8) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5186.14; Wed, 27 Apr 2022 15:51:43 +0000 Received: from SA2PR10MB4715.namprd10.prod.outlook.com ([fe80::c4aa:e093:f6cf:b111]) by SA2PR10MB4715.namprd10.prod.outlook.com ([fe80::c4aa:e093:f6cf:b111%5]) with mapi id 15.20.5186.021; Wed, 27 Apr 2022 15:51:43 +0000 From: Nick Alcock To: binutils@sourceware.org Subject: [PATCH 1/2] libctf: add a comment explaining how to use ctf_*open Date: Wed, 27 Apr 2022 16:51:29 +0100 Message-Id: <20220427155130.238504-1-nick.alcock@oracle.com> X-Mailer: git-send-email 2.36.0.262.gb007c8117e.dirty Content-Transfer-Encoding: 8bit Content-Type: text/plain X-ClientProxiedBy: LO4P123CA0120.GBRP123.PROD.OUTLOOK.COM (2603:10a6:600:192::17) To SA2PR10MB4715.namprd10.prod.outlook.com (2603:10b6:806:fb::10) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 55a86c60-07ac-4b73-c20b-08da2865d385 X-MS-TrafficTypeDiagnostic: DM6PR10MB4300:EE_ X-Microsoft-Antispam-PRVS: X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: dGfRdExWmPH/BhEdfFDvi5+V91Ddy5htSJSGDYOxKfx+XDJ2aLXlTvwh4mqM7pbDeJO3TTDnMjnFLwY2C0BhBCavw0OBGEv+qba69GOu77updRUON/SBJssO3Nr68rpLCyxklHOkLaYD0+a2w/zJvpOyiR9odInTpQtF1tPXVgrG48ffPXkcqTJ8S+abE0wIiLgpTEaKjQwnfE2Z9mnJeyot0cx39VUR4MuVehfbboUuHM5Ij2rqXbeHSX3cJsHYlqMxWRUoSRnWULmG4gDWMU5xizJu7PZnxM4l3ZXEEv8IExL3cSrWIEnIEZq5Sq7OhI2OQ9ijdaB+avHg3hDxgUYcu2KbQeKnZkFXwquIWjvaEgpdMHquQxlJ5K6A6hELmfs/wBMM5D/XrLHKWNu1iT9LKeR9La3t5G3X8aSyhakBwHwUNoXidBPoPsurmQJWtOXclZYPMPhEHTLAX7DnhdnWvbjB8hfIMCItaC9+R9a+KMWex124lSwdn0sehFXVi01F6/yUaS0e2pwSIdvcc4cRNAob5Yj9RzDlkkF0vKgmz1ZB7UgPMoi464N9AsXOMzTqG2fWOmLOZnx41NspjKB/iA/F0n6Jwj78euzOTcMjIV0Gg+5id014uMR564+qFBU/7gAXoj4tYKa7KjW9Kg== X-Forefront-Antispam-Report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:SA2PR10MB4715.namprd10.prod.outlook.com; PTR:; CAT:NONE; SFS:(13230001)(366004)(6486002)(5660300002)(8676002)(66556008)(66946007)(6666004)(52116002)(1076003)(36756003)(2906002)(6916009)(83380400001)(316002)(86362001)(8936002)(66476007)(38100700002)(6506007)(508600001)(6512007)(44832011)(186003)(2616005); DIR:OUT; SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?GNevRLt9ZpjZrI5kTXzeGeSBkNgR4tTKx6oU269P5JpljmHbU42Nh+R72eN1?= =?us-ascii?Q?mprLqKo3PtnRbBczfhXD3VN+3lOZBaWgbL22LObl06eFlwc1fk8yCGIeUD/E?= =?us-ascii?Q?uaOYoMhF8U8DR3qTBc+BEH4Ge6IZBOXyvyOs2GbbLbgA3qTE7V+So7+BrQfn?= =?us-ascii?Q?XRRtha4lVF28hq5xOMzneduGPHCG8SbpLCzyjLmCrqhbBA5zW3q1Obfyu37T?= =?us-ascii?Q?FAQeWF9PgVswZYgUrQtxdOHiIV7SzUPsQPJfQxT31n/fA6PMApPCghDKZhb6?= =?us-ascii?Q?6TMO/XtaOLsAHqIPn3N08F+9lbjgN2KvHYf8dotJT9mTtde0m6H1UfbjFVHv?= =?us-ascii?Q?UrfVlyxpHh4X3RrIUuZet0fhNBjD19/O5hy5asI1zEx1hgBofNVu+B1UoxdO?= =?us-ascii?Q?0tn+cOX9+B7wCDdFjxQWrLoeP9xiv6KTtJzBHjYZacBqyYSzbKjoSwVptdk9?= =?us-ascii?Q?cSprPCzQAKKMHWBoSZ01aI6IwZnW2GCXC59a/v5GGuLKVeVhu5/AbiiYve5k?= =?us-ascii?Q?fepDcgNRycBzMYqDWRY7z3AqAd+qi8Lxftzab/91LfUXuZgT6th3G3t+m+iv?= =?us-ascii?Q?aDru42hYuygvUZ/uHOVzlIa9m4EqSVSxofGH9aaHM50EAq8OPeHqnWdN2Fv1?= =?us-ascii?Q?S4qLBsOarbJsVNYakJxebNbfgoSytYr5W6FJMKGy7yfG5aZ1J/g4ORo72yrN?= =?us-ascii?Q?bJx3dh/IQCegzCCllhCpDO8h+elrhIcnfR2Y45HWDrzrDIZVe8Yq8dM8HmJu?= =?us-ascii?Q?nY2W25v6M0hkg2fYgEv2g5NpN2Q2jVMPRJxTSl+7iheT7rssgWeUW29eOPOH?= =?us-ascii?Q?unV6olIrywrpYLID0TDTsEDeueVSELxZa3hQGwiTCG+5sZVEbZThA4P4SP24?= =?us-ascii?Q?4ipzv48YMU3Q3NZNlgyYRmwpGMDDjV9/0VOQsPON5f/YREyBbkgIa0/D0ZT2?= =?us-ascii?Q?8pkwhkM+s9vn0g08ucAy1LUbD7wnuHDrMAXQW6otV7nMPhI5LXR/ZJs+myLS?= =?us-ascii?Q?9oHz1nobX21FLe/lzntGtKvFnD6PnYg40JLXXnrgLl6M2buFFDjaLv87GsDq?= =?us-ascii?Q?UkN9YecJPqPQNLl9YWe+lxQGgUacNWjrjikInpZqn77B8nWKDJC/NbbNO/Vr?= =?us-ascii?Q?6tZJ0uLAMyroVWttm9E5UjoLvjfLReBZE632Tf4x5Y9P7IGsiO4y4IxcbsrW?= =?us-ascii?Q?kr+r0gBG3G0IqnQxZllHcetCjACKNA3so1KPsW8zm5mkVHUru0SbDsmu4kSj?= =?us-ascii?Q?8mp3IMOZc7W8PsAhTylvh9KVqiCIiNDXz2HDZfFm2LGGSPT1Hi4mJoKPASI6?= =?us-ascii?Q?pZlA6Xf0398/x35RhcleiX+plbg+j8XqYbZsrVf2bQvNeMCkwZ508XsBSM+U?= =?us-ascii?Q?EQ4Z1IXxfStOcOPGIJ++ZPABi6tdYz3QtYkZ+RQEt3Qfxwuf7KqVeth9ab7g?= =?us-ascii?Q?5BXkwM3wR9YJOrUbjiQ5cJXlM58sNaKOSY5rGLpZT46KSPHXICOQhJAWW7jC?= =?us-ascii?Q?SMbRTBdupkhcvu9HoQWlXjK4ZbKmlV1kfOWMt4nRmT5UMo6Ek6fa+CwaF21d?= =?us-ascii?Q?cz+RDZwkDINxZ3iVKSzA7WdXbTUxB+i33z+wbw6BNV2v9utk8ZpRPfegturc?= =?us-ascii?Q?tA63Naj75DV7THY5lZZQ+deOk/cl2rhN7YPSMx2Y0nJZRbucmL/Be6NvX2wK?= =?us-ascii?Q?2lsE6TCb19q4Y4GBkA7LIlDommuU3tsmm6XakkamOSfIwuC7aLMrg46VyT+/?= =?us-ascii?Q?Vrud0euH26B464h8r0KhEZUFijidHpQ=3D?= X-OriginatorOrg: oracle.com X-MS-Exchange-CrossTenant-Network-Message-Id: 55a86c60-07ac-4b73-c20b-08da2865d385 X-MS-Exchange-CrossTenant-AuthSource: SA2PR10MB4715.namprd10.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 27 Apr 2022 15:51:43.3162 (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: m6PeHdtGnDnmDWz3WsTTGaYaQyla3jxPG1W7LldlgWuyKK9i+gpW+Ecd1MQoeRne1y32Kx5jyP4qSjeo5wHzig== X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM6PR10MB4300 X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:6.0.486, 18.0.858 definitions=2022-04-27_04:2022-04-27, 2022-04-27 signatures=0 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 phishscore=0 mlxlogscore=999 mlxscore=0 suspectscore=0 malwarescore=0 spamscore=0 adultscore=0 bulkscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2202240000 definitions=main-2204270099 X-Proofpoint-ORIG-GUID: RaVF7Fr0Y28i0LSyiuG8G2nz39suhz-y X-Proofpoint-GUID: RaVF7Fr0Y28i0LSyiuG8G2nz39suhz-y X-Spam-Status: No, score=-12.1 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, GIT_PATCH_0, KAM_LOTSOFHASH, RCVD_IN_DNSWL_LOW, 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: binutils@sourceware.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Binutils mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 27 Apr 2022 15:51:52 -0000 Specifically, tell users what to pass to those functions that accept raw section content, since it's fairly involved and easy to get wrong. (.dynsym / .dynstr when CTF_F_DYNSTR is set, otherwise .symtab / .strtab). include/ChangeLog: * ctf-api.h (ctf_*open): Improve comment. --- include/ctf-api.h | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/include/ctf-api.h b/include/ctf-api.h index a3f45283b3c..153e012b5a0 100644 --- a/include/ctf-api.h +++ b/include/ctf-api.h @@ -314,7 +314,13 @@ extern ctf_next_t *ctf_next_copy (ctf_next_t *); archives: so they can be used to open both. CTF files will appear to be an archive with one member named '.ctf'. The low-level functions ctf_simple_open and ctf_bufopen return ctf_dict_t's directly, and cannot - be used on CTF archives. */ + be used on CTF archives. + + Some of these functions take raw symtab and strtab section content in the + form of ctf_sect_t structures. For CTF in ELF files, these should be + extracted from .dynsym and its associated string table (usually .dynsym) + whenever the CTF_F_DYNSTR flag is set in the CTF preamble (which it almost + always will be for linked objects, but not for .o files). */ extern ctf_archive_t *ctf_bfdopen (struct bfd *, int *); extern ctf_archive_t *ctf_bfdopen_ctfsect (struct bfd *, const ctf_sect_t *, base-commit: 531c82a1c724079f98a4b069584681bc66da4dae prerequisite-patch-id: 40f3e06181aa2cd54d4058e4b944a0d824f34f5f prerequisite-patch-id: ef340a27f17470fb0544c063de87f3ae7de4dc2f prerequisite-patch-id: a12de7cf51d1cfd6e9a1c61e851faa359cd3982b prerequisite-patch-id: 2d39fffbdcc72a054184df623f9114f94b88cb64 prerequisite-patch-id: d55d8059be2d51962acc2e23a39a3921a3801199 prerequisite-patch-id: 3e0eea8043e3cd045779e30c375fe394c804c48f prerequisite-patch-id: 4cb4bb30adb35d6ac591905c68c68c58fda191df prerequisite-patch-id: 67d77176340cb47cc336c747a800d5748377136e prerequisite-patch-id: c7fb48d926d5923680ecaa4e96c0d59891a751d3 prerequisite-patch-id: c097df29724255c0fcb3cbb4e33a1dd642684b5d prerequisite-patch-id: fd1a706540f1780c1255b67784022e6268df3e9c prerequisite-patch-id: 75b6b1d5cc24d11fb29cb0aa49a68e0fa9c402d6 prerequisite-patch-id: 644c13ece37062694e37224fb16d00947e3524c5 prerequisite-patch-id: 3900eda69a5ff8250d3372782e44de3053b3ba38 prerequisite-patch-id: 41947744e6c79fc3cc26e8dc3eb51812de7cd37c prerequisite-patch-id: 4a566d02b8eb6d2fd01b305351e36b3b2fe300e0 prerequisite-patch-id: 47209dc4f1399290516ac8b96025f1984f887064 prerequisite-patch-id: 222cb080fcac03241c54f8ed254be5a441a1027d prerequisite-patch-id: 8c2928f8cbff1d26e720b29a00ae824b26eb117d prerequisite-patch-id: 026fe4a5b3a6e9e6824e68c3d6087bd560eaf404 prerequisite-patch-id: 0d678e933f28036e84cee8821c14db5d3a8c45f4 prerequisite-patch-id: d6c6a72b62a8b5e1a077f0578f592db9661e6271 prerequisite-patch-id: d318154951de43543c99211c5f518f478d68cebb prerequisite-patch-id: 2c07a379863a0ea6d9b2a0a8158bb8920284241c prerequisite-patch-id: 616d6d785dfaf8825cc55a3aeb8519e8e58569c3 prerequisite-patch-id: e8487d714c5a4b2a318b982913280255175b7698 prerequisite-patch-id: b3b209d80b57ab95d259834502f897f4636ee16a prerequisite-patch-id: 1ce23787a13f7bdf114bc78b4cc220335af4fab2 prerequisite-patch-id: 3e20d1754c62887e0d4097a3f5dd094d15884206 prerequisite-patch-id: fbacee4a6adf081d67aa4b7c0106dc9b135b815f prerequisite-patch-id: 4b5ce20b8eb1d5be0f9e4350099788ae8e86640d prerequisite-patch-id: 9a1e4134e43425877a1d895d618496fff2f1cf3f prerequisite-patch-id: 865cb1e5d11a00ab80aa4d8e4d1d33a887604982 prerequisite-patch-id: 4a80fbe279c2876b89cf795a032ad5f15d1a85cb prerequisite-patch-id: cb2824b2c24303c0ba461c0dd9d82f7d618aeacc prerequisite-patch-id: c490a4c4622b5229db11ebbc92d2bb4be6059290 prerequisite-patch-id: d49351257b621ee89ecb9253e375d87d452dd2ee prerequisite-patch-id: d14e527f602406060dfe3c7bec7bc398b79d6b52 prerequisite-patch-id: d72cfacadcb022988856538304efbf233762a209 prerequisite-patch-id: 4b42cc9effa21721b820c472f3aa96a526d183d8 prerequisite-patch-id: 8e3a539b1c19cc66f0517ffdda2faf5483e0cadf prerequisite-patch-id: d6b6641d5d50578518a5e66af864c28d6f5e135b prerequisite-patch-id: bd49be55da65d3c0834589edcc968a2a3c69ac8a prerequisite-patch-id: 9ed22b370da901499115758ec10e74d273bb944c prerequisite-patch-id: e7c4f1809a3f293d479d2bb0721d5afcbbd2fc8f prerequisite-patch-id: 07f52003a2ca2835cc1c48ab0523407027f737e4 prerequisite-patch-id: 5c6fcade90b1d7162810dd0b443363cb95ebe8ad prerequisite-patch-id: f8c92965ab50137dce4da03f254791bd1e99ca7f prerequisite-patch-id: 4952d7a2b2c9c999a29b7a0a977a8eaadbfd9c02 prerequisite-patch-id: 8ed93cc1f7e353cbf163f80ca6215dedf07524f8 prerequisite-patch-id: 0895d195998daf64e76003c8d8ca5f9657224829 prerequisite-patch-id: 49f2256590c40b9dd5b95053ff8e4b1ef63aab67 prerequisite-patch-id: 7638b29752342802329fe57895cb1960c5e63d8d prerequisite-patch-id: a57258c269449415ff3373ce7e945d828ed2f70f prerequisite-patch-id: 9dde5b4ca08a773e6d06aeffecde66ec7fc929b0 prerequisite-patch-id: 6616cb7d3be8b5d9777c0466f66671ab8809aa11 prerequisite-patch-id: 2098f5adc7e1a8e9700792796199f05864959594 prerequisite-patch-id: 058d42109d27390e1b71cc9561912a9ae3cc3ab6 prerequisite-patch-id: 84815b17d444e7e56dbff36e001392f9a79820a2 prerequisite-patch-id: 137d760d9dc554d7de70f1539a921dfe78843f61 prerequisite-patch-id: dfab5bd8525ebe14c776b582e5ea068ab133b249 prerequisite-patch-id: 205325a14cbc4fb3a87c48a486d263f02a80dd1f prerequisite-patch-id: dcd841b94b3e691a4fb73a2d6ca8699efb704906 prerequisite-patch-id: 43231ba369f10d25b371699a174cbde625ce1dd8 prerequisite-patch-id: 02008197837e16c30f60ac8f29816e4f34402736 prerequisite-patch-id: 8b9ab351f553f84cdd31ea5cad0c2965943a4f56 -- 2.36.0.262.gb007c8117e.dirty