Exponenta Banner
exponenta event banner

написать

Запись пакетных данных протокола в файл PCAP или PCAPNG

свернуть все на странице

    Синтаксис

    запись (pcapObj, пакет, метка времени)
    запись (pcapNgObj, пакет, метка времени, идентификатор интерфейса)
    запись (___, имя, значение)

    Описание

    write(pcapObj,packet,timestamp) записывает пакетные данные протокола в файл PCAP, указанный в объекте записи файла PCAP, pcapObj. Вход packet определяет пакет протокола и входные данные timestamp определяет время поступления пакета.

    write(pcapngObj,packet,timestamp,interfaceID) записывает пакетные данные протокола в файл PCAPNG, указанный в объекте записи файла PCAPNG, pcapngObj. Вход packet, timestamp, и interfaceID определяет пакет протокола, время поступления пакета и идентификатор интерфейса соответственно.

    пример

    write(___,Name,Value) указывает параметры, использующие один или несколько аргументов пары имя-значение в дополнение к комбинациям входных аргументов из любого из предыдущих синтаксисов. Например, 'PacketFormat','bits' устанавливает формат пакетов протокола в биты.

    Примеры

    свернуть все

    В этом примере используются:

    Открыть сценарий в реальном времени

    Создайте объект записи файла PCAP, указав имя файла PCAP. Укажите тип канала Bluetooth с низкой энергией (BLE).

    pcapObj = pcapWriter('FileName','writeBLEpacket');
bleLinkType = 251;

    Запишите глобальный заголовок в файл PCAP.

    writeGlobalHeader(pcapObj,bleLinkType);

    Укажите пакет канального уровня (LL) BLE.

    llpacket = '42BC13E206120E00050014010A001F0040001700170000007D47C0';

    Запишите пакет LL BLE в файл PCAP.

    timestamp = 129100; % Number of microseconds
write(pcapObj,llpacket,timestamp);

    В этом примере используются:

    Открыть сценарий в реальном времени

    Создайте объект модуля записи файлов PCAPNG, указав имя файла PCAPNG.

    pcapngObj = pcapngWriter('FileName','writeBLEpacket');

    Запишите блок описания интерфейса для BLE.

    interfaceName = 'BLE interface';
bleLinkType = 251;
interfaceId = writeInterfaceDescriptionBlock(pcapngObj,bleLinkType, ...
    interfaceName);

    Укажите пакет LL BLE.

    llpacket = '42BC13E206120E00050014010A001F0040001700170000007D47C0';

    Запишите пакет LL BLE в файл формата PCAPNG.

    timestamp = 0; % Number of microseconds
packetComment = 'This is BLE packet';
write(pcapngObj, llpacket,timestamp,interfaceId,'PacketComment', ...
    packetComment);

    Входные аргументы

    свернуть все

    Примечание

    pcapWriter и pcapngWriter объекты не перезаписывают существующие файлы PCAP или PCAPNG соответственно. При каждом вызове этих объектов укажите уникальное имя файла PCAP или PCAPNG.

    Объект записи файла PCAP, указанный как pcapWriter объект.

    Пакет протокола, указанный как одно из этих значений.

    • Вектор с двоичным значением - это значение представляет биты.

    • Символьный вектор - это значение представляет октеты в шестнадцатеричном формате.

    • Скаляр строки - это значение представляет октеты в шестнадцатеричном формате.

    • Числовой вектор с каждым элементом в диапазоне [0, 255] - это значение представляет октеты в десятичном формате.

    • символьный массив n-by-2 - в этом значении каждая строка представляет октет в шестнадцатеричном формате.

    Типы данных: char | string | double

    Время поступления пакета с 1/1/1970, указанное как неотрицательное целое число. Это значение должно быть выражено в микросекундах.

    Типы данных: double

    Объект записи файла PCAPNG, указанный как pcapngWriter объект.

    Уникальный идентификатор интерфейса, указанный как неотрицательный скаляр.

    Типы данных: double

    Аргументы пары «имя-значение»

    Укажите дополнительные пары, разделенные запятыми Name,Value аргументы. Name является именем аргумента и Value - соответствующее значение. Name должен отображаться внутри кавычек. Можно указать несколько аргументов пары имен и значений в любом порядке как Name1,Value1,...,NameN,ValueN.

    Пример: 'PacketFormat','bits' устанавливает формат пакетов протокола в биты.

    Формат пакета протокола, определяемый как разделенная запятыми пара, состоящая из PacketFormat и 'octets' или 'bits'. Если это значение указано как 'octets', packet указывается как одно из этих значений.

    • Вектор с двоичным значением - это значение представляет биты.

    • Символьный вектор - это значение представляет октеты в шестнадцатеричном формате.

    • Скаляр строки - это значение представляет октеты в шестнадцатеричном формате.

    • Числовой вектор с каждым элементом в диапазоне [0, 255] - это значение представляет октеты в десятичном формате.

    • символьный массив n-by-2 - в этом значении каждая строка представляет октет в шестнадцатеричном формате.

    Типы данных: char | string | double

    Комментарий для пакета протокола, указанного как разделенная запятыми пара, состоящая из PacketComment и вектор символов или строковый скаляр.

    Зависимости

    Чтобы включить этот аргумент пары имя-значение, укажите pcapngObj входной аргумент.

    Типы данных: char | string

    Ссылки

    [1] Tuexen, М. «Формат файла захвата PCAP следующего поколения (Pcapng)». 2020. https://www.ietf.org/.

    [2] Группа, Tcpdump. «Общий репозиторий Tcpdump/Libpcap». Доступно 20 мая 2020 года. https://www.tcpdump.org.

    [3] «Разработка/LibpcapFileFormat - Wiki Wiki Wireshark». Доступно 20 мая 2020 года. https://www.wireshark.org/.

    Расширенные возможности

    Создание кода C/C + +
    Создайте код C и C++ с помощью MATLAB ® Coder™

    .

    См. также

    Функции

    Объекты

    Представлен в R2020b

    Документация по инструментам связи

    Поддержка