aboutsummaryrefslogtreecommitdiff
path: root/examples/README
blob: f5a1c508add85a74fb48e069f5f51113bbb40454 (plain)
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
* Overview

This directory contains example Perl scripts that access ping903
facilities via REST API.  You can use them as templates for writing
your own configuration system, or just run them as they are, if you
prefer.

* Programs

 - inspect
     Queries the daemon for its configuration settings and displays
     them on stdout in the format of ping903 configuration file.

 - ipadd
     Adds IP address to the list of addresses monitored by ping903.

 - ipdel
     Removes IP address from the list of monitored addresses.

 - dbload
     Populates the list of monitored addresses from a SQL database.

All these programs use the LWP::Ping903 module, which provides support
for parsing the ".ping903.cred" file.  The source file for the module is
lib/LWP/Ping903.pm.  To run the programs from the examples directory,
define the following environment variable:

  export PERL5LIB=lib

If you don't plan to use basic authorization, you can get rid of this
dependency using the following command:

  sed -i 's/LWP::Ping903/LWP::UserAgent/' inspect ipadd ipdel dbload

* Documentation

Each example is self-documented.  To access the description, run the
script with the --help option, or do "perldoc PROG".


Local Variables:
mode: outline
paragraph-separate: "[	]*$"
version-control: never
End:


Return to:

Send suggestions and report system problems to the System administrator.