From jw137282@sac.sfbay.sun.com Fri Feb 20 14:51:41 2009
Received: from sunmail2sca.sfbay.sun.com (sunmail2sca.SFBay.Sun.COM [129.145.155.234])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id n1KMpfZM018268
	for <psarc-ext@sac.sfbay.sun.com>; Fri, 20 Feb 2009 14:51:41 -0800 (PST)
Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11])
	by sunmail2sca.sfbay.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id n1KMpeNO000605;
	Fri, 20 Feb 2009 14:51:41 -0800 (PST)
Received: from pmxchannel-daemon.brm-avmta-1.central.sun.com by
 brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0KFD00J0VZI46D00@brm-avmta-1.central.sun.com>; Fri,
 20 Feb 2009 15:51:40 -0700 (MST)
Received: from dm-sfbay-02.sfbay.sun.com ([129.146.11.31])
 by brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0KFD00431ZI3YVB0@brm-avmta-1.central.sun.com>; Fri,
 20 Feb 2009 15:51:40 -0700 (MST)
Received: from sac.sfbay.sun.com (sac.SFBay.Sun.COM [129.146.226.132])
	by dm-sfbay-02.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2)
 with ESMTP id n1KMpckJ022732; Fri, 20 Feb 2009 14:51:38 -0800 (PST)
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 n1KMpbNf018263; Fri,
 20 Feb 2009 14:51:37 -0800 (PST)
Received: (from jw137282@localhost)
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8/Submit) id n1KMpbYk018259; Fri,
 20 Feb 2009 14:51:37 -0800 (PST)
Date: Fri, 20 Feb 2009 14:51:37 -0800 (PST)
From: James Walker <jw137282@sac.sfbay.sun.com>
Subject: perl-pmtools [PSARC/2009/121 FastTrack timeout 02/27/2009]
To: PSARC-ext@sun.com
Cc: yuan.fan@sun.com
Message-id: <200902202251.n1KMpbYk018259@sac.sfbay.sun.com>
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
Status: RO
Content-Length: 14054

I'm sponsoring this familiarity case for Yuan Fan. The requested
release binding is minor. The man pages have been posted in the
materials directory.

Template Version: @(#)sac_nextcase %I% %G% SMI
This information is Copyright 2009 Sun Microsystems
1. Introduction
    1.1. Project/Component Working Name:
	 perl-pmtools
    1.2. Name of Document Author/Supplier:
	 Author:  Yuan Fan
    1.3  Date of This Document:
	20 February, 2009
4. Technical Description
perl-pmtools Check List
1.0 Project Information
1.1 Name of project/component
    perl-pmtools

1.2 Author of document
    Yuan Fan

2.0 Project Summary
  2.1 Project Description
    pmtools(Perl module tools) is a suite of small tools that help 
    manage and inspect perl modules, perl plain old documentation files, 
    and perl programs. 
    Some of the things these tools can do include: 
    - show the full path to a module 
    - show the version and description of a module 
    - list all installed modules with descriptions 
    - show what files a given program or module loads at compile time 
    - show what symbols a module exports 
    - list the methods of a class 
    - display the source code of a function of a module 

    pmtools-1.10 will be integrated into the SFW consolidation as part of this
    proposal, and will be installed as SUNWperl-pmtools.

  2.2 Release binding
      What is is the release binding?
      (see http://opensolaris.org/os/community/arc/policies/release-taxonomy/)
      [ ] Major
      [*] Minor
      [ ] Patch or Micro
      [ ] Unknown -- ARC review required

  2.3 Type of project
      Is this case a Linux Familiarity project?
      [*] Yes
      [ ] No

  2.4 Originating Community
    2.4.1 Community Name
      pmtools - Tom Christiansen [1]
    
    2.4.2 Community Involvement
      Indicate Sun's involvement in the community
      [ ] Maintainer
      [ ] Contributor
      [*] Monitoring
      
      Will the project team work with the upstream community to resolve
      architectural issues of interest to Sun?
      [*] Yes 
      [ ] No - briefly explain
      
      Will we or are we forking from the community?
      [ ] Yes - ARC review required prior to forking
      [*] No
      
3.0 Technical Description
  3.1 Installation & Sharable
    3.1.1S Solaris Installation - section only required for Solaris Software
      (see http://opensolaris.org/os/community/arc/policies/install-locations/ for details)
      Does this project follow the Install Locations best practice?
      [*] Yes 
      [ ] No - ARC review required
      
      Does this project install into /usr under [sbin|bin|lib|include|man|share]?
      [*] Yes
      [ ] No or N/A
      
      Does this project install into /opt?
      [ ] Yes - explain below
      [*] No or N/A
      
      Does this project install into a different directory structure?
      [ ] Yes - ARC review required
      [*] No or N/A
      
      Do any of the components of this project conflict with anything under /usr?
      (see http://opensolaris.org/os/community/arc/caselog/2007/047/ for details)
      [ ] Yes - explain below
      [*] No
      
      If conflicts exist then will this project install under /usr/gnu?
      [ ] Yes
      [ ] No - ARC review required
      [*] N/A
      
      Is this project installing into /usr/sfw?
      [ ] Yes - ARC review required
      [*] No
      
    3.1.1W Windows Installation - section only required for Windows Software
      (see http://sac.sfbay/WSARC/2002/494 for details)
      Does this project install software into a 
      <system drive>:\Program Files\Sun\<product> or <system drive>:\Sun\<product>
      directory?
      [ ] Yes
      [ ] No - ARC review required
      
      Does the project use the Windows registry?
      [ ] Yes
      [ ] No - ARC review required
      
      Does the project use 
      HKEY_LOCAL_MACHINE\SOFTWARE\Sun Microsystems\<product>\<version>
      for the registry key?
      [ ] Yes
      [ ] No - ARC review required
      
      Is the project's stored location
      HKEY_LOCAL_MACHINE\SOFTWARE\Sun Microsystems\<product id>\<version id>\Path?
      [ ] Yes
      [ ] No - ARC review required
      
    3.1.2 Share and Sharable
      Does the module include any components that are used or shared by 
      other projects?
      [ ] Yes
      [*] No
    
      If yes are these components packaged to be shared with the other FOSS?
      [ ] Yes
      [ ] No - ARC review required
      [*] N/A
    
      Are these components already in the Solaris WOS?
      [ ] Yes
      [*] No - continue with next section (section 3.2)
    
      If yes are these newer versions being delivered?
      [ ] Yes
      [ ] No - ARC review required
      
      If yes are the newer versions replacing the existing versions?
      [ ] Yes
      [ ] No - ARC review required

  3.2 Exported Libraries
      Are libraries being delivered by this project?
      [ ] Yes
      [*] No - continue with next section (section 3.3)
      
      Are 64-bit versions of the libraries being delivered?
      [ ] Yes
      [ ] No - ARC review required
    
      Are static versions of the libraries being delivered?
      [ ] Yes - ARC review required
      [ ] No 
      
  3.3 Services and the /etc Directory
      (see http://opensolaris.org/os/community/arc/policies/SMF-policy/)
      Does the project integrate anything into /etc/init.d or /etc/rc?.d?
      [ ] Yes - ARC review required
      [*] No
      
      Does the project integrate any new entries into /etc/inittab or
      /etc/inetd.conf?
      [ ] Yes - ARC review required
      [*] No
      
      Does the project integrate any private non-public files into /etc/default
      or /etc/ configuration files?
      [ ] Yes - ARC review required
      [*] No
      
      Does the service manifests method context grant rights above that
      of the noaccess user and basic privilege set?
      [ ] Yes - ARC review required
      [*] No
        
  3.4 Security
    3.4.1 Secure By Default 
      (see http://opensolaris.org/os/community/arc/policies/secure-by-default/ for details)
      (see http://www.opensolaris.org/os/community/arc/policies/NITS-policy/ for details)
      (see parts of http://opensolaris.org/os/community/arc/policies/SMF-policy/ for
       addtional details)
      Are there any network services provided by this project?
      [ ] Yes
      [*] No - continue with the next section (section 3.4.2)
      
      Are network services enabled by default?
      [ ] Yes - ARC review required
      [ ] No
      [ ] N/A
      
      Are network services automatically enabled by the project during installation?
      [ ] Yes - ARC review required
      [ ] No
      [ ] N/A
      
      Are inbound network communications denied by default?
      [ ] Yes
      [ ] No - ARC review required
      [ ] N/A
      
      Is inbound data checked to prevent content-based attacks?
      [ ] Yes
      [ ] No - ARC review required
      [ ] N/A
      
      Is the outbound receiver authenticated?
      [ ] Yes
      [ ] No - ARC review required
      [ ] N/A
      
      Is the receiver authenticated prior to receiving any sensitive outbound communication?
      [ ] Yes
      [ ] No - ARC review required
      [ ] N/A
      
    3.4.2 Authorization
      (see http://opensolaris.org/os/community/arc/bestpractices/rbac-intro/ and
	   http://opensolaris.org/os/community/arc/bestpractices/rbac-profiles/ and
	   http://opensolaris.org/os/community/arc/bestpractices/rbac-profiles/
           for details)
      Are there any setuid/setgid privileged binaries in the project?
      [ ] Yes - ARC review required
      [*] No - continue with next section (section 3.4.3)
      
      If yes then are the setuid/setgid privileges handled by the use of roles?
      [ ] Yes
      [ ] No - ARC review required

    3.4.3 Auditing
      (see http://opensolaris.org/os/community/arc/policies/audit-policy/ for details)
      (see http://opensolaris.org/os/community/arc/caselog/2003/397 for details)
      Does this component contain administrative or security enforcing software?
      [ ] Yes - ARC review required
      [*] No - continue to next section (section 3.4.4)
      
      (see http://opensolaris.org/os/community/arc/caselog/2003/397 for details)
      Do the components create audit logs detailing what took place including what event
      took place, who was involved, when the event took place?
      [ ] Yes - ARC contract and Audit project team review required
      [ ] No - ARC review required
        
        
    3.4.4 Authentication
      (see http://opensolaris.org/os/community/arc/policies/PAM/)
      Do the components contain any authentication code?
      [ ] Yes
      [*] No - continue to next section (section 3.4.5)
      
      If yes do the components use PAM (plugable authentication modules) for authentication?
      [ ] Yes
      [ ] No - ARC review required
      
      If yes is a single PAM session maintained during authentication?
      [ ] Yes
      [ ] No - ARC review required
      
      If yes are the components sufficiently privileged to allow the requested 
      operations (authentication, password change, process credential manipulation, 
      audit state initialization)?
      [ ] Yes - briefly describe below
      [ ] No - ARC review required
      
    3.4.5 Passwords
      (see http://opensolaris.org/os/community/arc/bestpractices/passwords-cli/ and
           http://opensolaris.org/os/community/arc/bestpractices/passwords-files/ for details)
      Do any of the components for the project deal with passwords?
      [ ] Yes
      [*] No - continue to next section (section 3.4.6)
      
      If yes are these passwords entered via the CLI or environment?
      [ ] Yes - ARC review required
      [ ] No
      
      Are passwords stored within the file system for the component?
      [ ] Yes
      [ ] No - continue to next section (section 3.4.6)
      
      If yes are the permissions on the file such to protect exposing the password(s)?
      [ ] Yes
      [ ] No - ARC review required
      
    3.4.6 General Security Questions
      (see http://opensolaris.org/os/community/arc/bestpractices/security-questions/ for details)
      Are there any network protocols used by this project?
      [ ] Yes
      [*] No - continue with the next section (section 3.5)
      
      Do the components use standard network protocols?
      [ ] Yes
      [ ] No - ARC review required
      
      Do network services for the project make decisions based upon user, host or 
      service identities?
      [ ] Yes - explain below
      [ ] No
      [ ] N/A
      
      Do the components make use of secret information during authentication and/or
      authorization?
      [ ] Yes - explain below
      [ ] No
      [ ] N/A
  
  3.5 Networking
      Do the components access the network?
      [ ] Yes
      [*] No - continue with the next section (section 3.6)
      
      If yes do the components support IPv6?
      [ ] Yes 
      [ ] No - ARC review required
          
  3.6 Core Solaris Components
      Do the components of this project compete with or duplicate core 
      Solaris components?
      [ ] Yes - ARC review required
      [*] No 
      
      Examples of Core Solaris Components include but are not limited to:
      
        Secure By Default
        Authorizations
        PAM -- Plugable Authentication Module
        Privilege
        PRM -- Process Rights Management -- Privilege
        Audit
        xVm -- Virtualization
        zones / Solaris Containers
        PRM -- Process Rights Management
        RBAC -- Role Based Access Control
        TX / Trusted Extensions
        ZFS
        SMF -- Service Management Facility
        FMA -- Fault Management Architecture
        SCF -- Smart Card Facility
        IPsec
        
4.0 Interfaces
  4.1 Exported Interfaces
  
    Interface Name		Classification		Comments
    -----------------		---------------		-----------------
    SUNWperl-pmtools	      	Uncommitted	      	Package
    usr/bin/basepods          	Uncommitted       	Perl script
    usr/bin/faqpods           	Uncommitted      	Perl script
    usr/bin/modpods           	Uncommitted      	Perl script
    usr/bin/pfcat             	Uncommitted       	Perl script
    usr/bin/plxload           	Uncommitted       	Perl script
    usr/bin/pmall             	Uncommitted       	Perl script
    usr/bin/pman              	Uncommitted       	Perl script
    usr/bin/pmcat             	Uncommitted       	Perl script
    usr/bin/pmdesc            	Uncommitted       	Perl script
    usr/bin/pmdirs            	Uncommitted       	Perl script
    usr/bin/pmeth             	Uncommitted       	Perl script
    usr/bin/pmexp             	Uncommitted       	Perl script
    usr/bin/pmfunc            	Uncommitted       	Perl script
    usr/bin/pminst            	Uncommitted       	Perl script
    usr/bin/pmload            	Uncommitted       	Perl script
    usr/bin/pmls              	Uncommitted       	Perl script
    usr/bin/pmpath            	Uncommitted       	Perl script
    usr/bin/pmvers            	Uncommitted       	Perl script
    usr/bin/podgrep           	Uncommitted       	Perl script
    usr/bin/podpath           	Uncommitted       	Perl script
    usr/bin/pods              	Uncommitted       	Perl script
    usr/bin/podtoc            	Uncommitted       	Perl script
    usr/bin/sitepods          	Uncommitted       	Perl script
    usr/bin/stdpods           	Uncommitted       	Perl script
    
  4.2 Imported Interfaces

    Interface Name		Classification 	Comments
    --------------------------- --------------	--------------------------
    SUNWperl584core		Volatile	Package
    
Appendix A - References
  [1] http://search.cpan.org/dist/pmtools/

  OSR ID# 10512
  RFE ID# 6785005


6. Resources and Schedule
    6.4. Steering Committee requested information
   	6.4.1. Consolidation C-team Name:
		SFW
    6.5. ARC review type: FastTrack
    6.6. ARC Exposure: open


From carlsonj@phorcys.east.sun.com Mon Feb 23 13:01:44 2009
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 n1NL1iTF029673
	for <psarc-ext@sac.sfbay.sun.com>; Mon, 23 Feb 2009 13:01:44 -0800 (PST)
Received: from nwk-avmta-1.SFBay.Sun.COM (nwk-avmta-1.SFBay.Sun.COM [129.146.11.74])
	by newsunmail1brm.central.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id n1NL1X6u041801;
	Mon, 23 Feb 2009 14:01:42 -0700 (MST)
Received: from pmxchannel-daemon.nwk-avmta-1.sfbay.Sun.COM by
 nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0KFJ00C0ZEETUA00@nwk-avmta-1.sfbay.Sun.COM>; Mon,
 23 Feb 2009 13:01:41 -0800 (PST)
Received: from phorcys.east.sun.com ([129.148.174.143])
 by nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0KFJ00HEFEER0460@nwk-avmta-1.sfbay.Sun.COM>; Mon,
 23 Feb 2009 13:01:40 -0800 (PST)
Received: from phorcys.east.sun.com (localhost [127.0.0.1])
	by phorcys.east.sun.com (8.14.3+Sun/8.14.3) with ESMTP id n1NL1TZ8006874; Mon,
 23 Feb 2009 16:01:29 -0500 (EST)
Received: (from carlsonj@localhost)
	by phorcys.east.sun.com (8.14.3+Sun/8.14.3/Submit) id n1NL1TPH006871; Mon,
 23 Feb 2009 16:01:29 -0500 (EST)
Date: Mon, 23 Feb 2009 16:01:29 -0500
From: James Carlson <james.d.carlson@sun.com>
Subject: Re: perl-pmtools [PSARC/2009/121 FastTrack timeout 02/27/2009]
In-reply-to: <200902202251.n1KMpbYk018259@sac.sfbay.sun.com>
To: James Walker <jw137282@sac.sfbay.sun.com>
Cc: PSARC-ext@sun.com, Yuan.Fan@sun.com
Message-id: <18851.3753.426701.565475@gargle.gargle.HOWL>
MIME-version: 1.0
X-Mailer: VM 7.01 under Emacs 21.3.1
Content-type: text/plain; charset=us-ascii
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
References: <200902202251.n1KMpbYk018259@sac.sfbay.sun.com>
Status: RO
Content-Length: 1176

James Walker writes:
>     Interface Name		Classification		Comments
>     -----------------		---------------		-----------------
>     SUNWperl-pmtools	      	Uncommitted	      	Package
>     usr/bin/basepods          	Uncommitted       	Perl script
>     usr/bin/faqpods           	Uncommitted      	Perl script
[...]

The installer for pmtools seems to use "perl -V:installscript" as a
default install location for these things, and that resolves as
/usr/perl5/5.8.4/bin on the current Perl in Solaris.

I note that of the things currently in that directory, *only*
/usr/perl5/5.4.8/bin/perl has a symlink in /usr/bin.  The rest do not.

This case seems to propose installing directly in /usr/bin, or perhaps
it'll link from /usr/perl5/5.4.8/bin (the intention is a little
unclear).

Where is the right place to install things like this?  Is this a new
precedent, or are those other things (such as the rather useful
'perldoc') installed incorrectly?

-- 
James Carlson, Solaris Networking              <james.d.carlson@sun.com>
Sun Microsystems / 35 Network Drive        71.232W   Vox +1 781 442 2084
MS UBUR02-212 / Burlington MA 01803-2757   42.496N   Fax +1 781 442 1677

From James.Walker@sun.com Mon Feb 23 14:02:31 2009
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 n1NM2UPm001388
	for <psarc-ext@sac.sfbay.sun.com>; Mon, 23 Feb 2009 14:02:31 -0800 (PST)
Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11])
	by sunmail4.singapore.sun.com (8.13.4+Sun/8.13.3/ENSMAIL,v2.2) with ESMTP id n1NM2MfV008672
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Tue, 24 Feb 2009 06:02:29 +0800 (SGT)
Received: from pmxchannel-daemon.brm-avmta-1.central.sun.com by
 brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0KFJ00B0BH84YM00@brm-avmta-1.central.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@Sun.Com); Mon, 23 Feb 2009 15:02:28 -0700 (MST)
Received: from brmea-mail-2.sun.com ([192.18.98.43])
 by brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0KFJ00DQFH83WVE0@brm-avmta-1.central.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@Sun.Com); Mon,
 23 Feb 2009 15:02:27 -0700 (MST)
Received: from fe-amer-10.sun.com ([192.18.109.80])
	by brmea-mail-2.sun.com (8.13.6+Sun/8.12.9) with ESMTP id n1NM2Rg5002983	for
 <PSARC-ext@Sun.Com>; Mon, 23 Feb 2009 22:02:27 +0000 (GMT)
Received: from conversion-daemon.mail-amer.sun.com by mail-amer.sun.com
 (Sun Java(tm) System Messaging Server 7.0-3.01 64bit (built Dec 23 2008))
 id <0KFJ00100GF5VS00@mail-amer.sun.com> for PSARC-ext@Sun.Com
 (ORCPT PSARC-ext@Sun.Com); Mon, 23 Feb 2009 15:02:27 -0700 (MST)
Received: from [172.20.25.153] ([unknown] [172.20.25.153])
 by mail-amer.sun.com (Sun Java(tm) System Messaging Server 7.0-3.01 64bit
 (built Dec 23 2008)) with ESMTPSA id <0KFJ006I7H7UJG80@mail-amer.sun.com>; Mon,
 23 Feb 2009 15:02:19 -0700 (MST)
Date: Mon, 23 Feb 2009 15:03:35 -0700
From: Jim Walker <James.Walker@sun.com>
Subject: Re: perl-pmtools [PSARC/2009/121 FastTrack timeout 02/27/2009]
In-reply-to: <18851.3753.426701.565475@gargle.gargle.HOWL>
Sender: James.Walker@sun.com
To: James Carlson <James.D.Carlson@sun.com>
Cc: James Walker <jw137282@sac.sfbay.sun.com>, PSARC-ext@sun.com,
        Yuan.Fan@sun.com
Reply-to: James.Walker@sun.com
Message-id: <49A31D37.5040504@sun.com>
Organization: Sun Microsystems, Inc.
MIME-version: 1.0
Content-type: text/plain; format=flowed; charset=ISO-8859-1
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
References: <200902202251.n1KMpbYk018259@sac.sfbay.sun.com>
 <18851.3753.426701.565475@gargle.gargle.HOWL>
User-Agent: Thunderbird 2.0.0.14 (X11/20080728)
Status: RO
Content-Length: 1369

James Carlson wrote:
> James Walker writes:
>>     Interface Name		Classification		Comments
>>     -----------------	---------------		-----------------
>>     SUNWperl-pmtools	      	Uncommitted	      	Package
>>     usr/bin/basepods         Uncommitted       	Perl script
>>     usr/bin/faqpods          Uncommitted      	Perl script
> [...]
> 
> The installer for pmtools seems to use "perl -V:installscript" as a
> default install location for these things, and that resolves as
> /usr/perl5/5.8.4/bin on the current Perl in Solaris.
> 
> I note that of the things currently in that directory, *only*
> /usr/perl5/5.4.8/bin/perl has a symlink in /usr/bin.  The rest do not.
> 
> This case seems to propose installing directly in /usr/bin, or perhaps
> it'll link from /usr/perl5/5.4.8/bin (the intention is a little
> unclear).
> 
> Where is the right place to install things like this?  Is this a new
> precedent, or are those other things (such as the rather useful
> 'perldoc') installed incorrectly?

Currently this case is proposing to install directly in the /usr/bin
directory without symlinks.

 From a familiarity perspective, /usr/bin is the right location:
http://packages.debian.org/etch/all/pmtools/filelist

But, the project team is open to suggestions.

Cheers,
Jim

-- 
Jim Walker, http://blogs.sun.com/jwalker
Sun Microsystems, Broomfield, Colorado

From carlsonj@phorcys.east.sun.com Mon Feb 23 14:09:03 2009
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 n1NM923c001421
	for <psarc-ext@sac.sfbay.sun.com>; Mon, 23 Feb 2009 14:09:02 -0800 (PST)
Received: from nwk-avmta-1.SFBay.Sun.COM (nwk-avmta-1.SFBay.Sun.COM [129.146.11.74])
	by newsunmail1brm.central.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id n1NM8lv6018670;
	Mon, 23 Feb 2009 15:09:00 -0700 (MST)
Received: from pmxchannel-daemon.nwk-avmta-1.sfbay.Sun.COM by
 nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0KFJ00284HJ0DO00@nwk-avmta-1.sfbay.Sun.COM>; Mon,
 23 Feb 2009 14:09:00 -0800 (PST)
Received: from phorcys.east.sun.com ([129.148.174.143])
 by nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0KFJ00H0UHIX08C0@nwk-avmta-1.sfbay.Sun.COM>; Mon,
 23 Feb 2009 14:08:58 -0800 (PST)
Received: from phorcys.east.sun.com (localhost [127.0.0.1])
	by phorcys.east.sun.com (8.14.3+Sun/8.14.3) with ESMTP id n1NM8leD007244; Mon,
 23 Feb 2009 17:08:47 -0500 (EST)
Received: (from carlsonj@localhost)
	by phorcys.east.sun.com (8.14.3+Sun/8.14.3/Submit) id n1NM8lI5007241; Mon,
 23 Feb 2009 17:08:47 -0500 (EST)
Date: Mon, 23 Feb 2009 17:08:47 -0500
From: James Carlson <James.D.Carlson@sun.com>
Subject: Re: perl-pmtools [PSARC/2009/121 FastTrack timeout 02/27/2009]
In-reply-to: <49A31D37.5040504@sun.com>
To: James.Walker@sun.com
Cc: James Walker <jw137282@sac.sfbay.sun.com>, PSARC-ext@sun.com,
        Yuan.Fan@sun.com
Message-id: <18851.7791.628736.76695@gargle.gargle.HOWL>
MIME-version: 1.0
X-Mailer: VM 7.01 under Emacs 21.3.1
Content-type: text/plain; charset=us-ascii
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
References: <200902202251.n1KMpbYk018259@sac.sfbay.sun.com>
 <18851.3753.426701.565475@gargle.gargle.HOWL> <49A31D37.5040504@sun.com>
Status: RO
Content-Length: 1606

Jim Walker writes:
> > The installer for pmtools seems to use "perl -V:installscript" as a
> > default install location for these things, and that resolves as
> > /usr/perl5/5.8.4/bin on the current Perl in Solaris.
> > 
> > I note that of the things currently in that directory, *only*
> > /usr/perl5/5.4.8/bin/perl has a symlink in /usr/bin.  The rest do not.
> > 
> > This case seems to propose installing directly in /usr/bin, or perhaps
> > it'll link from /usr/perl5/5.4.8/bin (the intention is a little
> > unclear).
> > 
> > Where is the right place to install things like this?  Is this a new
> > precedent, or are those other things (such as the rather useful
> > 'perldoc') installed incorrectly?
> 
> Currently this case is proposing to install directly in the /usr/bin
> directory without symlinks.
> 
>  From a familiarity perspective, /usr/bin is the right location:
> http://packages.debian.org/etch/all/pmtools/filelist
> 
> But, the project team is open to suggestions.

So, are all those other Perl deliveries on Solaris broken?  If so, is
there a bug filed against them so they can get fixed?

I'd rather have some intentional architecture here rather than a
collection of seemingly arbitrary decisions.  Asserting that there's
one right way to do this (which I _think_ you're doing by pointing at
the Debian documentation) goes only part way in that direction.

-- 
James Carlson, Solaris Networking              <james.d.carlson@sun.com>
Sun Microsystems / 35 Network Drive        71.232W   Vox +1 781 442 2084
MS UBUR02-212 / Burlington MA 01803-2757   42.496N   Fax +1 781 442 1677

From James.Walker@sun.com Mon Feb 23 15:16:11 2009
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 n1NNGAQE003688
	for <psarc-ext@sac.sfbay.sun.com>; Mon, 23 Feb 2009 15:16:11 -0800 (PST)
Received: from nwk-avmta-1.SFBay.Sun.COM (nwk-avmta-1.SFBay.Sun.COM [129.146.11.74])
	by newsunmail1brm.central.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id n1NNFr3j059179
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Mon, 23 Feb 2009 16:16:10 -0700 (MST)
Received: from pmxchannel-daemon.nwk-avmta-1.sfbay.Sun.COM by
 nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0KFJ00F0VKMFDH00@nwk-avmta-1.sfbay.Sun.COM> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Mon, 23 Feb 2009 15:15:51 -0800 (PST)
Received: from brmea-mail-1.sun.com ([192.18.98.31])
 by nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0KFJ00A7IKMEYXD0@nwk-avmta-1.sfbay.Sun.COM> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Mon,
 23 Feb 2009 15:15:50 -0800 (PST)
Received: from fe-amer-09.sun.com ([192.18.109.79])
	by brmea-mail-1.sun.com (8.13.6+Sun/8.12.9) with ESMTP id n1NNFo0D024845	for
 <PSARC-ext@sun.com>; Mon, 23 Feb 2009 23:15:50 +0000 (GMT)
Received: from conversion-daemon.mail-amer.sun.com by mail-amer.sun.com
 (Sun Java(tm) System Messaging Server 7.0-3.01 64bit (built Dec 23 2008))
 id <0KFJ00L00KKU7B00@mail-amer.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Mon, 23 Feb 2009 16:15:50 -0700 (MST)
Received: from [172.20.25.153] ([unknown] [172.20.25.153])
 by mail-amer.sun.com (Sun Java(tm) System Messaging Server 7.0-3.01 64bit
 (built Dec 23 2008)) with ESMTPSA id <0KFJ007GXKLSIBF0@mail-amer.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Mon,
 23 Feb 2009 16:15:28 -0700 (MST)
Date: Mon, 23 Feb 2009 16:16:47 -0700
From: Jim Walker <James.Walker@sun.com>
Subject: Re: perl-pmtools [PSARC/2009/121 FastTrack timeout 02/27/2009]
In-reply-to: <18851.7791.628736.76695@gargle.gargle.HOWL>
Sender: James.Walker@sun.com
To: James Carlson <James.D.Carlson@sun.com>
Cc: PSARC-ext@sun.com, Yuan.Fan@sun.com
Reply-to: James.Walker@sun.com
Message-id: <49A32E5F.7070603@sun.com>
Organization: Sun Microsystems, Inc.
MIME-version: 1.0
Content-type: text/plain; format=flowed; charset=ISO-8859-1
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
References: <200902202251.n1KMpbYk018259@sac.sfbay.sun.com>
 <18851.3753.426701.565475@gargle.gargle.HOWL> <49A31D37.5040504@sun.com>
 <18851.7791.628736.76695@gargle.gargle.HOWL>
User-Agent: Thunderbird 2.0.0.14 (X11/20080728)
Status: RO
Content-Length: 1482

James Carlson wrote:
> 
> So, are all those other Perl deliveries on Solaris broken?  If so, is
> there a bug filed against them so they can get fixed?
> 
> I'd rather have some intentional architecture here rather than a
> collection of seemingly arbitrary decisions.  Asserting that there's
> one right way to do this (which I _think_ you're doing by pointing at
> the Debian documentation) goes only part way in that direction.

The project team evaluated the target directories based on what was
commonly done by other unix distributions, but the utilities provided
by pmtools are closely related to the perl module and pod tools and
utilities found in /usr/perl5/5.8.4/bin (/usr/perl5/bin) on OpenSolaris.

My recommendation would be to deliver pmtools to the /usr/perl5/5.8.4/bin
directory now, and file a bug to rethink where perl components should go
in mass like you suggest. This would get end users access to the tools in
the least amount of time.

Moving current Perl components around is beyond the scope of the project
team. I don't know who the current Perl masters are. We may be able to
help to some extent, but resources are extremely tight (ie. we need a
re-architecture project that focuses on putting things in the "right"
places). If we move Perl out of ON into SFW (and make SFW easier to build),
the broader OpenSolaris community would be able to help more...

Cheers,
Jim

-- 
Jim Walker, http://blogs.sun.com/jwalker
Sun Microsystems, Broomfield, Colorado

From James.Walker@sun.com Wed Feb 25 08:09:37 2009
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 n1PG9akd004967
	for <psarc-ext@sac.sfbay.sun.com>; Wed, 25 Feb 2009 08:09:37 -0800 (PST)
Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11])
	by sunmail4.singapore.sun.com (8.13.4+Sun/8.13.3/ENSMAIL,v2.2) with ESMTP id n1PG9MM5012072
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Thu, 26 Feb 2009 00:09:36 +0800 (SGT)
Received: from pmxchannel-daemon.brm-avmta-1.central.sun.com by
 brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0KFM0070RQ7YRK00@brm-avmta-1.central.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@Sun.Com); Wed, 25 Feb 2009 09:09:34 -0700 (MST)
Received: from brmea-mail-2.sun.com ([192.18.98.43])
 by brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0KFM00C9ZQ7UGCE0@brm-avmta-1.central.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@Sun.Com); Wed,
 25 Feb 2009 09:09:30 -0700 (MST)
Received: from fe-amer-10.sun.com ([192.18.109.80])
	by brmea-mail-2.sun.com (8.13.6+Sun/8.12.9) with ESMTP id n1PG9UdJ013520	for
 <PSARC-ext@Sun.Com>; Wed, 25 Feb 2009 16:09:30 +0000 (GMT)
Received: from conversion-daemon.mail-amer.sun.com by mail-amer.sun.com
 (Sun Java(tm) System Messaging Server 7.0-3.01 64bit (built Dec 23 2008))
 id <0KFM00000O3D9G00@mail-amer.sun.com> for PSARC-ext@Sun.Com
 (ORCPT PSARC-ext@Sun.Com); Wed, 25 Feb 2009 09:09:30 -0700 (MST)
Received: from [172.20.25.153] ([unknown] [172.20.25.153])
 by mail-amer.sun.com (Sun Java(tm) System Messaging Server 7.0-3.01 64bit
 (built Dec 23 2008)) with ESMTPSA id <0KFM00CERQ7IQUG0@mail-amer.sun.com> for
 PSARC-ext@Sun.Com (ORCPT PSARC-ext@Sun.Com); Wed,
 25 Feb 2009 09:09:19 -0700 (MST)
Date: Wed, 25 Feb 2009 09:10:47 -0700
From: Jim Walker <James.Walker@sun.com>
Subject: Re: perl-pmtools [PSARC/2009/121 FastTrack timeout 02/27/2009]
In-reply-to: <200902202251.n1KMpbYk018259@sac.sfbay.sun.com>
Sender: James.Walker@sun.com
To: psarc-ext@sun.com
Cc: Yuan.Fan@sun.com
Reply-to: James.Walker@sun.com
Message-id: <49A56D87.7050704@sun.com>
Organization: Sun Microsystems, Inc.
MIME-version: 1.0
Content-type: text/plain; format=flowed; charset=ISO-8859-1
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
References: <200902202251.n1KMpbYk018259@sac.sfbay.sun.com>
User-Agent: Thunderbird 2.0.0.14 (X11/20080728)
Status: RO
Content-Length: 2319

Based on feedback from Jim, the project team updated the
proposal to place the Perl scripts in /usr/perl5/5.8.4/bin.

In addition, the Loaded.pm module was added along with it's
man page. It is used by the pmtools scripts, but is also
user callable, so we are classifying it Uncommitted.

The update interface table is shown below.

Cheers,
Jim

+++

   4.1 Exported Interfaces

     Interface Name                      Classification  Comments
     -----------------                   --------------- -----------------
     SUNWperl-pmtools                    Uncommitted     Package
     usr/perl5/5.8.4/bin/basepods        Uncommitted     Perl script
     usr/perl5/5.8.4/bin/faqpods         Uncommitted     Perl script
     usr/perl5/5.8.4/bin/modpods         Uncommitted     Perl script
     usr/perl5/5.8.4/bin/pfcat           Uncommitted     Perl script
     usr/perl5/5.8.4/bin/plxload         Uncommitted     Perl script
     usr/perl5/5.8.4/bin/pmall           Uncommitted     Perl script
     usr/perl5/5.8.4/bin/pman            Uncommitted     Perl script
     usr/perl5/5.8.4/bin/pmcat           Uncommitted     Perl script
     usr/perl5/5.8.4/bin/pmdesc          Uncommitted     Perl script
     usr/perl5/5.8.4/bin/pmdirs          Uncommitted     Perl script
     usr/perl5/5.8.4/bin/pmeth           Uncommitted     Perl script
     usr/perl5/5.8.4/bin/pmexp           Uncommitted     Perl script
     usr/perl5/5.8.4/bin/pmfunc          Uncommitted     Perl script
     usr/perl5/5.8.4/bin/pminst          Uncommitted     Perl script
     usr/perl5/5.8.4/bin/pmload          Uncommitted     Perl script
     usr/perl5/5.8.4/bin/pmls            Uncommitted     Perl script
     usr/perl5/5.8.4/bin/pmpath          Uncommitted     Perl script
     usr/perl5/5.8.4/bin/pmvers          Uncommitted     Perl script
     usr/perl5/5.8.4/bin/podgrep         Uncommitted     Perl script
     usr/perl5/5.8.4/bin/podpath         Uncommitted     Perl script
     usr/perl5/5.8.4/bin/pods            Uncommitted     Perl script
     usr/perl5/5.8.4/bin/podtoc          Uncommitted     Perl script
     usr/perl5/5.8.4/bin/sitepods        Uncommitted     Perl script
     usr/perl5/5.8.4/bin/stdpods         Uncommitted     Perl script

     usr/perl5/vendor_perl/5.8.4/Devel/Loaded.pm Uncommitted     Perl script

From carlsonj@phorcys.east.sun.com Wed Feb 25 08:17:10 2009
Received: from sunmail3mpk.sfbay.sun.com (sunmail3mpk.SFBay.Sun.COM [129.146.11.52])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id n1PGHAMp006633
	for <psarc-ext@sac.sfbay.sun.com>; Wed, 25 Feb 2009 08:17:10 -0800 (PST)
Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11])
	by sunmail3mpk.sfbay.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id n1PGH1ae012328;
	Wed, 25 Feb 2009 08:17:07 -0800 (PST)
Received: from pmxchannel-daemon.brm-avmta-1.central.sun.com by
 brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0KFM0080NQKHES00@brm-avmta-1.central.sun.com>; Wed,
 25 Feb 2009 09:17:05 -0700 (MST)
Received: from phorcys.east.sun.com ([129.148.174.143])
 by brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0KFM008HEQKE5Q00@brm-avmta-1.central.sun.com>; Wed,
 25 Feb 2009 09:17:02 -0700 (MST)
Received: from phorcys.east.sun.com (localhost [127.0.0.1])
	by phorcys.east.sun.com (8.14.3+Sun/8.14.3) with ESMTP id n1PGGpwA013413; Wed,
 25 Feb 2009 11:16:51 -0500 (EST)
Received: (from carlsonj@localhost)
	by phorcys.east.sun.com (8.14.3+Sun/8.14.3/Submit) id n1PGGpPM013410; Wed,
 25 Feb 2009 11:16:51 -0500 (EST)
Date: Wed, 25 Feb 2009 11:16:51 -0500
From: James Carlson <james.d.carlson@sun.com>
Subject: Re: perl-pmtools [PSARC/2009/121 FastTrack timeout 02/27/2009]
In-reply-to: <49A56D87.7050704@sun.com>
To: James.Walker@sun.com
Cc: psarc-ext@sun.com, Yuan.Fan@sun.com
Message-id: <18853.28403.391865.552805@gargle.gargle.HOWL>
MIME-version: 1.0
X-Mailer: VM 7.01 under Emacs 21.3.1
Content-type: text/plain; charset=us-ascii
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
References: <200902202251.n1KMpbYk018259@sac.sfbay.sun.com>
 <49A56D87.7050704@sun.com>
Status: RO
Content-Length: 448

Jim Walker writes:
> Based on feedback from Jim, the project team updated the
> proposal to place the Perl scripts in /usr/perl5/5.8.4/bin.

+1, though I hope we have someone somewhere thinking about these wolly
Perl paths.

-- 
James Carlson, Solaris Networking              <james.d.carlson@sun.com>
Sun Microsystems / 35 Network Drive        71.232W   Vox +1 781 442 2084
MS UBUR02-212 / Burlington MA 01803-2757   42.496N   Fax +1 781 442 1677

From James.Walker@sun.com Wed Feb 25 10:20:01 2009
Received: from sunmail3mpk.sfbay.sun.com (sunmail3mpk.SFBay.Sun.COM [129.146.11.52])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id n1PIK1tD013286
	for <psarc-ext@sac.sfbay.sun.com>; Wed, 25 Feb 2009 10:20:01 -0800 (PST)
Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11])
	by sunmail3mpk.sfbay.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id n1PIJsmY003909
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Wed, 25 Feb 2009 10:20:00 -0800 (PST)
Received: from pmxchannel-daemon.brm-avmta-1.central.sun.com by
 brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0KFM00K0DW9AL400@brm-avmta-1.central.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@Sun.Com); Wed, 25 Feb 2009 11:19:58 -0700 (MST)
Received: from brmea-mail-1.sun.com ([192.18.98.31])
 by brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0KFM008FJW9A5NB0@brm-avmta-1.central.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@Sun.Com); Wed,
 25 Feb 2009 11:19:58 -0700 (MST)
Received: from fe-amer-09.sun.com ([192.18.109.79])
	by brmea-mail-1.sun.com (8.13.6+Sun/8.12.9) with ESMTP id n1PIJwDv024637	for
 <PSARC-ext@Sun.Com>; Wed, 25 Feb 2009 18:19:58 +0000 (GMT)
Received: from conversion-daemon.mail-amer.sun.com by mail-amer.sun.com
 (Sun Java(tm) System Messaging Server 7.0-3.01 64bit (built Dec 23 2008))
 id <0KFM00500VCQBL00@mail-amer.sun.com> for PSARC-ext@Sun.Com
 (ORCPT PSARC-ext@Sun.Com); Wed, 25 Feb 2009 11:19:58 -0700 (MST)
Received: from [172.20.25.153] ([unknown] [172.20.25.153])
 by mail-amer.sun.com (Sun Java(tm) System Messaging Server 7.0-3.01 64bit
 (built Dec 23 2008)) with ESMTPSA id <0KFM008BVW92LSD0@mail-amer.sun.com> for
 PSARC-ext@Sun.Com (ORCPT PSARC-ext@Sun.Com); Wed,
 25 Feb 2009 11:19:50 -0700 (MST)
Date: Wed, 25 Feb 2009 11:21:20 -0700
From: Jim Walker <James.Walker@sun.com>
Subject: Re: perl-pmtools [PSARC/2009/121 FastTrack timeout 02/27/2009]
In-reply-to: <200902202251.n1KMpbYk018259@sac.sfbay.sun.com>
Sender: James.Walker@sun.com
To: PSARC-ext@sun.com
Cc: Yuan.Fan@sun.com
Reply-to: James.Walker@sun.com
Message-id: <49A58C20.5080503@sun.com>
Organization: Sun Microsystems, Inc.
MIME-version: 1.0
Content-type: text/plain; format=flowed; charset=ISO-8859-1
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
References: <200902202251.n1KMpbYk018259@sac.sfbay.sun.com>
User-Agent: Thunderbird 2.0.0.14 (X11/20080728)
Status: RO
Content-Length: 61

This case was approved at todays PSARC meeting.

Cheers,
Jim

