pcapngWriter

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

説明

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

作成

構文

pcapngObj = pcapngWriter

pcapngObj = pcapngWriter(PropertyName=Value)

説明

pcapngObj = pcapngWriter は、既定の PCAPNG ファイル ライター オブジェクトを作成します。

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

プロパティ

メモ

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

FileName — PCAPNG ファイルの名前

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

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

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

データ型: char | string

ByteOrder — バイト順

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

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

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

データ型: char | string

FileComment — PCAPNG ファイルに関するコメント

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

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

PCAPNG ファイルに関するコメント。文字ベクトルまたは string スカラーとして指定します。

データ型: char | string

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

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

R2026a 以降

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

依存関係

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

データ型: char | string

オブジェクト関数

このオブジェクトに固有

write	Write protocol packet data to PCAP or PCAPNG file
writeCustomBlock	Write custom block to PCAPNG file
writeInterfaceDescriptionBlock	PCAPNG ファイルへのインターフェイスの記述ブロックの書き込み

例

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

PCAPNG ファイルの名前を指定し、PCAPNG ファイル ライター オブジェクトを作成します。

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

5G New Radio (NR) のインターフェイス ブロックを書き込みます。5G NR パケットには有効なリンク タイプがありません。有効なリンク タイプが存在しない場合は、Tcpdump に従って SLL パケットのリンク タイプを指定します。

interface = '5GNR';                                       % Interface name
linkType = 113;                                           % Link type of SLL packet
timestamp = 300;                                          % Timestamp
interfaceID = writeInterfaceDescriptionBlock(pcapngObj,linkType,interface);

5G 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 start of NR MAC signature
payloadTag = 1;                                           % Payload tag for NR MAC 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;                                                   % 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 パケットを PCAPNG ファイルに書き込みます。

packetComment = 'This is NR MAC packet';                  % Packet comment
write(pcapngObj,packet,timestamp,interfaceID,'PacketComment',packetComment);

参照

[1] Tuexen, M. “PCAP Next Generation (Pcapng) Capture File Format.” 2020. https://www.ietf.org/.

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

[3] “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: pcapngWriter にパイプ インターフェイスのサポートを追加

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

参考

オブジェクト

• pcapWriter | nrPCAPWriter | pcapReader