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

    Примеры

    свернуть все

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

    Открыть Live Script

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

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

    Запись глобального заголовка в файл PCAP.

    writeGlobalHeader(pcapObj,bleLinkType);

    Укажите пакет BLE ссылки слоя (LL).

    llpacket = '42BC13E206120E00050014010A001F0040001700170000007D47C0';

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

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

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

    Открыть Live Script

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

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

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

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

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

    llpacket = '42BC13E206120E00050014010A001F0040001700170000007D47C0';

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

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

    Входные параметры

    свернуть все

    Примечание

    The 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, M. «PCAP Next Generation (Pcapng) Capture File Format». 2020. https://www.ietf.org/.

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

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

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

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

    .

    См. также

    Функции

    Объекты

    Введенный в R2020b

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

    Поддержка

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