pcapWriter

R2026b

プロトコル パケットの PCAP ファイル ライター

説明

pcapWriter オブジェクトは、生成および復元されたプロトコル パケットをパケット キャプチャ (PCAP) ファイル (.pcap) に書き込みます。

作成

構文

pcapObj = pcapWriter

pcapObj = pcapWriter(PropertyName=Value)

説明

pcapObj = pcapWriter は既定の PCAP ファイル ライター オブジェクトを作成します。

pcapObj = pcapWriter(PropertyName=Value) は、1 つ以上の名前と値の引数を使用してプロパティを設定します。各プロパティ名を引用符で囲みます。たとえば、ByteOrder="big-endian" はバイト順をビッグエンディアンとして指定します。

プロパティ

メモ

pcapWriter オブジェクトは既存の PCAP または PCAPNG ファイルを上書きしません。このオブジェクトを作成するたびに、一意の PCAP ファイル名または PCAPNG ファイル名を指定します。

FileName — PCAP ファイルの名前

'capture' (既定値) | 文字行ベクトル | string スカラー

このプロパティは、オブジェクト作成後、読み取り専用になります。

PCAP ファイルの名前。文字行ベクトルまたは string スカラーとして指定します。

データ型: char | string

ByteOrder — バイト順

'little-endian' (既定値) | 'big-endian'

このプロパティは、オブジェクト作成後、読み取り専用になります。

バイト順。'little-endian' または 'big-endian' として指定します。

データ型: char | string

PipeName — FIFO パイプ ファイルの名前

'' (既定値) | 文字ベクトル | string スカラー

R2026a 以降

このプロパティは、オブジェクト作成後、読み取り専用になります。

先入れ先出し (FIFO) パイプ (名前付きパイプとも呼ばれる) ファイルの名前。文字行ベクトルまたは string スカラーとして指定します。この値は、MATLAB の外部で作成したパイプへの絶対パスまたは相対パスです。

依存関係

このプロパティを有効にするには、FileName を指定しないでください。

データ型: char | string

オブジェクト関数

このオブジェクトに固有

write	Write protocol packet data to PCAP or PCAPNG file
writeGlobalHeader	Write global header to PCAP file

例

PCAP ファイルへの 5G NR パケットの書き込み

PCAP ファイルの名前を指定し、PCAP ファイル ライター オブジェクトを作成します。5G NR パケットには有効なリンク タイプがありません。有効なリンク タイプが存在しない場合は、Tcpdump に従って SLL パケットのリンク タイプを指定します。

pcapObj = pcapWriter('FileName','sample');
linkType = 113;                                         % Link type of SLL packet
timestamp = 300;                                        % Timestamp

グローバル ヘッダーを PCAP ファイルに書き込みます。

writeGlobalHeader(pcapObj,linkType);

5G New Radio (NR) パケットは、Wireshark で直接サポートされていません。Wireshark が 5G NR パケットを解析できるようにするには、カプセル化とメタデータを 5G NR パケットに追加します。

payload = [59; 205];                                    % MAC subPDU (contains truncated buffer status report (BSR) control element)
radioType = 1;                                          % Frequency division duplexing
linkDir = 0;                                            % Uplink packet
rntiType = 3;                                           % Cell-RNTI
startString = [109; 97; 99; 45; 110; 114];              % Tag to indicate the start of NR MAC signature
payloadTag = 1;                                         % Payload tag for NR packets
signature = [startString; radioType; linkDir; rntiType];
macNRInfoPacket = [signature; payloadTag; payload];

ユーザー データグラム プロトコル (UDP) ヘッダーを構築します。

udpPacketLength = 8 + length(macNRInfoPacket);          % Length of header (8 bytes) and payload
udpHeader = [163; 76;                                   % Source port number
    39; 15;                                             % Destination port number
    fix(udpPacketLength/256); mod(udpPacketLength,256); % Total length of UDP packet
    0; 0];                                              % Checksum

IPv4 ヘッダーを構築します。

ipPacketLength = 20 + udpPacketLength;                  % Length of header (20 bytes) and payload
ipHeader = [69;                                         % Version of IP protocol and priority or traffic Class
    0;                                                  % Type of service
    fix(ipPacketLength/256); mod(ipPacketLength,256);   % Total length of the IPv4 packet
    0; 1;                                               % Identification
    0; 0;                                               % Flags and fragmentation offset
    64;                                                 % Time to live in seconds
    17;                                                 % UDP protocol number
    0; 0;                                               % Header checksum
    127; 0; 0; 1;                                       % Source IP address
    127; 0; 0; 1];                                      % Destination IP address

SLL ヘッダーを構築します。

sllHeader = [0; 0;                                      % Packet type
    3; 4;                                               % Address resolution protocol hardware (ARPHRD) type
    0; 0;                                               % Link layer address length
    0; 0; 0; 0; 0; 0; 0; 0;                             % Link layer address
    8; 0];                                              % Protocol type

カプセル化とメタデータを追加して、5G NR パケットを構築します。

packet = [sllHeader; ipHeader; udpHeader; macNRInfoPacket];

5G NR パケットを PCAP ファイルに書き込みます。

write(pcapObj,packet,timestamp);

参照

[1] Group, The Tcpdump. “Tcpdump/Libpcap Public Repository.” Accessed May 20, 2020. https://www.tcpdump.org.

[2] “Development/LibpcapFileFormat - The Wireshark Wiki.” Accessed May 20, 2020. https://www.wireshark.org.

拡張機能

C/C++ コード生成
MATLAB® Coder™ を使用して C および C++ コードを生成します。

GPU コード生成
GPU Coder™ を使用して NVIDIA® GPU のための CUDA® コードを生成します。

バージョン履歴

R2020b で導入

R2026a: pcapWriter にパイプ インターフェイスのサポートを追加

pcapWriter オブジェクトにおいて、PipeName プロパティを使用して FIFO パイプ ファイルを指定できるようになりました。

参考

オブジェクト

• pcapngWriter | nrPCAPWriter | pcapReader