From sacadmin Mon Aug 18 10:09:51 2008 Received: from sr1-umpk-16.sfbay.sun.com (sr1-umpk-16.SFBay.Sun.COM [129.145.154.66]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m7IH9pSd002243; Mon, 18 Aug 2008 10:09:51 -0700 (PDT) Received: from sr1-umpk-16.sfbay.sun.com (localhost [127.0.0.1]) by sr1-umpk-16.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m7IH9oE8019756; Mon, 18 Aug 2008 10:09:50 -0700 (PDT) Received: (from johnf@localhost) by sr1-umpk-16.sfbay.sun.com (8.13.8+Sun/8.13.8/Submit) id m7IH9o2S019750; Mon, 18 Aug 2008 10:09:50 -0700 (PDT) Date: Mon, 18 Aug 2008 10:09:50 -0700 (PDT) From: John Fischer Message-Id: <200808181709.m7IH9o2S019750@sr1-umpk-16.sfbay.sun.com> To: LSARC@sac.sfbay.sun.com Cc: ghee.teo@sun.com Subject: gnome-nettool [LSARC/2008/529 FastTrack timeout 08/25/2008] Status: RO Content-Length: 6482 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: gnome-nettool 1.2. Name of Document Author/Supplier: Author: Ghee Teo 1.3 Date of This Document: 18 August, 2008 4. Technical Description 1. Introduction 1.1. Project/Component Working Name: gnome-nettool 1.2. Name of Document Author/Supplier: Author: Ghee Teo (ghee.teo@sun.com) 1.3. Date of This Document: 12/08/2008 1.4. Name of Major Document Customer(s)/Consumer(s): 1.4.1. The PAC or CPT you expect to review your project: Solaris PAC 1.4.2. The ARC(s) you expect to review your project: LSARC 1.4.3. The Director/VP who is "Sponsoring" this project: Robert O'Dea 1.4.4. The name of your business unit: Software - OPG 1.5. Email Aliases: 1.5.1. Responsible Manager: leo.binchy@sun.com 1.5.2. Responsible Engineer: ghee.teo@sun.com 1.5.3. Interest List: jds-dev@sun.com 2. Project Summary 2.1. Project Description: gnome-nettool provides a GTK+ GUI to a set of networking command line tools including ping(1M), netstat(1M), traceroute(1M), dig(1M), finger(1), whois(1), port scan and and showing network device information. The benefit of this tool is to provide a collection of network client commands in a single place through an easy to use GUI. 3. Business Summary gnome-nettool has been adopted by a number of popular distributions including ubuntu and debian. It is something OpenSolaris can have on the desktop to improve its appeal in the network tools. 4. Technical Description: 4.1. Details: gnome-nettool is a GUI wrapper around a number of popular network command line program. It was first developed as gnome-network module [1] also provided GUI for remote ssh access. However, this is now removed from gnome-nettool and making it a simple network tool set GUI. gnome-nettool provides 8 tabs each performing a set of network related functions. They are presented in the following order: Tab 1: Devices - this displays all the network interface devices on the machine including loopback interface. For each interface, the IP information, Interface details and data statistics that the interface holds are shown. Tab 2: Ping - User can enter a network address by name or numeric form before clicking on the Ping button. Data is displayed on the same tab. Tab 3: Netstat - it uses netstat to display (1) Routing Table information, (2) Active Network Services, (3) Multicast Information. Tab 4: Traceroute - User specifies a network address and the traceout output is shown in a table. Tab 5: Port Scan - User specifies a network address, and all its opened ports are shown. Tab 6: Lookup - User specifies a network address and also specifies the type of information required. Each of these will be looked up and displayed in a table. Tab 7: Finger - User specifies a user name and a network address, information about the user is 'fingered'. Tab 8: Whois - User specifies a domain address and click on Whois button, the domain information is retrieved and displayed. 4.2. Interfaces: Exported Interfaces Interface Classification Comments --------------- --------------- ----------------------- /usr/bin/gnome-nettool Volatile the main program gnome-nettool.desktop Volatile dot desktop file SUNWgnome-nettool uncommitted package name Imported Interfaces Interface Classification Comments --------- -------------- -------- ping Stable PSARC1997/244 netstat Stable PSARC1997/312, PSARC2001/355 traceroute Stable PSARC/1997/355/ dig External PSARC/2001/586 (NOTE 2) finger Standard RFC 1288 (also PSARC/1996/246) whois Stable RFC954 NOTE: While these classification of these commands are stable and committed. gnome-nettool uses its text output whose stability is defined. However, given that these commands have been around for so long and their output would be relatively stable. NOTE 2: The ARC case for dig(1M) PSARC/2001/586 has planned to move its stablility from External to Evolving in its second release, but it did not happen. However, the version of dig does get updated by the BIND project, PSARC/2004/363, PSARC/2005/553. 4.3. Doc Impact: Man page is needed. 4.4. Packaging & Delivery: SUNWgnome-nettool - the package for gnome-nettool 4.5. Dependencies: In providing the network device information, gnome-nettool uses a standard API called, getifaddrs() which is a well known API implemented on BSD and also Linux. However, this function is not available in Solaris networking library. James Carlson has kindly donated a copy of this code that he has pre- viously worked on the WIDE project. This project essentially absorbed the code as a point patch for now since this consists of 2 files with 265 lines of code including comments. RFE 6731945 has been logged against solaris/library/network-other. The plan is that when that RFE is integrated this project can remove the patch. This approach is taken in order to fit into the release schedule of OpenSolaris 2008.11. 4.6. L10N Impact: The Desktop team is working with the G11N to evaluate and providing I18N/L10N support 4.7 Security Impact: None. 5. Reference Documents: [1] http://www.gnome.org/projects/gnome-network This is the only official website for gnome-nettool though the information contained here referred to gnome-network which is the previous incarnation of gnome-nettool. 6. Resources and Schedule 6.4. Steering Committee requested information 6.4.1. Consolidation C-team Name: JDS - Desktop 6.5. ARC review type: FastTrack 6.6. ARC Exposure: open From John.Fischer@sun.com Mon Aug 18 10:18:18 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 m7IHIHLr002457 for ; Mon, 18 Aug 2008 10:18:18 -0700 (PDT) Received: from nwk-avmta-1.SFBay.Sun.COM (nwk-avmta-1.SFBay.Sun.COM [129.146.11.74]) by sunmail4.singapore.sun.com (8.13.4+Sun/8.13.3/ENSMAIL,v2.2) with ESMTP id m7IHIE8W003265 for <@sunmail2sca.sfbay.sun.com:LSARC-ext@sun.com>; Tue, 19 Aug 2008 01:18:16 +0800 (SGT) 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 <0K5T0010342FNJ00@nwk-avmta-1.sfbay.Sun.COM> for LSARC-ext@sun.com (ORCPT LSARC-ext@sun.com); Mon, 18 Aug 2008 10:18:15 -0700 (PDT) Received: from brmea-mail-4.sun.com ([192.18.98.36]) by nwk-avmta-1.sfbay.Sun.COM (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0K5T00JTZ42E3830@nwk-avmta-1.sfbay.Sun.COM> for LSARC-ext@sun.com (ORCPT LSARC-ext@sun.com); Mon, 18 Aug 2008 10:18:15 -0700 (PDT) Received: from fe-amer-09.sun.com ([192.18.109.79]) by brmea-mail-4.sun.com (8.13.6+Sun/8.12.9) with ESMTP id m7IHIEHU019357 for ; Mon, 18 Aug 2008 17:18:14 +0000 (GMT) Received: from conversion-daemon.mail-amer.sun.com by mail-amer.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007)) id <0K5T00B0111O6C00@mail-amer.sun.com> (original mail from John.Fischer@Sun.COM) for LSARC-ext@sun.com (ORCPT LSARC-ext@sun.com); Mon, 18 Aug 2008 11:18:14 -0600 (MDT) Received: from 129.145.154.66 ([129.145.154.66]) by mail-amer.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007)) with ESMTPSA id <0K5T00BAD426EJD0@mail-amer.sun.com> for LSARC-ext@sun.com (ORCPT LSARC-ext@sun.com); Mon, 18 Aug 2008 11:18:07 -0600 (MDT) Date: Mon, 18 Aug 2008 10:18:06 -0700 From: John Fischer Subject: LSARC/2008/529 - Gnome Nettool Sender: John.Fischer@sun.com To: LSARC-ext@sun.com Cc: John Fischer , Ghee Teo Reply-to: John.Fischer@sun.com Message-id: <1219079886.9503.28.camel@sr1-umpk-16> MIME-version: 1.0 X-Mailer: Ximian Evolution 1.4.6.301 Content-type: multipart/mixed; boundary="Boundary_(ID_xlA+Y2WTi2FeMKZhSgqO2w)" X-PMX-Version: 5.4.1.325704 Status: RO Content-Length: 9634 --Boundary_(ID_xlA+Y2WTi2FeMKZhSgqO2w) Content-type: text/plain Content-transfer-encoding: 7BIT All, I am sponsoring this case for Ghee Teo of the JDS team in Ireland. The project directory contains the attached proposal and man page for gnome-nettool. I have set the timer for Monday, August 25th, 2008. This project proposes to integrate gnome-nettool into a Minor release of Solaris (i.e., Nevada/Open Solaris). This project provides a GTK+ GUI front end to networking tools such as ping, netstat, traceroute, dig, finger and whois. The interface is being declared as Volatile. Thanks, John --Boundary_(ID_xlA+Y2WTi2FeMKZhSgqO2w) Content-type: text/plain; charset=ASCII; name=proposal.txt Content-transfer-encoding: 7BIT Content-disposition: attachment; filename=proposal.txt 1. Introduction 1.1. Project/Component Working Name: gnome-nettool 1.2. Name of Document Author/Supplier: Author: Ghee Teo (ghee.teo@sun.com) 1.3. Date of This Document: 12/08/2008 1.4. Name of Major Document Customer(s)/Consumer(s): 1.4.1. The PAC or CPT you expect to review your project: Solaris PAC 1.4.2. The ARC(s) you expect to review your project: LSARC 1.4.3. The Director/VP who is "Sponsoring" this project: Robert O'Dea 1.4.4. The name of your business unit: Software - OPG 1.5. Email Aliases: 1.5.1. Responsible Manager: leo.binchy@sun.com 1.5.2. Responsible Engineer: ghee.teo@sun.com 1.5.3. Interest List: jds-dev@sun.com 2. Project Summary 2.1. Project Description: gnome-nettool provides a GTK+ GUI to a set of networking command line tools including ping(1M), netstat(1M), traceroute(1M), dig(1M), finger(1), whois(1), port scan and and showing network device information. The benefit of this tool is to provide a collection of network client commands in a single place through an easy to use GUI. 3. Business Summary gnome-nettool has been adopted by a number of popular distributions including ubuntu and debian. It is something OpenSolaris can have on the desktop to improve its appeal in the network tools. 4. Technical Description: 4.1. Details: gnome-nettool is a GUI wrapper around a number of popular network command line program. It was first developed as gnome-network module [1] also provided GUI for remote ssh access. However, this is now removed from gnome-nettool and making it a simple network tool set GUI. gnome-nettool provides 8 tabs each performing a set of network related functions. They are presented in the following order: Tab 1: Devices - this displays all the network interface devices on the machine including loopback interface. For each interface, the IP information, Interface details and data statistics that the interface holds are shown. Tab 2: Ping - User can enter a network address by name or numeric form before clicking on the Ping button. Data is displayed on the same tab. Tab 3: Netstat - it uses netstat to display (1) Routing Table information, (2) Active Network Services, (3) Multicast Information. Tab 4: Traceroute - User specifies a network address and the traceout output is shown in a table. Tab 5: Port Scan - User specifies a network address, and all its opened ports are shown. Tab 6: Lookup - User specifies a network address and also specifies the type of information required. Each of these will be looked up and displayed in a table. Tab 7: Finger - User specifies a user name and a network address, information about the user is 'fingered'. Tab 8: Whois - User specifies a domain address and click on Whois button, the domain information is retrieved and displayed. 4.2. Interfaces: Exported Interfaces Interface Classification Comments --------------- --------------- ----------------------- /usr/bin/gnome-nettool Volatile the main program gnome-nettool.desktop Volatile dot desktop file SUNWgnome-nettool Uncommitted package name Imported Interfaces Interface Classification Comments --------- -------------- -------- ping Stable PSARC1997/244 netstat Stable PSARC1997/312, PSARC2001/355 traceroute Stable PSARC/1997/355/ dig External PSARC/2001/586 (NOTE 2) finger Standard RFC 1288 (also PSARC/1996/246) whois Stable RFC954 NOTE: While these classification of these commands are stable and committed. gnome-nettool uses its text output whose stability is defined. However, given that these commands have been around for so long and their output would be relatively stable. NOTE 2: The ARC case for dig(1M) PSARC/2001/586 has planned to move its stablility from External to Evolving in its second release, but it did not happen. However, the version of dig does get updated by the BIND project, PSARC/2004/363, PSARC/2005/553. 4.3. Doc Impact: Man page is needed. 4.4. Packaging & Delivery: SUNWgnome-nettool - the package for gnome-nettool 4.5. Dependencies: In providing the network device information, gnome-nettool uses a standard API called, getifaddrs() which is a well known API implemented on BSD and also Linux. However, this function is not available in Solaris networking library. James Carlson has kindly donated a copy of this code that he has pre- viously worked on the WIDE project. This project essentially absorbed the code as a point patch for now since this consists of 2 files with 265 lines of code including comments. RFE 6731945 has been logged against solaris/library/network-other. The plan is that when that RFE is integrated this project can remove the patch. This approach is taken in order to fit into the release schedule of OpenSolaris 2008.11. 4.6. L10N Impact: The Desktop team is working with the G11N to evaluate and providing I18N/L10N support 4.7 Security Impact: None. 5. Reference Documents: [1] http://www.gnome.org/projects/gnome-network This is the only official website for gnome-nettool though the information contained here referred to gnome-network which is the previous incarnation of gnome-nettool. --Boundary_(ID_xlA+Y2WTi2FeMKZhSgqO2w) Content-type: text/plain; charset=ASCII; name=gnome-nettool.man.txt Content-transfer-encoding: 7BIT Content-disposition: attachment; filename=gnome-nettool.man.txt NAME gnome-nettool(1) gnome-nettool - Graphical front end to network clients SYNOPSIS gnome-nettool [-i DEVICE | --info=DEVICE] [-p HOST | --ping=HOST] [ -n COMMAND | --netstat=COMMAND] [-t HOST | --traceroute=HOST] [-s HOST | --port-scan=HOST] [-l HOST | --lookup=HOST] [-f USER | --finger=USER] [-w DOMAIN | --whois=DOMAIN] [--display=DISPLAY] DESCRIPTION The gnome-nettool application is a GTK+ front end for a number of network client command line applications including ping(1M), netstat(1M), traceroute(1M), dig(1M), finger(1), whois(1) and also showing the network interface devices and scanning for services. Each of these functions is grouped into a tab on its own. When gnome-nettool is invoked without any option, it displays its first tab which is showing the machine's network devices. However, it can also be invoked with any one of the option above. These option can only be invoked one at a time, except the --display option. -i DEVICE | --info=DEVICE launch gnome-nettool showing the device tab with the DEVICE specified. -p HOST | --ping=HOST launch gnome-nettool showing the ping tab and pinging the HOST. -n COMMAND | --netstat=COMMAND launch gnome-nettool in the netstat tab with the COMMAND option, the valid values for COMMAND are {route, active, multicast}. -t HOST | --traceroute=HOST launch gnome-nettool in the traceroute tab showing the routes. -s HOST | --port-scan=HOST launch gnome-nettool in the Port Scan tab and showing the open port for HOST. -l HOST | --lookup=HOST launch gnome-nettool in the Lookup tab and showing the HOST information. -f USER | --finger=USER launch gnome-nettool in the Finger tab showing the USER in local host. This option can also be invoked with -l option together. -w DOMAIN | --whois=DOMAIN launch gnome-nettool in the Whois tab showing the domain information for DOMAIN. EXAMPLES Example 1: Launching the tool in Device tab for ath0 example % gnome-nettool --info=ath0 EXIT STATUS The following exit values are returned: 0 Application exited successfully >0 Application exited with failure FILES The following files are used by this application: /usr/bin/gnome-nettool Executable for front end for network tools. ATTRIBUTES Availability SUNWgnome-nettool Interface stability Volatile SEE ALSO ping(1M), netstat(1M), traceroute(1M), dig(1M), finger(1), whois(1) NOTES Written by Ghee Teo, Sun Microsystems Inc., 2008 --Boundary_(ID_xlA+Y2WTi2FeMKZhSgqO2w)-- From johnf@sr1-umpk-16.sfbay.sun.com Tue Aug 26 10:08:11 2008 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 m7QH8AA6029348 for ; Tue, 26 Aug 2008 10:08:10 -0700 (PDT) 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 m7QH81WX016726 for <@sunmail2sca.sfbay.sun.com:LSARC-ext@sun.com>; Tue, 26 Aug 2008 10:08:10 -0700 (PDT) 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 <0K6700L2RWXML800@brm-avmta-1.central.sun.com> for LSARC-ext@sun.com (ORCPT LSARC-ext@sun.com); Tue, 26 Aug 2008 11:08:10 -0600 (MDT) Received: from dm-sfbay-01.sfbay.sun.com ([129.145.155.118]) by brm-avmta-1.central.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0K6700KDEWXLNO10@brm-avmta-1.central.sun.com> for LSARC-ext@sun.com (ORCPT LSARC-ext@sun.com); Tue, 26 Aug 2008 11:08:10 -0600 (MDT) Received: from sr1-umpk-16.sfbay.sun.com (sr1-umpk-16.SFBay.Sun.COM [129.145.154.66]) by dm-sfbay-01.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id m7QH88BF060595; Tue, 26 Aug 2008 10:08:08 -0700 (PDT) Received: from sr1-umpk-16.sfbay.sun.com (localhost [127.0.0.1]) by sr1-umpk-16.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m7QH88C6043740; Tue, 26 Aug 2008 10:08:08 -0700 (PDT) Received: (from johnf@localhost) by sr1-umpk-16.sfbay.sun.com (8.13.8+Sun/8.13.8/Submit) id m7QH88Ii043739; Tue, 26 Aug 2008 10:08:08 -0700 (PDT) Date: Tue, 26 Aug 2008 10:08:08 -0700 (PDT) From: John Fischer Subject: Re: LSARC/2008/529 - Gnome Nettool To: John.Fischer@sun.com, LSARC-ext@sun.com Cc: Ghee.Teo@sun.com Message-id: <200808261708.m7QH88Ii043739@sr1-umpk-16.sfbay.sun.com> Content-transfer-encoding: 7BIT X-PMX-Version: 5.4.1.325704 Status: RO Content-Length: 99 All, The timer having expired with no feedback I am closing this case as approved. Thanks, John