La classe SNMP SNMP
&reftitle.intro; Représente une session SNMP.
&reftitle.classsynopsis; SNMP SNMP &Properties; public readonly array info public intnull max_oids public int valueretrieval public bool quick_print public bool enum_print public int oid_output_format public bool oid_increasing_check public int exceptions_enabled &Methods; &Constants; const int SNMP::ERRNO_NOERROR 0 const int SNMP::ERRNO_GENERIC 2 const int SNMP::ERRNO_TIMEOUT 4 const int SNMP::ERRNO_ERROR_IN_REPLY 8 const int SNMP::ERRNO_OID_NOT_INCREASING 16 const int SNMP::ERRNO_OID_PARSING_ERROR 32 const int SNMP::ERRNO_MULTIPLE_SET_QUERIES 64 const int SNMP::ERRNO_ANY 126 const int SNMP::VERSION_1 0 const int SNMP::VERSION_2C 1 const int SNMP::VERSION_2c 1 const int SNMP::VERSION_3 3
&reftitle.properties; max_oids Nombre maximal de OID par demande GET/SET/GETBULK valueretrieval Contrôle la façon dont les valeurs SNMP seront retournées <tgroup cols="2"> <tbody> <row> <entry><constant>SNMP_VALUE_LIBRARY</constant></entry> <entry> Les valeurs retournées le seront de la même façon que par la bibliothèque Net-SNMP. </entry> </row> <row> <entry><constant>SNMP_VALUE_PLAIN</constant></entry> <entry> Les valeurs retournées le seront en valeur pleine, sans l'information de type SNMP. </entry> </row> <row> <entry><constant>SNMP_VALUE_OBJECT</constant></entry> <entry> Les valeurs retournées le seront sous forme d'objets avec les propriétés "value" et "type", où le type pourra être une constante SNMP_OCTET_STR, SNMP_COUNTER etc... La façon dont la "value" est retournée est basée suivant la constante définie : <constant>SNMP_VALUE_LIBRARY</constant> ou <constant>SNMP_VALUE_PLAIN</constant>. </entry> </row> </tbody> </tgroup> </table> </listitem> </varlistentry> <varlistentry xml:id="snmp.props.quick-print"> <term><varname>quick_print</varname></term> <listitem> <para>Valeur du paramètre <parameter>quick_print</parameter> dans la bibliothèque NET-<acronym>SNMP</acronym></para> <para> Définit la valeur du paramètre <parameter>quick_print</parameter> dans la bibliothèque NET-<acronym>SNMP</acronym>. Lorsqu'il est défini (1), la bibliothèque <acronym>SNMP</acronym> retournera des valeurs rapidement imprimables. Cela signifie uniquement que les valeurs seront imprimées. Lorsque le paramètre <parameter>quick_print</parameter> n'est pas défini (par défaut), la bibliothèque NET-<acronym>SNMP</acronym> imprimera des informations additionnelles incluant le type de la valeur (i.e. IpAddress ou OID). De plus, si quick_print n'est pas activé, la bibliothèque imprimera les valeurs hexadécimales pour toutes les chaînes contenant jusqu'à 3 caractères. </para> </listitem> </varlistentry> <varlistentry xml:id="snmp.props.enum-print"> <term><varname>enum_print</varname></term> <listitem> <para> Contrôle la façon dont les valeurs enum sont imprimées. </para> <para> Permet d'indiquer à walk/get etc. s'ils doivent automatiquement chercher les valeurs enum dans le MIIB et les retourner en plus de leurs chaînes humainement lisibles. </para> </listitem> </varlistentry> <varlistentry xml:id="snmp.props.oid-output-format"> <term><varname>oid_output_format</varname></term> <listitem> <para>Contrôle le format de sortie OID</para> <table> <title>Représentation OID .1.3.6.1.2.1.1.3.0 pour diverses valeurs de <varname>oid_output_format</varname> SNMP_OID_OUTPUT_FULLLa forme complète, comme "iso.org.dod...."SNMP_OID_OUTPUT_NUMERICLa forme numérique, comme ".1.3.6.1.4.1.8072.3.2.10" SNMP_OID_OUTPUT_MODULELa forme courte, comme "NET-SNMP-TC::linux"SNMP_OID_OUTPUT_SUFFIXTBDSNMP_OID_OUTPUT_UCDTBDSNMP_OID_OUTPUT_NONETBD
 oid_increasing_check Contrôle la vérification de la désactivation pour l'augmentation de l'OID lors du parcours de l'arbre OID Quelques agents SNMP sont connus pour retourner des OIDs dans la mauvais ordre, mais peuvent malgré tout continuer le parcours. D'autres agents retournent des OIDs dans la mauvais ordre et peuvent conduire la méthode SNMP::walk dans une boucle infinie tant que la limite de mémoire n'est pas atteinte. La bibliothèque PHP SNMP, par défaut, effectue la vérification de l'augmentation de l'OID et stoppe le parcours sur l'arbre OID lorsqu'elle détecte une possible boucle en émettant une alerte. Définissez la variable oid_increasing_check à &false; pour désactiver cette vérification. exceptions_enabled Contrôle quelle exception SNMPException sera émise au lieu des alertes. Utiliser l'opérateur OR des constantes SNMP::ERRNO_*. Par défaut, toutes les exceptions SNMP sont désactivées. info Propriété en lecture seul contenant la configuration de l'agent distant : nom d'hôte, port, délai d'expiration par défaut, nombre de récupération par défaut
&reftitle.constants;
Types d'erreurs <acronym>SNMP</acronym> SNMP::ERRNO_NOERROR Aucune erreur spécifique SNMP n'est survenue. SNMP::ERRNO_GENERIC Une erreur SNMP générique est survenue. SNMP::ERRNO_TIMEOUT Demande à l'agent SNMP d'atteindre le délai d'expiration. SNMP::ERRNO_ERROR_IN_REPLY L'agent SNMP retourne une erreur dans la réponse. SNMP::ERRNO_OID_NOT_INCREASING L'agent SNMP n'incrémente plus l'OID lors de l'exécution de la commande WALK (BULK). Ceci indique qu'un problème survient avec l'agent SNMP. SNMP::ERRNO_OID_PARSING_ERROR La bibliothèque échoue lors de l'analyse de l'OID (et/ou le type pour la commande SET). Aucune requête n'est effectuée. SNMP::ERRNO_MULTIPLE_SET_QUERIES La bibliothèque utilisera plusieurs requêtes pour l'opération SET demandée. Cela signifie que l'opération sera effectuée de façon non transactionnelle et que les morceaux suivants pourront échouer si un mauvais type ou une mauvaise valeur est fourni. SNMP::ERRNO_ANY Tous les codes opérateur OR des constantes SNMP::ERRNO_*.
Versions du protocole <acronym>SNMP</acronym> SNMP::VERSION_1 SNMP::VERSION_2C, SNMP::VERSION_2c SNMP::VERSION_3
&reference.snmp.entities.snmp;