README
1Proc::Fork
2
3This module provides an intuitive, Perl-ish way to write forking programs
4by letting you use blocks to illustrate which code section executes in
5which fork. The code for the parent, child, retry handler and error
6handler are grouped together in a "fork block". The clauses may appear in
7any order, but they must be consecutive (without any other statements in
8between).
9
10All four clauses need not be specified. If the retry clause is omitted,
11only one fork will be attempted. If the error clause is omitted the
12program will die with a simple message if it can't retry. If the parent
13or child clause is omitted, the respective (parent or child) process will
14start execution after the final clause. So if one or the other only has
15to do some simple action, you need only specify that one. For example:
16
17 # spawn off a child process to do some simple processing
18 run_fork { child {
19 exec '/bin/ls', '-l';
20 die "Couldn't exec ls: $!\n";
21 } };
22 # Parent will continue execution from here
23 # ...
24
25If the code in any of the clauses does not die or exit, it will continue
26execution after the fork block.
27
28INSTALLATION
29
30This is a Perl module distribution. It should be installed with whichever
31tool you use to manage your installation of Perl, e.g. any of
32
33 cpanm .
34 cpan .
35 cpanp -i .
36
37Consult http://www.cpan.org/modules/INSTALL.html for further instruction.
38Should you wish to install this module manually, the procedure is
39
40 perl Makefile.PL
41 make
42 make test
43 make install
44
45COPYRIGHT AND LICENSE
46
47This documentation is copyright (c) 2002 by Eric J. Roode.
48
49This software is copyright (c) 2018 by Aristotle Pagaltzis.
50
51This is free software; you can redistribute it and/or modify it under the
52same terms as the Perl 5 programming language system itself.
53