RFC: 4113
Оригинал: Management Information Base for the User Datagram Protocol (UDP)
Предыдущие версии: RFC 2013, RFC 2454
Категория: Предложенный стандарт
Дата публикации:
Авторы: ,
Перевод: Николай Малых

RFC 4113, Страница 4 из 5

...

udpEndpointLocalAddress OBJECT-TYPE
    SYNTAX     InetAddress
    MAX-ACCESS not-accessible
    STATUS     current
    DESCRIPTION
           "Локальный IP-адрес данной конечной точки UDP.

            Значение этого объекта может быть представлено тремя
            способами в зависимости от характеристик слушающего приложения:

            1. Для приложений, которые готовы принимать дейтаграммы IPv4
               и IPv6, значение этого объекта должно быть''h (строка
               октетов нулевой длины) со значением соответствующего
               экземпляра объекта udpEndpointLocalAddressType — unknown(0).

            2. Для приложений, готовых принимать дейтаграммы только
               одного типа (IPv4 или IPv6), значение этого объекта должно
               быть '0.0.0.0' или '::', соответственно, тогда как
               соответствующий экземпляр объекта udpEndpointLocalAddressType
               представляет подходящий тип адреса.

            3. Для приложений, которые слушают данные, направленные
               только в заданный адрес IP, значением этого объекта
               является этот IP-адрес, а соответствующий экземпляр
               udpEndpointLocalAddressType представляет подходящий
               тип адреса.

            Когда этот объект используется в индексе для udpEndpointTable,
            разработчикам следует быть аккуратными, чтобы не создать
            записей, которые будут приводить к появлению OID с числом
            субидентификаторов, превышающим 128, поскольку в таких
            случаях информация не будет доступна для протоколов SNMPv1,
            SNMPv2c, SNMPv3.
    ::= { udpEndpointEntry 2 }

udpEndpointLocalPort OBJECT-TYPE
    SYNTAX     InetPortNumber
    MAX-ACCESS not-accessible
    STATUS     current
    DESCRIPTION
           "Локальный номер порта для данной конечной точки UDP."
    ::= { udpEndpointEntry 3 }

udpEndpointRemoteAddressType OBJECT-TYPE
    SYNTAX     InetAddressType
    MAX-ACCESS not-accessible
    STATUS     current
    DESCRIPTION
           "Тип адреса udpEndpointRemoteAddress. Ожидаются только
            адреса типов IPv4, IPv4z, IPv6, Ipv6z или unknown(0),
            если принимаются дейтаграммы UDP от всех удаленных
            адресов IP. Отметим также, что комбинации
            udpEndpointLocalAdressType и udpEndpointRemoteAddressType
            не поддерживаются. В частности, если значение этого
            объекта отличается от unknown(0), предполагается, что он
            указывает на ту же версию IP, что и udpEndpointLocalAddressType."
    ::= { udpEndpointEntry 4 }

udpEndpointRemoteAddress OBJECT-TYPE
    SYNTAX     InetAddress
    MAX-ACCESS not-accessible
    STATUS     current
    DESCRIPTION
           "Удаленный адрес IP для данной конечной точки UDP. Если
            принимаются дейтаграммы от любой удаленной системы, это
            значение должно быть ''h (строка октетов нулевой длины).
            В остальных случаях это значение имеет тип, описанный для
            udpEndpointRemoteAddressType и является адресом удаленной
            точки, из которой принимаются дейтаграммы (или в которую
            они передаются).

            Когда этот объект используется в индексе для udpEndpointTable,
            разработчикам следует быть аккуратными, чтобы не создать
            записей, которые будут приводить к появлению OID с числом
            субидентификаторов, превышающим 128, поскольку в таких
            случаях информация не будет доступна для протоколов SNMPv1,
            SNMPv2c, SNMPv3."

    ::= { udpEndpointEntry 5 }

udpEndpointRemotePort OBJECT-TYPE
    SYNTAX     InetPortNumber
    MAX-ACCESS not-accessible
    STATUS     current
    DESCRIPTION
           "Номер удаленного порта UDP для данной конечной точки
            UDP. Если принимаются дейтаграммы от любой удаленной
            системы, это значение должно быть нулевым."
    ::= { udpEndpointEntry 6 }

udpEndpointInstance OBJECT-TYPE
    SYNTAX     Unsigned32 (1..'ffffffff'h)
    MAX-ACCESS not-accessible
    STATUS     current
    DESCRIPTION
           "Экземпляр Удаленной точки. Этот объект используется
            для того, чтобы различать множество процессов,
            «подключенных» к одной конечной точке UDP. Например,
            в системах, поддерживающих интерфейс сокетов BSD,
            этот объект может использоваться для поддержки опций
            сокетов SO_REUSEADDR и SO_REUSEPORT."
    ::= { udpEndpointEntry 7 }

udpEndpointProcess OBJECT-TYPE
    SYNTAX     Unsigned32
    MAX-ACCESS read-only
    STATUS     current
    DESCRIPTION
           "The system's process ID for the process associated with
            this endpoint, or zero if there is no such process.
            This value is expected to be the same as
            HOST-RESOURCES-MIB::hrSWRunIndex or SYSAPPL-MIB::
            sysApplElmtRunIndex for some row in the appropriate
            tables."
    ::= { udpEndpointEntry 8 }

-- Устаревшая таблица UDP Listener.

-- Эта таблица содержит только информацию конечных точках IPv4
-- данного объекта, на которых локальные приложения принимают
-- дейтаграммы. Более детальной информации или сведений о
-- конечных точках IPv6 таблица не содержала.

udpTable OBJECT-TYPE
    SYNTAX     SEQUENCE OF UdpEntry
    MAX-ACCESS not-accessible
    STATUS     deprecated
    DESCRIPTION
           "Таблица содержит информацию IPv4 о «слушателях» UDP.
            Эта информация включает все локальные конечные точки
            IPv4, на которых приложения принимают дейтаграммы.
            Эта таблица запрещена в пользу независимой от версии
            IP таблицы udpEndpointTable."
    ::= { udp 5 }

udpEntry OBJECT-TYPE
    SYNTAX     UdpEntry
    MAX-ACCESS not-accessible
    STATUS     deprecated
    DESCRIPTION
           "Информация об отдельном «слушателе» UDP."
    INDEX   { udpLocalAddress, udpLocalPort }
    ::= { udpTable 1 }

UdpEntry ::= SEQUENCE {
    udpLocalAddress   IpAddress,
    udpLocalPort      Integer32
}

udpLocalAddress OBJECT-TYPE
    SYNTAX     IpAddress
    MAX-ACCESS read-only
    STATUS     deprecated
    DESCRIPTION
           "Локальный IP-адрес «слушателя» UDP. В том случае,
            когда дейтаграммы UDP принимаются для всех IP-адресов
            данного узла, используется значение 0.0.0.0."
    ::= { udpEntry 1 }

udpLocalPort OBJECT-TYPE
    SYNTAX     Integer32 (0..65535)
    MAX-ACCESS read-only
    STATUS     deprecated
    DESCRIPTION
           "Локальный номер порта «слушателя» UDP."
    ::= { udpEntry 2 }

-- Информация о соответствии спецификациям.

udpMIBConformance OBJECT IDENTIFIER ::= { udpMIB 2 }
udpMIBCompliances OBJECT IDENTIFIER ::= { udpMIBConformance 1 }
udpMIBGroups      OBJECT IDENTIFIER ::= { udpMIBConformance 2 }

-- Заявления о соответствии.

udpMIBCompliance2 MODULE-COMPLIANCE
    STATUS     current
    DESCRIPTION
           "Заявление о соответствии для систем, реализующих
            протокол UDP.

            Существует множество объектов INDEX, которые не
            могут быть представлены в форме объектов (OBJECT)
            в SMIv2, но для которых имеются следующие требования
            соответствия, выраженные ниже в форме объектов:

            -- OBJECT      udpEndpointLocalAddressType
            -- SYNTAX      InetAddressType { unknown(0), ipv4(1),
            --                               ipv6(2), ipv4z(3),
            --                               ipv6z(4) }
            -- DESCRIPTION
            --     Поддержка dns(5) не требуется.
            -- OBJECT      udpEndpointLocalAddress
            -- SYNTAX      InetAddress (SIZE(0|4|8|16|20))
            -- DESCRIPTION
            --     Поддержка требуется только для строк октетов
            --     нулевой длины и наблюдаемых или ненаблюдаемых
            --     адресов IPv4 и IPv6
            -- OBJECT      udpEndpointRemoteAddressType
            -- SYNTAX      InetAddressType { unknown(0), ipv4(1),
            --                               ipv6(2), ipv4z(3),
            --                               ipv6z(4) }
            -- DESCRIPTION
            --     Поддержка dns(5) не требуется.
            -- OBJECT      udpEndpointRemoteAddress
            -- SYNTAX      InetAddress (SIZE(0|4|8|16|20))
            -- DESCRIPTION
            --     Поддержка требуется только для строк октетов
            --     нулевой длины и наблюдаемых или ненаблюдаемых
            --     адресов IPv4 и IPv6
           "
    MODULE  -- this module
         MANDATORY-GROUPS { udpBaseGroup, udpEndpointGroup }
         GROUP       udpHCGroup
         DESCRIPTION
                "Эта группа является обязательной для систем, оторые
                 способны принимать или передавать более 1 миллиона
                 дейтаграмм в секунду. Скорость 1 миллион дейтаграмм
                 в секунду будет приводить к переполнению счетчиков
                 Counter32 в течение времени чуть больше 1 часа."
    ::= { udpMIBCompliances 2 }

udpMIBCompliance MODULE-COMPLIANCE
    STATUS     deprecated
    DESCRIPTION
           "Это заявление о соответствии для систем, поддерживающих
            только IPv4 и реализующих UDP. В целях обеспечения
            независимости от версии протокола IP это заявление о
            совместимости отклонено в пользу независимого от версии
            udpMIBCompliance2. Однако агенты по-прежнему поддерживают
            это заявление для обеспечения совместимости с
            установленными программами сетевого управления."
    MODULE  -- this module
        MANDATORY-GROUPS { udpGroup }
    ::= { udpMIBCompliances 1 }

-- Элементы соответствия

udpGroup OBJECT-GROUP
    OBJECTS   { udpInDatagrams, udpNoPorts,
                udpInErrors, udpOutDatagrams,
                udpLocalAddress, udpLocalPort }
    STATUS     deprecated
    DESCRIPTION
           "Устаревшая группа объектов, обеспечивавшая
            управление UDP по протоколу IPv4."
    ::= { udpMIBGroups 1 }

udpBaseGroup OBJECT-GROUP
    OBJECTS   { udpInDatagrams, udpNoPorts, udpInErrors,
                udpOutDatagrams }
    STATUS     current
    DESCRIPTION
           "Группа объектов, обеспечивающая счетчики статистики
            UDP."
    ::= { udpMIBGroups 2 }

udpHCGroup OBJECT-GROUP
    OBJECTS   { udpHCInDatagrams, udpHCOutDatagrams }
    STATUS     current
    DESCRIPTION
           "Группа объектов, обеспечивающая счетчики для
            высокоскоростных реализаций UDP."
    ::= { udpMIBGroups 3 }

udpEndpointGroup OBJECT-GROUP
    OBJECTS    { udpEndpointProcess }
    STATUS     current
    DESCRIPTION
           "Группа объектов, обеспечивающая независимое от
            версии IP управление конечными точками UDP."
    ::= { udpMIBGroups 4 }

END
2007 - 2017 © Русские переводы RFC, IETF, ISOC.