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 по умолчанию. Задайте тип ссылки для пакета WLAN.

    pcapObj = pcapWriter;
wlanLinkType = 105;

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

    writeGlobalHeader(pcapObj,wlanLinkType);

    Сгенерируйте пакет WLAN в битах.

    macConfig = wlanMACFrameConfig;
[mpdu,frameLength] = wlanMACFrame(macConfig,'OutputFormat','bits');

    Запишите пакет WLAN в файл PCAP, задав формат пакета как биты.

    timestamp = 124800; % Number of microseconds
write(pcapObj,mpdu,timestamp,'PacketFormat','bits');
    Скрипт Open Live Script

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

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

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

    interfaceName = 'WLAN';
wlanLinkType = 105;
interfaceId = writeInterfaceDescriptionBlock(pcapngObj,wlanLinkType, ...
    interfaceName);

    Сгенерируйте пакет WLAN в битах.

    macConfig = wlanMACFrameConfig;
[mpdu,frameLength] = wlanMACFrame(macConfig,'OutputFormat','bits');

    Запишите пакет WLAN в файл PCAPNG, задав пакетный комментарий и формат пакета.

    timestamp = 0; % Number of microseconds
packetComment = 'This is the first packet';
write(pcapngObj,mpdu,timestamp,interfaceId,'PacketComment', ...
    packetComment,'PacketFormat','bits');

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

    свернуть все

    Примечание

    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 (Pcapng) Формат файла Получения”. 2020. https://www.ietf.org/.

    [2] “Radiotap - Введение”. Полученный доступ 20 мая 2020. https://www.radiotap.org/.

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

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

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

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

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

    Функции

    Объекты

    Введенный в R2020b

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

    Поддержка

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