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
|
# --
# Copyright (C) 2001-2021 OTRS AG, https://otrs.com/
# --
# This software comes with ABSOLUTELY NO WARRANTY. For details, see
# the enclosed file COPYING for license information (GPL). If you
# did not receive this file, see https://www.gnu.org/licenses/gpl-3.0.txt.
# --
package Kernel::System::Daemon::BaseDaemon;
use strict;
use warnings;
=head1 NAME
Kernel::System::Daemon::BaseDaemon - daemon base class
=head1 DESCRIPTION
Base class for daemon modules.
=head1 PUBLIC INTERFACE
=head2 PreRun()
Perform additional validations/preparations and wait times before Run().
Override this method in your daemons.
If this method returns true, execution will be continued. If it returns false,
the main daemon aborts at this point, and Run() will not be called and the complete
daemon module dies waiting to be recreated again in the next loop.
=cut
sub PreRun {
my ( $Self, %Param ) = @_;
return 1;
}
=head2 Run()
Runs the daemon.
Override this method in your daemons.
If this method returns true, execution will be continued. If it returns false, the
main daemon aborts at this point, and PostRun() will not be called and the complete
daemon module dies waiting to be recreated again in the next loop.
=cut
sub Run {
my ( $Self, %Param ) = @_;
return 1;
}
=head2 PostRun()
Perform additional clean-ups and wait times after Run().
Override this method in your daemons.
If this method returns true, execution will be continued. If it returns false, the
main daemon aborts at this point, and PreRun() will not be called again and the
complete daemon module dies waiting to be recreated again in the next loop.
=cut
sub PostRun {
my ( $Self, %Param ) = @_;
sleep 1;
return 1;
}
=head2 Summary()
Provides a summary of what is the daemon doing in the current time, the summary is in form of tabular
data and it must contain a header, the definition of the columns, the data, and a message if there
was no data.
my @Summary = $DaemonObject->Summary();
returns
@Summary = (
{
Header => 'Header Message',
Column => [
{
Name => 'somename',
DisplayName => 'some name',
Size => 40,
},
# ...
],
Data => [
{
somename => $ScalarValue,
# ...
},
# ...
],
NoDataMessage => "Show this message if there is no data.",
},
);
Override this method in your daemons.
=cut
sub Summary {
my ( $Self, %Param ) = @_;
return ();
}
1;
=head1 TERMS AND CONDITIONS
This software is part of the OTRS project (L<https://otrs.org/>).
This software comes with ABSOLUTELY NO WARRANTY. For details, see
the enclosed file COPYING for license information (GPL). If you
did not receive this file, see L<https://www.gnu.org/licenses/gpl-3.0.txt>.
=cut
|
