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

pcapReader

Средство чтения файлов PCAP пакетов протокола

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

Описание

pcapReader возразите читает и декодирует Ethernet и пакеты протокола расширенного общего общедоступного радио-интерфейса (eCPRI) на основе определенных критериев. Можно также включить пользовательские декодеры протокола.

Создание

Синтаксис

pcap = pcapReader(filename)

pcap = pcapReader(filename,OutputTimestampFormat='seconds')

Описание

pcap = pcapReader(filename) создает объект средства чтения файлов PCAP считать пакеты протокола из файла входа PCAP.

pcap = pcapReader(filename,OutputTimestampFormat='seconds') свойство OutputTimestampFormat наборов к seconds.

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

развернуть все

`filename` — Имя файла PCAP
вектор символов | строковый скаляр

Имя файла PCAP включая расширение в виде вектора символов или строкового скаляра.

Пример: "ethernetSamplePackets.pcap"

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

Свойства

развернуть все

`OutputTimestampFormat` — Выходной формат для пакетной метки времени
`'microseconds'` (значение по умолчанию) | `'seconds'` | `'datetime'`

Выходной формат для пакета устанавливает метку времени в виде 'microseconds'секунды, или 'datetime'. Это значение задает метку времени декодируемого пакета протокола.

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

`MajorVersion` — Основная версия формата файла PCAP
неотрицательный скаляр

Это свойство доступно только для чтения.

Основная версия формата файла PCAP, возвращенного как неотрицательный скаляр.

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

`MinorVersion` — Вспомогательная версия формата файла PCAP
неотрицательный скаляр

Это свойство доступно только для чтения.

Вспомогательная версия формата файла PCAP, возвращенного как неотрицательный скаляр.

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

`SnapLength` — Максимальная длина пакета в файле PCAP
неотрицательный скаляр

Это свойство доступно только для чтения.

Максимальная длина пакета в файле PCAP, возвращенном как неотрицательный скаляр.

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

`LinkType` — Соедините тип в глобальном заголовке PCAP
неотрицательный скаляр

Это свойство доступно только для чтения.

Соедините тип в глобальном заголовке PCAP, возвращенном как неотрицательный скаляр. Для получения дополнительной информации об этом свойстве, см. Общедоступный Репозиторий Tcpdump/Libpcap [1].

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

`LinkName` — Имя типа ссылки дано объектом средства чтения файлов PCAP
вектор символов | строковый скаляр

Это свойство доступно только для чтения.

Имя типа ссылки дано объектом средства чтения файлов PCAP, возвращенным как вектор символов или строковый скаляр.

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

`NanoSecResolution` — Отметьте, чтобы указать, имеет ли файл PCAP разрешение наносекунды для пакетной метки времени
1 или `true`| 0 или `false`

Это свойство доступно только для чтения.

Отметьте, чтобы указать, имеет ли файл PCAP разрешение наносекунды для пакетной метки времени, возвращенной как 1 TRUE) или 0 ложь).

Типы данных: логический

Функции объекта

развернуть все

Характерный для этого объекта

`addLinkTypeDecoder`	Добавьте декодер протокола слоя настраиваемой ссылки в средство чтения файлов PCAP
`addUpperLayerDecoder`	Добавьте пользовательский декодер протокола верхнего уровня в средство чтения файлов PCAP
`read`	Считайте следующий пакет протокола из файла PCAP
`readAll`	Считайте все пакеты протокола от текущего положения до конца файла PCAP
`reset`	Сбросьте положение средства чтения файлов PCAP к первому пакету протокола файла PCAP

Примеры

свернуть все

Считайте пакеты Ethernet из файла PCAP

Скрипт Open Live Script

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

pcapReaderObj = pcapReader('ethernetSamplePackets.pcap');

Считайте все пакеты от файла PCAP до рабочей области MATLAB®.

decodedPackets = readAll(pcapReaderObj)

decodedPackets=1×35 struct array with fields:
    SNo
    Timestamp
    LinkType
    Protocol
    PacketLength
    Packet
    RawBytes

Считайте пакеты Ethernet в потоковом режиме из файла PCAP

Скрипт Open Live Script

Создайте объект средства чтения файлов PCAP, задав имя файла PCAP и выходного формата для пакетной метки времени.

pcapReaderObj = pcapReader('ethernetSamplePackets.pcap', ...
    OutputTimestampFormat='datetime');

Создайте фильтр для исходного адреса Ethernet и типа Ethernet.

filterString = ['eth.SourceAddress == 44FB5A9710AC && ' ...
    'eth.Type == 2048'];

В потоковом режиме считайте пакеты Ethernet, которые совпадают с заданным фильтром к рабочему пространству MATLAB.

for packetCount = 1:3
    ethPacket = read(pcapReaderObj,filterString)
end

ethPacket = struct with fields:
             SNo: 1
       Timestamp: 08-Feb-2021 03:27:18.043900
        LinkType: 1
        Protocol: 'eth'
    PacketLength: 171
          Packet: [1x1 struct]
        RawBytes: [1x0 double]
    TimestampSec: 1.6128e+09

ethPacket = struct with fields:
             SNo: 4
       Timestamp: 08-Feb-2021 03:27:19.098190
        LinkType: 1
        Protocol: 'eth'
    PacketLength: 120
          Packet: [1x1 struct]
        RawBytes: [1x0 double]
    TimestampSec: 1.6128e+09

ethPacket = struct with fields:
             SNo: 5
       Timestamp: 08-Feb-2021 03:27:20.145857
        LinkType: 1
        Protocol: 'eth'
    PacketLength: 171
          Packet: [1x1 struct]
        RawBytes: [1x0 double]
    TimestampSec: 1.6128e+09

Считайте eCPRI Пакеты из Файла PCAP

Скрипт Open Live Script

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

pcapReaderObj = pcapReader('ethernetSamplePackets.pcap');

Создайте фильтр для eCPRI пакетов, задав eCPRI типы сообщений.

filterString = ['ecpri.MessageType == IQData || ecpri.MessageType == BitSequence ' ...
    '|| ecpri.MessageType == RemoteReset'];

Считайте eCPRI пакеты, которые совпадают с заданными фильтрами к рабочему пространству MATLAB.

ecpriFilteredFirstPacket = read(pcapReaderObj,filterString)

ecpriFilteredFirstPacket = struct with fields:
             SNo: 21
       Timestamp: 1.6128e+15
        LinkType: 1
        Protocol: 'eth'
    PacketLength: 64
          Packet: [1x1 struct]
        RawBytes: [1x0 double]

ecpriFilteredSecondPacket = read(pcapReaderObj,filterString)

ecpriFilteredSecondPacket = struct with fields:
             SNo: 22
       Timestamp: 1.6128e+15
        LinkType: 1
        Protocol: 'eth'
    PacketLength: 64
          Packet: [1x1 struct]
        RawBytes: [1x0 double]

ecpriFilteredRemainingPackets = readAll(pcapReaderObj,filterString)

ecpriFilteredRemainingPackets=1×5 struct array with fields:
    SNo
    Timestamp
    LinkType
    Protocol
    PacketLength
    Packet
    RawBytes

Сбросьте положение средства чтения файлов PCAP к первому пакету файла PCAP.

reset(pcapReaderObj);

Создайте новый фильтр на том же файле PCAP, задав тип сообщения как синфазный и квадратура (IQ) данные.

filterString = 'ecpri.MessageType == IQData';

Считайте eCPRI пакеты, которые совпадают с заданным фильтром к рабочему пространству MATLAB.

ecpriFilteredPackets = readAll(pcapReaderObj,filterString)

ecpriFilteredPackets = struct with fields:
             SNo: 21
       Timestamp: 1.6128e+15
        LinkType: 1
        Protocol: 'eth'
    PacketLength: 64
          Packet: [1x1 struct]
        RawBytes: [1x0 double]

Ссылки

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

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

[3] “Общий Общедоступный Радио-Интерфейс: Спецификация V1.2 Интерфейса eCPRI” Получила доступ 22 июня 2021.

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

Объекты

pcapWriter | pcapngWriter | nrPCAPWriter

Введенный в R2021b

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

Поддержка