NAME

Net::Radio::Location::SUPL::DBusObject::RecvPushMsg - DBus Server Object to receive SUPL PushMessages

DESCRIPTION

This package provides a DBus Object with the interface to receive notification's from oFono's mmsd about PushMessages with the WAP Application ID x-oma-application:ulp.ua and the Content Type application/vnd.omaloc-supl-init.

An appropriate mmsd configuration looks like follows:

[SUPL]
# simple match on the content type
MatchContentType=application/vnd.omaloc-supl-init
# match on WAP application id
MatchApplicationId=x-oma-application:ulp.ua
# D-Bus session or system bus
TargetBus=session
# D-Bus service name
TargetService=org.vfnet.supl
# D-Bus target path
TargetPath=/org/vfnet/supl/PushConsumer

The TargetService and the TargetPath must passed when instantiating this object as @cfg{"bus-name", "object-path"}.

METHODS

new

Instantiates new PushMessage receiver from oFono's mmsd. The parameters bus-name and object-path must be specified as described under "DESCRIPTION" in the way documented at Net::Radio::Location::SUPL::DBusObject/new.

Additional parameter:

test-setup

Contains hash for each SUPL message type with construction information.

Notify

Receives notification from mmsd as described in mmsd/doc/consumer.txt.

Expects two array of bytes as parameter containing the PushMessage header and body (SUPLINIT payload).

Release

Receives notification from mmsd that mmsd process ends. This notification is ignored and might be result in a configurable exit in future.

BUGS

Please report any bugs or feature requests to bug-supl-test at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=SUPL-Test. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

If you think you've found a bug then please read "How to Report Bugs Effectively" by Simon Tatham: http://www.chiark.greenend.org.uk/~sgtatham/bugs.html.

SUPPORT

You can find documentation for this module with the perldoc command.

perldoc Net::Radio::Location::SUPL::Test

You can also look for information at:

• RT: CPAN's request tracker

  http://rt.cpan.org/NoAuth/Bugs.html?Dist=SUPL-Test

  If you think you've found a bug then please read "How to Report Bugs Effectively" by Simon Tatham: http://www.chiark.greenend.org.uk/~sgtatham/bugs.html.

• AnnoCPAN: Annotated CPAN documentation

  http://annocpan.org/dist/SUPL-Test

• CPAN Ratings

  http://cpanratings.perl.org/d/SUPL-Test

• Search CPAN

  http://search.cpan.org/dist/SUPL-Test/

Where can I go for help with a concrete version?

Bugs and feature requests are accepted against the latest version only. To get patches for earlier versions, you need to get an agreement with a developer of your choice - who may or not report the issue and a suggested fix upstream (depends on the license you have chosen).

Business support and maintenance

For business support you can contact Jens via his CPAN email address rehsackATcpan.org. Please keep in mind that business support is neither available for free nor are you eligible to receive any support based on the license distributed with this package.

ACKNOWLEDGEMENTS

AUTHOR

Jens Rehsack, <rehsack at cpan.org>

LICENSE AND COPYRIGHT

Copyright 2012 Jens Rehsack.

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.

cpanm Net::Radio::Location::SUPL::Test

perl -MCPAN -e shell
install Net::Radio::Location::SUPL::Test