| 1 |
README for extras |
| 2 |
|
| 3 |
dhcp_probe.cf.sample is a sample dhcp_probe configuration file. You may find |
| 4 |
it useful to use as a template. |
| 5 |
|
| 6 |
dhcp_probe_notify2 is a sample alert program, suitable for specification |
| 7 |
via the alert_program_name2 configuration file statement. It is a Perl script |
| 8 |
that sends email. If you choose to use, it, install it someplace on your system |
| 9 |
where the dhcp_probe daemon can execute it. You will need to edit the definitions |
| 10 |
at the top of this script. Note that it calls the mail-throttled script below. |
| 11 |
|
| 12 |
dhcp_probe_notify is a sample alert program, similar to dhcp_probe_notify2; |
| 13 |
see the description above for 'dhcp_probe_notify2' for details. |
| 14 |
Unlike dhcp_probe_notify2, this program supports the older syntax used by |
| 15 |
the alert_program_name configuration file statement, rather than the newer |
| 16 |
syntax used by the alert_program_name2 configuration file statement. |
| 17 |
Because the older syntax is not extensible, this version cannot provide all the |
| 18 |
same features as 'dhcp_probe_notify2'. |
| 19 |
|
| 20 |
mail-throttled is a perl script called by dhcp_probe_notify2 or |
| 21 |
dhcp_probe_notify to throttle the frequency of messages that share a unique "key" |
| 22 |
specified by its caller. If you choose to use, it, install it someplace on your |
| 23 |
system where the dhcp_probe_notify script (called by dhcp_probe daemon) can execute it. |
| 24 |
You will need to edit the definitions at the top. |
| 25 |
|
| 26 |
dhcp_probe.startup.Solaris9 is a sample startup script that works in Solaris 9. |
| 27 |
If you choose to use it, place it in /etc/init.d/ with the filename 'dhcp_probe', |
| 28 |
and the symlinks documented in the script's comments. |
| 29 |
|
| 30 |
dhcp_probe.FreeBSD.sh is a sample rcNG script for use with FreeBSD. |
| 31 |
If you choose to use it, place it in /usr/local/etc/rc.d/ with the |
| 32 |
filename 'dhcp_probe.sh', then enable it in /etc/rc.conf: |
| 33 |
dhcp_probe_enable="YES" |
| 34 |
dhcp_probe_flags="<interface>" |
| 35 |
|
| 36 |
dhcp_probe.xml is a sample SMF manifest file and site-application-dhcp_probe |
| 37 |
is a sample Solaris method script, for use with Solaris SMF. |
| 38 |
If you choose to use them, place site-application-dhcp_probe in |
| 39 |
/lib/svc/method/site-application-dhcp_probe (for example), and |
| 40 |
place dhcp_probe.xml in /var/svc/manifest/site/application/dhcp_probe.xml |
| 41 |
(for example). Edit dhcp_probe.xml to specify an instance for each |
| 42 |
network interface on which you wish to run the program, naming each instance |
| 43 |
the same as the network interface name. Edit site-application-dhcp_probe |
| 44 |
as necessary. Then import the manifest and enable each desired instance, for example: |
| 45 |
/usr/sbin/svccfg -v validate /var/svc/manifest/site/application/dhcp_probe.xml |
| 46 |
/usr/sbin/svccfg -v import /var/svc/manifest/site/application/dhcp_probe.xml |
| 47 |
svcadm enable svc:/site/application/dhcp_probe:INSTANCE1 |
| 48 |
svcadm enable svc:/site/application/dhcp_probe:INSTANCE2 |
| 49 |
svcadm enable svc:/site/application/dhcp_probe:INSTANCE3 |
| 50 |
etc. |
| 51 |
|
| 52 |
rotate_logs is a log rotation utility which may optionally be used |
| 53 |
by site-application-dhcp_probe to rotate packet capture files. |