/usr/share/perl5/MCE.pod is in libmce-perl 1.517-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 | =head1 NAME
MCE - Many-core Engine for Perl. Provides parallel processing capabilities.
=head1 VERSION
This document describes MCE version 1.517
=head1 DESCRIPTION
Many-core Engine (MCE) for Perl helps enable a new level of performance by
maximizing all available cores. MCE spawns a pool of workers and therefore
does not fork a new process per each element of data. Instead, MCE follows
a bank queuing model. Imagine the line being the data and bank-tellers the
parallel workers. MCE enhances that model by adding the ability to chunk
the next n elements from the input stream to the next available worker.
Chunking and input data are optional in MCE. One may use MCE to run many
workers in parallel without specifying input data.
=head1 CORE MODULES
Three modules make up the core engine for MCE.
=over 3
=item L<MCE::Core>
Provides the core API for Many-core Engine.
=item L<MCE::Signal>
Temporary directory creation/cleanup & signal handling.
=item L<MCE::Util>
Public and private utility functions.
=back
=head1 MCE ADDONS
Currently, there are 2 addon modules.
=over 3
=item L<MCE::Queue>
Provides a hybrid queuing implementation for MCE supporting normal queues and
priority queues from a single module. MCE::Queue exchanges data via the core
engine to enable queueing to work for both children (spawned from fork) and
threads.
=item L<MCE::Subs>
Exports functions mapped directly to MCE's methods, e.g. mce_wid. The module
allows 3 options; :manager, :worker, :getter.
=back
=head1 MCE MODELS
MCE 1.5 includes 6 models. They configure the MCE instance and tune chunk_size
and max_workers for you. Spawning and shutdown is also automatic. In essence,
the models take Many-core Engine to a new level for ease of use.
=over 3
=item L<MCE::Loop>
Provides a parallel loop utilizing MCE for building creative loops.
=item L<MCE::Flow>
A parallel flow model for building creative applications. This makes use of
user_tasks in MCE. The author has full control when utilizing this model.
MCE::Flow is similar to MCE::Loop, but allows for multiple code blocks to
run simultaneously with a slight change to syntax.
=item L<MCE::Grep>
Provides a parallel grep implementation similar to the native grep function.
=item L<MCE::Map>
Provides a parallel map model similar to the native map function.
=item L<MCE::Step>
Provides a parallel step implementation utilizing MCE::Queue between user
tasks. MCE::Step is a spin off from MCE::Flow with a touch of MCE::Stream.
This model, introduced in 1.506, allows one to pass data from one sub-task
into the next transparently.
=item L<MCE::Stream>
Provides an efficient parallel implementation for chaining multiple maps
and greps together through user_tasks and MCE::Queue. Like with MCE::Flow,
MCE::Stream can run multiple code blocks simultaneously with a slight
change to syntax from MCE::Map and MCE::Grep.
=back
=head1 EXAMPLES
A placeholder for the examples included with the distribution.
=over 3
=item L<MCE::Examples>
Describes various demonstations for MCE including a Monte Carlo simulation.
=back
=head1 REQUIREMENTS
Perl 5.8.0 or later. PDL::IO::Storable is required in scripts running PDL
and using MCE for parallelization.
=head1 SOURCE
The source is hosted at L<http://code.google.com/p/many-core-engine-perl/>
=head1 AUTHOR
Mario E. Roy, S<E<lt>marioeroy AT gmail DOT comE<gt>>
=head1 COPYRIGHT AND LICENSE
Copyright (C) 2012-2014 by Mario E. Roy
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 L<http://dev.perl.org/licenses/> for more information.
=cut
|