write

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

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

    Синтаксис

    write(pcapObj,packet,timestamp)
    write(pcapngObj,packet,timestamp,interfaceID)
    write(___,Name,Value)

    Описание

    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' устанавливает формат пакетов протокола вдребезги.

    Примеры

    свернуть все

    Этот пример использует:

    Скрипт Open Live Script

    Создайте объект средства записи файла 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);

    Этот пример использует:

    Скрипт Open Live Script

    Создайте объект средства записи файла 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

    Документация Communications Toolbox

    Поддержка

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