468 lines
21 KiB
Perl
468 lines
21 KiB
Perl
#
|
|
# Copyright 2020 Centreon (http://www.centreon.com/)
|
|
#
|
|
# Centreon is a full-fledged industry-strength solution that meets
|
|
# the needs in IT infrastructure and application monitoring for
|
|
# service performance.
|
|
#
|
|
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
# you may not use this file except in compliance with the License.
|
|
# You may obtain a copy of the License at
|
|
#
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
|
#
|
|
# Unless required by applicable law or agreed to in writing, software
|
|
# distributed under the License is distributed on an "AS IS" BASIS,
|
|
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
# See the License for the specific language governing permissions and
|
|
# limitations under the License.
|
|
#
|
|
|
|
package snmp_standard::mode::processcount;
|
|
|
|
use base qw(centreon::plugins::mode);
|
|
|
|
use strict;
|
|
use warnings;
|
|
use centreon::plugins::statefile;
|
|
use Digest::MD5 qw(md5_hex);
|
|
|
|
my %map_process_status = (
|
|
1 => 'running',
|
|
2 => 'runnable',
|
|
3 => 'notRunnable',
|
|
4 => 'invalid',
|
|
);
|
|
|
|
sub new {
|
|
my ($class, %options) = @_;
|
|
my $self = $class->SUPER::new(package => __PACKAGE__, %options);
|
|
bless $self, $class;
|
|
|
|
$options{options}->add_options(arguments => {
|
|
'process-status:s' => { name => 'process_status', default => 'running|runnable' },
|
|
'process-name:s' => { name => 'process_name' },
|
|
'regexp-name' => { name => 'regexp_name' },
|
|
'process-path:s' => { name => 'process_path' },
|
|
'regexp-path' => { name => 'regexp_path' },
|
|
'process-args:s' => { name => 'process_args' },
|
|
'regexp-args' => { name => 'regexp_args' },
|
|
'warning:s' => { name => 'warning' },
|
|
'critical:s' => { name => 'critical' },
|
|
'memory' => { name => 'memory' },
|
|
'warning-mem-each:s' => { name => 'warning_mem_each' },
|
|
'critical-mem-each:s' => { name => 'critical_mem_each' },
|
|
'warning-mem-total:s' => { name => 'warning_mem_total' },
|
|
'critical-mem-total:s' => { name => 'critical_mem_total' },
|
|
'warning-mem-avg:s' => { name => 'warning_mem_avg' },
|
|
'critical-mem-avg:s' => { name => 'critical_mem_avg' },
|
|
'cpu' => { name => 'cpu' },
|
|
'warning-cpu-total:s' => { name => 'warning_cpu_total' },
|
|
'critical-cpu-total:s' => { name => 'critical_cpu_total' },
|
|
'top' => { name => 'top' },
|
|
'top-num:s' => { name => 'top_num', default => 5 },
|
|
'top-size:s' => { name => 'top_size', default => 52428800 }, # 50MB
|
|
});
|
|
|
|
$self->{statefile_cache} = centreon::plugins::statefile->new(%options);
|
|
$self->{filter4md5} = '';
|
|
return $self;
|
|
}
|
|
|
|
sub check_options {
|
|
my ($self, %options) = @_;
|
|
$self->SUPER::init(%options);
|
|
|
|
if (($self->{perfdata}->threshold_validate(label => 'warning', value => $self->{option_results}->{warning})) == 0) {
|
|
$self->{output}->add_option_msg(short_msg => "Wrong warning threshold '" . $self->{option_results}->{warning} . "'.");
|
|
$self->{output}->option_exit();
|
|
}
|
|
if (($self->{perfdata}->threshold_validate(label => 'critical', value => $self->{option_results}->{critical})) == 0) {
|
|
$self->{output}->add_option_msg(short_msg => "Wrong critical threshold '" . $self->{option_results}->{critical} . "'.");
|
|
$self->{output}->option_exit();
|
|
}
|
|
if (($self->{perfdata}->threshold_validate(label => 'warning-mem-each', value => $self->{option_results}->{warning_mem_each})) == 0) {
|
|
$self->{output}->add_option_msg(short_msg => "Wrong warning-mem-each threshold '" . $self->{warning_mem_each} . "'.");
|
|
$self->{output}->option_exit();
|
|
}
|
|
if (($self->{perfdata}->threshold_validate(label => 'critical-mem-each', value => $self->{option_results}->{critical_mem_each})) == 0) {
|
|
$self->{output}->add_option_msg(short_msg => "Wrong critical-mem-each threshold '" . $self->{critical_mem_each} . "'.");
|
|
$self->{output}->option_exit();
|
|
}
|
|
if (($self->{perfdata}->threshold_validate(label => 'warning-mem-total', value => $self->{option_results}->{warning_mem_total})) == 0) {
|
|
$self->{output}->add_option_msg(short_msg => "Wrong warning-mem-total threshold '" . $self->{warning_mem_total} . "'.");
|
|
$self->{output}->option_exit();
|
|
}
|
|
if (($self->{perfdata}->threshold_validate(label => 'critical-mem-total', value => $self->{option_results}->{critical_mem_total})) == 0) {
|
|
$self->{output}->add_option_msg(short_msg => "Wrong critical-mem-total threshold '" . $self->{critical_mem_total} . "'.");
|
|
$self->{output}->option_exit();
|
|
}
|
|
if (($self->{perfdata}->threshold_validate(label => 'warning-mem-avg', value => $self->{option_results}->{warning_mem_avg})) == 0) {
|
|
$self->{output}->add_option_msg(short_msg => "Wrong warning-mem-avg threshold '" . $self->{warning_mem_avg} . "'.");
|
|
$self->{output}->option_exit();
|
|
}
|
|
if (($self->{perfdata}->threshold_validate(label => 'critical-mem-avg', value => $self->{option_results}->{critical_mem_avg})) == 0) {
|
|
$self->{output}->add_option_msg(short_msg => "Wrong critical-mem-avg threshold '" . $self->{critical_mem_avg} . "'.");
|
|
$self->{output}->option_exit();
|
|
}
|
|
if (($self->{perfdata}->threshold_validate(label => 'warning-cpu-total', value => $self->{option_results}->{warning_cpu_total})) == 0) {
|
|
$self->{output}->add_option_msg(short_msg => "Wrong warning-cpu-total threshold '" . $self->{warning_cpu_total} . "'.");
|
|
$self->{output}->option_exit();
|
|
}
|
|
if (($self->{perfdata}->threshold_validate(label => 'critical-cpu-total', value => $self->{option_results}->{critical_cpu_total})) == 0) {
|
|
$self->{output}->add_option_msg(short_msg => "Wrong critical-cpu-total threshold '" . $self->{critical_cpu_total} . "'.");
|
|
$self->{output}->option_exit();
|
|
}
|
|
|
|
if (defined($self->{option_results}->{cpu})) {
|
|
$self->{statefile_cache}->check_options(%options);
|
|
# Construct filter for file cache (avoid one check erase one other)
|
|
my @labels = ('process_name', 'regexp_name', 'process_path', 'regexp_path', 'process_args', 'regexp_args', 'process_status');
|
|
foreach (@labels) {
|
|
if (defined($self->{option_results}->{$_})) {
|
|
$self->{filter4md5} .= ',' . $self->{option_results}->{$_};
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
my $filters = {
|
|
status => { oid => '.1.3.6.1.2.1.25.4.2.1.7', default => 1, value => '', regexp => 1 }, # hrSWRunStatus
|
|
name => { oid => '.1.3.6.1.2.1.25.4.2.1.2', default => 0, value => '' }, # hrSWRunName (Warning: it's truncated. (15 characters))
|
|
path => { oid => '.1.3.6.1.2.1.25.4.2.1.4', default => 0, value => '' }, # hrSWRunPath
|
|
args => { oid => '.1.3.6.1.2.1.25.4.2.1.5', default => 0, value => '' }, # hrSWRunParameters (Warning: it's truncated. (128 characters))
|
|
};
|
|
|
|
my $oid_hrSWRunName = '.1.3.6.1.2.1.25.4.2.1.2';
|
|
my $oid_hrSWRunStatus = '.1.3.6.1.2.1.25.4.2.1.7';
|
|
my $oid_hrSWRunPerfMem = '.1.3.6.1.2.1.25.5.1.1.2';
|
|
my $oid_hrSWRunPerfCPU = '.1.3.6.1.2.1.25.5.1.1.1';
|
|
|
|
sub check_top {
|
|
my ($self, %options) = @_;
|
|
|
|
my $data;
|
|
foreach my $key (keys %{$self->{snmp_response}->{$oid_hrSWRunName}}) {
|
|
if ($key =~ /\.([0-9]+)$/ && defined($self->{snmp_response}->{$oid_hrSWRunPerfMem}->{$oid_hrSWRunPerfMem . '.' . $1})) {
|
|
$data->{$self->{snmp_response}->{$oid_hrSWRunName}->{$oid_hrSWRunName . '.' . $1}}->{memory} += $self->{snmp_response}->{$oid_hrSWRunPerfMem}->{$oid_hrSWRunPerfMem . '.' . $1} * 1024;
|
|
push @{$data->{$self->{snmp_response}->{$oid_hrSWRunName}->{$oid_hrSWRunName . '.' . $1}}->{pids}}, $1;
|
|
}
|
|
}
|
|
|
|
my $i = 1;
|
|
foreach my $name (sort { $data->{$b}->{memory} <=> $data->{$a}->{memory} } keys %$data) {
|
|
last if ($i > $self->{option_results}->{top_num});
|
|
last if ($data->{$name}->{memory} < $self->{option_results}->{top_size});
|
|
|
|
my ($mem_value, $mem_unit) = $self->{perfdata}->change_bytes(value => $data->{$name}->{memory});
|
|
$self->{output}->output_add(long_msg => sprintf("Top %d '%s' [pids: %s] memory usage: %s %s", $i, $name, join(", ", @{$data->{$name}->{pids}}), $mem_value, $mem_unit));
|
|
$self->{output}->perfdata_add(label => 'top_' . $name, unit => 'B',
|
|
value => $data->{$name}->{memory}, min => 0);
|
|
$i++;
|
|
}
|
|
}
|
|
|
|
sub run {
|
|
my ($self, %options) = @_;
|
|
$self->{snmp} = $options{snmp};
|
|
|
|
my $extra_oids = [];
|
|
foreach my $filter (keys %$filters) {
|
|
if (defined($self->{option_results}->{'process_' . $filter}) && $self->{option_results}->{'process_' . $filter} ne '') {
|
|
$filters->{$filter}->{value} = $self->{option_results}->{'process_' . $filter};
|
|
|
|
if ($filters->{$filter}->{default} == 0) {
|
|
push @{$extra_oids}, $filters->{$filter}->{oid};
|
|
}
|
|
}
|
|
if (defined($self->{option_results}->{'regexp_' . $filter})) {
|
|
$filters->{$filter}->{regexp} = 1;
|
|
}
|
|
}
|
|
if (defined($self->{option_results}->{memory})) {
|
|
push @{$extra_oids}, $oid_hrSWRunPerfMem;
|
|
}
|
|
if (defined($self->{option_results}->{cpu})) {
|
|
push @{$extra_oids}, $oid_hrSWRunPerfCPU;
|
|
}
|
|
|
|
my $oids_multiple_table = [ { oid => $oid_hrSWRunStatus } ];
|
|
if (defined($self->{option_results}->{top})) {
|
|
push @{$oids_multiple_table}, { oid => $oid_hrSWRunName };
|
|
push @{$oids_multiple_table}, { oid => $oid_hrSWRunPerfMem };
|
|
}
|
|
|
|
# First lookup on name and status
|
|
$self->{snmp_response} = $self->{snmp}->get_multiple_table(oids => $oids_multiple_table);
|
|
foreach my $key ($self->{snmp}->oid_lex_sort(keys %{$self->{snmp_response}->{$oid_hrSWRunStatus}})) {
|
|
$key =~ /\.([0-9]+)$/;
|
|
my $pid = $1;
|
|
$self->{results}->{$pid}->{status} = $map_process_status{$self->{snmp_response}->{$oid_hrSWRunStatus}->{$oid_hrSWRunStatus . '.' . $pid}};
|
|
|
|
foreach my $filter (keys %$filters) {
|
|
next if !defined($self->{results}->{$pid}) || $filters->{$filter}->{value} eq '' || $filters->{$filter}->{default} == 0;
|
|
|
|
if ((defined($filters->{$filter}->{regexp}) && $self->{results}->{$pid}->{$filter} !~ /$filters->{$filter}->{value}/)
|
|
|| (!defined($filters->{$filter}->{regexp}) && $self->{results}->{$pid}->{$filter} ne $filters->{$filter}->{value})) {
|
|
delete $self->{results}->{$pid};
|
|
}
|
|
}
|
|
}
|
|
|
|
# Second lookup on extra oids
|
|
if (scalar(keys %{$self->{results}}) > 0) {
|
|
if (scalar(@$extra_oids) > 0) {
|
|
$self->{snmp}->load(oids => $extra_oids, instances => [ keys %{$self->{results}} ]);
|
|
$self->{snmp_response_extra} = $self->{snmp}->get_leef();
|
|
|
|
foreach my $pid (keys %{$self->{results}}) {
|
|
foreach my $filter (keys %$filters) {
|
|
next if !defined($self->{results}->{$pid}) || $filters->{$filter}->{value} eq '' || $filters->{$filter}->{default} == 1;
|
|
|
|
if ((defined($filters->{$filter}->{regexp}) && $self->{snmp_response_extra}->{$filters->{$filter}->{oid} . '.' . $pid} !~ /$filters->{$filter}->{value}/)
|
|
|| (!defined($filters->{$filter}->{regexp}) && $self->{snmp_response_extra}->{$filters->{$filter}->{oid} . '.' . $pid} ne $filters->{$filter}->{value})) {
|
|
delete $self->{results}->{$pid};
|
|
} else {
|
|
$self->{results}->{$pid}->{$filter} = $self->{snmp_response_extra}->{$filters->{$filter}->{oid} . '.' . $pid};
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
my $num_processes_match = scalar(keys(%{$self->{results}}));
|
|
my $exit = $self->{perfdata}->threshold_check(value => $num_processes_match,
|
|
threshold => [ { label => 'critical', exit_litteral => 'critical' },
|
|
{ label => 'warning', exit_litteral => 'warning' } ]);
|
|
$self->{output}->output_add(severity => $exit,
|
|
short_msg => "Number of current processes running: $num_processes_match");
|
|
$self->{output}->perfdata_add(label => 'nbproc',
|
|
value => $num_processes_match,
|
|
warning => $self->{perfdata}->get_perfdata_for_output(label => 'warning'),
|
|
critical => $self->{perfdata}->get_perfdata_for_output(label => 'critical'),
|
|
min => 0);
|
|
|
|
# Check memory
|
|
if (defined($self->{option_results}->{memory}) && $num_processes_match > 0) {
|
|
my $total_memory = 0;
|
|
foreach my $pid (keys %{$self->{results}}) {
|
|
$total_memory += ($self->{snmp_response_extra}->{$oid_hrSWRunPerfMem . "." . $pid} * 1024);
|
|
my ($memory_value, $memory_unit) = $self->{perfdata}->change_bytes(value => $self->{snmp_response_extra}->{$oid_hrSWRunPerfMem . '.' . $pid} * 1024);
|
|
$self->{results}->{$pid}->{memory} = $memory_value . " " . $memory_unit;
|
|
|
|
$exit = $self->{perfdata}->threshold_check(value => $self->{snmp_response_extra}->{$oid_hrSWRunPerfMem . '.' . $pid} * 1024,
|
|
threshold => [ { label => 'critical-mem-each', exit_litteral => 'critical' },
|
|
{ label => 'warning-mem-each', exit_litteral => 'warning' } ]);
|
|
if (!$self->{output}->is_status(value => $exit, compare => 'ok', litteral => 1)) {
|
|
$self->{output}->output_add(severity => $exit,
|
|
short_msg => sprintf("Process '%s' memory usage: %.2f %s", $pid, $memory_value, $memory_unit));
|
|
}
|
|
}
|
|
|
|
my $exit = $self->{perfdata}->threshold_check(value => $total_memory,
|
|
threshold => [ { label => 'critical-mem-total', exit_litteral => 'critical' },
|
|
{ label => 'warning-mem-total', exit_litteral => 'warning' } ]);
|
|
my ($total_mem_value, $total_mem_unit) = $self->{perfdata}->change_bytes(value => $total_memory);
|
|
$self->{output}->output_add(severity => $exit,
|
|
short_msg => sprintf("Total memory usage: %s", $total_mem_value . " " . $total_mem_unit));
|
|
$self->{output}->perfdata_add(label => 'mem_total', unit => 'B',
|
|
value => $total_memory,
|
|
warning => $self->{perfdata}->get_perfdata_for_output(label => 'warning-mem-total'),
|
|
critical => $self->{perfdata}->get_perfdata_for_output(label => 'critical-mem-total'),
|
|
min => 0);
|
|
|
|
$exit = $self->{perfdata}->threshold_check(value => $total_memory / $num_processes_match,
|
|
threshold => [ { label => 'critical-mem-avg', exit_litteral => 'critical' },
|
|
{ label => 'warning-mem-avg', exit_litteral => 'warning' } ]);
|
|
my ($avg_mem_value, $avg_mem_unit) = $self->{perfdata}->change_bytes(value => $total_memory / $num_processes_match);
|
|
$self->{output}->output_add(severity => $exit,
|
|
short_msg => sprintf("Average memory usage: %.2f %s", $avg_mem_value, $avg_mem_unit));
|
|
$self->{output}->perfdata_add(label => 'mem_avg', unit => 'B',
|
|
value => sprintf("%.2f", $total_memory / $num_processes_match),
|
|
warning => $self->{perfdata}->get_perfdata_for_output(label => 'warning-mem-avg'),
|
|
critical => $self->{perfdata}->get_perfdata_for_output(label => 'critical-mem-avg'),
|
|
min => 0);
|
|
}
|
|
|
|
# Check cpu
|
|
if (defined($self->{option_results}->{cpu}) && $num_processes_match > 0) {
|
|
my $datas = {};
|
|
$datas->{last_timestamp} = time();
|
|
|
|
$self->{statefile_cache}->read(statefile => "snmpstandard_" . $self->{snmp}->get_hostname() . '_' .
|
|
$self->{snmp}->get_port() . '_' . $self->{mode} . '_' . md5_hex($self->{filter4md5}));
|
|
my $old_timestamp = $self->{statefile_cache}->get(name => 'last_timestamp');
|
|
|
|
my $total_cpu = 0;
|
|
my $checked = 0;
|
|
foreach my $pid (keys %{$self->{results}}) {
|
|
$datas->{'cpu_' . $pid} = $self->{snmp_response_extra}->{$oid_hrSWRunPerfCPU . "." . $pid};
|
|
my $old_cpu = $self->{statefile_cache}->get(name => 'cpu_' . $pid);
|
|
# No value added
|
|
if (!defined($old_cpu) || !defined($old_timestamp)) {
|
|
$self->{results}->{$pid}->{cpu} = 'Buffer creation...';
|
|
next;
|
|
}
|
|
# Go back to zero
|
|
if ($old_cpu > $datas->{'cpu_' . $pid}) {
|
|
$old_cpu = 0;
|
|
}
|
|
my $time_delta = ($datas->{last_timestamp} - $old_timestamp);
|
|
# At least one seconds.
|
|
if ($time_delta == 0) {
|
|
$time_delta = 1;
|
|
}
|
|
|
|
$total_cpu += (($datas->{'cpu_' . $pid} - $old_cpu) / $time_delta);
|
|
$self->{results}->{$pid}->{cpu} = sprintf("%.2f %%", ($datas->{'cpu_' . $pid} - $old_cpu) / $time_delta);
|
|
$checked = 1;
|
|
}
|
|
|
|
if ($checked == 1) {
|
|
$exit = $self->{perfdata}->threshold_check(value => $total_cpu, threshold => [ { label => 'critical-cpu-total', exit_litteral => 'critical' },
|
|
{ label => 'warning-cpu-total', exit_litteral => 'warning' } ]);
|
|
$self->{output}->output_add(severity => $exit,
|
|
short_msg => sprintf("Total CPU usage: %.2f %%", $total_cpu));
|
|
$self->{output}->perfdata_add(label => 'cpu_total', unit => '%',
|
|
value => sprintf("%.2f", $total_cpu),
|
|
warning => $self->{perfdata}->get_perfdata_for_output(label => 'warning-cpu-total'),
|
|
critical => $self->{perfdata}->get_perfdata_for_output(label => 'critical-cpu-total'),
|
|
min => 0);
|
|
}
|
|
|
|
$self->{statefile_cache}->write(data => $datas);
|
|
}
|
|
|
|
$self->check_top() if (defined($self->{option_results}->{top}));
|
|
|
|
foreach my $pid (keys %{$self->{results}}) {
|
|
my $long_msg = sprintf("Process '%s'", $pid);
|
|
foreach my $key (keys %{$self->{results}->{$pid}}) {
|
|
$long_msg .= sprintf(" [%s: %s]", $key, $self->{results}->{$pid}->{$key});
|
|
}
|
|
$self->{output}->output_add(long_msg => $long_msg);
|
|
}
|
|
|
|
$self->{output}->display();
|
|
$self->{output}->exit();
|
|
}
|
|
|
|
1;
|
|
|
|
__END__
|
|
|
|
=head1 MODE
|
|
|
|
Check system number of processes.
|
|
Can also check memory usage and cpu usage.
|
|
|
|
=over 8
|
|
|
|
=item B<--process-status>
|
|
|
|
Filter process status. Can be a regexp.
|
|
(Default: 'running|runnable').
|
|
|
|
=item B<--process-name>
|
|
|
|
Filter process name.
|
|
|
|
=item B<--regexp-name>
|
|
|
|
Allows to use regexp to filter process
|
|
name (with option --process-name).
|
|
|
|
=item B<--process-path>
|
|
|
|
Filter process path.
|
|
|
|
=item B<--regexp-path>
|
|
|
|
Allows to use regexp to filter process
|
|
path (with option --process-path).
|
|
|
|
=item B<--process-args>
|
|
|
|
Filter process arguments.
|
|
|
|
=item B<--regexp-args>
|
|
|
|
Allows to use regexp to filter process
|
|
arguments (with option --process-args).
|
|
|
|
=item B<--warning>
|
|
|
|
Threshold warning of matching processes count.
|
|
|
|
=item B<--critical>
|
|
|
|
Threshold critical of matching processes count.
|
|
|
|
=item B<--memory>
|
|
|
|
Check memory usage.
|
|
|
|
=item B<--warning-mem-each>
|
|
|
|
Threshold warning of memory
|
|
used by each matching processes (in Bytes).
|
|
|
|
=item B<--critical-mem-each>
|
|
|
|
Threshold critical of memory
|
|
used by each matching processes (in Bytes).
|
|
|
|
=item B<--warning-mem-total>
|
|
|
|
Threshold warning of total
|
|
memory used by matching processes (in Bytes).
|
|
|
|
=item B<--critical-mem-total>
|
|
|
|
Threshold critical of total
|
|
memory used by matching processes (in Bytes).
|
|
|
|
=item B<--warning-mem-avg>
|
|
|
|
Threshold warning of average
|
|
memory used by matching processes (in Bytes).
|
|
|
|
=item B<--critical-mem-avg>
|
|
|
|
Threshold critical of average
|
|
memory used by matching processes (in Bytes).
|
|
|
|
=item B<--cpu>
|
|
|
|
Check cpu usage. Should be used with fix processes.
|
|
If processes pid changes too much, the plugin can't compute values.
|
|
|
|
=item B<--warning-cpu-total>
|
|
|
|
Threshold warning of cpu usage for all processes (in percent).
|
|
CPU usage is in % of one cpu, so maximum can be 100% * number of CPU
|
|
and a process can have a value greater than 100%.
|
|
|
|
=item B<--critical-cpu-total>
|
|
|
|
Threshold critical of cpu usage for all processes (in percent).
|
|
CPU usage is in % of one cpu, so maximum can be 100% * number of CPU
|
|
and a process can have a value greater than 100%.
|
|
|
|
=item B<--top>
|
|
|
|
Enable top memory usage display.
|
|
|
|
=item B<--top-num>
|
|
|
|
Number of processes in top memory display (Default: 5).
|
|
|
|
=item B<--top-size>
|
|
|
|
Minimum memory usage to be in top memory display
|
|
(Default: 52428800 -> 50 MB).
|
|
|
|
=back
|
|
|
|
=cut
|