This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Provide the \N{U+HHHH} syntax before we forget.
[perl5.git] / pod / perlthrtut.pod
CommitLineData
2605996a
JH
1=head1 NAME
2
3perlthrtut - tutorial on threads in Perl
4
5=head1 DESCRIPTION
6
53d7eaa8
JH
7B<NOTE>: this tutorial describes the new Perl threading flavour
8introduced in Perl 5.6.0 called interpreter threads, or ithreads
9for short. There is another older perl threading flavour called
10the 5.005 model, unsurprisingly for 5.005 versions of Perl.
2a4bf773 11
53d7eaa8
JH
12You can see which (or neither) threading flavour you have by
13running C<perl -V> and look at the C<Platform> section.
14If you have C<useithreads=define> you have ithreads, if you
15have C<use5005threads=define> you have 5.005 threads.
16If you have neither, you don't have any thread support built in.
17If you have both, you are in trouble.
2605996a 18
53d7eaa8 19This document is unfortunately rather sparse as of 2001-Sep-17.
2605996a 20
53d7eaa8
JH
21In the meanwhile, you can read up on threading basics (while keeping
22in mind the above caveat about the changing threading flavours) in
23L<perlothrtut>
2605996a
JH
24
25=over 4
26
53d7eaa8 27=item *
2605996a 28
53d7eaa8 29L<perlothrtut/What Is A Thread Anyway?>
2605996a 30
53d7eaa8 31=item *
2605996a 32
53d7eaa8 33L<perlothrtut/Threaded Program Models>
2605996a 34
53d7eaa8 35=item *
2605996a 36
53d7eaa8 37L<perlothrtut/Native threads>
2605996a 38
53d7eaa8 39=item *
2605996a 40
53d7eaa8 41L<perlothrtut/What kind of threads are perl threads?>
2605996a 42
2605996a 43
53d7eaa8 44=item *
2605996a 45
53d7eaa8 46L<perlothrtut/Threadsafe Modules>
2605996a
JH
47
48=back
49
53d7eaa8
JH
50When C<perlothrut> reaches L<perlothrtut/Thread Basics> is when
51you should slow down and remember to mentally read C<threads>
52when C<perlothrtut> says C<Thread>. The C<Thread> was the old
535.005-style threading module, the C<threads> is the new ithreads
54style threading module.
2605996a 55
53d7eaa8 56For more information please see L<threads> and L<threads::shared>.
2605996a 57