GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  POE::COMPONENT::IKC::SPECIFIER (3)

.ds Aq ’

NAME

POE::Component::IKC::Specifier - IKC event specifer

CONTENTS

SYNOPSIS



    use POE;
    use POE::Component::IKC::Specifier;
    $state=specifier_parse(poe://*/timeserver/connect);
    print The foreign state is .specifier_name($state);



DESCRIPTION

This is a helper module that encapsulates POE IKC specifiers. An IKC specifier is a way of designating either a kernel, a session or a state within a IKC cluster.

IKC specifiers have the folloing format :



    poe:://kernel/session/state



<B>kernelB> may a kernel name, a kernel ID, blank (for local kernel), a ’*’ (all known foreign kernels) or host:port (not currently supported).

<B>sessionB> may be any session alias that has been published by the foreign kernel.

<B>stateB> is a state that has been published by a foreign session.

Examples :
poe://Pulse/timeserver/connect State ’connect’ in session ’timeserver’ on kernel ’Pulse’.
poe:/timeserver/connect State ’connect’ in session ’timeserver’ on the local kernel.
poe://*/timeserver/connect State ’connect’ in session ’timeserver’ on any known foreign kernel.
poe://Billy/bob/ Session ’bob’ on foreign kernel ’Billy’.

EXPORTED FUNCTIONS

CWspecifier_parse($spec)

Turn a specifier into the internal representation (hash ref). Returns <B>B>undef()<B>B> if the specifier wasn’t valid.



    print Dumper specifer_parse(poe://Pulse/timeserver/time);



would print



    $VAR1 = {
        kernel => Pulse,
        session => timeserver,
        state => time,
    };



<B>NoteB> : the internal representation might very well change some day.

CWspecifier_name($spec)

Turns a specifier into a string.

BUGS

AUTHOR

Philip Gwyn, <perl-ikc at pied.nu>

COPYRIGHT AND LICENSE

Copyright 1999-2014 by Philip Gwyn. All rights reserved.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

See <http://www.perl.com/language/misc/Artistic.html>

SEE ALSO

POE, POE::Component::IKC::Responder
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 IKC::SPECIFIER (3) 2014-07-07

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.