/*******************************************************************************

    Author ......... Arno Streuli
    Contact ........ astreuli@gmail.com
    Home Site ...... http://cactiusers.org
    Program ........ Network Link Discovery for Cacti
    Purpose ........ Network Link Discovery

*******************************************************************************/

----[ Purpose

	This plugin is for scanning the network and follow the CDP discovered host, creating graph of all uplink.

----[ Installation

	To install the plugin, please refer to the Plugin Installation Documentation

	linkdiscovery requires the Settings plugin to be installed at least, but ideally thold and monitor too
    
----[ Possible Bugs?
   
    The way you can call thold from another plugin: it create a threshold based on all your template, as long as it fit your interface. Example: if you have a traffic threshold and a status threshold, both will be created !
	It's a simple way of doing it, and not very good. I'm planning to create better way, but that require to write directly into cacti database, without calling thold plugin
	
	On slow link it can crash you poller process, so I advice to disable slow link device
	If you find a problem, let me know!!! http://bugs.cacti.net

----[ Future Changes

	Got any ideas or complaints, please e-mail me!

----[ Changelog

0.2	Added the Switch/router equipement type into the comment
0.3 Added a search based on destination hostname on the discover page
0.4 Addeds option for LLDP support
1.0 SCacti 1.x Compliant
1.0.2 added optional graph for non unicast packet
1.0.3 added the option to keep trace of IP phone, and keep the phone number. And keep WiFi AP monitored with ping
1.1.0 if extenddb is present we keep serial_no and type into the extention of the DB
1.1.1 added the management of the flag isPhone if extenddb is present
1.2.0 use automation templates to define what Device template has to be applied, and in the setting -> linkdiscovery just enable or disable graph creation
1.2.1 integration to EfficientIP netchange device management
1.2.2 make some cleaning about old configuration, and correct some graph creation problem
1.2.3 Don't graph subinterface, only type ethernetcsmacd (type 6) and tunnel(131)
1.2.4 Add the option to add to Aruba Clearpass NAC, as every discovered device will be added to the server provided
1.2.5 In Settings Linkdiscovery Seed device is displayed with description instead of hostname
1.2.6 Some optimisation on findhost, include detection if the process is allready running, and proxy bypass on parse-url, improve serial number reading fom switch based on type
1.2.7 Major correction on polling device on findhost, include the possibilité to have a CPU graph created from a snmp_queries
1.2.8 Minor correction on the phone tab display, display switch name (hostname), so added description
1.3.0 Major correction on the way graph are created, that solve some issue where all info for the graph where createed exce
pt the RRD file. 
1.3.1 Add a utilities to display the number of each device, based on SYSObjectID
1.3.2 Add the hash for Add the ClearPass access Token on the gui, instead of hardcoded
1.3.3 Add the option to disable the parsing of discovered phone, was used to have the phone number, but it's time consuming
1.3.4 Correction on the display of discovered link due to a change in the snmp_query ID, same for phone display
1.3.5 Correction for device count and display of device count, on utilities
1.3.6 Change the SNMP default setting, is taken from automation config instead of seed host, and if automation is not set, look via default config
1.3.7 rename one field on the linkdiscovery DB, remove config for graph since it should be handle by automation
1.3.8 correction in the way a host is added to IPAM or ClearPass when we receive a call from api_device_new
1.3.9 Correction of polling time calculation
1.4.0 Make some cleaning on plugin_linkdiscovery_hosts table, and on settings
1.4.1 remove type count, and move it to extenddb
1.4.2 optimize api hook call, and remove serial number and device type
1.4.3 remove IPAM from setup, and create a separate plugin
1.4.4 change type to model on host table
1.4.5 Follow change on extenddb about serial number, use only when parsing web page on phone
1.4.6 Chnaged the No scan option in the config, to handle VLSM subnet mask and hostname (IP), not just hostname
1.4.7 Added a 'loop' view, based on each port of a switch. Show what's the next until Spanntree limit of 6 switch, or the same as start
1.4.8 Added the option to keep the FQDN name for wifi device, their in DHCP so can change IP.
1.4.9 add the loop view, to draw the loop based on PDB. add debug option for this part
1.4.10: Add a record into the DB for setting: next_run_time, to store this value after findhost run.
1.5.0: remove all function related to the design of Loop, it's to time consuming, and to complicate when a switch is connected to a switch without any 'loop'