[maemo-developers] D-BUS service name confusion

[From: Axel Sommerfeldt]

I just changed all my com.nokia to something different, use the full 
osso service name for X-Osso-Service and osso_initialize() and it works, 
too. It's so easy if you know how, just specify the full osso service 
name everywhere and it works from the stretch.

So in total I find the current situation very bad:

- The Maemo 4.0 Tutorial is wrong, it must be "osso_context = 
osso_initialize( "org.maemo.example_libosso", "0.0.1", TRUE, NULL);" 
instead of "osso_context = osso_initialize( "example_libosso", "0.0.1", 
TRUE, NULL);", otherwise this example will simply not work.

- The documentation of osso_initialize() is wrong/misleading.

- The maemopad example is misleading: It works, but only as long as you 
don't change the "com.nokia" to something different, otherwise it stopps 
working and you simply don't know why.

This issue has cost me days and I was only one inch away from giving up 
completely.

Axel



Luca Donaggio schrieb:
> I can confirm Eero statement: in grsync I use it.opbyte.grsync both for 
> X-Osso-Service and for osso_initialize() and it works.
> 
> Luca Donaggio
> 
> 
> 
> On Wed, May 28, 2008 at 1:34 PM, Eero Tamminen <eero.tamminen at nokia.com 
> <mailto:eero.tamminen at nokia.com>> wrote:
> 
>     Hi,
> 
>     ext Axel Sommerfeldt wrote:
>      > In the Maemo 4.0 Tutorial, section "Integrating Applications to maemo
>      > Framework", there is an example desktop file with the line:
>      >
>      > X-Osso-Service=org.maemo.example_libosso
>      >
>      > But when I take a look at the examples provided by Nokia, only the
>      > application name is stated here, for example:
>      >
>      > X-Osso-Service=maemopad
>      >
>      > But which one is correct, the "long" term (found in the Tutorial)
>     or the
>      > "short" term (found in the maemopad example)?
>      >
>      > Which confuses me even more is a statement found in the
>     documentation of
>      > osso_initialize(): [1]
>      >
>      > "Note that the D-BUS service name will be
>     'com.nokia.application', where
>      > 'application' is the value you gave as the parameter."
>      >
>      > So a DBUS service name have to be
>     "com.nokia.<your-application-name-here>"?
>      >
>      > Furthermore one can found there:
>      >
>      > "Note also that this argument must be identical to the X-Osso-Service
>      > value in the desktop file, or the D-BUS daemon will kill your
>     application."
>      >
>      > Mixing all of this together, I come to the conclusion that the
>     "short"
>      > X-Osso-Service line is correct (because the argument of
>      > osso_initialize() must be identical to this value) and using a DBUS
>      > service name like "org.maemo.example_libosso" is wrong, because
>     it must
>      > be "com.nokia.example_libosso" instead. Is this correct?
>      >
>      > At least the Tutorial is inconsistent to the example and to the
>      > documentation of osso_initialize(). But what information is
>     correct and
>      > what is wrong?
>      >
>      > [1] http://maemo.org/api_refs/4.0/libosso/index.html
> 
>     Please file a bug against documentation to bugs.maemo.org
>     <http://bugs.maemo.org>
>     with the above details.
> 
>     AFAIK com.nokia. is automatically prepended to service names
>     that contain only one path element (no dots).  I think it
>     would be better to use a long name as "com.nokia." is not
>     appropriate service prefix for 3rd party software.
> 
> 
>            - Eero
>     _______________________________________________
>     maemo-developers mailing list
>     maemo-developers at maemo.org <mailto:maemo-developers at maemo.org>
>     https://lists.maemo.org/mailman/listinfo/maemo-developers
> 
>