From sh162551@sac.sfbay.sun.com Sun Mar 1 23:19:44 2009 Received: from sunmail5.uk.sun.com (sunmail5.UK.Sun.COM [129.156.85.165]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id n227Jh0w029214 for ; Sun, 1 Mar 2009 23:19:43 -0800 (PST) Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11]) by sunmail5.uk.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id n227JNkT017956; Mon, 2 Mar 2009 07:19:42 GMT 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 <0KFV0050BB0T1V00@brm-avmta-1.central.sun.com>; Mon, 02 Mar 2009 00:19:41 -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 <0KFV00M6QB0SX0F0@brm-avmta-1.central.sun.com>; Mon, 02 Mar 2009 00:19: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 n227Jdv6046303; Sun, 01 Mar 2009 23:19:39 -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 n227JcRq029205; Sun, 01 Mar 2009 23:19:38 -0800 (PST) Received: (from sh162551@localhost) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8/Submit) id n227JbX4029200; Sun, 01 Mar 2009 23:19:37 -0800 (PST) Date: Sun, 01 Mar 2009 23:19:37 -0800 (PST) From: Shi-Ying Irene Huang Subject: Libunique for OpenSolaris [LSARC/2009/142 FastTrack timeout 03/10/2009] To: LSARC-ext@sun.com Cc: halton.huo@sun.com Message-id: <200903020719.n227JbX4029200@sac.sfbay.sun.com> Content-transfer-encoding: 7BIT X-PMX-Version: 5.4.1.325704 Status: RO Content-Length: 6056 Template Version: @(#)sac_nextcase 1.68 02/23/09 SMI This information is Copyright 2009 Sun Microsystems 1. Introduction 1.1. Project/Component Working Name: Libunique for OpenSolaris 1.2. Name of Document Author/Supplier: Author: Halton Huo 1.3 Date of This Document: 01 March, 2009 4. Technical Description 1. Introduction 1.1. Project/Component Working Name: LibUnique 1.2. Name of Document Author/Supplier: Halton Huo 1.3. Date of This Document: 02/23/09 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: harry.lu@sun.com 1.5.2. Responsible Engineer: halton.huo@sun.com 1.5.3. Marketing Manager: glynn.foster@sun.com 1.5.4. Interest List: desktop-discuss@opensolaris.org 2. Project Summary 2.1. Project Description: LibUnique is a library for writing a single instance application. If you launch a single instance application twice, the second instance will exit quietly or will send a message to the running instance. LibUnique makes it easy to write these kind of applications, by providing a base class, taking care of all the IPC machinery needed to send messages to a running instance, and and also handling startup notification. LibUnique aims to obsolete very similar code (for example, the BaconMessageConnection interface) that has been copied into many projects and replace it with standard LibUnique library interfaces. 4. Technical Description: 4.1. Details: LibUnique offers the following features: * simple API, easy to subclass * custom commands * bidirectional communication channel * signal based * commodity API for sending raw data, plain text and URI lists * multiple backends (changeable at runtime) LibUnique supports two IPC backends: bacon and dbus. The default backend is dbus. User can override the default backend by setting the UNIQUE_BACKEND environment variable with the name of the desired backend. When dbus is used, the messages are transmitted through private channel: connection=DBUS_SESSION_BUS name=org.mydomain.YourApplication path=/Factory interface=org.gtk.UniqueApp When bacon is used, libUnique uses PF_UNIX family socket to allow communications between processes on the same machine. The socket file is created as /var/tmp/unique/org.gnome.YourApplication.token.process-id. In this example, the string "org.gnome.YourApplication" is passed to applications which use libunique to create the UniqueApp instance. This string must be unique for different applications. Otherwise, the second application can not be started. Assume nautilus and vino-preferences use same string "Oh.God". If nautilus is running (it should be always running with session), unique_app_is_running() returns TRUE, it will cause vino-preferences will not be started. 4.2. Interfaces: Exported Interfaces Classification Comments ----------------------------------- -------------- ----------- SUNWlibunique Uncommitted Package name SUNWlibunique-devel Uncommitted Package name /usr/lib/pkgconfig/unique-1.0.pc Uncommitted pkg-config file /usr/lib/libunique-1.0.so.0 Volatile C library /usr/include/unique-1.0/unique Volatile header files /usr/share/gtk-doc/html/unique Volatile gtk-doc files Imported Interfaces Classification Comments ----------------------- --------------- ---------- D-Bus & dbus-glib Volatile LSARC 2006/368 GNOME Committed Platform Libraries Committed LSARC 2007/520 4.3. Doc Impact: Man page for libunique-1.0.3 is added 4.7. Admin/Config Impact: None. 4.8. HA Impact: None. 4.9. I18N/L10N Impact: The JDS team and the G11N team are working together to evaluate and provide I18N/L10N support. 4.10. Packaging & Delivery: Adds new packages: SUNWlibunique (base package) - base package for libraries SUNWlibunique-devel (development package) - development package for header and documents Packages will only go into SUNWCall and SUNWCXall clusters. 4.11. Security Impact: When dbus is used as backend, the D-Bus communication is only allowed by processes started by the same user, so other users can not interact via D-Bus. When bacon is used as backend, the PF_UNIX socket files under /var/tmp/unique/ is owned by user:other with 700 permissions to prevent tampering. 4.12. Dependencies: LSARC 2006/368 D-Bus & dbus-glib 5. Reference Documents: [1] Related ARC Cases: LSARC 2006/368: D-Bus & dbus-glib LSARC 2007/520: GNOME Committed Platform Libraries [2] Project homepage: http://live.gnome.org/LibUnique 6. Resources and Schedule 6.4. Steering Committee requested information 6.4.1. Consolidation C-team Name: Desktop 6.5. ARC review type: FastTrack 6.6. ARC Exposure: open From John.Fischer@Sun.COM Mon Mar 2 14:18:24 2009 Received: from sunmail5.uk.sun.com (sunmail5.UK.Sun.COM [129.156.85.165]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id n22MINeM019512 for ; Mon, 2 Mar 2009 14:18:23 -0800 (PST) Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6]) by sunmail5.uk.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id n22MIM2m009940 for <@sunmail2sca.sfbay.sun.com:LSARC-ext@sun.com>; Mon, 2 Mar 2009 22:18:22 GMT 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 <0KFW00D2RGMLQM00@nwk-avmta-2.sfbay.sun.com> for LSARC-ext@sun.com (ORCPT LSARC-ext@sun.com); Mon, 02 Mar 2009 14:18:21 -0800 (PST) Received: from sca-es-mail-2.sun.com ([192.18.43.133]) by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0KFW003RFGMKEHA0@nwk-avmta-2.sfbay.sun.com> for LSARC-ext@sun.com (ORCPT LSARC-ext@sun.com); Mon, 02 Mar 2009 14:18:20 -0800 (PST) Received: from fe-sfbay-10.sun.com ([192.18.43.129]) by sca-es-mail-2.sun.com (8.13.7+Sun/8.12.9) with ESMTP id n22MIK7a017464 for ; Mon, 02 Mar 2009 14:18:20 -0800 (PST) Received: from conversion-daemon.fe-sfbay-10.sun.com by fe-sfbay-10.sun.com (Sun Java(tm) System Messaging Server 7.0-3.01 64bit (built Dec 23 2008)) id <0KFW00H00GBOTF00@fe-sfbay-10.sun.com> for LSARC-ext@sun.com (ORCPT LSARC-ext@sun.com); Mon, 02 Mar 2009 14:18:20 -0800 (PST) Received: from [192.168.10.10] ([unknown] [76.20.56.47]) by fe-sfbay-10.sun.com (Sun Java(tm) System Messaging Server 7.0-3.01 64bit (built Dec 23 2008)) with ESMTPSA id <0KFW0017MGMJ2070@fe-sfbay-10.sun.com>; Mon, 02 Mar 2009 14:18:20 -0800 (PST) Date: Mon, 02 Mar 2009 14:17:04 -0800 From: John Fischer Subject: Re: Libunique for OpenSolaris [LSARC/2009/142 FastTrack timeout 03/10/2009] In-reply-to: <200903020719.n227JbX4029200@sac.sfbay.sun.com> Sender: John.Fischer@Sun.COM To: Shi-Ying Irene Huang Cc: LSARC-ext@Sun.COM, Halton.Huo@Sun.COM Reply-to: John.Fischer@Sun.COM Message-id: <49AC5AE0.2030109@sun.com> 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: <200903020719.n227JbX4029200@sac.sfbay.sun.com> User-Agent: Thunderbird 2.0.0.18 (X11/20090203) Status: RO Content-Length: 6502 +1 assuming that 64-bit versions of the library and pkg-config file. Thanks, John Shi-Ying Irene Huang wrote: > Template Version: @(#)sac_nextcase 1.68 02/23/09 SMI > This information is Copyright 2009 Sun Microsystems > 1. Introduction > 1.1. Project/Component Working Name: > Libunique for OpenSolaris > 1.2. Name of Document Author/Supplier: > Author: Halton Huo > 1.3 Date of This Document: > 01 March, 2009 > 4. Technical Description > > 1. Introduction > 1.1. Project/Component Working Name: > LibUnique > > 1.2. Name of Document Author/Supplier: > Halton Huo > > 1.3. Date of This Document: > 02/23/09 > > 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: > harry.lu@sun.com > > 1.5.2. Responsible Engineer: > halton.huo@sun.com > > 1.5.3. Marketing Manager: > glynn.foster@sun.com > > 1.5.4. Interest List: > desktop-discuss@opensolaris.org > > 2. Project Summary > 2.1. Project Description: > > LibUnique is a library for writing a single instance application. > If you launch a single instance application twice, the second instance > will exit quietly or will send a message to the running instance. > > LibUnique makes it easy to write these kind of applications, by > providing a base class, taking care of all the IPC machinery needed > to send messages to a running instance, and and also handling startup > notification. > > LibUnique aims to obsolete very similar code (for example, the > BaconMessageConnection interface) that has been copied into many > projects and replace it with standard LibUnique library interfaces. > > 4. Technical Description: > 4.1. Details: > > LibUnique offers the following features: > * simple API, easy to subclass > * custom commands > * bidirectional communication channel > * signal based > * commodity API for sending raw data, plain text and URI lists > * multiple backends (changeable at runtime) > > LibUnique supports two IPC backends: bacon and dbus. The default > backend is dbus. User can override the default backend by setting > the UNIQUE_BACKEND environment variable with the name of the > desired backend. > > When dbus is used, the messages are transmitted through private > channel: > connection=DBUS_SESSION_BUS > name=org.mydomain.YourApplication > path=/Factory > interface=org.gtk.UniqueApp > > When bacon is used, libUnique uses PF_UNIX family socket to allow > communications between processes on the same machine. The socket file > is created as > /var/tmp/unique/org.gnome.YourApplication.token.process-id. > > In this example, the string "org.gnome.YourApplication" is passed > to applications which use libunique to create the UniqueApp instance. > > This string must be unique for different applications. Otherwise, the > second application can not be started. Assume nautilus and > vino-preferences use same string "Oh.God". If nautilus is running > (it should be always running with session), unique_app_is_running() > returns TRUE, it will cause vino-preferences will not be started. > > 4.2. Interfaces: > > Exported Interfaces Classification Comments > ----------------------------------- -------------- ----------- > SUNWlibunique Uncommitted Package name > SUNWlibunique-devel Uncommitted Package name > /usr/lib/pkgconfig/unique-1.0.pc Uncommitted pkg-config file > /usr/lib/libunique-1.0.so.0 Volatile C library > /usr/include/unique-1.0/unique Volatile header files > /usr/share/gtk-doc/html/unique Volatile gtk-doc files > > Imported Interfaces Classification Comments > ----------------------- --------------- ---------- > D-Bus & dbus-glib Volatile LSARC 2006/368 > GNOME Committed Platform Libraries Committed LSARC 2007/520 > > 4.3. Doc Impact: > Man page for libunique-1.0.3 is added > > 4.7. Admin/Config Impact: > None. > > 4.8. HA Impact: > None. > > 4.9. I18N/L10N Impact: > The JDS team and the G11N team are working together to evaluate and > provide I18N/L10N support. > > 4.10. Packaging & Delivery: > Adds new packages: > SUNWlibunique (base package) - base package for libraries > SUNWlibunique-devel (development package) - development package for > header and documents > Packages will only go into SUNWCall and SUNWCXall clusters. > > 4.11. Security Impact: > When dbus is used as backend, the D-Bus communication is only allowed > by processes started by the same user, so other users can not > interact via D-Bus. > > When bacon is used as backend, the PF_UNIX socket files under > /var/tmp/unique/ is owned by user:other with 700 permissions to > prevent tampering. > > 4.12. Dependencies: > LSARC 2006/368 D-Bus & dbus-glib > > 5. Reference Documents: > > [1] Related ARC Cases: > LSARC 2006/368: D-Bus & dbus-glib > LSARC 2007/520: GNOME Committed Platform Libraries > > [2] Project homepage: > http://live.gnome.org/LibUnique > > > 6. Resources and Schedule > 6.4. Steering Committee requested information > 6.4.1. Consolidation C-team Name: > Desktop > 6.5. ARC review type: FastTrack > 6.6. ARC Exposure: open > From margot.miller@sun.com Mon Mar 2 16:33:59 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 n230XxX0017224 for ; Mon, 2 Mar 2009 16:33:59 -0800 (PST) Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11]) by newsunmail1brm.central.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id n230XuGT032969; Mon, 2 Mar 2009 17:33:56 -0700 (MST) 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 <0KFW00E05MWKNS00@brm-avmta-1.central.sun.com>; Mon, 02 Mar 2009 17:33:56 -0700 (MST) Received: from jurassic-x4600.sfbay.sun.com ([129.146.17.63]) by brm-avmta-1.central.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0KFW00GSBMWK6XC0@brm-avmta-1.central.sun.com>; Mon, 02 Mar 2009 17:33:56 -0700 (MST) Received: from [10.7.250.251] (punchin-client-10-7-250-251.SFBay.Sun.COM [10.7.250.251]) by jurassic-x4600.sfbay.sun.com (8.14.3+Sun/8.14.3) with ESMTP id n230XslL125557; Mon, 02 Mar 2009 16:33:54 -0800 (PST) Date: Mon, 02 Mar 2009 16:30:04 -0800 From: Margot Miller Subject: Re: Libunique for OpenSolaris [LSARC/2009/142 FastTrack timeout 03/10/2009] In-reply-to: <200903020719.n227JbX4029200@sac.sfbay.sun.com> To: Shi-Ying Irene Huang Cc: LSARC-ext@sun.com, halton.huo@sun.com Message-id: <49AC7A0C.30206@sun.com> MIME-version: 1.0 Content-type: text/plain; charset=ISO-8859-1; format=flowed Content-transfer-encoding: 7BIT X-PMX-Version: 5.4.1.325704 References: <200903020719.n227JbX4029200@sac.sfbay.sun.com> User-Agent: Thunderbird 2.0b1 (X11/20070115) Status: RO Content-Length: 6600 The UNIQUE_BACKEND environment variable should be added to exported interface table. Please add the man page to the materials. And I assume that the UNIQUE_BACKEND is documented in the man page? Thanks Margot Shi-Ying Irene Huang wrote: > Template Version: @(#)sac_nextcase 1.68 02/23/09 SMI > This information is Copyright 2009 Sun Microsystems > 1. Introduction > 1.1. Project/Component Working Name: > Libunique for OpenSolaris > 1.2. Name of Document Author/Supplier: > Author: Halton Huo > 1.3 Date of This Document: > 01 March, 2009 > 4. Technical Description > > 1. Introduction > 1.1. Project/Component Working Name: > LibUnique > > 1.2. Name of Document Author/Supplier: > Halton Huo > > 1.3. Date of This Document: > 02/23/09 > > 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: > harry.lu@sun.com > > 1.5.2. Responsible Engineer: > halton.huo@sun.com > > 1.5.3. Marketing Manager: > glynn.foster@sun.com > > 1.5.4. Interest List: > desktop-discuss@opensolaris.org > > 2. Project Summary > 2.1. Project Description: > > LibUnique is a library for writing a single instance application. > If you launch a single instance application twice, the second instance > will exit quietly or will send a message to the running instance. > > LibUnique makes it easy to write these kind of applications, by > providing a base class, taking care of all the IPC machinery needed > to send messages to a running instance, and and also handling startup > notification. > > LibUnique aims to obsolete very similar code (for example, the > BaconMessageConnection interface) that has been copied into many > projects and replace it with standard LibUnique library interfaces. > > 4. Technical Description: > 4.1. Details: > > LibUnique offers the following features: > * simple API, easy to subclass > * custom commands > * bidirectional communication channel > * signal based > * commodity API for sending raw data, plain text and URI lists > * multiple backends (changeable at runtime) > > LibUnique supports two IPC backends: bacon and dbus. The default > backend is dbus. User can override the default backend by setting > the UNIQUE_BACKEND environment variable with the name of the > desired backend. > > When dbus is used, the messages are transmitted through private > channel: > connection=DBUS_SESSION_BUS > name=org.mydomain.YourApplication > path=/Factory > interface=org.gtk.UniqueApp > > When bacon is used, libUnique uses PF_UNIX family socket to allow > communications between processes on the same machine. The socket file > is created as > /var/tmp/unique/org.gnome.YourApplication.token.process-id. > > In this example, the string "org.gnome.YourApplication" is passed > to applications which use libunique to create the UniqueApp instance. > > This string must be unique for different applications. Otherwise, the > second application can not be started. Assume nautilus and > vino-preferences use same string "Oh.God". If nautilus is running > (it should be always running with session), unique_app_is_running() > returns TRUE, it will cause vino-preferences will not be started. > > 4.2. Interfaces: > > Exported Interfaces Classification Comments > ----------------------------------- -------------- ----------- > SUNWlibunique Uncommitted Package name > SUNWlibunique-devel Uncommitted Package name > /usr/lib/pkgconfig/unique-1.0.pc Uncommitted pkg-config file > /usr/lib/libunique-1.0.so.0 Volatile C library > /usr/include/unique-1.0/unique Volatile header files > /usr/share/gtk-doc/html/unique Volatile gtk-doc files > > Imported Interfaces Classification Comments > ----------------------- --------------- ---------- > D-Bus & dbus-glib Volatile LSARC 2006/368 > GNOME Committed Platform Libraries Committed LSARC 2007/520 > > 4.3. Doc Impact: > Man page for libunique-1.0.3 is added > > 4.7. Admin/Config Impact: > None. > > 4.8. HA Impact: > None. > > 4.9. I18N/L10N Impact: > The JDS team and the G11N team are working together to evaluate and > provide I18N/L10N support. > > 4.10. Packaging & Delivery: > Adds new packages: > SUNWlibunique (base package) - base package for libraries > SUNWlibunique-devel (development package) - development package for > header and documents > Packages will only go into SUNWCall and SUNWCXall clusters. > > 4.11. Security Impact: > When dbus is used as backend, the D-Bus communication is only allowed > by processes started by the same user, so other users can not > interact via D-Bus. > > When bacon is used as backend, the PF_UNIX socket files under > /var/tmp/unique/ is owned by user:other with 700 permissions to > prevent tampering. > > 4.12. Dependencies: > LSARC 2006/368 D-Bus & dbus-glib > > 5. Reference Documents: > > [1] Related ARC Cases: > LSARC 2006/368: D-Bus & dbus-glib > LSARC 2007/520: GNOME Committed Platform Libraries > > [2] Project homepage: > http://live.gnome.org/LibUnique > > > 6. Resources and Schedule > 6.4. Steering Committee requested information > 6.4.1. Consolidation C-team Name: > Desktop > 6.5. ARC review type: FastTrack > 6.6. ARC Exposure: open > > From Halton.Huo@sun.com Mon Mar 2 17:51:02 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 n231p2tw019281 for ; Mon, 2 Mar 2009 17:51:02 -0800 (PST) Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11]) by newsunmail1brm.central.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id n231p0Bp010589 for <@sunmail2sca.sfbay.sun.com:LSARC-ext@sun.com>; Mon, 2 Mar 2009 18:51:01 -0700 (MST) 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 <0KFW00M0BQH0MU00@brm-avmta-1.central.sun.com> for LSARC-ext@sun.com (ORCPT LSARC-ext@sun.com); Mon, 02 Mar 2009 18:51:00 -0700 (MST) Received: from sineb-mail-2.sun.com ([192.18.19.7]) by brm-avmta-1.central.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0KFW00I8GQGZI930@brm-avmta-1.central.sun.com> for LSARC-ext@sun.com (ORCPT LSARC-ext@sun.com); Mon, 02 Mar 2009 18:51:00 -0700 (MST) Received: from fe-apac-06.sun.com (fe-apac-06.sun.com [192.18.19.177] (may be forged)) by sineb-mail-2.sun.com (8.13.6+Sun/8.12.9) with ESMTP id n231owGx004233 for ; Tue, 03 Mar 2009 01:50:58 +0000 (GMT) Received: from conversion-daemon.mail-apac.sun.com by mail-apac.sun.com (Sun Java(tm) System Messaging Server 7.0-3.01 64bit (built Dec 23 2008)) id <0KFW00200QDOBC00@mail-apac.sun.com> for LSARC-ext@sun.com (ORCPT LSARC-ext@sun.com); Tue, 03 Mar 2009 09:50:58 +0800 (SGT) Received: from [129.158.217.65] ([unknown] [129.158.217.65]) by mail-apac.sun.com (Sun Java(tm) System Messaging Server 7.0-3.01 64bit (built Dec 23 2008)) with ESMTPSA id <0KFW00B3DQGWBTD0@mail-apac.sun.com>; Tue, 03 Mar 2009 09:50:57 +0800 (SGT) Date: Tue, 03 Mar 2009 09:49:48 +0800 From: Halton Huo Subject: Re: Libunique for OpenSolaris [LSARC/2009/142 FastTrack timeout 03/10/2009] In-reply-to: <49AC5AE0.2030109@sun.com> Sender: Halton.Huo@sun.com To: John.Fischer@sun.com Cc: Shi-Ying Irene Huang , LSARC-ext@sun.com Message-id: <1236044988.19483.1.camel@judo> MIME-version: 1.0 X-Mailer: Evolution 2.25.91 Content-type: text/plain; charset=UTF-8 Content-transfer-encoding: 7BIT X-PMX-Version: 5.4.1.325704 References: <200903020719.n227JbX4029200@sac.sfbay.sun.com> <49AC5AE0.2030109@sun.com> Status: RO Content-Length: 186 On Mon, 2009-03-02 at 14:17 -0800, John Fischer wrote: > +1 assuming that 64-bit versions of the library and pkg-config file. John, Added in exported interfaces. Thanks, Halton. From Halton.Huo@sun.com Mon Mar 2 17:53:35 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 n231rZNe019394 for ; Mon, 2 Mar 2009 17:53:35 -0800 (PST) Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11]) by newsunmail1brm.central.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id n231rMub012183 for <@sunmail2sca.sfbay.sun.com:LSARC-ext@sun.com>; Mon, 2 Mar 2009 18:53:34 -0700 (MST) 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 <0KFW00M1TQL8W700@brm-avmta-1.central.sun.com> for LSARC-ext@sun.com (ORCPT LSARC-ext@sun.com); Mon, 02 Mar 2009 18:53:32 -0700 (MST) Received: from sineb-mail-1.sun.com ([192.18.19.6]) by brm-avmta-1.central.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0KFW00I6NQL3I620@brm-avmta-1.central.sun.com> for LSARC-ext@sun.com (ORCPT LSARC-ext@sun.com); Mon, 02 Mar 2009 18:53:28 -0700 (MST) Received: from fe-apac-05.sun.com (fe-apac-05.sun.com [192.18.19.176] (may be forged)) by sineb-mail-1.sun.com (8.13.6+Sun/8.12.9) with ESMTP id n231rQ1f015394 for ; Tue, 03 Mar 2009 01:53:26 +0000 (GMT) Received: from conversion-daemon.mail-apac.sun.com by mail-apac.sun.com (Sun Java(tm) System Messaging Server 7.0-3.01 64bit (built Dec 23 2008)) id <0KFW00100QF8WF00@mail-apac.sun.com> for LSARC-ext@sun.com (ORCPT LSARC-ext@sun.com); Tue, 03 Mar 2009 09:53:26 +0800 (SGT) Received: from [129.158.217.65] ([unknown] [129.158.217.65]) by mail-apac.sun.com (Sun Java(tm) System Messaging Server 7.0-3.01 64bit (built Dec 23 2008)) with ESMTPSA id <0KFW00B7GQL1TGE0@mail-apac.sun.com>; Tue, 03 Mar 2009 09:53:26 +0800 (SGT) Date: Tue, 03 Mar 2009 09:52:17 +0800 From: Halton Huo Subject: Re: Libunique for OpenSolaris [LSARC/2009/142 FastTrack timeout 03/10/2009] In-reply-to: <49AC7A0C.30206@sun.com> Sender: Halton.Huo@sun.com To: Margot Miller Cc: Shi-Ying Irene Huang , LSARC-ext@sun.com Message-id: <1236045137.19483.4.camel@judo> MIME-version: 1.0 X-Mailer: Evolution 2.25.91 Content-type: multipart/mixed; boundary="Boundary_(ID_oFgxZbi7jGxdJRQ5uiiETg)" X-PMX-Version: 5.4.1.325704 References: <200903020719.n227JbX4029200@sac.sfbay.sun.com> <49AC7A0C.30206@sun.com> Status: RO Content-Length: 4145 --Boundary_(ID_oFgxZbi7jGxdJRQ5uiiETg) Content-type: text/plain; charset=UTF-8 Content-transfer-encoding: 7BIT Margot, On Mon, 2009-03-02 at 16:30 -0800, Margot Miller wrote: > The UNIQUE_BACKEND environment variable should be > added to exported interface table. Added in exported interface table. Exported Interfaces Classification Comments ----------------------------------- -------------- ----------- SUNWlibunique Uncommitted Package name SUNWlibunique-devel Uncommitted Package name /usr/lib/pkgconfig/unique-1.0.pc Uncommitted pkg-config file /usr/lib/amd64/pkgconfig/unique-1.0.pc Uncommitted 64-bit pkg-config file /usr/lib/libunique-1.0.so.0 Volatile C library /usr/lib/amd64/libunique-1.0.so.0 Volatile 64-bit C library /usr/include/unique-1.0/unique Volatile header files /usr/share/gtk-doc/html/unique Volatile gtk-doc files UNIQUE_BACKEND environment variable Volatile environment variable to define backend > Please add the man page to the materials. And I assume > that the UNIQUE_BACKEND is documented in the man page? Yes. Attach the man page. Thanks, Halton. --Boundary_(ID_oFgxZbi7jGxdJRQ5uiiETg) Content-type: text/plain; charset=UTF-8; name=libunique-1.0.txt Content-transfer-encoding: 7BIT Content-disposition: attachment; filename=libunique-1.0.txt C Library Functions libunique-1.0(3) NAME libunique-1.0 - A library for writing single instance appli- cations DESCRIPTION libunique-1.0 is a library for writing single instance applications. If you launch a single instance application twice, the second instance will exit quietly or will send a message to the running instance. libunique-1.0 makes it easy to write these kind of applica- tions, by providing a base class, taking care of all the IPC machinery needed to send messages to a running instance, and also handling startup notification. libunique-1.0 supports two IPC backends: bacon and dbus. When dbus is used, the messages are transmitted through D- Bus private channel. When bacon is used, libunique-1.0 uses PF_UNIX family socket(3head) to allow communications between processes on the same machine. ENVIRONMENT VARIABLES See environ(5) for descriptions of environment variables. UNIQUE_BACKEND The default backend is dbus. User can over- ride the default backend by setting the UNIQUE_BACKEND environment variable with the name of the desired backend. FILES The following files are used by this library: /usr/lib/libunique-1.0.so API shared library /usr/share/gtk-doc/html/unique Location of developer documentation ATTRIBUTES See attributes(5) for descriptions of the following attri- butes: SunOS 5.11 Last change: 27 Feb 2009 1 C Library Functions libunique-1.0(3) ____________________________________________________________ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | |_____________________________|_____________________________| | Availability | SUNWlibunique | |_____________________________|_____________________________| | Interface stability | Volatile | |_____________________________|_____________________________| SEE ALSO attributes(5), environ(5), gnome-interfaces(5), socket(3head) NOTES Written by Halton Huo, Sun Microsystems Inc., 2009. SunOS 5.11 Last change: 27 Feb 2009 2 --Boundary_(ID_oFgxZbi7jGxdJRQ5uiiETg)-- From margot.miller@sun.com Mon Mar 2 19:59:54 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 n233xrTu023067 for ; Mon, 2 Mar 2009 19:59:53 -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 n233xdle003710; Tue, 3 Mar 2009 11:59:50 +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 <0KFW00D05WFQ5300@brm-avmta-1.central.sun.com>; Mon, 02 Mar 2009 20:59:50 -0700 (MST) Received: from jurassic-x4600.sfbay.sun.com ([129.146.17.63]) by brm-avmta-1.central.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0KFW00I4GWFPI570@brm-avmta-1.central.sun.com>; Mon, 02 Mar 2009 20:59:49 -0700 (MST) Received: from [10.7.250.251] (punchin-client-10-7-250-251.SFBay.Sun.COM [10.7.250.251]) by jurassic-x4600.sfbay.sun.com (8.14.3+Sun/8.14.3) with ESMTP id n233xcVp160260; Mon, 02 Mar 2009 19:59:45 -0800 (PST) Date: Mon, 02 Mar 2009 19:55:45 -0800 From: Margot Miller Subject: Re: Libunique for OpenSolaris [LSARC/2009/142 FastTrack timeout 03/10/2009] In-reply-to: <1236045137.19483.4.camel@judo> To: Halton Huo Cc: Shi-Ying Irene Huang , LSARC-ext@sun.com Message-id: <49ACAA41.1090105@sun.com> MIME-version: 1.0 Content-type: text/plain; charset=UTF-8; format=flowed Content-transfer-encoding: 7BIT X-PMX-Version: 5.4.1.325704 References: <200903020719.n227JbX4029200@sac.sfbay.sun.com> <49AC7A0C.30206@sun.com> <1236045137.19483.4.camel@judo> User-Agent: Thunderbird 2.0b1 (X11/20070115) Status: RO Content-Length: 4189 Looks good. +1 Thanks Margot Halton Huo wrote: > Margot, > > On Mon, 2009-03-02 at 16:30 -0800, Margot Miller wrote: > >> The UNIQUE_BACKEND environment variable should be >> added to exported interface table. >> > Added in exported interface table. > > Exported Interfaces Classification Comments > ----------------------------------- -------------- ----------- > SUNWlibunique Uncommitted Package name > SUNWlibunique-devel Uncommitted Package name > /usr/lib/pkgconfig/unique-1.0.pc Uncommitted pkg-config file > /usr/lib/amd64/pkgconfig/unique-1.0.pc Uncommitted 64-bit > pkg-config file > /usr/lib/libunique-1.0.so.0 Volatile C library > /usr/lib/amd64/libunique-1.0.so.0 Volatile 64-bit C library > /usr/include/unique-1.0/unique Volatile header files > /usr/share/gtk-doc/html/unique Volatile gtk-doc files > UNIQUE_BACKEND environment variable Volatile environment > variable to > define backend > > > >> Please add the man page to the materials. And I assume >> that the UNIQUE_BACKEND is documented in the man page? >> > Yes. Attach the man page. > > Thanks, > Halton. > > > ------------------------------------------------------------------------ > > > > > C Library Functions libunique-1.0(3) > > > > NAME > libunique-1.0 - A library for writing single instance appli- > cations > > DESCRIPTION > libunique-1.0 is a library for writing single instance > applications. If you launch a single instance application > twice, the second instance will exit quietly or will send a > message to the running instance. > > libunique-1.0 makes it easy to write these kind of applica- > tions, by providing a base class, taking care of all the IPC > machinery needed to send messages to a running instance, and > also handling startup notification. > > libunique-1.0 supports two IPC backends: bacon and dbus. > When dbus is used, the messages are transmitted through D- > Bus private channel. When bacon is used, libunique-1.0 uses > PF_UNIX family socket(3head) to allow communications between > processes on the same machine. > > ENVIRONMENT VARIABLES > See environ(5) for descriptions of environment variables. > > UNIQUE_BACKEND The default backend is dbus. User can over- > ride the default backend by setting the > UNIQUE_BACKEND environment variable with the > name of the desired backend. > > > > FILES > The following files are used by this library: > > /usr/lib/libunique-1.0.so > > API shared library > > > > /usr/share/gtk-doc/html/unique > > Location of developer documentation > > > > ATTRIBUTES > See attributes(5) for descriptions of the following attri- > butes: > > > > > > > SunOS 5.11 Last change: 27 Feb 2009 1 > > > > > > > C Library Functions libunique-1.0(3) > > > > ____________________________________________________________ > | ATTRIBUTE TYPE | ATTRIBUTE VALUE | > |_____________________________|_____________________________| > | Availability | SUNWlibunique | > |_____________________________|_____________________________| > | Interface stability | Volatile | > |_____________________________|_____________________________| > > > SEE ALSO > attributes(5), environ(5), gnome-interfaces(5), > socket(3head) > > NOTES > Written by Halton Huo, Sun Microsystems Inc., 2009. > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > SunOS 5.11 Last change: 27 Feb 2009 2 > > > > From Irene.Huang@sun.com Tue Mar 10 22:32:36 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 n2B5Wau1028140 for ; Tue, 10 Mar 2009 22:32:36 -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 n2B5WZUi027401 for <@sunmail2sca.sfbay.sun.com:LSARC-ext@sun.com>; Tue, 10 Mar 2009 23:32:36 -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 <0KGB00503U2ABI00@nwk-avmta-2.sfbay.sun.com> for LSARC-ext@sun.com (ORCPT LSARC-ext@sun.com); Tue, 10 Mar 2009 22:32:34 -0700 (PDT) Received: from sineb-mail-2.sun.com ([192.18.19.7]) by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0KGB003LCU292070@nwk-avmta-2.sfbay.sun.com> for LSARC-ext@sun.com (ORCPT LSARC-ext@sun.com); Tue, 10 Mar 2009 22:32:34 -0700 (PDT) Received: from fe-apac-05.sun.com (fe-apac-05.sun.com [192.18.19.176] (may be forged)) by sineb-mail-2.sun.com (8.13.6+Sun/8.12.9) with ESMTP id n2B5WXcO000885 for ; Wed, 11 Mar 2009 05:32:33 +0000 (GMT) Received: from conversion-daemon.mail-apac.sun.com by mail-apac.sun.com (Sun Java(tm) System Messaging Server 7.0-3.01 64bit (built Dec 23 2008)) id <0KGB00600TQKMY00@mail-apac.sun.com> for LSARC-ext@sun.com (ORCPT LSARC-ext@sun.com); Wed, 11 Mar 2009 13:32:33 +0800 (SGT) Received: from [129.158.217.245] ([unknown] [129.158.217.245]) by mail-apac.sun.com (Sun Java(tm) System Messaging Server 7.0-3.01 64bit (built Dec 23 2008)) with ESMTPSA id <0KGB002S7U27HK40@mail-apac.sun.com>; Wed, 11 Mar 2009 13:32:32 +0800 (SGT) Date: Wed, 11 Mar 2009 13:32:32 +0800 From: Irene Huang Subject: Re: Libunique for OpenSolaris [LSARC/2009/142 FastTrack timeout 03/10/2009] In-reply-to: <49ACAA41.1090105@sun.com> Sender: Irene.Huang@sun.com To: Margot Miller Cc: Halton Huo , Shi-Ying Irene Huang , LSARC-ext@sun.com Message-id: <49B74CF0.3020504@sun.com> MIME-version: 1.0 Content-type: text/plain; format=flowed; charset=UTF-8 Content-transfer-encoding: 7BIT X-PMX-Version: 5.4.1.325704 References: <200903020719.n227JbX4029200@sac.sfbay.sun.com> <49AC7A0C.30206@sun.com> <1236045137.19483.4.camel@judo> <49ACAA41.1090105@sun.com> User-Agent: Thunderbird 2.0.0.19 (Windows/20081209) Status: RO Content-Length: 4420 Great closed approved. --Irene Margot Miller wrote: > Looks good. +1 > > Thanks > Margot > > > Halton Huo wrote: >> Margot, >> >> On Mon, 2009-03-02 at 16:30 -0800, Margot Miller wrote: >> >>> The UNIQUE_BACKEND environment variable should be >>> added to exported interface table. >>> >> Added in exported interface table. >> >> Exported Interfaces Classification Comments >> ----------------------------------- -------------- ----------- >> SUNWlibunique Uncommitted Package name >> SUNWlibunique-devel Uncommitted Package name >> /usr/lib/pkgconfig/unique-1.0.pc Uncommitted pkg-config file >> /usr/lib/amd64/pkgconfig/unique-1.0.pc Uncommitted 64-bit >> pkg-config file >> /usr/lib/libunique-1.0.so.0 Volatile C library >> /usr/lib/amd64/libunique-1.0.so.0 Volatile 64-bit C library >> /usr/include/unique-1.0/unique Volatile header files >> /usr/share/gtk-doc/html/unique Volatile gtk-doc files >> UNIQUE_BACKEND environment variable Volatile environment >> variable to >> define backend >> >> >>> Please add the man page to the materials. And I assume >>> that the UNIQUE_BACKEND is documented in the man page? >>> >> Yes. Attach the man page. >> >> Thanks, >> Halton. >> >> >> ------------------------------------------------------------------------ >> >> >> >> >> C Library Functions libunique-1.0(3) >> >> >> >> NAME >> libunique-1.0 - A library for writing single instance appli- >> cations >> >> DESCRIPTION >> libunique-1.0 is a library for writing single instance >> applications. If you launch a single instance application >> twice, the second instance will exit quietly or will send a >> message to the running instance. >> >> libunique-1.0 makes it easy to write these kind of applica- >> tions, by providing a base class, taking care of all the IPC >> machinery needed to send messages to a running instance, and >> also handling startup notification. >> >> libunique-1.0 supports two IPC backends: bacon and dbus. >> When dbus is used, the messages are transmitted through D- >> Bus private channel. When bacon is used, libunique-1.0 uses >> PF_UNIX family socket(3head) to allow communications between >> processes on the same machine. >> >> ENVIRONMENT VARIABLES >> See environ(5) for descriptions of environment variables. >> >> UNIQUE_BACKEND The default backend is dbus. User can over- >> ride the default backend by setting the >> UNIQUE_BACKEND environment variable with the >> name of the desired backend. >> >> >> >> FILES >> The following files are used by this library: >> >> /usr/lib/libunique-1.0.so >> >> API shared library >> >> >> >> /usr/share/gtk-doc/html/unique >> >> Location of developer documentation >> >> >> >> ATTRIBUTES >> See attributes(5) for descriptions of the following attri- >> butes: >> >> >> >> >> >> >> SunOS 5.11 Last change: 27 Feb 2009 1 >> >> >> >> >> >> >> C Library Functions libunique-1.0(3) >> >> >> >> ____________________________________________________________ >> | ATTRIBUTE TYPE | ATTRIBUTE VALUE | >> |_____________________________|_____________________________| >> | Availability | SUNWlibunique | >> |_____________________________|_____________________________| >> | Interface stability | Volatile | >> |_____________________________|_____________________________| >> >> >> SEE ALSO >> attributes(5), environ(5), gnome-interfaces(5), >> socket(3head) >> >> NOTES >> Written by Halton Huo, Sun Microsystems Inc., 2009. >> >> >> >> >> >> >> >> >> >> >> >> >> >> >> >> >> >> >> >> >> >> >> >> >> >> >> >> >> >> >> >> >> >> >> >> >> >> >> >> >> SunOS 5.11 Last change: 27 Feb 2009 2 >> >> >> >> >