Sobre o Gerenciamento de Roteador com MIB
As APIs da Base de Informações de Gerenciamento (MIB) para o gerenciamento de roteador possibilitam consultar e definir os valores das variáveis MIB exportadas por um dos gerentes de roteador ou qualquer um dos protocolos de roteamento que os gerentes de roteador servicem. Usando essa API, o roteador dá suporte ao SNMP (Simple Network Management Protocol).
Na estrutura SNMP, cada um dos objetos gerenciáveis no roteador é representado por uma variável que tem um OID (Identificador de Objeto) exclusivo. Correspondente a cada OID é um valor que representa o estado atual do objeto. A coleção de OIDs e valores é conhecida como uma MIB (Base de Informações de Gerenciamento). As chamadas mprAdminMib permitem que um desenvolvedor especifique um objeto por sua OID e consulta ou gravação ("Set") do valor do objeto.
Para consultar e definir variáveis MIB, o módulo que atende às chamadas deve definir um conjunto de estruturas de dados. Essas estruturas de dados incluem estruturas a serem usadas como Identificadores de Objeto e estruturas que contêm os valores das variáveis MIB que estão sendo acessadas. Essas estruturas de dados são opacas para todos, exceto o chamador da função MIB e o módulo que atende a chamada.
O módulo que atende a chamada MIB é um gerenciador de roteador ou um dos protocolos de roteamento. O chamador deve especificar um gerenciador de roteador, mesmo que a chamada seja tratada por um dos protocolos de roteamento. Nesse caso, o chamador deve especificar o gerenciador de roteador que corresponde à família de protocolos para esse protocolo de roteamento. Por exemplo, se o protocolo de roteamento OSPF (Open Shortest Path First) estivesse tratando a chamada MIB, o chamador precisaria especificar o Gerenciador de Roteador de IP, já que o OSPF pertence à família de protocolos IP. Em cada uma das funções MIB, o parâmetro dwTransportId especifica um gerenciador de roteador e o parâmetro RoutingPid especifica o protocolo de roteamento. O gerenciador de roteador também tem um RoutingPid exclusivo, pois algumas das variáveis MIB podem ser manipuladas pelo próprio gerenciador de roteador.
As funções MprAdminMib podem ser chamadas em um computador diferente do que está sendo administrado. As funções MprAdminMIB que consultam ou gravam valores, assumem como parâmetro um identificador para o computador a ser administrado. Use a função MprAdminMIBServerConnect para estabelecer a conexão com o computador remoto e obter esse identificador. Depois de chamar as funções MprAdminMIB necessárias para realizar uma tarefa administrativa específica, chame a função MprAdminMIBServerDisconnect para encerrar a conexão com o computador remoto.
As funções MprAdminMIBEntryCreate e MprAdminMIBEntrySet assumem como parâmetros um OID e um buffer que contém o novo valor para o objeto.
As funções MprAdminMIBEntryGet, MprAdminMIBEntryGetFirst e MprAdminMIBEntryGetNext assumem como parâmetros um OID e o endereço de uma variável de ponteiro. No retorno bem-sucedido, a variável de ponteiro aponta para um buffer que contém o valor do objeto . O chamador deve liberar a memória para esse buffer chamando a função MprAdminMIBBufferFree .
As funções MprAdminMIBEntryGetFirst e MprAdminMIBEntryGetNext permitem que um desenvolvedor execute uma caminhada SNMP. Como os OIDs são ordenados, cada OID e, portanto, cada objeto gerenciável tem uma próxima OID. Uma caminhada SNMP refere-se a percorrer uma parte do MIB lendo ou escrevendo uma sequência de OIDs.
Todas as chamadas mprAdminMib passam pelo DIM (Dynamic Interface Manager). Dependendo do OID, DIM passa a chamada para um dos gerentes do roteador. (Ip e IPX dão suporte a SNMP). Novamente, dependendo do OID, o gerenciador de roteador pode lidar com a chamada em si ou passar a chamada para um de seus clientes. Todos os clientes do roteador são necessários para implementar e exportar as seguintes funções que correspondem às funções MprAdminMIB de forma semelhante: