NAME

Thread::IID - unique perl Interpreter IDs

VERSION

version 0.010002_002

SYNOPSIS

use Thread::IID ':all';

print "Hi, I am interpreter #" . get_interpreter_id();

DESCRIPTION

This provides an identifier to distinguish Perl interpreter instances.

In environments like mod_perl, where interpreters are cloned and passed around between OS threads, the thread ID gives no indication of which interpreter instance is actually running (and hence which corresponding set of values/data-structures is actually being referenced)

EXPORT

None by default. The following function is available:

get_interpreter_id()

Returns an integer ID for the current Perl interpreter instance.

Where multiple interpreters have been created to run in threads of the current process the IDs returned will be different for each interpreter, regardless of which threads are running which interpreters.

AUTHOR

Original XS code is from a posting by ikegami at PerlMonks. Packaged by Roger Crew, <crew@cs.stanford.edu>

COPYRIGHT AND LICENSE

Copyright (C) 2011 by Roger Crew

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.10.1 or, at your option, any later version of Perl 5 you may have available.