From patchwork Tue Nov 28 19:58:09 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Vladimir Mezentsev X-Patchwork-Id: 170930 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:ce62:0:b0:403:3b70:6f57 with SMTP id o2csp4188308vqx; Tue, 28 Nov 2023 11:58:39 -0800 (PST) X-Google-Smtp-Source: AGHT+IFH6WGNLaO4UkR6dA66uRdMK7CvJ5kUb9njN//LonKA2cV9/MtoKbuJ3i+INrOfhtvl1N2S X-Received: by 2002:a05:6358:52ca:b0:16b:fe18:27fc with SMTP id z10-20020a05635852ca00b0016bfe1827fcmr15330078rwz.31.1701201519068; Tue, 28 Nov 2023 11:58:39 -0800 (PST) ARC-Seal: i=3; a=rsa-sha256; t=1701201519; cv=pass; d=google.com; s=arc-20160816; b=On7XPvzDo5TkrJn/hjZSVwHlUBc7/zGLGwkmgrQZOtVt3XwM3wGgtbFZ5mVJucUbqy Xw79Oth7RpYqt6T49fARvaQwQi8j53BgdnDdEp8DIvuy5PcQLitiKuPzC9OS7B+3/KPp NiCtRlvlOKvZ87zhmp/6HwwGhNJRE6pJLbjPw/nArvTAReZTzYN/iVPYQgS2Pnnf22WA gA2z4HxpthUyBNjVqImnzBpEy6ESpw2/Ywv4DiFydR2aFPKOwDOr86IKMJkpXomPuaZ2 BkN6KsOMT/TEFSp1E2x3eVzGHXKnvAilap4dWr4bND3WLGAnk3yMdlB+oQyAq/NCRj9l z3+A== ARC-Message-Signature: i=3; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=errors-to:list-subscribe:list-help:list-post:list-archive :list-unsubscribe:list-id:precedence:mime-version :content-transfer-encoding:message-id:date:subject:cc:to:from :dkim-signature:dkim-signature:arc-filter:dmarc-filter:delivered-to; bh=7/T5rYqYvfu4QoMfCnK88pE9e7baRRz/gTRJDq6fyvM=; fh=rGgRskdXqkw/EDUeDqnE3q/qQuWE7ZzID6eKNBELT+8=; b=v95VUHTfBMb4zUqNTkltfiNSAZ20V40lzqhIrcDwNM4T6FZQBFpGbqnGlmE8am7wPy Z+DnUxNPT2a1d9KCuEG25uqCyiu3aXGDbrDi+g6EsIGhb+I7NJlHtkcPWuAoR80/GVMI oGyXWMG+uZsxn6j0ZJieGIEfa3S3haSCJxbxnS5dsGFnqRKYo8D+GnqhwYBXvET8P2qF 2sr0iG8yFLboaXNJ4hQwqImVq4UVweOlS68qV4OGeOiolnbh8RzVDbUSyZ/yIHn3dEk9 3YQRbUpFeO8vDPRbyhRlSJhewmXrOETbedv20RK2vDvK90evG+ak5AKyJMvyMspR+mLH 66eA== ARC-Authentication-Results: i=3; mx.google.com; dkim=pass header.i=@oracle.com header.s=corp-2023-11-20 header.b=hgzzyX4O; dkim=pass header.i=@oracle.onmicrosoft.com header.s=selector2-oracle-onmicrosoft-com header.b=lsIlcm19; arc=pass (i=2); spf=pass (google.com: domain of binutils-bounces+ouuuleilei=gmail.com@sourceware.org designates 2620:52:3:1:0:246e:9693:128c as permitted sender) smtp.mailfrom="binutils-bounces+ouuuleilei=gmail.com@sourceware.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=oracle.com Received: from server2.sourceware.org (server2.sourceware.org. [2620:52:3:1:0:246e:9693:128c]) by mx.google.com with ESMTPS id n6-20020ac85a06000000b004197d8cff5fsi11491184qta.612.2023.11.28.11.58.38 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 28 Nov 2023 11:58:39 -0800 (PST) Received-SPF: pass (google.com: domain of binutils-bounces+ouuuleilei=gmail.com@sourceware.org designates 2620:52:3:1:0:246e:9693:128c as permitted sender) client-ip=2620:52:3:1:0:246e:9693:128c; Authentication-Results: mx.google.com; dkim=pass header.i=@oracle.com header.s=corp-2023-11-20 header.b=hgzzyX4O; dkim=pass header.i=@oracle.onmicrosoft.com header.s=selector2-oracle-onmicrosoft-com header.b=lsIlcm19; arc=pass (i=2); spf=pass (google.com: domain of binutils-bounces+ouuuleilei=gmail.com@sourceware.org designates 2620:52:3:1:0:246e:9693:128c as permitted sender) smtp.mailfrom="binutils-bounces+ouuuleilei=gmail.com@sourceware.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=oracle.com Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id B39F338768A1 for ; Tue, 28 Nov 2023 19:58:38 +0000 (GMT) X-Original-To: binutils@sourceware.org Delivered-To: binutils@sourceware.org Received: from mx0b-00069f02.pphosted.com (mx0b-00069f02.pphosted.com [205.220.177.32]) by sourceware.org (Postfix) with ESMTPS id 8984D385783B for ; Tue, 28 Nov 2023 19:58:23 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 8984D385783B Authentication-Results: sourceware.org; dmarc=pass (p=none dis=none) header.from=oracle.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=oracle.com ARC-Filter: OpenARC Filter v1.0.0 sourceware.org 8984D385783B Authentication-Results: server2.sourceware.org; arc=pass smtp.remote-ip=205.220.177.32 ARC-Seal: i=2; a=rsa-sha256; d=sourceware.org; s=key; t=1701201509; cv=pass; b=TA9H28bsx3GQPjET1wM58AOgF59JFT7ff0Oo84EcoVM15etSZ1irJzuJaGKOkVBRGv0kfdgh2vhX4QtbjySrVBNh8FGpA0s1K/QmA+EC3bmy8aV2UGe0OSsrSild+IXQTXj8AC7/afBPxQIVr/wLdedk0DiR83FGbes+6OJ6Xs0= ARC-Message-Signature: i=2; a=rsa-sha256; d=sourceware.org; s=key; t=1701201509; c=relaxed/simple; bh=XzyytifIE1/LyOHcFgGoQLzGt9yxNvrlD34YM5mMjhQ=; h=DKIM-Signature:DKIM-Signature:From:To:Subject:Date:Message-Id: MIME-Version; b=Pn+RM8J2NqnpGJOFF+J93EJvat+4FpHdTl94WTy2iUGNUg2ibdLTlH6NqM5DnI/lgqkyGPzNKeNoGhxUNo9tdpaJpVgVyiM/Ka7v/xef7CR59x+n2kJUHsdXL9q4SC9I3+OXWNrwzN+saIE/kWgJ1iGCrx3yekqWYZfBO6B59bo= ARC-Authentication-Results: i=2; server2.sourceware.org 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 3ASHwuoP026432 for ; Tue, 28 Nov 2023 19:58:23 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-11-20; bh=7/T5rYqYvfu4QoMfCnK88pE9e7baRRz/gTRJDq6fyvM=; b=hgzzyX4O1RRGC9q4QCfdbwD74GsBpE9c9LAiqPjvjY6N6Ldi98n5RsldYTyREfkSRaQA L1v0v8Ayp0WZ/B19YQ9GeDeeMZYW0d864eINdrTPVLeZ5wTKcL4c8xkft/x5mYayXByE HydD9xeI2TqMPJx3xE4IT276bkVtMEE9uhO5Bx1CSTwtiTn0WOgrA4Xwpcn6oElYYUg+ yatKFCkDqc4mHGf5HGWJZWyali7IXBeP/IAkq/2ea+hWiCKxl3VlhjjK+D4klidfL5Gy PbLnX8IEwPwHRPrjrcdXrkt7rQcIcgVXnqKbMsb1pykihXV5YEyH/n3omczhNkVZefBl bA== Received: from iadpaimrmta02.imrmtpd1.prodappiadaev1.oraclevcn.com (iadpaimrmta02.appoci.oracle.com [147.154.18.20]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 3uk8yd6uuu-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Tue, 28 Nov 2023 19:58:22 +0000 Received: from pps.filterd (iadpaimrmta02.imrmtpd1.prodappiadaev1.oraclevcn.com [127.0.0.1]) by iadpaimrmta02.imrmtpd1.prodappiadaev1.oraclevcn.com (8.17.1.19/8.17.1.19) with ESMTP id 3ASJSIb2002216 for ; Tue, 28 Nov 2023 19:58:22 GMT Received: from nam10-dm6-obe.outbound.protection.outlook.com (mail-dm6nam10lp2101.outbound.protection.outlook.com [104.47.58.101]) by iadpaimrmta02.imrmtpd1.prodappiadaev1.oraclevcn.com (PPS) with ESMTPS id 3uk7cdp95u-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Tue, 28 Nov 2023 19:58:21 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=MI43hLKf6Yaq2npXqYD7G3jP2cyy34eKNXKjiohmjKGZtvU3O90OnmyQ/WKef6JNhqKd3bNNCYZ0qDGl4Ic7CFb4yggI1MfdBlpCNH6I+o9MX1f385xLJ0iad4SN07cuMEDjLZXk8WcoZtA4du86hj6zOeQ3LmeIHnXRS9R5viloaqxW010qHocLlKeJmt1dJcoP5edjyEsu+/yf3OfV0VpxZQDTgPQYT2215j6AP64IfHrGCw43R2PH2W+RVwvBf+XgnTzgAp75o0su2htSNWce8b+t0q/cH6I5OXxySoKmNYoWZO4Sf1Od07ngY16HGBy3BJc3MAEHoiXOedLYnQ== 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=7/T5rYqYvfu4QoMfCnK88pE9e7baRRz/gTRJDq6fyvM=; b=Gpg1OZH4a87DK9K1/hc+LBybfJCAkLmClyt9Sz9OLccNW2s+WVZADrr+Wo3VwektiyoM9f3mhDxuB35a+sj/mdYvu7TVDtRteF8I/0o7uCtV5r3AuscQAK9zeX8Rbf1/bdfgOOXZmu+0YTvgJCMsiBNFsGqj6aGwTQmuTuaXncEY2BhhWHVjRx4afZq9N3M3Dx0Nb25vv8eQwR86Vbg7Fd8sc2ZAxiazbF0I00eYNL6Yw0yyOw8wObE++7wF1Ek2IMfi/7nlUvvBR/n3X1UNOzkrAvsnEEio+z5FddVRQjCf+8i2DPsYFR6YxRsIJxEkAi7/Zw4q2o841Q+ItHKUng== 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=7/T5rYqYvfu4QoMfCnK88pE9e7baRRz/gTRJDq6fyvM=; b=lsIlcm19X+JkwHk/7RpEi+heHOSx/fWJnIqb1mNrJCBGRbkFsAGh6mfkJa9gEqS3zKafknGUf2WD8bvDFKsYPHo1nezD7Lvq+sqw2cKf2MFHvutMHqWf2XV+61gSdTYgzZNIjYDM05j11QLH5kgy/n+rJbrjJ0gDJ4D9a5IfQf0= Received: from SA2PR10MB4636.namprd10.prod.outlook.com (2603:10b6:806:11e::10) by IA1PR10MB7312.namprd10.prod.outlook.com (2603:10b6:208:3fc::5) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7025.27; Tue, 28 Nov 2023 19:58:16 +0000 Received: from SA2PR10MB4636.namprd10.prod.outlook.com ([fe80::412c:783e:a135:f0d7]) by SA2PR10MB4636.namprd10.prod.outlook.com ([fe80::412c:783e:a135:f0d7%4]) with mapi id 15.20.7046.015; Tue, 28 Nov 2023 19:58:16 +0000 From: vladimir.mezentsev@oracle.com To: binutils@sourceware.org Cc: Vladimir Mezentsev Subject: [PATCH] gprofng: updated man pages and user guide Date: Tue, 28 Nov 2023 11:58:09 -0800 Message-Id: <20231128195809.1299822-1-vladimir.mezentsev@oracle.com> X-Mailer: git-send-email 2.31.1 X-ClientProxiedBy: LO3P265CA0008.GBRP265.PROD.OUTLOOK.COM (2603:10a6:600:bb::13) To SA2PR10MB4636.namprd10.prod.outlook.com (2603:10b6:806:11e::10) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: SA2PR10MB4636:EE_|IA1PR10MB7312:EE_ X-MS-Office365-Filtering-Correlation-Id: c5c79002-e011-4c59-b254-08dbf04c5c7a X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: +H1l0mAlMTzSkzHdd9pKARR5h760Kypc+TRyt1NmNyZYUBlfZ8EfoPbK8YUYqo/+Ky10ji23EfjDwXRinbu+DCp6HMXxVIHPLXrf+zmdIQ2ZSWbyBgUtpe5HpK6hb8YLnBDUXgwn/KzpYa0SoqAcPFRLV8c87rzt631N9peBRI/4kwsuy7uqfO38jV99T9mbQfaB/7W1kk4ZSumSddwaXlbhmVl9r2eoSeG2slqDYr50XzGSAo6sMCu/wncUIm6ubaYYKlSiAT8MbL/ujF3hOYkC7QwThoNny8fENIYMkTmoNe2NC+KLXvUemNOK7VMPgXbAHjA1Reb59tCWMZ4SWO6rIf1SwiUMG0guvJjJFZLdi/5wn+dBO+3JFonQRHGWFobJnN1g7HslDy5FzgYLFW67+1coiVPEWP6hxMGG55Vu5SN6BblR+8j4UEOY0goW2DY73NA5486TTh03gIFNeHdZ3RaUwC6k54uZDmGbgxgH/dYwrSlIwBPkjzQq4auizdFpKJYfVREwjVRDDc2kaGlQJ1OXbcjfRBfzsfOGV4uoR3i5Tymx0necIZYE0ysc53tZVGg/jNASXu4V+Tg/2NNa6Jl5YiZJ/+3jAZ9jbCYPZ/kuyXseV4iwY5lcjuGq X-Forefront-Antispam-Report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:SA2PR10MB4636.namprd10.prod.outlook.com; PTR:; CAT:NONE; SFS:(13230031)(366004)(376002)(39860400002)(396003)(346002)(136003)(230173577357003)(230922051799003)(230273577357003)(64100799003)(186009)(451199024)(1800799012)(41300700001)(66574015)(83380400001)(6512007)(107886003)(1076003)(6506007)(2616005)(9686003)(38100700002)(86362001)(36756003)(316002)(5660300002)(4001150100001)(8676002)(6486002)(4326008)(8936002)(30864003)(15650500001)(66476007)(2906002)(66946007)(6666004)(6916009)(478600001)(66556008)(559001)(579004); DIR:OUT; SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: y4CeZgUfrB4/AmCRHUoaYDTediwcQy6K3u10Xbfecply6B47VAaAG9wwU6fBnAyl9T+813hBXtRgLd6QXW63WpBrYXTXqWIfeOkfmARTOAArMJKv/cpE3TK/N2rKVlgAVE/rOX6IRuBVh5PwM4BpAEuheu2/80AZuQqeL9SrZnganOCgLPdGesbfAtGpmRnFIQ0U9VZCZqeKppN35w3SS1njlRJSjvTAwLTGZ9SODTdux5hmaCH/OHFgMN98qUT31vu/yShmeyui8S73TH4H7kVuXC1GBF2w7y364Z82AfAIbeTYG9267l8Ir4GMlqiuGdhCodtqDp8DfCBbaRpYfKaT6HaUNR1BuVwCPFc1d/vdtsJ8qJrri3ESqfRfonx5GKFulMrJbpmsUp/CQSMMce55sJo99Ke6+mcNTaNuMI5FlCgznt6OKGEBg2Av71tgDXxHMFh6/0kIb+b8rDUXA/bkyctyEHx8/zt3qEZCmBzuTcO7J9CkhrQzdGEwvfqEx1251gkQ6xzPF03ChiWwt3Gx4mn0h7MwomQFhgCDFY3tRkyiEzwJ4DrbyKX/qnbwqooJRSKCZmd1V9zj/3PalPNYui06TC5N73xQUkBSYQvV2clQM2QIidaYpyznPwPitV3rPSI5HyA0fQ6xgW7sA7VyjE7TTCPCuMExHVsYjDR82f5iW7tQqBklZQHiVerprzjSiJx+EZ9JY2P7ch+xjL0m/fouhlQvgsBJzBvgBmJmY1Y2HkJXrfOgydIV6WSDyhwUasRgaCjy2G+taIS45A5bKF1j5TgRn/WcpSFFgVYbGVvpfH1uk5oyXLrhPgTkLTG2SqidstYWZFBnFKYFpjzT26gInG+4Msy0HoWYUnVPDgs8r7vafUb63VmiUY0HG6jRhn8GdUojCKjupJ6NVxYc9l1Jx6SYTOPo5ar2RLsYbHfll9BYmiF/eDLAFg/yi3wn0TRgmpwDzf+h8Ck8eblkandzd6FgcyvKqFynvlxE2aJQUf7UfbirwfY+HP9uA9f9x+QQPEJDh3i1Ipg0SY77UPmm91E8SlbeqxojOwRxWYx+wq97Fm0auIYeynusMfM+g60fe/HqTUGv1k/2fcZ0/o/mAQzAVGg6HAVkUAcA7veY9/oewqJzTCTEdTMKAy1xtpnpKmIGEonFIrum+IyFrv7hB0Isjec1ZC6E1N0qdiULiSpTchu1ZSqf+jdDXpVY2KOPgw/OTk+A7/Dlz53Igk7C56zwLrLY16mMdHtdIAFGFOZwE0mxI9sDtRWpLG/ALkZd1G7ADqtE1hZC3c+apoTUhRXkb18xDlIqSj/KH2pI/gmwVBwBmeJ2X1cqZFpUyRTIqf9CS7A+fVzfMWuA4n8Brppn7TxtRFgD1akaKC299Lr2kLd4Hc+zxTpAJNVYPQv2pYroFR+OgUso9/b5lT1o605QLEOgVkAqXoXe5fCO2T3CiTDQMH5fHcDrjz20RceSO58i6DkBAXQg3bxtxrL5rP/RBsa9dcUr1q4/hTIcDYU+j1lJtHZeI02imIsRWUOAZ0/jkIGBHaFNaWzUlhLxpRg1+smICT37azMff+ibprw+pO1PQ3AiFuq7WgYe6Wn2qKPabLkDo8wmAqqMrnG8wbc6W6sRJRhq0wNO/Fu+P5XJHyzWow0n7c2v X-MS-Exchange-AntiSpam-ExternalHop-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-ExternalHop-MessageData-0: 7YV0lrqcCbOSTIvt5L696C0/u1OymXVDYe19u92zDKwbZvngsPRpZ5kzjmaLkZbmvVQqE0wK+5eiodwsR6YoQU8kqcz7RqW90luNmFlSHaX6h6lEdmDQEXNaIpJjjWG9f8msp1xoIr/4El7OKwklK+U/dXcedXwy4QXEVqN23Ky8HCqXSSV83DXy3SYyn2TPK+HdJJvdrM6t2vzL/Cf9hGHVJDBblhVPAeVpbF6jwomv6yc26U/cc9Ace37vsA5fkGu+VaqB/T+0kN0cebOjJlkveeSd0I5PIYNXES9lFaafQ0pnBY1pNy9rcYvAdO7eDKsv8nTPb1ZrpMTeLxHqiDEqCY81zFYOy5XO2S1FbC6JmVNFNVT/3ZJg0rfIuJP1VljP55nEVMqFw4CS/IueMq6Od+X72A2xWRDqxBnewYOjF25cw3XMOtm4kJ+ENSZZ4ILtFUlM2Aq8oNPM+2Rx0DyODK5Hjmjw3mg5Jg1Z7zHqXAqCPe8A9IZRyJJylVVHpnDg10Ltjt0NQP9kvkrlPrk0YbCCFPZ/FTBjxWSmR8ZSSJEjUmegZjdhPf37aIlKHDf1FtcAj8s+ad6ZsmB87jq/q29yG+TCo4hmIVxC7luD1hVuadnJ8in3htxAUQsMj5iIr3QFF/EaOq9aTYQLj0mBa6taopfWeVoXDe/myoLckEPey9ulFvUOAbwNPPJX/MwQ9FP3P/b2YEIO2aFc1xCaSwkivvfseEtBon9MCaFqGMQUtLmAuMS9tRx3HVlpUznpSc2xIBVAjN6A1JZ4Rg== X-OriginatorOrg: oracle.com X-MS-Exchange-CrossTenant-Network-Message-Id: c5c79002-e011-4c59-b254-08dbf04c5c7a X-MS-Exchange-CrossTenant-AuthSource: SA2PR10MB4636.namprd10.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 28 Nov 2023 19:58:16.8592 (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: 0VApV7FEA7Z9G9yb49JA9iGUlOAGdt3YPcP0skEqt/VqeP6gnwy6gTRzxMzQukYrhEDOH25FHLC7TF/Qb8a24UjSjsDYVteCzv0qiLFOdUM= X-MS-Exchange-Transport-CrossTenantHeadersStamped: IA1PR10MB7312 X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.272,Aquarius:18.0.997,Hydra:6.0.619,FMLib:17.11.176.26 definitions=2023-11-28_22,2023-11-27_01,2023-05-22_02 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 spamscore=0 suspectscore=0 bulkscore=0 mlxlogscore=999 adultscore=0 malwarescore=0 mlxscore=0 phishscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2311060000 definitions=main-2311280159 X-Proofpoint-ORIG-GUID: mG-rWlX0AXpcA_GVbNBWwVNck9sncTGW X-Proofpoint-GUID: mG-rWlX0AXpcA_GVbNBWwVNck9sncTGW X-Spam-Status: No, score=-12.3 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, GIT_PATCH_0, KAM_ASCII_DIVIDERS, 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 X-BeenThere: binutils@sourceware.org X-Mailman-Version: 2.1.30 Precedence: list List-Id: Binutils mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: binutils-bounces+ouuuleilei=gmail.com@sourceware.org X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1783839083811210749 X-GMAIL-MSGID: 1783839083811210749 From: Vladimir Mezentsev This is a major update of all the man pages. Bugs 30679 and 30895 are addressed. In addition to fixes for typos, the texts have been expanded and clarified, and line lengths no longer extend beyond column 79. In case of gp-display-html, the new option syntax is documented. The user guide has a new section on the gprofng GUI. gprofng/ChangeLog 2023-11-28 Ruud van der Pas PR 30679 PR 30895 * doc/gp-archive.texi: Expand the description of the options. * doc/gp-collect-app.texi: Fix various typos and textual improvements. * doc/gp-display-html.texi: Cover the new GNU long option syntax. * doc/gp-display-src.texi: Fix various typos and textual improvements. * doc/gp-display-text.texi: Fix typos fixed and textual improvements. * doc/gp-macros.texi: Fix a bug in the vspace macro and add new macro. * doc/gprofng.texi: Cover the GPROFNG_SYSCONFDIR environment variable. * doc/gprofng_ug.texi: Fix various typos and textual improvements. * doc/version.texi: Adapt the date and version number. --- gprofng/doc/gp-archive.texi | 260 +++++++++++++++++++++++++------ gprofng/doc/gp-collect-app.texi | 115 ++++++++------ gprofng/doc/gp-display-html.texi | 154 ++++++++++++------ gprofng/doc/gp-display-src.texi | 65 ++++---- gprofng/doc/gp-display-text.texi | 71 ++++++--- gprofng/doc/gp-macros.texi | 6 + gprofng/doc/gprofng.texi | 112 ++++++++++--- gprofng/doc/gprofng_ug.texi | 114 +++++++++----- gprofng/doc/version.texi | 6 +- 9 files changed, 635 insertions(+), 268 deletions(-) diff --git a/gprofng/doc/gp-archive.texi b/gprofng/doc/gp-archive.texi index 722a9546081..d57380e0a25 100644 --- a/gprofng/doc/gp-archive.texi +++ b/gprofng/doc/gp-archive.texi @@ -1,11 +1,11 @@ @c ---------------------------------------------------------------------------- -@c This is the Texinfo source file for the gp-collect-app man page. +@c This is the Texinfo source file for the gp-archive man page. @c @c Author: Ruud van der Pas @c ---------------------------------------------------------------------------- @ifset man \input texinfo @c -*-texinfo-*- -@setfilename gprofng archive +@setfilename gp-archive @settitle Archive gprofng experiment data @include gp-macros.texi @end ifset @@ -54,7 +54,8 @@ @ManPageStart{NAME} @c man begin NAME -gprofng archive - Archive gprofng experiment data +gp-archive - Archive the associated application binaries and sources for a +gprofng experiment @c man end @ManPageEnd{} @@ -81,9 +82,12 @@ gprofng archive - Archive gprofng experiment data Archive the associated application binaries and source files in a gprofng experiment to make it self contained and portable. -By default, the binaries are archived, but the application source files -are not archived. Use this tool to change this and afterwards archive -additional components. +By default, the binaries are archived as part of the data collection, but the +application source files are not archived. Use this tool to change this and +afterwards archive additional components. + +This tool has to be executed on the same system where the profiling data was +recorded. @c man end @ManPageEnd{} @@ -111,34 +115,39 @@ Print the version number and exit. Print usage information and exit. -@c -- @item --verbose @{on|off@} -@c -- @ifclear man -@c -- @IndexSubentry{Options, @code{--verbose}} -@c -- @end ifclear - -@c -- Enable (on) or disable (off) verbose mode; the default is @samp{off}. - -@item -a @{off|on|ldobjects|src|usedldobjects|usedsrc@} +@item -a @{off | on | ldobjects | src | usedldobjects | used[src]@} @ifclear man @IndexSubentry{Options, @code{-a}} @end ifclear Specify archiving of binaries and other files. In addition to disable this -feature (off), or enable archiving off all loadobjects and sources (on), -the other op tions support a more refined selection. +feature (@samp{off}), or enable archiving of all loadobjects and sources +(@samp{on}), the other choices support a more refined selection. -All of these options enable archiving, but the keyword controls what exactly -is selected: all load objects (ldobjects), all source files (src), the -loadobjects asscoiated with a program counter (usedldobjects), or the source -files associated with a program counter (usedsrc). -The default is @samp{-a ldobjects}. +All of these choices enable archiving, but the keyword controls what exactly +is selected: all load objects (@samp{ldobjects}), all source files +(@samp{src}), the loadobjects associated with a program counter +(@samp{usedldobjects}), or the source files associated with a program counter +(@samp{used[src]}). The default is @samp{-a ldobjects}. -@item -n +@item -d @var{path} @ifclear man -@IndexSubentry{Options, @code{-n}} +@IndexSubentry{Options, @code{-d}} @end ifclear -Archive the named experiment only, not any of its descendants. +The @var{path} is the absolute path to a common archive, which is a +directory that contains archived files. If the directory does not +exist, then it will be created. Files are saved in the common archive +directory, and a symbolic link is created in the experiment archive. + +@item -F +@ifclear man +@IndexSubentry{Options, @code{-F}} +@end ifclear + +Force writing, or rewriting of .archive files. All archived files will be +removed and recreated, except if the @samp{-n} or @samp{-m} option is used, +or if the experiment is a subexperiment. @item -m @var{regex} @ifclear man @@ -148,32 +157,67 @@ Archive the named experiment only, not any of its descendants. Archive only those source, object, and debug info files whose full path name matches the given POSIX compliant @var{regex} regular expression. +@item -n +@ifclear man +@IndexSubentry{Options, @code{-n}} +@end ifclear + +Archive the named experiment only, not any of its descendants. + @item -q @ifclear man @IndexSubentry{Options, @code{-q}} @end ifclear -Do not write any warnings to stderr. Warnings are incorporated into the -.archive file in the experiment directory. They are shown in the output -of @command{gprofng display text}. +Do not write any warnings to @file{stderr}. Warnings are incorporated into +the .archive file in the experiment directory. They are shown in the output +of the @command{gprofng display text} command. -@item -F +@item -r @var{path} @ifclear man -@IndexSubentry{Options, @code{-F}} +@IndexSubentry{Options, @code{-r}} @end ifclear -Force writing or rewriting of the archive. This is ignored with the -@samp{-n} or @samp{-m} option, or if this is a subexperiment. +This option specifies the location of a common archive. The value is the +relative path to a common archive, which is a directory that contains +archived files. +If the directory does not exist, then it will be created. Files are saved +in the common archive directory, and a symbolic link is created in the +experiment archive. -@item -d @var{path} +@item -s @var{selection} @ifclear man -@IndexSubentry{Options, @code{-d}} +@IndexSubentry{Options, @code{-s}} @end ifclear -The @var{path} is the absolute path path to a common archive, which is a -directory that contains archived files. If the directory does not -exist, then it will be created. Files are saved in the common archive -directory, and a symbolic link is created in the experiment archive. +Specify archiving of source files. The allowed values for @var{selection} are: + +@table @gcctabopt + +@item no + +Do not archive any source files. + +@item all + +Archive all source and object files that can be found. + +@item used[src] + +Archive source and object files for functions against which data was +recorded in the experiment, and that can be found. +@end table + +By default, application source files are not archived into the experiment. +If the @samp{-s all}, or @samp{-s used} option is used, sources and object +files are archived. +These options also ensure that source files are available in the experiment, +even if the original source files have been modified, or are inaccessible +afterwards. + +In case archive files cannot be found, use the @samp{addpath}, or +@samp{pathmap} command, or both, in an @file{.er.rc} file to specify the +location of the missing file(s). @end table @@ -187,17 +231,130 @@ directory, and a symbolic link is created in the experiment archive. @ManPageStart{NOTES} @c man begin NOTES -Default archiving does not occur in case the application profiled terminates -prematurely, or if archiving is disabled when collecting the performance data. -In such cases, this tool can be used to afterwards archive the information, -but it has to be run on the same system where the profiling data was recorded. +@itemize @minus + +@c ---------------------------------------------------------------------------- +@item +Archiving of application binaries - +By default, binaries are archived automatically when an experiment is +created. However, archiving does not occur in one or more of the +following circumstances: + +@itemize @bullet + +@item +If the profiled application is terminated before it exits normally. + +@item +If a running process is profiled. + +@item +If archiving is explicitly disabled when profiling. For example by using +the @samp{-a off} option on @command{gprofng collect app}. + +@end itemize + +In these cases, @command{gprofng archive} must be run manually and on the same +machine where the profiling data was recorded. + +Archiving of experiment data during the data collection process can be quite +expensive. Especially if the experiment has many descendant processes. +@ifclear man +@IndexSubentry{Options, @code{-a}} +@end ifclear +In such cases, a more efficient strategy is to use the @samp{-a off} option +when collecting the data. Once the collection has completed, the data can be +@ifclear man +@IndexSubentry{Options, @code{-s}} +@end ifclear +archived using the @samp{-s all} option. This saves all executables and +source files in the experiment. + +If during the archiving there is an error message that an executable, or +@ifclear man +@IndexSubentry{Commands, @code{addpath}} +@end ifclear +source file cannot be found, the @samp{addpath} command to add the path +to the missing file(s) can be included in the @file{.er.rc} file. +After this command has been added, archive the experiment again. The +archiving archiving can be repeated as many times as necessary to archive all +files. + +Archiving should be done on the same system as was used to collect the +experiment. If some files cannot be accessed from this system (e.g. sources +or object files), then additional archiving can be done using another system +that can access them. For example, the system where the application was built. Some Java applications store shared objects in jar files. By default, such shared objects are not automatically archived. To archive shared objects -contained in jar files, the addpath directive in an .er.rc file. The addpath -directive should give the path to the jar file, including the jar file itself. -The .er.rc file should be saved in the user home directory or parent of the -experiment directory. +contained in jar files, make sure to include the @samp{addpath} command in +an @file{.er.rc} file. +The @samp{addpath} command should give the path to the jar file, including +the jar file itself. The @file{.er.rc} file should be saved in the user home +directory, or experiment parent directory. + +@item +Archiving of application sources - +By default, application source files are not archived in the experiment. +Execute the @command{gprofng archive} command with the @samp{-s all}, or +@samp{-s used} option on each experiment to store source files in the +experiment. + +@item +Automatic archiving of application sources - +Environment variable @samp{GPROFNG_ARCHIVE} may be set to automatically +archive sources when the experiment has completed. This environment +variable can contain @samp{-s} and @samp{-m} arguments, as pairs of +argument and options, separated by one or more blanks. +@ifclear man +@IndexSubentry{Environment variables, @code{GPROFNG_ARCHIVE}} +@IndexSubentry{Options, @code{-a}} +@IndexSubentry{Options, @code{-m}} +@IndexSubentry{Options, @code{-s}} +@end ifclear + +If more than one @samp{-s} argument appears on the command line, the +last one prevails. If @samp{-s} is both passed on the command line, and +set by the environment variable, the option from the environment variable +prevails. + +Note that in case automatic source archiving during data collection has +been enabled using either the @samp{GPROFNG_ARCHIVE} variable, or the +@samp{-a src}, or @samp{-a usedsrc} option, it is recommended to confirm that +source files have been correctly resolved by executing the +@command{gprofng archive -s all}, or @command{gprofng archive -s used} +command. + +@item +The @samp{-d} and @samp{-r} options are mutually exclusive. +@ifclear man +@IndexSubentry{Options, @code{-d}} +@IndexSubentry{Options, @code{-r}} +@end ifclear + +@item +When using the @samp{-d} or @samp{-r} option, environment variable +@ifclear man +@IndexSubentry{Options, @code{-d}} +@IndexSubentry{Options, @code{-r}} +@IndexSubentry{Environment variables, @code{GPROFNG_ARCHIVE_COMMON_DIR}} +@end ifclear +@samp{GPROFNG_ARCHIVE_COMMON_DIR} can be used to specify the location of +the common archive. This can be very convenient when using a script to +profile applications. + +@item +If more than one @samp{-s} option is given on the command line, or +specified in the environment variable, the specified option for all must +be the same. If not, @command{gprofng archive} exits with an error. + +@item +This tool does not work on experiments recorded with earlier versions of +the tools. If invoked on such experiments, a warning is printed. Use the +version of @command{gprofng archive} from the same release with which the +experiment was recorded. + +@end itemize @c man end @ManPageEnd{} @@ -206,10 +363,19 @@ experiment directory. @c SEEALSO section @c ---------------------------------------------------------------------------- -@ManPageStart{SEEALSO} +@ManPageStart{SEE ALSO} @c man begin SEEALSO -gprofng(1), gp-collect-app(1), gp-display-html(1), gp-display-src(1), gp-display-text(1) +gprofng(1), +gp-collect-app(1), +gp-display-gui(1), +gp-display-html(1), +gp-display-src(1), +gp-display-text(1) + +@iftex +@vspace{1} +@end iftex The user guide for gprofng is maintained as a Texinfo manual. If the info and gprofng programs are correctly installed, the command diff --git a/gprofng/doc/gp-collect-app.texi b/gprofng/doc/gp-collect-app.texi index 7e81f8505e7..203827c38ea 100644 --- a/gprofng/doc/gp-collect-app.texi +++ b/gprofng/doc/gp-collect-app.texi @@ -5,7 +5,7 @@ @c ---------------------------------------------------------------------------- @ifset man \input texinfo @c -*-texinfo-*- -@setfilename gprofng collect app +@setfilename gp-collect-app @settitle Collect performance data for the target application @include gp-macros.texi @end ifset @@ -54,7 +54,7 @@ @ManPageStart{NAME} @c man begin NAME -gprofng collect app - Collect performance data for the target program +gp-collect-app - Collect performance data for the target program @c man end @ManPageEnd{} @@ -66,7 +66,8 @@ gprofng collect app - Collect performance data for the target program @ManPageStart{SYNOPSIS} @c man begin SYNOPSIS -@command{gprofng collect app} [@var{option(s)}] @var{target} [@var{option(s)}] +@command{gprofng collect app} [@var{option(s)}] @var{target} +[@var{target-option(s)}] @c man end @ManPageEnd{} @@ -79,7 +80,8 @@ gprofng collect app - Collect performance data for the target program @c man begin DESCRIPTION Collect performance data on the target program. In addition to Program Counter -(PC) sampling, hardware event counters and various tracing options are supported. +(PC) sampling, hardware event counters and various tracing options are +supported. For example, this command collects performance data for an executable called @samp{a.out} and stores the data collected in an experiment directory with @@ -115,28 +117,29 @@ Print the version number and exit. Print usage information and exit. -@c -- @item --verbose @{on|off@} -@c -- @ifclear man -@c -- @IndexSubentry{Options, @code{--verbose}} -@c -- @end ifclear +@item -v, --verbose +@ifclear man +@IndexSubentry{Options, @code{-v}} +@IndexSubentry{Options, @code{--verbose}} +@end ifclear -@c -- Enable (on) or disable (off) verbose mode; the default is @samp{off}. +By default, verbose mode is disabled. This option enables it. -@item -p @{off|on|lo|hi|@var{}@} +@item -p @{off | on | lo[w] | hi[gh] | @var{}@} @ifclear man @IndexSubentry{Options, @code{-p}} @end ifclear -Disable (off) or enable (on) clock-profiling using a default sampling -granularity, or enable clock-profiling implicitly by setting the sampling -granularity (lo, hi, or a specific value in ms). By default, clock profiling -is enabled (@samp{-p on}). +Disable (@samp{off}) or enable (@samp{on}) clock profiling using a default +sampling granularity, or enable clock profiling implicitly by setting the +sampling granularity (@samp{lo[w]}, @samp{hi[gh]}, or a specific value in +ms). By default, clock profiling is enabled (@samp{-p on}). -@item -h @var{@{...,@}} +@item -h @var{[,]} @ifclear man @IndexSubentry{Options, @code{-h}} @end ifclear -Enable hardware event counter profiling and select the counter(s). +Enable hardware event counter profiling and select one or more counter(s). To see the supported counters on this system, use the @samp{-h} option without other arguments. @@ -147,6 +150,7 @@ without other arguments. Specify the name for the experiment directory. The name has to end with @samp{.er} and may contain an absolute path (e.g. @file{/tmp/experiment.er}). +An existing experiment with the same name will not be overwritten. @item -O @var{} @ifclear man @@ -164,41 +168,46 @@ overwrites an existing experiment directory with the same name. Add up to 10 comment strings to the experiment. These comments appear in the notes section of the header and can be retrieved with the @command{gprofng display text} command using the @samp{-header} option. +@ifclear man +@IndexSubentry{Options, @code{-header}} +@IndexSubentry{Commands, @code{-header}} +@end ifclear -@item -j @{on|off|@var{}@} +@item -j @{on | off | @var{}@} @ifclear man @IndexSubentry{Options, @code{-j}} @end ifclear -Controls Java profiling when the target is a JVM machine. The allowed values of -this option are: enable (on), disable (off) Java profiling when the target -program is a JVM, or set @samp{} to a non-default JVM. -The default is @samp{-j on} +Controls Java profiling when the target is a JVM machine. The allowed values +for this option are: @table @gcctabopt @item on Record profiling data for the JVM machine, and recognize methods compiled by -the Java HotSpot virtual machine. Also record Java call stacks. The default -is @samp{-j on}. +the Java HotSpot virtual machine. Also record Java call stacks. @item off -Does not record Java profiling data. Profiling data for native call stacks is +Do not record Java profiling data. Profiling data for native call stacks is still recorded. @item @var{} -Records profiling data for the JVM, and use the JVM as installed in @var{}. +Records profiling data for the JVM, and use the JVM as installed in +@var{}. @end table -@item -J @var{} +The default is @samp{-j on}. + +@item -J @var{} @ifclear man @IndexSubentry{Options, @code{-J}} @end ifclear -Specifies additional options to be passed to the JVM used. The -@var{jvm-options} list must be enclosed in quotation marks if it contains more -than one option. The items in the list need to be separated by spaces or tab. +Specifies one or more additional options to be passed to the JVM used. The +@var{jvm-option(s)} list must be enclosed in quotation marks if it contains +more than one option. The items in the list need to be separated by spaces +or tabs. Each item is passed as a separate option to the JVM. Note that this option implies @samp{-j on}. @@ -211,11 +220,12 @@ Collects data for the specified duration. The duration can be a single number, optionally followed by either @samp{m} to specify minutes, or @samp{s} to specify seconds, which is the default. -The duration can also two numbers separated by minus (-) sign. If a single -number is given, data is collected from the start of the run until the given -time. If two numbers are given, data is collected from the first time to the -second. If the second time is zero, data is collected until the end of the -run. If two non-zero numbers are given, the first must be less than the second. +The duration can also consists of two numbers separated by a minus (@minus{}) +sign. If a single number is given, data is collected from the start of the run +until the given time. +If two numbers are given, data is collected from the first time to the second. +In case the second time is zero, data is collected until the end of the run. +If two non-zero numbers are given, the first must be less than the second. @item -n @ifclear man @@ -243,8 +253,8 @@ enclose the @var{regex} in single quotes. The default is @samp{-F on}. @end ifclear Specify archiving of binaries and other files. In addition to disable this -feature (off), or enable archiving off all loadobjects and sources (on), -the other op tions support a more refined selection. +feature (@samp{off}), or enable archiving off all loadobjects and sources +(@samp{on}), the other options support a more refined selection. All of these options enable archiving, but the keyword controls what exactly is selected: all load objects (ldobjects), all source files (src), the @@ -257,9 +267,9 @@ The default is @samp{-a ldobjects}. @IndexSubentry{Options, @code{-S}} @end ifclear -Disable (off), or enable (on) periodic sampling of process-wide resource -utilization. By default, sampling occurs every second. Use the @var{} -option to change this. The default is @samp{-S on}. +Disable (off), or enable (on) periodic sampling of process-wide +resource utilization. By default, sampling occurs every second. Use the +@var{} option to change this. The default is @samp{-S on}. @item -y @var{}[,r] @ifclear man @@ -267,11 +277,11 @@ option to change this. The default is @samp{-S on}. @end ifclear Controls recording of data with the signal named @var{}, referred to -as the pause-resume signal. Whenever the given signal is delivered to the +as the pause-resume signal. Whenever the given signal is delivered to the process, switch between paused (no data is recorded) and resumed (data is recorded) states. -By default, data collection begins in the paused state. If the optional +By default, data collection begins in the paused state. If the optional @samp{r} is given, data collection begins in the resumed state and data collection begins immediately. @@ -283,8 +293,9 @@ not used by the target can be used. @IndexSubentry{Options, @code{-l}} @end ifclear -Specify a signal that will trigger a sample of process-wide resource utilization. -When the named @var{} is delivered to the process, a sample is recorded. +Specify a signal that will trigger a sample of process-wide resource +utilization. When the named @var{} is delivered to the process, +a sample is recorded. The signal can be specified using the full name, without the initial letters @code{SIG}, or the signal number. Note that the @command{kill} @@ -299,9 +310,10 @@ different. @end ifclear Enable synchronization wait tracing, where @var{