Roger Crew > Thread-IID > Thread::IID

Download:
Thread-IID-0.04.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 0.04   Source  

NAME ^

Thread::IID - unique Interpreter IDs

VERSION ^

version 0.04

SYNOPSIS ^

  use Thread::IID ':all';

  print "Hi, I am interpreter #" . interpreter_id;

DESCRIPTION ^

This provides an identifier to distinguish Perl interpreter instances.

In environments like mod_perl2, where interpreters can be cloned and arbitrarily assigned to 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. For such situations an interpreter ID is more likely to be what you actually want.

EXPORT

None by default. The following function is available:

interpreter_id

Returns an (integer) ID for the Perl interpreter from which this call is being made. Returns 0 if the Perl was not compiled to allow multiple interpreters.

Where multiple interpreters have been created to run in threads of the current process and are concurrently in existence, the IDs returned will be distinct for each interpreter, regardless of which threads are running which interpreters. However, once an interpreter exits and its memory is reclaimed, nothing prevents its ID from being reused. It is also possible for the same ID to be returned from interpreters in different processes (and likely in the event that the processes were created by fork()).

In the current implementation, the Interpreter ID is derived from the memory address of the PerlInterpreter structure.

EXAMPLE ^

In the following

 my @value = (0, interpreter_id, $$, time);
 sleep(1);

 sub counter {
     ++$value[0];
     return @value;
 }

counter() is guaranteed to return a list value distinct from all other invocations in all processes/threads that are running this code on a given host.

AUTHOR ^

Roger Crew <crew@cs.stanford.edu>.

ACKNOWLEDGEMENTS ^

The original XS code for this was from a posting by ikegami at PerlMonks.

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.8.1 or, at your option, any later version of Perl 5 you may have available.

syntax highlighting: