From gjelinek@sac.sfbay.sun.com Thu Jul 31 10:23:16 2008 Received: from newsunmail1brm.central.sun.com (newsunmail1brm.Central.Sun.COM [129.147.62.245]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m6VHNFlD013740 for ; Thu, 31 Jul 2008 10:23:16 -0700 (PDT) Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6]) by newsunmail1brm.central.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id m6VHNFnU058114; Thu, 31 Jul 2008 11:23:15 -0600 (MDT) Received: from pmxchannel-daemon.nwk-avmta-2.sfbay.sun.com by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) id <0K4V00103SARBL00@nwk-avmta-2.sfbay.sun.com>; Thu, 31 Jul 2008 10:23:15 -0700 (PDT) Received: from dm-sfbay-01.sfbay.sun.com ([129.145.155.118]) by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0K4V00JCNSAQF580@nwk-avmta-2.sfbay.sun.com>; Thu, 31 Jul 2008 10:23:14 -0700 (PDT) Received: from sac.sfbay.sun.com (new-sac.SFBay.Sun.COM [129.146.175.65]) by dm-sfbay-01.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id m6VHNEXP038788; Thu, 31 Jul 2008 10:23:14 -0700 (PDT) Received: from sac.sfbay.sun.com (localhost [127.0.0.1]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m6VHNDKu013714; Thu, 31 Jul 2008 10:23:13 -0700 (PDT) Received: (from gjelinek@localhost) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8/Submit) id m6VHNDJ0013710; Thu, 31 Jul 2008 10:23:13 -0700 (PDT) Date: Thu, 31 Jul 2008 10:23:13 -0700 (PDT) From: Gerald Jelinek Subject: pmadvise/pldd unresolved link map flag [PSARC/2008/490 Self Review] To: PSARC-ext@sun.com Cc: Edward.Pilatowicz@sun.com Message-id: <200807311723.m6VHNDJ0013710@sac.sfbay.sun.com> Content-transfer-encoding: 7BIT X-PMX-Version: 5.4.1.325704 Status: RO Content-Length: 3545 I am sponsoring this case for Ed Pilatowicz. Since this is a simple change in classification of an existing option, I marked it closed approved automatic. If anyone feels this needs more review, let me know and I'll change it to a fast-track. Thanks, Jerry Template Version: @(#)sac_nextcase 1.66 04/17/08 SMI This information is Copyright 2008 Sun Microsystems 1. Introduction 1.1. Project/Component Working Name: pmadvise/pldd unresolved link map flag 1.2. Name of Document Author/Supplier: Author: Ed Pilatowicz 1.3 Date of This Document: 31 July, 2008 4. Technical Description pmadvise/pldd unresolved link map flag This case requests patch binding. (With an intent to back port this functionality to s10.) New interface stability is documented in the interface table below. A. INTRODUCTION Currently, pmap supports an un-arced -l option (introduced by [1]) which controls how object paths are displayed. If the -l flag is specified, pmap reports the object names as reported by the target processes linker. If the -l flag is not specified, pmap tries a variety of techniques to attempt to determine the real filesystem path to the mapped object. Pmadvise[2] has a special -v mode where it displays output almost identical to pmap output, but annotated to include memory advice settings. B. DESCRIPTION The fix for 6599704[3] moves all the special filesystem object resolution code currently found in pmap into libproc. Doing this provides for more consistent results and allows all libproc consumers to have access to both raw linker object names and the resolved filesystem paths that correspond to those object names. Pmap will continue to function as it currently does, but this new object resolution functionality will be enabled by default for pldd and pmadvise -v. Pmadvise -v will be updated to support a -l flag, who's behavior will mirror that of the pmap -l flag. Pldd will be updated to display resolved filesystem object paths by default, and if a -l flag is specified, the raw linker object paths will be displayed. Here's an example. With the fix for 6599704, if pldd is run against the 'init' process running in an lx branded zone, we will see the following resolved filesystem paths to all loaded objects: ---8<--- root@ns-x4100-5$ pldd 101753 101753: /sbin/init /usr/lib/lx_brand.so.1 /usr/lib/libmapmalloc.so.1 /usr/lib/libc/libc_hwcap2.so.1 /lib/libsocket.so.1 /lib/libnsl.so.1 /export/zones/lx1/root/lib/tls/libc-2.3.2.so /export/zones/lx1/root/lib/ld-2.3.2.so ---8<--- If the -l flag is passed to pldd, then we'll see the raw and unresolved object paths as reported by the linker data in the target process. ---8<--- root@ns-x4100-5$ pldd -l 101753 101753: /sbin/init /native/usr/lib/lx_brand.so.1 /native/usr/lib/libmapmalloc.so.1 /native/lib/libc.so.1 /native/lib/libsocket.so.1 /native/lib/libnsl.so.1 /lib/tls/libc.so.6 /lib/ld-linux.so.2 ---8<--- C. INTERFACES pmadvise, and pldd [-l] option Committed pmadvise, and pldd [-l] output format Uncommitted C. REFERENCES [1] 4088148 truss, gcore, and the /proc tools should use a common library [2] PSARC/2004/484 pmadvise [3] 6599704 libproc should look inside zones for objects D. MANPAGE CHANGES To be determined. The diffs will eventually be included in: 6722171 pmadvise and pldd have new '-l' flags that should be documented 6. Resources and Schedule 6.4. Steering Committee requested information 6.4.1. Consolidation C-team Name: ON 6.5. ARC review type: Automatic 6.6. ARC Exposure: open From gww@eng.sun.com Thu Jul 31 10:32:29 2008 Received: from sunmail4.singapore.sun.com (sunmail4.Singapore.Sun.COM [129.158.71.19]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m6VHWSQp014544 for ; Thu, 31 Jul 2008 10:32:29 -0700 (PDT) Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6]) by sunmail4.singapore.sun.com (8.13.4+Sun/8.13.3/ENSMAIL,v2.2) with ESMTP id m6VHWO5E014075 for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Fri, 1 Aug 2008 01:32:25 +0800 (SGT) Received: from pmxchannel-daemon.nwk-avmta-2.sfbay.sun.com by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) id <0K4V0012FSQ0N400@nwk-avmta-2.sfbay.sun.com> for PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Thu, 31 Jul 2008 10:32:24 -0700 (PDT) Received: from dm-eng-02.sfbay.sun.com ([129.146.11.32]) by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0K4V00JJ2SQ0EW80@nwk-avmta-2.sfbay.sun.com> for PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Thu, 31 Jul 2008 10:32:24 -0700 (PDT) Received: from marduk.eng.sun.com (marduk.SFBay.Sun.COM [129.146.108.224]) by dm-eng-02.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id m6VHWLVT038620; Thu, 31 Jul 2008 10:32:21 -0700 (PDT) Received: from marduk.eng.sun.com (localhost [127.0.0.1]) by marduk.eng.sun.com (8.13.6+Sun/8.12.11) with ESMTP id m6VHTE9D009215; Thu, 31 Jul 2008 10:29:14 -0700 (PDT) Received: (from gww@localhost) by marduk.eng.sun.com (8.13.6+Sun/8.12.11/Submit) id m6VHTDRW009214; Thu, 31 Jul 2008 10:29:13 -0700 (PDT) Date: Thu, 31 Jul 2008 10:29:13 -0700 (PDT) From: Gary Winiger Subject: Re: pmadvise/pldd unresolved link map flag [PSARC/2008/490 Self Review] To: PSARC-ext@sun.com, gjelinek@sac.sfbay.sun.com Cc: edward.pilatowicz@sun.com Message-id: <200807311729.m6VHTDRW009214@marduk.eng.sun.com> Content-transfer-encoding: 7BIT X-Sun-Charset: US-ASCII X-PMX-Version: 5.4.1.325704 Status: RO Content-Length: 667 > an existing option, I marked it closed approved > automatic. If anyone feels this needs more review, > let me know and I'll change it to a fast-track. I'm not asking for a fast-track, just a clarification of the intention (below). > C. INTERFACES > > pmadvise, and pldd [-l] option Committed > pmadvise, and pldd [-l] output format Uncommitted The way I read this is that the output of -l is intended as a programming interface and isn't expected to change except across what had been a Minor Release boundary and then only with notice. If that's not correct, perhaps Volatile or Not-an-Interface for the output format is more appropriate. Gary.. From edward.pilatowicz@sun.com Thu Jul 31 12:01:29 2008 Received: from newsunmail1brm.central.sun.com (newsunmail1brm.Central.Sun.COM [129.147.62.245]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m6VJ1S7N017371 for ; Thu, 31 Jul 2008 12:01:28 -0700 (PDT) Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6]) by newsunmail1brm.central.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id m6VJ1G2Y025076; Thu, 31 Jul 2008 13:01:27 -0600 (MDT) Received: from pmxchannel-daemon.nwk-avmta-2.sfbay.sun.com by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) id <0K4V0050ZWUC5N00@nwk-avmta-2.sfbay.sun.com>; Thu, 31 Jul 2008 12:01:24 -0700 (PDT) Received: from jurassic-x4600.sfbay.sun.com ([129.146.17.63]) by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0K4V00J6SWTLF3E0@nwk-avmta-2.sfbay.sun.com>; Thu, 31 Jul 2008 12:00:57 -0700 (PDT) Received: from jurassic-x4600.sfbay.sun.com (localhost [127.0.0.1]) by jurassic-x4600.sfbay.sun.com (8.14.3+Sun/8.14.3) with ESMTP id m6VJ0vhN420424 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Thu, 31 Jul 2008 12:00:57 -0700 (PDT) Received: (from edp@localhost) by jurassic-x4600.sfbay.sun.com (8.14.3+Sun/8.14.3/Submit) id m6VJ0vHF420419; Thu, 31 Jul 2008 12:00:57 -0700 (PDT) Date: Thu, 31 Jul 2008 12:00:57 -0700 From: Edward Pilatowicz Subject: Re: pmadvise/pldd unresolved link map flag [PSARC/2008/490 Self Review] In-reply-to: <200807311729.m6VHTDRW009214@marduk.eng.sun.com> To: Gary Winiger Cc: PSARC-ext@sun.com, gjelinek@sac.sfbay.sun.com Message-id: <20080731190057.GA416469@eng.sun.com> MIME-version: 1.0 Content-type: text/plain; charset=us-ascii Content-transfer-encoding: 7BIT Content-disposition: inline X-PMX-Version: 5.4.1.325704 References: <200807311729.m6VHTDRW009214@marduk.eng.sun.com> X-Authentication-warning: jurassic-x4600.sfbay.sun.com: edp set sender to edward.pilatowicz@sun.com using -f User-Agent: Mutt/1.5.17 (2007-11-01) Status: RO Content-Length: 891 On Thu, Jul 31, 2008 at 10:29:13AM -0700, Gary Winiger wrote: > > an existing option, I marked it closed approved > > automatic. If anyone feels this needs more review, > > let me know and I'll change it to a fast-track. > > I'm not asking for a fast-track, just a clarification of the > intention (below). > > > C. INTERFACES > > > > pmadvise, and pldd [-l] option Committed > > pmadvise, and pldd [-l] output format Uncommitted > > The way I read this is that the output of -l is intended > as a programming interface and isn't expected to change > except across what had been a Minor Release boundary and > then only with notice. If that's not correct, perhaps > Volatile or Not-an-Interface for the output format is > more appropriate. > my unfamiliarity with the new taxonomy shows. the output is not intended to be an interface, hence i'll go with Not-an-Interface. ed