Funkcia programu

Program Arpmon monitoruje zmeny v malej počítačovej sieti, t. j. v sieti s jedným smerovačom. Ak do siete pribudne nové zariadenie, alebo zariadenie zmení MAC adresu, administrátor obdrží o zmene e-mail.

Po spustení programu Arpmon sa vygenerujú dva textové súbory a dva HTML súbory. Na jednej HTML stránke je tabuľka s IP adresami, rozhraniami, MAC adresami a časmi (časom prvého záznamu IP adresy v ARP tabuľke a časom posledného záznamu IP adresy v ARP tabuľke). Program zaznamenáva aj to, keď zariadenie zmení MAC adresu. Preto môže jednej IP adrese prislúchať viacero MAC adries a tým aj časov.

Na druhej stránke je tabuľka s MAC adresami, rozhraniami, IP adresami a časmi (časom prvého záznamu MAC adresy v ARP tabuľke a časom posledného záznamu MAC adresy v ARP tabuľke). Jendej MAC adrese môže prislúchať viacero IP adries a tým aj časov.

Funkciou programu Arpmon_sort je triedenie údajov vo výstupných HTML súboroch. Po kliknutí na odkaz nad niektorým zo stĺpcov v tabuľke sa spustí CGI skript. Skript spustí program Arpmon_sort s príslušnými parametrami na triedenie. Arpmon_sort zotriedi údaje podľa zvolených parametrov a vygeneruje HTML stránku so zotriedenými údajmi. Po jednom kliknutí na odkaz v tabuľke sa vykoná vzostupné triedenie a po opätovnom kliknutí na ten istý odkaz sa vykoná zostupné triedenie.

Pre lepšiu orientáciu na stránkach sú IP res. MAC adresy nachádzajúce sa v danom čase v ARP tabuľke zobrazené inou farbou ako adresy, ktoré sa v danom čase nepoužívajú. Údaje sú vo výstupných súboroch aktualizované každých 5 sekúnd.

Súpis obsahu dodávky

Program je dodávaný na jednom inštalačnom médiu --- CD.
Dodávka obsahuje:

• arpmon-1.0.0.deb
• zdrojový súbor arpmon.c
• zdrojový súbor arpmon_sort.c
• dokumentáciu
  • systémovú príručku
  • používateľskú príručku

Inštalácia programu

Požiadavky na technické prostriedky

Minimálne technické požiadavky:

• Intel Pentium III
• RAM 128MB
• HDD s potrebným voľným miestom 10 MB
• sieťová karta 100Mbit/s na pripojenie do siete

Požiadavky na programové prostriedky

Pre spustenie programu je potrebné, aby mal počítač nainštalované nasledujúce programové prostriedky:

• Operačný systém GNU/Linux
• Web-ový server
• E-mailový server alebo účet na e-mailovom serveri
• Príslušné práva na používanie programu a potrebných súborov
• Balíček build-essential
• Balíček man
• Balíček mailutilis
• Prekladač jazyka C

Vlastná inštalácia

Na inštaláciu balíčka sú potrebné práva superpoužívateľa. Balíček sa inštaluje zadaním príkazu: $ dpkg -i ./arpmon-1.0.0.deb

Po nainštalovaní balíčka sa programy a potrebné súbory nakopírujú do adresára /var/www/arpmon a manuálové stránky do adresára /usr/share/man/man8. Najprv je potrebné spustiť program Arpmon zadaním príkazu: $ ./arpmon. Program Arpmon_sort je spúšťaný prostredníctvom CGI skriptov.

Program arpmon možno ukončiť stlačením: CTRL C.

Použitie programu

Pre použitie programu je nutné mať nainštalovaný web-ový server. Web-ový server je potrebné nakonfigurovať tak, aby spúšťal CGI programy a web-ové stránky z adresára /var/www/arpmon.

Aby bolo možné programy používať, musia mať pridelené príslušné práva. Programu Arpmon, Arpmon_sort a CGI programom je potrebné prideliť práva na vykonávanie. Vstupnému a výstupným súborom je potrebné prideliť práva na čítanie a zápis. Súbory html.txt, html2.txt a style.css musia mať práva na čítanie. Súbor config.txt práva na zápis a čítanie.

Arpmon sa spúšťa v konzolovom okne zadaním príkazu $ ./arpmon. Spustený program vygeneruje dva textové výstupné súbory a dva HTML výstupné súbory. Výstup programu - HTML stránku je potrebné otvoriť v prehliadači a do adresného poľa zadať IP adresu alebo doménovú adresu web-ového servera, poprípadne URI adresu http://localhost/, ak je web-ový server spustený na lokálnom počítači. Keď je stránka vo web-ovom prehliadači spustená, kliknutím na odkaz nad niektorým zo stĺpcov tabuľky sa spustí CGI skript. Skript spustí program Arpmon_sort s príslušnými parametrami na triedenie a zobrazí web-ovú stráku so zotriedenými údajmi.

Informácie o programoch, ich používaní a potrebných súboroch sú používateľom poskytnuté prostredníctvom manuálových stránok. Na zobrazenie manuálových stránok pre program Arpmon a Arpmon_sort sa používajú nasledujúce príkazy:
$ man arpmon
$ man arpmon_sort

Popis funkcie programu

Po otvorení stránky vo web-ovom prehliadači sa zobrazí stránka s tabuľkou. V tabuľke sa nachádzajú IP adresy, MAC adresy, rozhrania a časy, pozri Obrázok 1.

Obrázok 1.: Obsah súboru index.html

Údaje v tabuľke je možné triediť kliknutím na príslušný odkaz, nad niektorým zo stĺpcov. Po jednom kliknutí na daný odkaz sa vykoná vzostupné triedenie a po opätovnom kliknutí na ten istý odkaz sa vykoná zostupné triedenie. Na Obrázku 2 sa nachádza výstupný súbor s tabuľkou so vzostupne zotriedenými údajmi podľa IP adries.

Obrázok 2.: Obsah súboru sorted_ip_output.html

Po kliknutí na odkaz "Table with MAC addresses, interfaces, IP addresses and times" sa zobrazí web-ová stránka s podobným obsahom, aký je znázornený na Obrázku 3. Na tejto stránke je možné triediť údaje analogickým spôsobom, ako v predchádzajúcom príklade. Na stránku, kde sa k IP adresám vypisujú MAC adresy, rozhrania a časy, sa vracia kliknutím na odkaz "Table with IP addresses, interfaces, MAC addresses and times".

Obrázok 3.: Obsah súboru arp_output_mac.html

Opis vstupných, výstupných, pracovných súborov a manuálových stránok

Vstupný súbor

arp_input.txt
Vstupný textový súbor programu Arpmon. Do tohto súboru sa presmeruváva obsah ARP tabuľky.

Výstupné súbory

arp_output.txt
Výstupný textový súbor programu Arpmon, do ktorého sa vypisujú IP adresy k nim prislúchajúce MAC adresy, rozhrania a časy. Slúži ako vstupný súbor programu Arpmon_sort.

arp_output_mac.txt
Výstupný textový súbor programu Arpmon, do ktorého sa vypisujú MAC adresy k nim prislúchajúce IP adresy, rozhrania a časy. Slúži ako vstupný súbor programu Arpmon_sort.

index.html
Výstupný HTML súbor programu Arpmon, do ktorého sa vypisujú IP adresy k nim prislúchajúce MAC adresy, rozhrania a časy. údaje sú vypísané do tabuľky.

arp_output_mac.html
Výstupný HTML súbor programu Arpmon, do ktorého sa vypisujú MAC adresy k nim prislúchajúce IP adresy, rozhrania a časy. údaje sú vypísané do tabuľky.

sorted_ip_output.html
Výstupný HTML súbor programu Arpmon_sort, do ktorého sa vypisujú IP adresy k nim prislúchajúce MAC adresy, rozhrania a časy. údaje sú vypísané do tabuľky a sú zotriedené podľa zvoleného kritéria.

sorted_mac_output.html
Výstupný HTML súbor programu Arpmon_sort, do ktorého sa vypisujú MAC adresy k nim prislúchajúce IP adresy, rozhrania a časy. údaje sú vypísané do tabuľky a sú zotriedené podľa zvoleného kritéria.

Pracovné súbory

style.csc
Externý CSS súbor.

html.txt
html2.txt
Pomocné súbory.

ip_ascend.cgi
ip_descend.cgi
inf_ascend.cgi
inf_descend.cgi
mac_ascend.cgi
mac_descend.cgi
time1_ascend.cgi
time1_descend.cgi
time2_ascend.cgi
time2_descend.cgi
time11_ascend.cgi
time11_descend.cgi
time22_ascend.cgi
time22_descend.cgi
CGI programy.

config.txt
Konfiguračný súbor, v ktorom sa nachádza e-mailová adresa, na ktorú sa budú posielať upozornenia.

Manuálové stránky

ARPMON(8)
ARPMON_SORT(8)
Manuálové stránky zahŕňajú meno programu, popis spúťania a funkcie programu, chybové hlásenia a príklady použitia.

Obmedzenia programu

Program je určený na používanie v malých počítačových sieťach. Program môže zaznamenať najviac päťtisíc zariadení a pre jedno zariadenie zaznamená najviac päťdesiat IP resp. MAC adries.

Zmeny sa monitorujú každých päť sekúnd, ale pokiaľ v sieti pribudne nové zariadenie, alebo zariadenie zmení MAC adresu, odosiela sa e-mail informujúci administrátora o zmene. A tým sa čas vykonania ďalšieho náhľadu do ARP tabuľky predĺži o čas potrebný na odoslanie e-mailu alebo e-mailov.

Dĺžka e-mailovej adresy, na ktorú sa budú posielať upozornenia, môže mať najviac päťdesiat znakov.

Chybové hlásenia

Uvedené chybové hlásenia môžu byť spôsobené nedostatkom miesta na disku, nedostatkom pamäte. Systém ma limit na počet otvorených súborov, a ak je otvorený maximálny možný počet súborov, ďalší už otvoriť nie je možné. Alebo daný súbor neexistuje.

Error, unable to open file html.txt
Error, unable to open file html2.txt
Error, unable to open file config.txt
Error, unable to open file arp_input.txt
Error, unable to open file arp_output.txt
Error, unable to open file arp_output_mac.txt
Error, unable to open file index.html
Error, unable to open file arp_output_mac.html
Error, unable to open file sorted_ip_output.html
Error, unable to open file sorted_mac_output.html

Chybové hlásenie spôsobené kvôli nesprávnemu počtu argumentov:

Wrong number of arguments.

1. item argument: program name [./arpmon_sort]
2. argument: file name:
   • [--arp_output.txt]
   • [--arp_output_mac.txt]
3. argument:
   • ascend sorting [--vzostupne]
   • descend sorting [--zostupne]
4. argument: sorting parameter
   • IP address [--ip]
   • time when IP address was first time in the ARP table [--cas1]
   • time when IP address was last time in the ARP table [--cas2]
   • MAC address [--mac]
   • interface [--inf]
   • time when MAC address was first time in the ARP table [--cas11]
   • time when MAC address was last time in the ARP table [--cas22]

Chybové hlásenie spôsobené zadaním aspoň jedného nesprávneho argumentu:

Wrong argument.

1. item argument: program name [./arpmon_sort]
2. argument: file name:
   • [--arp_output.txt]
   • [--arp_output_mac.txt]
3. argument:
   • ascend sorting [--vzostupne]
   • descend sorting [--zostupne]
4. argument: sorting parameter
   • IP address [--ip]
   • time when IP address was first time in the ARP table [--cas1]
   • time when IP address was last time in the ARP table [--cas2]
   • MAC address [--mac]
   • interface [--inf]
   • time when MAC address was first time in the ARP table [--cas11]
   • time when MAC address was last time in the ARP table [--cas22]

Príklad použitia

Po otvorení stránky vo web-ovom prehliadači sa zobrazí web-ová stránka s tabuľkou, ako je to znázornené na Obrázku 1.

Po kliknutí na odkaz "Table with MAC addresses, interfaces, IP addresses and times" sa zobrazí web-ová stránka s tabuľkou, kde sa k MAC adresám zobrazujú IP adresy, rozhrania a časy, pozri Obrázok 3.

Po kliknutí na odkaz "MAC address" v hlavičke tabuľky dôjde k vzostupnému zotriedeniu údajov podľa MAC adries a po opätovnom kliknutí na daný odkaz sa vykoná zostupné triedenie, pozri Obrázok 4.

Obrázok 4.: Tabuľka so zostupne zotriedenými údajmi podľa MAC adries

-- IvanaKsenicova - 18 May 2009