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
140
141
142
143
144
145
146
147
148
|
=head1 NAME
Apache2::Process - Perl API for Apache process record
=head1 Synopsis
use Apache2::Process ();
use Apache2::ServerRec ();
my $proc = $s->process;
# global pool cleared on exit
my $global_pool = $proc->pool;
# configuration pool cleared on restart
my $pconf = $proc->pconf;
# short program name (e.g. httpd)
my $proc_name = $proc->short_name;
=head1 Description
C<Apache2::Process> provides the API for the Apache process object,
which you can retrieve with
C<L<$s-E<gt>process|docs::2.0::api::Apache2::ServerRec/C_process_>>:
use Apache2::ServerRec ();
$proc = $s->process;
=head1 API
C<Apache2::Process> provides the following functions and/or methods:
=head2 C<pconf>
Get configuration pool object.
$p = $proc->pconf();
=over 4
=item obj: C<$proc>
( C<L<Apache2::Process object|docs::2.0::api::Apache2::Process>> )
=item ret: C<$p>
( C<L<APR::Pool object|docs::2.0::api::APR::Pool>> )
=item since: 2.0.00
=back
This pool object gets cleared on server restart.
=head2 C<pool>
Get the global pool object.
$p = $proc->pool();
=over 4
=item obj: C<$proc>
( C<L<Apache2::Process object|docs::2.0::api::Apache2::Process>> )
=item ret: C<$p>
( C<L<APR::Pool object|docs::2.0::api::APR::Pool>> )
=item since: 2.0.00
=back
This pool object gets cleared only on (normal) server exit
=head2 C<short_name>
The name of the program used to execute the program
$short_name = $proc->short_name();
=over 4
=item obj: C<$proc>
( C<L<Apache2::Process object|docs::2.0::api::Apache2::Process>> )
=item ret: C<$short_name> (string)
e.g. C<httpd>
=item since: 2.0.00
=back
=head1 See Also
L<mod_perl 2.0 documentation|docs::2.0::index>.
=head1 Copyright
mod_perl 2.0 and its core modules are copyrighted under
The Apache Software License, Version 2.0.
=head1 Authors
L<The mod_perl development team and numerous
contributors|about::contributors::people>.
=cut
|
