host/ihost-perl/ihost.pl

#!/usr/bin/perl -w

# -----------------------------------------------------------
# Perl i-scream Host.
# http://www.i-scream.org.uk
#
# An all-in-one script to act as an i-scream host on
# a typical Unix/Linux box.
#
# $Author: tdb $
# $Id: ihost.pl,v 1.45 2001/12/18 06:07:00 tdb Exp $
#------------------------------------------------------------

$| = 1;

use strict;
use IO::Socket;
use Sys::Hostname;

use vars qw (
             $filter_manager_addr
             $filter_manager_port
             $seq_no
             $udp_update_time
             $tcp_update_time
             $last_udp_time
             $last_tcp_time
             $last_modified
             $udp_port
             $tcp_port
             $filter_addr
             $file_list
             $fqdn
             $pidfile
             $retry_wait
             $ostype
             @data
            );

if (@ARGV != 2) {
    die "Usage: ihost.pl [i-scream filter manager] [TCP port]\n";
}

$filter_manager_addr = $ARGV[0];
$filter_manager_port = $ARGV[1];

$seq_no = 1;
$retry_wait = 60;

# work out our platform, if we can.
$ostype = `uname -s`;
chomp $ostype;
$ostype = "unknown" if not defined $ostype;

# write our PID to a file
# use home dir by default
#$pidfile = $ENV{"HOME"};
# or drop it in /var/tmp if we can't find HOME
$pidfile = "/var/tmp" if not defined $pidfile;
$pidfile .= "/.ihost.pid";
&write_pid();

&tcp_configure();
&send_udp_packet();

$last_udp_time = time;
$last_tcp_time = time;
while (1) {
    my($time) = time;
    if ($time >= $last_udp_time + $udp_update_time) {
        &send_udp_packet();
        $last_udp_time = $time;
    }
    if ($time >= $last_tcp_time + $tcp_update_time) {
        &send_tcp_heartbeat();
        $last_tcp_time = $time;
    }
    my($next_udp) = $udp_update_time - $time + $last_udp_time;
    my($next_tcp) = $tcp_update_time - $time + $last_tcp_time;
    my($delay);
    if ($next_udp < $next_tcp) {
        $delay = $next_udp
    }
    else {
        $delay = $next_tcp;
    }
    sleep $delay;
}

# we'll probably never get here...
`rm -f $pidfile`;
exit(0);


#-----------------------------------------------------------------------
# wait_then_retry
# Waits for the period of time specified in $retry_wait, then attempts
# to reconfigure with the server.
#-----------------------------------------------------------------------
sub wait_then_retry() {
    print "Will retry configuration with filter manager in $retry_wait seconds.\n";
    sleep $retry_wait;
}


#-----------------------------------------------------------------------
# tcp_configure
# Establishes a TCP connection to the specified i-scream filter manager.
# The host then requests details from the server, such as the intervals
# at which to send UDP packets.
#-----------------------------------------------------------------------
sub tcp_configure() {
    
    while (1) {
        my($sock) = new IO::Socket::INET(
                                         PeerAddr => $filter_manager_addr,
                                         PeerPort => $filter_manager_port,
                                         Proto => 'tcp'
                                        ) or die "Cannot connect!";
        if (!defined $sock) {
            print "IHOST ERROR: Could not connect to $filter_manager_addr:$filter_manager_port.\n";
            print "Please check that there is an i-scream server at this address.\n";
            wait_then_retry();
            next;
        }

        # Now run through the configuration process...
        my($response);
    
        print $sock "STARTCONFIG\n";
        $response = <$sock>;
        if ($response && !($response eq "OK\n")) {
            print "The i-scream server rejected the STARTCONFIG command.\n";
            close($sock);
            wait_then_retry();
            next;
        }

        print "Config started okay.\n";
    
        print $sock "LASTMODIFIED\n";
        $response = <$sock>;
        if (!$response) {
            print "The i-scream server did not return anything for the LASTMODIFIED command.\n";
            close($sock);
            wait_then_retry();
            next;
        }
        chop $response;
        $last_modified = $response;
    
        print "Config last modified: ". (scalar localtime $last_modified/1000) . "\n";

        print $sock "FILELIST\n";
        $response = <$sock>;
        if (!$response) {
            print "The i-scream server did not provide a configuration file list.\n";
            close($sock);
            wait_then_retry();
            next;
        }
        chop $response;
        $file_list = $response;

        print "File list obtained: $file_list\n";

        print $sock "FQDN\n";
        $response = <$sock>;
        if (!$response) {
            print "The i-scream server did not tell us our FQDN.\n";
            close($sock);
            wait_then_retry();
            next;
        }
        chop $response;
        $fqdn = $response;

        print "FQDN returned: $fqdn\n";

        print $sock "UDPUpdateTime\n";
        $response = <$sock>;
        if (!$response) {
            print "The i-scream server did not give us a UDPUpdateTime.\n";
            close($sock);
            wait_then_retry();
            next;
        }
        chop $response;
        $udp_update_time = $response;

        print $sock "TCPUpdateTime\n";
        $response = <$sock>;
        if (!$response) {
            print "The i-scream server did not give us a TCPUpdateTime.\n";
            close($sock);
            wait_then_retry();
            next;
        }
        chop $response;
        $tcp_update_time = $response;
    
        print "UDP packet period: $udp_update_time seconds.\nTCP heartbeat period: $tcp_update_time seconds.\n";

        print $sock "ENDCONFIG\n";
        $response = <$sock>;
        if ($response && !($response eq "OK\n")) {
            print "ENDCONFIG command to server failed.  Terminated.\n";
            close($sock);
            wait_then_retry();
            next;
        }

        print "Config ended.\n";
    
        print $sock "FILTER\n";
        $response = <$sock>;
        if (!$response) {
            print "Failed: Could not get a filter address from the filter manager.\n";
            close($sock);
            wait_then_retry();
            next;
        }
        chop $response;
        $response =~ /^(.*);(.*);(.*)/;
        if ($response eq "ERROR") {
            print "There are no active configured filters for your host.\n";
            close($sock);
            wait_then_retry();
            next;
        }
        ($filter_addr, $udp_port, $tcp_port) = ($1, $2, $3);
        unless (defined($filter_addr) && defined($udp_port) && defined($tcp_port)) {
            print "Failed: Filter address response from server did not make sense: $response\n";
            close($sock);
            wait_then_retry();
            next;
        }
    
        print "Got filter data ($filter_addr, $udp_port, $tcp_port)\n";

        print $sock "END\n";
        $response = <$sock>;
        if ($response && ($response eq "OK\n")) {
            print "Host successfully configured via TCP.\n"
        }
        else {
            print "The server failed the host configuration on the END command.\n";
            close($sock);
            wait_then_retry();
            next;
        }
    
        close($sock);

        print "Configuration finished sucessfully!\n";
        last;
    }
    return;
}


#-----------------------------------------------------------------------
# send_udp_packet
# Sends a UDP packet to an i-scream filter.
# The packet contains XML markup describing some of the machine's state.
# Receipt of UDP packets is not guaranteed.
#-----------------------------------------------------------------------
sub send_udp_packet() {

    my($plugins_dir) = "plugins";
    
    opendir PLUGINS, $plugins_dir;
    my(@plugins) = readdir PLUGINS;
    foreach my $plugin (@plugins) {
        push @data, `$plugins_dir/$plugin $ostype` if -x "$plugins_dir/$plugin" && -f "$plugins_dir/$plugin";
    }
    
    # get some extra data
    my($date) = time;
    my($ip);
    $ip = inet_ntoa(scalar(gethostbyname(hostname())) || 'localhost') or $ip = 'localhost';
    
    # add some extra data to the array
    push(@data, "packet.attributes.seq_no $seq_no");
    push(@data, "packet.attributes.machine_name $fqdn");
    push(@data, "packet.attributes.date $date");
    push(@data, "packet.attributes.type data");
    push(@data, "packet.attributes.ip $ip");
    
    # sort the data
    @data = sort(grep(!/^$/, grep(/^packet\./, @data)));

    # turn the array into some nice XML
    my($xml) = &make_xml("", "");

    my($sock) = new IO::Socket::INET (
                                      PeerPort => $udp_port,
                                      PeerAddr => $filter_addr,
                                      Proto => 'udp'
                                     ) or die "Could not send UDP: $!\n";
    
    print $sock $xml or die "Could not send UDP packet: $!\n";
    close($sock);
    $seq_no++;
    print "-";
    
    return;
}


#-----------------------------------------------------------------------
# send_tcp_heartbeat
# Establishes a TCP connection to an i-scream filter.
# The heartbeat is used as a guaranteed "I'm alive" delivery mechanism.
# If we need to reconfigure, then we complete the heartbeat before
# doing so.
#-----------------------------------------------------------------------
sub send_tcp_heartbeat() {

    my ($doReconfigure) = 0;

    my($sock) = new IO::Socket::INET(
                                     PeerAddr => $filter_addr,
                                     PeerPort => $tcp_port,
                                     Proto => 'tcp'
                                    ) or return;
    if (!defined $sock) {
        print "IHOST WARNING: Failed to deliver a heartbeat to the i-scream filter.\n";
        &tcp_configure();
        return;
    }

    # Now run through the configuration process.
    my($response);

    print $sock "HEARTBEAT\n";
    $response = <$sock>;
    if (!$response eq "OK\n") {
        close($sock);
        print "Server gave wrong response to HEARTBEAT: $response\n";
        &tcp_configure();
        return;
    }
    
    print $sock "CONFIG\n";
    $response = <$sock>;
    if (!$response eq "OK\n") {
        close($sock);
        print "Server gave wrong response to CONFIG: $response\n";
        &tcp_configure();
        return;
    }

    print $sock "$file_list\n";
    $response = <$sock>;
    if (!$response eq "OK\n") {
        close($sock);
        print "Server gave wrong response to file list: $response\n";
        &tcp_configure();
        return;
    }
    
    print $sock "$last_modified\n";
    $response = <$sock>;
    if ($response eq "ERROR\n") {
        close($sock);
        print "Server configuration changed.  Reconfiguring with filter manager.\n";
        $doReconfigure = 1;
    }
    if (!$response eq "OK\n") {
        close($sock);
        print "Server gave wrong response to HEARTBEAT: $response\n";
        &tcp_configure();
        return;
    }
    
    print $sock "ENDHEARTBEAT\n";
    $response = <$sock>;
    if (!$response eq "OK\n") {
        close($sock);
        print "Server gave wrong response to ENDHEARTBEAT: $response\n";
        &tcp_configure();
        return;
    }
    
    close($sock);
    print "^";
    
    &tcp_configure() if $doReconfigure;
    
    return;
}


#-----------------------------------------------------------------------
# write_pid
# Writes the PID (process ID) of this instance to $pidfile.
# This is then used by a seperate script to check (and restart) ihost.
#-----------------------------------------------------------------------
sub write_pid() {
    open PID, ">$pidfile";
    print PID $$;
    close PID;
    
    return;
}

#-----------------------------------------------------------------------
# make_xml
# Turns an array of plugins data into an XML string.
#-----------------------------------------------------------------------
sub make_xml() {
    my($curlevel, $curline) = @_;
    my($xmltemp) = ""; my($curtag) = ""; my($attributes) = "";
    while(1) {
        $curline = shift(@data) if $curline eq "";
        return $xmltemp if not defined $curline;
        chomp $curline;
        # dealing with nest (or attributes)
        if($curline =~ /^$curlevel([^\.\s]+\.)/) {
            $curtag=$1;
            if($curline =~ /^$curlevel$curtag([^\.\s]+)\s+(.*)$/) {
                $xmltemp .= &make_xml("$curlevel$curtag", $curline);
            }
            elsif($curline =~ /^$curlevel$curtag(attributes)\.([^\.\s]+)\s+(.*)$/) {
                $attributes .= " $2=\"$3\"";
            }
            else {
                $xmltemp .= &make_xml("$curlevel$curtag", $curline);
            }
            my($nextline) = $data[0]; chomp $nextline if defined $nextline;
            $curtag =~ s/(.*)\./$1/;
            if((defined $nextline) && ($nextline =~ /^$curlevel$curtag\./)) {
                $curline = ""; 
            }
            else {
                $xmltemp = "<$curtag$attributes>$xmltemp</$curtag>" unless $curtag eq "";
                return $xmltemp;
            }
        }
        # dealing with value
        elsif($curline =~ /^$curlevel([^\.\s]+)\s+(.*)$/) {
            $curtag=$1;
            $xmltemp=$2;           
            my($nextline) = $data[0]; chomp $nextline if defined $nextline;
            if(defined $nextline && ($nextline =~ /^$curlevel$curtag\./ || $nextline =~ /^$curlevel$curtag\s+/)) {
                $curline = ""; 
            }
            else {
                $xmltemp = "<$curtag$attributes>$xmltemp</$curtag>" unless $curtag eq "";
                return $xmltemp;
            }
        }
        # dealing with a null value
        elsif($curline =~ /^$curlevel([^\.\s]+)$/) {
            # simply adding a space makes the above elsif deal with it :)
            # just level with an empty tag in the XML
            $curline .= " ";
        }
        # failing all that, skip the line
        else {
            $curline = "";
        }
    }
}
Revision:	1.46
Committed:	Mon Mar 11 13:34:24 2002 UTC (22 years, 8 months ago) by tdb
Content type:	text/plain
Branch:	MAIN
Changes since 1.45:	+11 -1 lines
Log Message:	If data is given from an ihost plugin with just a tag name, ihost loops forever. An example of such a line is "packet.testlevel.test". This commit fixes this by taking advantage of a kludge :) If the above line was infact "packet.testlevel.test " it would be parsed, albeit creating an empty nest of XML: "<packet><testlevel><test></test></testlevel></packet>". Seeing as this is probably what was intended we just add a space to the end of the offending line and have another go at parsing it :) Also, to further ensure this doesn't happen in future, a catchall statement has been added to drop any lines which don't seem to make sense.
#	Content
1	#!/usr/bin/perl -w
2
3	# -----------------------------------------------------------
4	# Perl i-scream Host.
5	# http://www.i-scream.org.uk
6	#
7	# An all-in-one script to act as an i-scream host on
8	# a typical Unix/Linux box.
9	#
10	# $Author: tdb $
11	# $Id: ihost.pl,v 1.45 2001/12/18 06:07:00 tdb Exp $
12	#------------------------------------------------------------
13
14	$\| = 1;
15
16	use strict;
17	use IO::Socket;
18	use Sys::Hostname;
19
20	use vars qw (
21	$filter_manager_addr
22	$filter_manager_port
23	$seq_no
24	$udp_update_time
25	$tcp_update_time
26	$last_udp_time
27	$last_tcp_time
28	$last_modified
29	$udp_port
30	$tcp_port
31	$filter_addr
32	$file_list
33	$fqdn
34	$pidfile
35	$retry_wait
36	$ostype
37	@data
38	);
39
40	if (@ARGV != 2) {
41	die "Usage: ihost.pl [i-scream filter manager] [TCP port]\n";
42	}
43
44	$filter_manager_addr = $ARGV[0];
45	$filter_manager_port = $ARGV[1];
46
47	$seq_no = 1;
48	$retry_wait = 60;
49
50	# work out our platform, if we can.
51	$ostype = `uname -s`;
52	chomp $ostype;
53	$ostype = "unknown" if not defined $ostype;
54
55	# write our PID to a file
56	# use home dir by default
57	#$pidfile = $ENV{"HOME"};
58	# or drop it in /var/tmp if we can't find HOME
59	$pidfile = "/var/tmp" if not defined $pidfile;
60	$pidfile .= "/.ihost.pid";
61	&write_pid();
62
63	&tcp_configure();
64	&send_udp_packet();
65
66	$last_udp_time = time;
67	$last_tcp_time = time;
68	while (1) {
69	my($time) = time;
70	if ($time >= $last_udp_time + $udp_update_time) {
71	&send_udp_packet();
72	$last_udp_time = $time;
73	}
74	if ($time >= $last_tcp_time + $tcp_update_time) {
75	&send_tcp_heartbeat();
76	$last_tcp_time = $time;
77	}
78	my($next_udp) = $udp_update_time - $time + $last_udp_time;
79	my($next_tcp) = $tcp_update_time - $time + $last_tcp_time;
80	my($delay);
81	if ($next_udp < $next_tcp) {
82	$delay = $next_udp
83	}
84	else {
85	$delay = $next_tcp;
86	}
87	sleep $delay;
88	}
89
90	# we'll probably never get here...
91	`rm -f $pidfile`;
92	exit(0);
93
94
95	#-----------------------------------------------------------------------
96	# wait_then_retry
97	# Waits for the period of time specified in $retry_wait, then attempts
98	# to reconfigure with the server.
99	#-----------------------------------------------------------------------
100	sub wait_then_retry() {
101	print "Will retry configuration with filter manager in $retry_wait seconds.\n";
102	sleep $retry_wait;
103	}
104
105
106	#-----------------------------------------------------------------------
107	# tcp_configure
108	# Establishes a TCP connection to the specified i-scream filter manager.
109	# The host then requests details from the server, such as the intervals
110	# at which to send UDP packets.
111	#-----------------------------------------------------------------------
112	sub tcp_configure() {
113
114	while (1) {
115	my($sock) = new IO::Socket::INET(
116	PeerAddr => $filter_manager_addr,
117	PeerPort => $filter_manager_port,
118	Proto => 'tcp'
119	) or die "Cannot connect!";
120	if (!defined $sock) {
121	print "IHOST ERROR: Could not connect to $filter_manager_addr:$filter_manager_port.\n";
122	print "Please check that there is an i-scream server at this address.\n";
123	wait_then_retry();
124	next;
125	}
126
127	# Now run through the configuration process...
128	my($response);
129
130	print $sock "STARTCONFIG\n";
131	$response = <$sock>;
132	if ($response && !($response eq "OK\n")) {
133	print "The i-scream server rejected the STARTCONFIG command.\n";
134	close($sock);
135	wait_then_retry();
136	next;
137	}
138
139	print "Config started okay.\n";
140
141	print $sock "LASTMODIFIED\n";
142	$response = <$sock>;
143	if (!$response) {
144	print "The i-scream server did not return anything for the LASTMODIFIED command.\n";
145	close($sock);
146	wait_then_retry();
147	next;
148	}
149	chop $response;
150	$last_modified = $response;
151
152	print "Config last modified: ". (scalar localtime $last_modified/1000) . "\n";
153
154	print $sock "FILELIST\n";
155	$response = <$sock>;
156	if (!$response) {
157	print "The i-scream server did not provide a configuration file list.\n";
158	close($sock);
159	wait_then_retry();
160	next;
161	}
162	chop $response;
163	$file_list = $response;
164
165	print "File list obtained: $file_list\n";
166
167	print $sock "FQDN\n";
168	$response = <$sock>;
169	if (!$response) {
170	print "The i-scream server did not tell us our FQDN.\n";
171	close($sock);
172	wait_then_retry();
173	next;
174	}
175	chop $response;
176	$fqdn = $response;
177
178	print "FQDN returned: $fqdn\n";
179
180	print $sock "UDPUpdateTime\n";
181	$response = <$sock>;
182	if (!$response) {
183	print "The i-scream server did not give us a UDPUpdateTime.\n";
184	close($sock);
185	wait_then_retry();
186	next;
187	}
188	chop $response;
189	$udp_update_time = $response;
190
191	print $sock "TCPUpdateTime\n";
192	$response = <$sock>;
193	if (!$response) {
194	print "The i-scream server did not give us a TCPUpdateTime.\n";
195	close($sock);
196	wait_then_retry();
197	next;
198	}
199	chop $response;
200	$tcp_update_time = $response;
201
202	print "UDP packet period: $udp_update_time seconds.\nTCP heartbeat period: $tcp_update_time seconds.\n";
203
204	print $sock "ENDCONFIG\n";
205	$response = <$sock>;
206	if ($response && !($response eq "OK\n")) {
207	print "ENDCONFIG command to server failed. Terminated.\n";
208	close($sock);
209	wait_then_retry();
210	next;
211	}
212
213	print "Config ended.\n";
214
215	print $sock "FILTER\n";
216	$response = <$sock>;
217	if (!$response) {
218	print "Failed: Could not get a filter address from the filter manager.\n";
219	close($sock);
220	wait_then_retry();
221	next;
222	}
223	chop $response;
224	$response =~ /^(.);(.);(.*)/;
225	if ($response eq "ERROR") {
226	print "There are no active configured filters for your host.\n";
227	close($sock);
228	wait_then_retry();
229	next;
230	}
231	($filter_addr, $udp_port, $tcp_port) = ($1, $2, $3);
232	unless (defined($filter_addr) && defined($udp_port) && defined($tcp_port)) {
233	print "Failed: Filter address response from server did not make sense: $response\n";
234	close($sock);
235	wait_then_retry();
236	next;
237	}
238
239	print "Got filter data ($filter_addr, $udp_port, $tcp_port)\n";
240
241	print $sock "END\n";
242	$response = <$sock>;
243	if ($response && ($response eq "OK\n")) {
244	print "Host successfully configured via TCP.\n"
245	}
246	else {
247	print "The server failed the host configuration on the END command.\n";
248	close($sock);
249	wait_then_retry();
250	next;
251	}
252
253	close($sock);
254
255	print "Configuration finished sucessfully!\n";
256	last;
257	}
258	return;
259	}
260
261
262	#-----------------------------------------------------------------------
263	# send_udp_packet
264	# Sends a UDP packet to an i-scream filter.
265	# The packet contains XML markup describing some of the machine's state.
266	# Receipt of UDP packets is not guaranteed.
267	#-----------------------------------------------------------------------
268	sub send_udp_packet() {
269
270	my($plugins_dir) = "plugins";
271
272	opendir PLUGINS, $plugins_dir;
273	my(@plugins) = readdir PLUGINS;
274	foreach my $plugin (@plugins) {
275	push @data, `$plugins_dir/$plugin $ostype` if -x "$plugins_dir/$plugin" && -f "$plugins_dir/$plugin";
276	}
277
278	# get some extra data
279	my($date) = time;
280	my($ip);
281	$ip = inet_ntoa(scalar(gethostbyname(hostname())) \|\| 'localhost') or $ip = 'localhost';
282
283	# add some extra data to the array
284	push(@data, "packet.attributes.seq_no $seq_no");
285	push(@data, "packet.attributes.machine_name $fqdn");
286	push(@data, "packet.attributes.date $date");
287	push(@data, "packet.attributes.type data");
288	push(@data, "packet.attributes.ip $ip");
289
290	# sort the data
291	@data = sort(grep(!/^$/, grep(/^packet\./, @data)));
292
293	# turn the array into some nice XML
294	my($xml) = &make_xml("", "");
295
296	my($sock) = new IO::Socket::INET (
297	PeerPort => $udp_port,
298	PeerAddr => $filter_addr,
299	Proto => 'udp'
300	) or die "Could not send UDP: $!\n";
301
302	print $sock $xml or die "Could not send UDP packet: $!\n";
303	close($sock);
304	$seq_no++;
305	print "-";
306
307	return;
308	}
309
310
311	#-----------------------------------------------------------------------
312	# send_tcp_heartbeat
313	# Establishes a TCP connection to an i-scream filter.
314	# The heartbeat is used as a guaranteed "I'm alive" delivery mechanism.
315	# If we need to reconfigure, then we complete the heartbeat before
316	# doing so.
317	#-----------------------------------------------------------------------
318	sub send_tcp_heartbeat() {
319
320	my ($doReconfigure) = 0;
321
322	my($sock) = new IO::Socket::INET(
323	PeerAddr => $filter_addr,
324	PeerPort => $tcp_port,
325	Proto => 'tcp'
326	) or return;
327	if (!defined $sock) {
328	print "IHOST WARNING: Failed to deliver a heartbeat to the i-scream filter.\n";
329	&tcp_configure();
330	return;
331	}
332
333	# Now run through the configuration process.
334	my($response);
335
336	print $sock "HEARTBEAT\n";
337	$response = <$sock>;
338	if (!$response eq "OK\n") {
339	close($sock);
340	print "Server gave wrong response to HEARTBEAT: $response\n";
341	&tcp_configure();
342	return;
343	}
344
345	print $sock "CONFIG\n";
346	$response = <$sock>;
347	if (!$response eq "OK\n") {
348	close($sock);
349	print "Server gave wrong response to CONFIG: $response\n";
350	&tcp_configure();
351	return;
352	}
353
354	print $sock "$file_list\n";
355	$response = <$sock>;
356	if (!$response eq "OK\n") {
357	close($sock);
358	print "Server gave wrong response to file list: $response\n";
359	&tcp_configure();
360	return;
361	}
362
363	print $sock "$last_modified\n";
364	$response = <$sock>;
365	if ($response eq "ERROR\n") {
366	close($sock);
367	print "Server configuration changed. Reconfiguring with filter manager.\n";
368	$doReconfigure = 1;
369	}
370	if (!$response eq "OK\n") {
371	close($sock);
372	print "Server gave wrong response to HEARTBEAT: $response\n";
373	&tcp_configure();
374	return;
375	}
376
377	print $sock "ENDHEARTBEAT\n";
378	$response = <$sock>;
379	if (!$response eq "OK\n") {
380	close($sock);
381	print "Server gave wrong response to ENDHEARTBEAT: $response\n";
382	&tcp_configure();
383	return;
384	}
385
386	close($sock);
387	print "^";
388
389	&tcp_configure() if $doReconfigure;
390
391	return;
392	}
393
394
395	#-----------------------------------------------------------------------
396	# write_pid
397	# Writes the PID (process ID) of this instance to $pidfile.
398	# This is then used by a seperate script to check (and restart) ihost.
399	#-----------------------------------------------------------------------
400	sub write_pid() {
401	open PID, ">$pidfile";
402	print PID $$;
403	close PID;
404
405	return;
406	}
407
408	#-----------------------------------------------------------------------
409	# make_xml
410	# Turns an array of plugins data into an XML string.
411	#-----------------------------------------------------------------------
412	sub make_xml() {
413	my($curlevel, $curline) = @_;
414	my($xmltemp) = ""; my($curtag) = ""; my($attributes) = "";
415	while(1) {
416	$curline = shift(@data) if $curline eq "";
417	return $xmltemp if not defined $curline;
418	chomp $curline;
419	# dealing with nest (or attributes)
420	if($curline =~ /^$curlevel([^\.\s]+\.)/) {
421	$curtag=$1;
422	if($curline =~ /^$curlevel$curtag([^\.\s]+)\s+(.*)$/) {
423	$xmltemp .= &make_xml("$curlevel$curtag", $curline);
424	}
425	elsif($curline =~ /^$curlevel$curtag(attributes)\.([^\.\s]+)\s+(.*)$/) {
426	$attributes .= " $2=\"$3\"";
427	}
428	else {
429	$xmltemp .= &make_xml("$curlevel$curtag", $curline);
430	}
431	my($nextline) = $data[0]; chomp $nextline if defined $nextline;
432	$curtag =~ s/(.*)\./$1/;
433	if((defined $nextline) && ($nextline =~ /^$curlevel$curtag\./)) {
434	$curline = "";
435	}
436	else {
437	$xmltemp = "<$curtag$attributes>$xmltemp</$curtag>" unless $curtag eq "";
438	return $xmltemp;
439	}
440	}
441	# dealing with value
442	elsif($curline =~ /^$curlevel([^\.\s]+)\s+(.*)$/) {
443	$curtag=$1;
444	$xmltemp=$2;
445	my($nextline) = $data[0]; chomp $nextline if defined $nextline;
446	if(defined $nextline && ($nextline =~ /^$curlevel$curtag\./ \|\| $nextline =~ /^$curlevel$curtag\s+/)) {
447	$curline = "";
448	}
449	else {
450	$xmltemp = "<$curtag$attributes>$xmltemp</$curtag>" unless $curtag eq "";
451	return $xmltemp;
452	}
453	}
454	# dealing with a null value
455	elsif($curline =~ /^$curlevel([^\.\s]+)$/) {
456	# simply adding a space makes the above elsif deal with it :)
457	# just level with an empty tag in the XML
458	$curline .= " ";
459	}
460	# failing all that, skip the line
461	else {
462	$curline = "";
463	}
464	}
465	}