mrtglib - En ligne dans le Cloud

PROGRAMME:

Nom

MRTG_lib.pm - Bibliothèque pour MRTG et scripts de support

SYNOPSIS

utiliser MRTG_lib ;
mon ($configfile, @target_names, %globalcfg, %targetcfg);
readcfg ($ fichier de configuration, \@target_names, \%globalcfg, \%targetcfg);
mes (@parsed_targets);
cfgcheck(\@target_names, \%globalcfg, \%targetcfg, \@parsed_targets);

DESCRIPTION

MRTG_lib fait partie de MRTG, le grapheur de trafic multi-routeurs. Il a été séparé de MRTG pour
permettre à d'autres programmes d'utiliser facilement les mêmes fichiers de configuration. La partie principale de MRTG_lib est le
analyseur de fichier de configuration, mais d'autres fonctions sont également présentes.

$MRTG_lib ::OS
Type d'OS : WIN, UNIX, VMS

$MRTG_lib ::SL
Slash dans le système d'exploitation actuel.

$MRTG_lib :: PS
Séparateur de chemin dans la variable PATH

"readcfg"
"readcfg($file, \@targets, \%globalcfg, \%targetcfg [, $prefix, \%extrules])"

Lit un fichier de configuration, l'analyse et remplit des tableaux et des hachages. L'obligatoire
les arguments sont : le nom du fichier de configuration, une référence à un tableau qui sera rempli
avec une liste des noms de cible, un hashref pour la configuration globale, un hashref pour
la configuration cible.

La syntaxe du fichier de configuration est :

option globale : valeur
optioncible[nom cible] : valeur
aprefix*extglobal : valeur
aprefix*exttarget[target2] : valeur

Par exemple

répertoire de travail : /var/stat/mrtg
cible[routeur1] : 2 :public@router1.local.net
14toutes*colonnes : 2

Le hachage de configuration globale a la structure

$globalcfg{configoption} = 'valeur'

Le hachage de configuration cible a la structure

$targetcfg{configoption}{targetname} = 'valeur'

Voir mrtg-reference pour plus d'informations sur la syntaxe de configuration MRTG.

"readcfg" peut prendre deux arguments supplémentaires pour étendre la syntaxe du fichier de configuration. Cette
permet aux programmes de mettre leur configuration dans le fichier de configuration mrtg. Le cinquième
argument est le préfixe de l'extension, le sixième argument est un hachage avec le
les règles de contrôle pour ces paramètres d'extension. Par exemple, si le préfixe est "14all", "readcfg" sera
vérifiez les lignes de configuration qui commencent par "14all*", c'est-à-dire toutes les lignes comme

14toutes*colonnes : 2
14all*graphsize[target3] : 500 200

contre les règles de %extrules. Le format de ce hachage est :

$extrules{option} = [sub{$_[0] =~ m/^\d+$/}, sub{"Message d'erreur pour $_[0]"}]
à
$extrules{option}[0] -> une expression de test
$extrules{option}[1] -> message d'erreur si le test échoue

La première partie du tableau est une expression perl pour tester la valeur de l'option. Les
test peut accéder à cette valeur dans la variable "$arg". La deuxième partie du tableau est un
message d'erreur à afficher lorsque le test échoue. La valeur défaillante peut être intégrée par
en utilisant la variable "$arg".

Les paramètres de configuration avec un préfixe différent de celui donné dans l'appel "readcfg" sont
non vérifié mais inséré dans %globalcfg et votre %ciblecfg. Les paramètres préfixés conservent leur
préfixe dans les hachages de configuration :

$targetcfg{'14all*graphsize'}{'target3'} = '500 200'

"cfgcheck"
"cfgcheck(\@target_names, \%globalcfg, \%targetcfg, \@parsed_targets)"

Vérifie la configuration lue par "readcfg". Vérifie les valeurs dans la configuration pour
erreurs syntaxiques et/ou sémantiques. Définit les valeurs par défaut pour certaines options. Analyse le
"target[...]" options et remplit le tableau @parsed_targets prêt pour les fonctions mrtg.

Les trois premiers arguments sont les mêmes que pour "readcfg". Le quatrième argument est un
arrayref qui sera rempli avec les defs cibles analysées.

"cfgcheck" convertit les valeurs des paramètres cibles Options, par exemple

options[router1] : bits, growright

à un hachage :

$targetcfg{'option'}{'bits'}{'router1'} = 1
$targetcfg{'option'}{'growright'}{'router1'} = 1

Cela n'est pas fait par "readcfg", donc si vous n'utilisez pas "cfgcheck", vous devez vérifier le
variable scalaire $targetcfg{'option'}{'router1'} (MRTG permet de séparer les options
par espace ou ',').

"assurerSL"
"assurerSL(\$chemin)"

Vérifie que le chemin d'accès ne contient pas de séparateurs à double chemin et se termine par un chemin
séparateur. Il utilise $MRTG_lib::SL comme séparateur de chemin qui sera / ou \ selon
le système d'exploitation.

"log2rrd"
"log2rrd ($router,\%globalcfg,\%targetcfg)"

Convertir le fichier journal au format rrd. Nécessite rrdtool.

"datestr"
"datestr(heure)"

Renvoie l'heure donnée dans l'argument sous la forme d'une chaîne de date bien formatée. L'argument
doit être au format horaire UNIX (secondes depuis 1970-1-1).

"horodatage"
"horodatage()"

Renvoie une chaîne représentant l'heure actuelle.

"setup_loghandlers"
"setup_loghandlers(nom de fichier)"

Installez les gestionnaires de signaux pour __DIE__ et __WARN__ en faisant en sorte que les erreurs soient spécifiées
destination. Si le nom du fichier est « eventlog », mrtg se connectera au journal des événements Windows.

"expister"
"expistr(heure)"

Renvoie l'heure indiquée dans l'argument formaté de manière appropriée pour les en-têtes d'expiration HTTP.

"create_pid"
"create_pid()"

Crée un fichier pid pour le démon mrtg

"demonize_me"
"demonize_me()"

Met le programme en cours d'exécution en arrière-plan, le détachant du terminal.

"peuplercache"
"populatecache(\%confcache, $host, $reread, $snmpoptshash)"

Lit les variables SNMP ifDescr, ipAdEntIfIndex, ifPhysAddress, siNom du hôte
et stocke les valeurs dans %confcache comme suit:

$confcache{$host}{'Descr'}{ifDescr}{oid} = (ifDescr ou 'Dup')
$confcache{$host}{'IP'}{ipAdEntIfIndex}{oid} = (ipAdEntIfIndex ou 'Dup')
$confcache{$host}{'Eth'}{ifPhysAddress}{oid} = (ifPhysAddress ou 'Dup')
$confcache{$host}{'Name'}{ifName}{oid} = (ifName ou 'Dup')
$confcache{$host}{'Type'}{ifType}{oid} = (ifType ou 'Dup')

La valeur (à droite de =) est 'Dup' si une valeur a été récupérée plusieurs fois,
la valeur récupérée else.

"readconfcache"
"mon $confcache = readconfcache($file)"

Précharger le confcache à partir d'un fichier.

"readfromconfcache"
"writeconfcache($confcache,$file)"

Stockez le confcache actuel dans un fichier.

"writeconfcache"
"writeconfcache($confcache,$file)"

Stockez le confcache actuel dans un fichier.

"magasinache"
"storeincache($confcache,$host,$method,$key,$value)"

"readfromcache"
"readfromcache($confcache,$host,$method,$key)"

"clearfromcache"
"clearfromcache($confcache,$host)"

"déboguer"
"debug($type, $message)"

Imprime le message sur STDERR si le débogage est activé pour le type type. Un type de débogage est
activé si type est dans le tableau @main::DEBUG.

AUTEURS

Rainer BawidamannRainer.Bawidamann@rz.uni-ulm.de>

(Cette page de manuel)

Utilisez mrtglib en ligne en utilisant les services onworks.net