write

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

    Описание

    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';

    Запишите пакет BLE LL в файл 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);

    Задайте пакет BLE LL.

    llpacket = '42BC13E206120E00050014010A001F0040001700170000007D47C0';

    Запишите пакет BLE LL в файл формата 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

    Пакетное время поступления в POSIX® микросекунды протекли с 1/1/1970 в виде неотрицательного целого числа.

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

    Средство записи файла PCAPNG возражает в виде pcapngWriter объект.

    Уникальный идентификатор для интерфейса в виде неотрицательного скаляра.

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

    Аргументы name-value

    Задайте дополнительные разделенные запятой пары 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, M. “Следующее поколение PCAP (Pcapng) Формат файла Получения”. 2020. https://www.ietf.org/.

    [2] Группа, Tcpdump. “Репозиторий Общественности Tcpdump/Libpcap”. Полученный доступ 20 мая 2020. https://www.tcpdump.org.

    [3] “Development/LibpcapFileFormat - Wiki Wireshark”. Полученный доступ 20 мая 2020. https://www.wireshark.org.

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

    Генерация кода C/C++
    Генерация кода C и C++ с помощью MATLAB® Coder™.

    Смотрите также

    Функции

    Объекты

    Введенный в R2020b
    Для просмотра документации необходимо авторизоваться на сайте