NVMe Flexible Data Placement：資料放置、回收單位與事件觀察

從主機看見的更新開始

01.02.檔案系統把某個 LBA 的內容改掉，並不表示 SSD 已經原地覆寫同一塊媒體。裝置可能把新內容放到別處，原位置成為不再需要的舊資料。回收空間時，若同一批媒體仍夾著有效資料，控制器就需要保留或搬移那些資料。這是理解 FDP 的出發點。

主機提供的是分組資訊

01.03.主機較容易知道哪些資料會一起失效，例如同一批可整體刪除的暫存檔。FDP 讓主機把這種關係反映到資料放置上，但不把 NAND 實體位址交給主機管理，也不保證任意分組都能改善寫入量；分錯生命週期，仍可能留下需要搬移的資料。

NSID

Namespace Identifier，controller 用來指向 namespace 的數值 handle；identifier 不等於 namespace 物件本身。

RGID

Reclaim Group Identifier；選擇 Reclaim Group 的編號。

RGIF

Reclaim Group Identifier Format；PID 高位分配給 RGID 的 bit 數。

先分清楚 4 層物件

01.04.Endurance Group 裡有一個或多個 Reclaim Group；每個 Reclaim Group 裡有多個 Reclaim Unit。Reclaim Unit Handle 在每個 Reclaim Group 各持有一個目前可寫入單位的參照。因此只說 RUH 3 還不夠，還需要知道是哪一個 Reclaim Group。

Reclaim Unit Handle

Reclaim Unit Handle；回收單位控制代號，簡寫 RUH；在每個 RG 各參照一個目前的 RU。

Reclaim Group

Reclaim Group；回收群組，簡寫 RG；包含多個可輪替使用的回收單位。

Handle 會持續存在，所指單位會換

01.05.當目前的 Reclaim Unit 寫滿，控制器把相應參照改到同一 Reclaim Group 的另一個空單位。主機後續仍可使用相同 handle；相同 PID 並不是某塊媒體永久不變的地址。切換也不表示之前寫入的有效資料已刪除。

把模型接回 namespace

01.06.每個 namespace 的 Placement Handle List 將 PHNDL 對應到 RUHID。主機寫入時帶 NSID、LBA 和 PID；控制器先從 PID 取 PHNDL 與 RGID，再查 namespace 的表，最後選到目前的 RU。這幾個步驟會在後文使用同一組數值逐步演算。

RUHID

Reclaim Unit Handle Identifier；識別 Endurance Group 內的一個 RUH。

先看共同點

02.02.兩種類型都讓不同 RUH 的新寫入起初放在不同 RU。不能把 Initially Isolated 解讀成完全沒有隔離，也不能把 Persistently Isolated 解讀成控制器不得搬移資料。真正需要比較的是控制器內部搬移之後，哪些資料可以放到同一個目的 RU。

Initially Isolated 的允許範圍

02.03.RUHT=1h。控制器例如為了垃圾回收，把舊資料搬到同一 Reclaim Group 內的另一個 RU；目的 RU 可以混合其他 Initially Isolated RUH 所寫的資料。原本分組仍影響初次放置，但不能據此假設搬移後每一組都維持各自的 RU。

RUHT

Reclaim Unit Handle Type；指定搬移時的隔離類型。

RUH 類型	X、Y 的新資料	控制器搬移 X、Y 舊資料後
Initially Isolated	不同 RU	允許進同一個目的 RU
Persistently Isolated	不同 RU	X、Y 必須保留不同目的 RU

Persistently Isolated 的限制

02.04.RUHT=2h。控制器一樣可以在同一 Reclaim Group 內搬移，但目的 RU 只能包含由同一 RUH 寫入的資料。這是資料來源的隔離條件，不是固定實體地址、跨 Reclaim Group 的複製能力，或資料永久保留的承諾。

隔離不等於 namespace 隔離

02.05.不同 namespace 可以在符合格式等條件時共用同一 RUH。此時即使 RUHT=2h，也不能把該 RUH 的持續隔離當成這些 namespace 彼此隔離；規則的識別對象是 RUH。選用共享或獨立 RUH 前，要先確認應用程式想一起管理的是哪些資料。

先讀清單外框，再讀一筆配置

03.02.NUMFDPC 在 header bytes 1:0，採數量減 1 的編碼；值 1 表示 2 筆配置。SZE 是整份 log 的 byte 數，第一筆從 byte 16 開始。每筆配置可能因 RUH 數與廠商資料長度不同而有不同 DSZE，所以下一筆位置要加上本筆 DSZE，不能假設固定間距。

NUMFDPC

Number of FDP Configurations；配置清單數量減 1。

SZE

Size；整份 FDP Configurations log 的 byte 長度。

位置、索引與有效性分開

03.03.第 0、1、2 筆是清單索引，Set Features 的 FDPCIDX 選這個索引。假設第 0 筆 DSZE=80，則第 1 筆起點是 byte 96；要選它仍填 FDPCIDX=1，不是 96。FDPCV=0 表示該候選目前不可用；建立其他 Endurance Group 或啟用其他配置後，可用性可能改變。

FDPCIDX

FDP Configuration Index；選清單的第幾筆，從 0 開始。

用配置判斷數量、類型與大小

03.04.NRG、NRUH 是直接計數且非零；RUH 清單依 RUHID 遞增，每筆描述器提供 RUHT。RUNS 是每個 RU 的名目 bytes，ERUTL 是估計時間上限秒數，0 表示未回報。MAXPIDS 則是 Update 可接受的 NPID 編碼上限，不能把這幾個值都當成同一種容量。

MAXPIDS

Max Placement Identifiers；Update 的 NPID 編碼上限。

ERUTL

Estimated Reclaim Unit Time Limit；配置中的估計時間上限，秒。

NPID

Number of Placement Identifiers；Update 清單 PID 數減 1。

從一個 16-bit 值取出兩個選擇

03.05.RGIF=r 且 r>0 時，RGID=PID>>(16-r)，PHNDL=PID & ((1<<(16-r))-1)。NRG=1 且 RGIF=0 時，16 bits 全部是 PHNDL；NRG=1 但 RGIF 非零也合法，此時 RGID 欄位由控制器忽略。不要自行以 log2(NRG) 取代裝置實際回報的 RGIF。

結構長度需要把對齊也算進去

03.06.一筆配置先有 64 bytes 固定部分，再加 NRUH×4 bytes 的 RUH 描述器、VSS bytes 的廠商內容，最後補 0 到 8-byte 邊界。例：NRUH=3、VSS=1，未補齊為 77 bytes，補 3 bytes 後 DSZE=80。VS 是廠商資料；沒有廠商定義時不替其中的值編造意義。

VSS

Vendor Specific Size；廠商定義內容的 byte 數。

VS

Vendor Specific；廠商定義的內容，需廠商文件才可進一步解讀。

FDPS 回答能力，不回答目前狀態

04.02.Identify Controller 的 CTRATT.FDPS=1 表示支援 FDP；LID 20h 再回答有哪些配置。即使兩者都符合，也還不能直接對現有 namespace 所屬群組改設定。支援、候選可用性與目前啟用狀態是不同問題，必須依次確認。

CTRATT

Controller Attributes；Identify Controller 的能力屬性欄。

先處理現有 namespace 的原因

04.03.FDP 改變的是群組的配置，後續 namespace 的資料格式與 handle 映射也與該配置有關。只要群組還有 namespace，而要求的 FID 1Dh 值又不同於目前值，控制器就以 Command Sequence Error 拒絕。這項規則要求刪除該群組全部 namespace 後才變更，不能把它畫成隨時可以切換的普通開關。

1. 查 FDPS → LID20h 選目前有效的配置。
2. 準備好目標 Endurance Group：修改 FID1Dh 前必須沒有 namespace。
3. Set FID1Dh、SV=1，填 ENDGID、FDPCIDX、FDPE。
4. 重新查資料格式 → Create namespace，建立 PHNDL→RUHID。
5. 設定所需事件 → 對 namespace 啟用 Data Placement Directive → 查狀態與 cache。
6. Write 使用 PID；後續以 Status、Update、Statistics、Events 觀察並管理。

ENDGID

Endurance Group Identifier；選定耐久度群組的編號。

把目標、配置與保存分開編碼

04.04.CDW11 低 16 bits 是 ENDGID；CDW12 bit 0 是 FDPE、bits 15:8 是 FDPCIDX；Save 在 CDW10 bit 31。此 Feature 可保存、預設 0，值的改變只允許在 SV=1 時進行。支援 SSFS 而 SV=0 的要求會回 Invalid Field in Command。

SSFS

Save and Select Feature Support；是否支援保存設定及選擇非零 SEL 查詢。

CDW

CDW（Command Dword）；命令中的 32-bit 欄位單位，例如 CDW10 的 10 是欄位 index，不是 byte offset。

成功後需要重新確認什麼

04.05.Feature 值改變時，控制器可以改變 Identify 所提供的資料格式相關資訊。主機應重新查支持的格式，再建立使用 NVM Command Set（CSI=00h）的 namespace。還要保留舊統計的量測終點，因為成功改值會把 FDP Statistics 清 0，並清掉 FDP Events；前後已不是同一段累計期間。

CSI

I/O Command Set Identifier；選擇 I/O 命令集，NVM Command Set 使用 00h。

報告操作順序不等於立即執行刪除

04.06.本文教的是配置條件與流程。完整順序是確認能力與候選、安排既有資料與 namespace 的處理、在空群組保存新設定、重新查格式、建立 namespace 及其映射，再啟用所需 Directive 與事件。這裡不把「設定成功」當成資料已遷移或已安全保存的證明。

PHNDL 是清單的位置，RUHID 是清單的內容

05.02.本例 NPHNDLS=2，bytes 512:513 放 1，514:515 放 3。第 0 筆的位置定義 PHNDL 0，內容 1 才是 RUHID。這是「索引」與「值」的典型差別：寫入帶 PHNDL，控制器查出 RUHID；不能把主機清單 [1,3] 解讀成這個 namespace 只有 PHNDL 1 和 PHNDL 3。

主機提供清單時的完整檢查

05.03.非零 NPHNDLS 不能大於 NRUH 或 128；每個 RUHID 必須小於 NRUH；同一 namespace 的清單不能重複 RUHID。若列到控制器已為 NPHNDLS=0 的 namespace 選用的 RUH，也會被拒絕為 Invalid Placement Handle List。

不提供清單並不是沒有 Placement Handle

05.04.NPHNDLS=0 要求控制器替 namespace 建立唯一的 PHNDL 0。若群組已存在這種 namespace，新 namespace 使用相同的控制器選定 RUH；否則控制器需選一個未被主機明確配置的 RUH。沒有可用候選時會回 Invalid Placement Handle List，不能任意借用一個已被明確配置的 RUH。

共享需要一致的資料格式

05.05.兩個 namespace 明確使用同一 RUH 時，Format Index 必須相同；不一致會回 Invalid Format。只看每個 logical block 的 data bytes 相同還不夠，Format Index 代表整份資料格式選擇。FDP 群組中的 namespace 使用 NVM Command Set，且不能把 NVM Set 配置混進同一個 FDP 配置。

logical block

邏輯區塊；namespace 可定址的基本單位，其資料大小由使用中的格式決定。

Format Index

格式索引；用來選取一組 LBAF／ELBAF 格式資訊的編號。

NVM Set

NVM Set，把 namespace 與一組共同管理的 NVM 資源建立關聯的容量集合。

index

索引；清單中第幾個項目的編號，與項目距起點多少 bytes 不同。

建立後取得目前映射與容量

05.06.建立命令決定 PHNDL 到 RUH 的關係，但每個 RUH 在各 Reclaim Group 指向的 RU 會隨寫入變化。使用 I/O Management Receive 查目前的 PID、RUHID、剩餘可寫量與時間，才能把建立時的表接到運作中的狀態。Create 與 Attachment 是不同操作；要透過某控制器做 I/O，namespace 還需能由該控制器存取。

I/O

Input/Output，對 namespace 執行資料輸入與輸出的操作類別。

先確認兩種狀態各屬於誰

06.02.FID 1Dh 是 Endurance Group 的 FDP 設定；Data Placement Directive 則套用到指定 namespace，以及適用的主機身分與共享控制器關係。群組有能力並已啟用，不會自動證明某主機已替 namespace 啟用 Directive。

Enable 由 Identify Directive 處理

06.03.Directive Send 外層選 DTYPE=00h、DOPER=01h，再由 CDW12 的 DTYPE=02h、ENDIR=1 指定目標。若 namespace 不在已啟用 FDP 的群組，回 FDP Disabled；若用 NSID=FFFFFFFFh 要一次啟用所有 namespace，回 Invalid Namespace or Format。應逐一對有效 namespace 設定。

DOPER

Directive Operation；所選 Directive 中的管理動作。

ENDIR

Enable Directive；控制目標 Directive 的啟用或停用。

目的	入口與選擇	改變或取得什麼
群組啟用 FDP	Set Features / FID1Dh	Endurance Group 的配置
namespace 使用 PID	Directive Send / Identify / Enable target02h	Data Placement 啟用狀態
查每個 PID 狀態	I/O Management Receive / MO1	映射、剩餘量、估計時間
改到空 RU	I/O Management Send / MO1	所列 PID 的目前 RU 參照

為何不能直接對 Data Placement 發管理操作

06.04.§8.1.9.4 沒有定義 Data Placement 的任何 Directive Operations。因此 Send 或 Receive 若在 CDW11 直接選 DTYPE=02h，回 Invalid Field in Command。查能力使用 Identify Directive 的 Return Parameters；查 RUH 狀態與更新參照則使用 I/O Management 命令，各入口有不同工作。

DTYPE 被忽略、明確使用與非法類型

06.05.I/O 中若沒有任何 I/O Directive 啟用，或 DTYPE=00h，控制器忽略 DTYPE／DSPEC；FDP 群組裡這種寫入使用 PHNDL 0，RG 由控制器選。若 Directive 有效且 DTYPE=02h，才解讀 DSPEC 為 PID。若已有 I/O Directive 啟用，卻選不支援或未啟用的類型，則以 Invalid Field in Command 拒絕。

DSPEC

Directive Specific；Data Placement 的 I/O 中承載 PID。

保存的啟用狀態不代表參照不變

06.06.Data Placement 的 DPDIRCLR=1 表示其啟用狀態跨 Controller Level Reset 保留；但 RUH 目前指向哪個 RU、剩餘容量與事件仍需重新查。不要因為 Enable 不必照搬 Streams 的 reset 規則，就省略後續 FDP 狀態恢復流程。

DPDIRCLR

Data Placement Directive Persistent Across Controller Level Resets；啟用狀態是否跨此類 reset 保留。

固定其他條件，觀察 PID 的作用

07.02.假設 namespace A 可存取、Data Placement 已啟用，映射 [1,3]，NRG=4、RGIF=2。PID=8001h 指 RG 2 與 PHNDL 1，查表得到 RUH 3。控制器把這次資料放到 RUH 3 在 RG 2 目前參照的 RU；LBA 128 是 namespace 的邏輯位置，與 RG 2 不是同一層地址。

把命令長度與放置選項分開

07.03.8 blocks 的 NLB 是 7，位於 CDW12 bits 15:0；DTYPE=2 位於 bits 23:20。CETYPE=0 的格式下，PID 放在 CDW13 高 16 bits。不能把 PID 填入 SLBA，不能把 8 直接填成 NLB，也不能把這個 CDW13 例子無條件套到非零 CETYPE。

CETYPE

Command Extension Type；決定 Write 的擴充欄位格式，本篇例子固定 0。

SLBA

Starting LBA；一段邏輯資料的起始 LBA。

NLB

Number of Logical Blocks；Write 的資料區塊數減 1。

沒有明確帶 PID 時仍有 FDP 放置

07.04.若本例 Write 不使用 Directive，PHNDL 自動採 0，因而查到 RUHID 1；Reclaim Group 由控制器選。這不表示離開 FDP 群組，也不表示控制器把非零 DSPEC 自動當作 PID。是否解讀 DSPEC 先取決於 Directive 規則。

非法 PID 的資料與事件分開判斷

07.05.假設改成 PHNDL=2，但 A 只有 PHNDL 0、1。控制器為這次 Write 選擇 A 可存取的 RG／RUH；這個放置錯誤本身不是要求 Write 必須失敗。事件是否出現還取決於實際所選 RUH 是否啟用了 Invalid Placement Identifier；想收到此事件，應在所有 RUH 啟用它。其他命令錯誤仍可能使 Write 失敗。

寫入完成與媒體持久化分開

07.06.FDP 沒有取消 volatile write cache 的差別。有些配置帶 cache，有些 namespace 由 VWCNP=1 明確表示沒有。完成 Write 不應一律解讀成已寫入非揮發媒體；需要持久化時使用原本的 FUA／Flush 規則。FDP 的分組選擇也不額外提供原子寫入保證。

VWCNP

Volatile Write Cache Not Present；1 表示此 namespace 沒有揮發性寫入快取。

FUA

Force Unit Access；對這筆 Write 要求資料及 metadata 在成功完成前寫入非揮發媒體。

查詢對象是 namespace，不是 ENDGID

08.02.I/O Management Receive 用 NSID 指定可存取的 namespace；MO=01h，這個操作沒有定義 MOS 的額外選擇。NSID=0 或 FFFFFFFFh 會回 Invalid Namespace or Format，FDP 未啟用則回 FDP Disabled。這和 LID 20h～23h 用 ENDGID 選群組不同。

MOS

Management Operation Specific；由 MO 決定含義，Update 時保存 NPID。

先讀 header，再按 32 bytes 前進

08.03.header 是 16 bytes，NRUHSD 位於 bytes 15:14，直接表示描述器數量。第 i 筆從 16+32×i 開始。NVM 排序先 PHNDL 遞增，再 RGID 遞增：先看 PH0/RG0、PH0/RG1…，才輪到 PH1。這有助於核對相同 PH 在不同 RG 的狀態。

NRUHSD

Number of Reclaim Unit Handle Status Descriptors；狀態描述器直接計數。

PID / PH / RG	RUHID	RUAMW (blocks)	EARUTR (s)
0001h / 1 / 0	3	8	30
4001h / 1 / 1	3	4	15
8001h / 1 / 2	3	6	20
C001h / 1 / 3	3	0	0

容量與時間各回答一個問題

08.04.RUAMW 是當時仍可寫入的 logical block 數；EARUTR 是目前 RU 估計還可維持被參照的秒數，0 表示沒回報時間，不表示立即到期。ERUTL 是配置層的估計上限，EARUTR 是這次狀態中的剩餘估計，不該用相同數值替代。

實際容量可能大於或小於名目大小

08.05.RUAMW×格式化 block 大小可以小於 RUNS，例如有缺陷的可寫媒體減少；也可以大於 RUNS，例如有額外預留容量。因此即使看到未寫過的 RU，也不能直接用 RUNS 除 block size 取代裝置回覆。Reset 或 Flush 之後，RUAMW 也可能改變或不變。

傳輸長度與快照限制

08.06.NUMD 採 Dword 數量減 1；短 buffer 只收到前段。此 Status 操作有特別規則：buffer 比完整結構長時，多出的部分填 0。不同描述器不是保證同一時刻的原子快照；若另外有 Write 或 Update 正在處理，不可把剛查到的容量當成已為下一筆 Write 保留。

buffer

緩衝區；主機準備給命令提供或接收資料的記憶體。

Dword

Dword（Double word）；32 bits，也就是 4 bytes。對比 word=16 bits；例如 zero-based dword count=3 代表 4 個 Dwords，也就是 16 bytes。

NUMD

Number of Dwords；4-byte 傳輸單位的個數減 1。

Update 改的是參照，不是 PHNDL 清單

09.02.同一 PID 經由同一 PHNDL→RUHID 映射，在指定 RG 換到新的空 RU。它不是重新建立 namespace 的 Placement Handle List，不會把 PHNDL 1 改成 PHNDL 2，也不會因為成功就把舊 RU 的有效 LBA 刪掉。

已寫入與原本為空有不同要求

09.03.若目前 RU 已寫有 user data，控制器必須改到另一個空 RU；若目前 RU 完全沒寫過，可保留也可換另一個空 RU。主機提早切走尚未寫滿的 RU，可能犧牲可用寫入量，並在事件已啟用時留下 Not Fully Written To Capacity 紀錄。

NPID 放在 MOS 裡，不是獨立 CDW

09.04.CDW10 的 MO 位於 bits 7:0，MOS 位於 bits 31:16；Update 把 MOS 的 16 bits 定義為 NPID。清單有 K 個 PID 時，NPID=K-1，每個 PID 2 bytes。NPID 不得超過配置 MAXPIDS；MAXPIDS 自身已是數量減 1 的上限，不能再把編碼值多減一次。

Update 不採 Write 的非法 PID 容錯

09.05.RGID 超出 NRG 或 PHNDL 超出 namespace 的數量時，Update 回 Invalid Field in Command。命令被拒絕也不保證清單完全沒動過，因為規格允許部分 PID 已更新。完成後需要的狀態應重新查詢，不能假設整批更新具備全部成功或全部回復的語意。

想形成清楚資料邊界，先處理重疊 I/O

09.06.如果某筆 Write 在 Update 處理期間使用同一 PID，資料可進入切換前或切換後的 RU。主機若需要讓「這一批」和「下一批」分開，應先完成並協調相關寫入，執行 Update，確認完成後才送下一批；還要依 cache 情況處理持久化。單靠先後送進不同 queue 不能證明控制器的處理順序。

先選正確群組

10.02.Get Log Page 的 LSI.ENDGID 選 Endurance Group；FDP 已啟用時，此查詢的 NSID 保留。不能把某個 NSID 放進去期待清單只剩這個 namespace 的 RUH。若該群組 FDP 未啟用，回 FDP Disabled。

LSI

Log Specific Identifier；依 log 定義選對象，本篇 FDP logs 用它放 ENDGID。

RUHID 由清單位置取得

10.03.8-byte header 的 NRUH 是直接計數，與目前配置的 NRUH 相同。第 i 個 8-byte 描述器從 8+8×i 開始，它描述 RUHID i；描述器本身 byte 0 是 RUHA，其餘保留。不要把它的 byte offset 當成 RUHID。

三個值是分類，不是數量

10.04.RUHA=0 表示沒被 namespace 使用，1 表示主機在建立時明確指定，2 表示 namespace 請控制器選。控制器自選的 namespace 共用同一個此類 RUH，所以整份清單最多一筆為 2。RUHA=1 的 RUH 可以被符合條件的多個 namespace 共享。

用兩種查詢回答不同問題

10.05.安排新 namespace 時，Usage 協助看 RUH 的分配來源；準備下一批 Write 時，Status 協助看某 namespace 可用的 PID 及剩餘量。Usage 不會直接告訴你哪個 RU 尚有 24 KiB，也不能由 RUHA=0 推斷某段舊媒體已被擦除。

先知道這份累計涵蓋誰

11.03.Log 以 Endurance Group 為範圍，包含該 FDP 配置期間曾存在的全部 namespace。不能刪掉某 namespace 後，就以為它過去的寫入也會從累計移除。FDP 未啟用時，查詢回 FDP Disabled；啟用時 NSID 在這份查詢中保留。

主機寫入與媒體寫入的差距

11.04.HBMW 不含控制器垃圾回收等內部寫入；MBMW 包含相關主機和內部寫入。NVM §4.1.4.6 指明計入 User Data Out Commands，以及 Write Zeroes、Write Uncorrectable。因此不能單純用 PCIe 傳輸的 payload bytes 替代 HBMW，尤其某些命令沒有等量主機 payload。

用前後快照算增量

11.05.三個計數都是 128 bits，讀出後先記錄配置、群組、時間與起點，再計算同一時段差值。例如 host 從 500 增至 600 GiB，media 從 800 增至 950 GiB，差值的比是 150/100=1.5，不是只比結束時的 950/600。工作負載與背景處理也應一併考量。

Host

主機；執行作業系統並送出 NVMe 命令的一端。

遇到清零、飽和與零分母

11.06.成功改變 FID 1Dh 值會把統計清 0，firmware update 不會清零；計數到 2^128-1 後飽和不回繞。跨清零不能直接相減，飽和後差值不再完整，host 增量為 0 時則不計這個比值。這些邊界會決定一個漂亮數字到底有沒有意義。

先查支援，再選需要的類型

12.02.Get Features FID 1Eh 以指定 namespace 的 PHNDL 找到 RUH。一般的值查詢會在 buffer 回 supported event descriptors，CQE DW0.NOET 回項目數，按事件值遞增排列。SEL=3 則是通用能力查詢，不能用一般值回覆格式解讀。

NOET

Number of FDP Event Types；事件類型的直接計數。

CQE

Completion Queue Entry，CQ 中的一筆完成結果資料結構。

SEL

Select；Get Features 要讀目前、預設、保存值，還是支援能力。

Set 一次控制所列的一組事件

12.03.CDW11 高位 NOET 表示 buffer 中有幾個 1-byte 事件類型，低位 PHNDL 選對象；CDW12.FDPEE 決定這些類型啟用或停用。Get 忽略輸入的 NOET 與 CDW12 開關，回覆每個類型目前狀態。若 PHNDL 無效，Get／Set 都會回 Invalid Field in Command。

FDPEE

FDP Event Enable；事件啟用位，與整體 FDP 啟用不同。

選 namespace 的路徑，改 RUH 的設定

12.04.A 的 PHNDL 1 與 B 的 PHNDL 0 若都映射到 RUH 3，透過 A 改事件設定會影響這個共享 RUH。不能以為 NSID 不同就各有一份獨立開關。FDP 停用時，此 Feature 的 Get／Set 都回 FDP Disabled；Feature 本身可保存，保存行為仍按通用 SV／SEL 規則使用。

沒有紀錄，不一定沒有發生

12.05.事件必須在發生時已對相關 RUH 啟用才會被記錄。容量達上限後，新增紀錄會丟掉最舊的一筆；若設定值改變也可能清掉整份歷史。因此排程與效能分析應記錄設定及讀取時段，不能只憑空白的 log 宣告整段運作從未發生事件。

查哪一類事件先由命令決定

13.02.CDW10 bit 8 的 FDPET=1 選 host events，0 選 controller events；單次回覆不混兩類。整份 log 是 4096 bytes，64-byte header 後接 64-byte 記錄，最多容納 63 筆；實際支援上限仍依裝置。NUMFDPE 是實際筆數，最後一筆以外的 bytes 沒有可任意當作新紀錄的意義。

NUMFDPE

Number of FDP Events；log 內實際事件紀錄數。

FDPET

依所在結構而定：log 請求中是選 host／controller 的 1-bit 值；supported descriptor 中是事件種類的 byte 值。

Host events 說明哪些使用行為

13.03.00h 是主機 Update 時舊 RU 尚未寫滿；01h 是未在估計時間內寫滿而控制器改參照；02h 是 Controller Level Reset 改了一個或多個 RUH，此事件的 NSID 與 PID 保留；03h 是 Write 的 PHNDL 或 RGID 不合法。事件名稱描述原因，不能把全部都翻成「配置失敗」。

位元	為 1 時可讀	為 0 時怎麼處理
PIV	PID；03h事件為主機原值	PID 保留
NSIDV	NSID	NSID 清0並忽略
LV	RGID 與 RUHID	兩欄清0並忽略
LBAV（80h NVM 擴充）	其中一個被搬移 LBA	LBA 清0並忽略

Controller events 說明內部改變

13.04.80h Media Reallocated 描述 Initially Isolated 資料被搬到別的 RU；81h 描述控制器隱式改了 RUH 的參照。這和主機明確送 Update 不同。廠商事件範圍另有編碼，沒有廠商說明時只保存原值，不套用 80h 的欄位意義。

先看有效位，再讀看似有值的欄位

13.05.PIV 決定 PID 可否使用，NSIDV 決定 NSID，LV 同時控制 RGID 與 RUHID。NSIDV=0 時 NSID 清 0 且忽略；LV=0 時兩個位置欄清 0 且忽略；PIV=0 時 PID 保留。若無法回報具體 RUH，PIV 與 LV 都清 0，不能把這些 0 解讀成真的在 RG0／RUH0。

Media Reallocated 的 LBA 只是一個被搬移的例子

13.06.NVM 擴充中的 NLBAM=0 表示沒回報數量，FFFFh 表示至少 65535 個；LBA 在 LBAV=1 時有效，代表其中一個被搬移的 LBA，而不是連續範圍起點。因此 NLBAM=8、LBA=100 不能推論恰好搬了 100～107。PIV=1 才能把原始寫入的 handle 與此搬移關聯起來。

順序以清單為準，時間需要讀來源與計時屬性

13.07.紀錄按發生先後排列，但 reset 或主機重新設 Timestamp 可讓後一筆時間數值較小。ETMSP 的格式含時間、初始化來源與是否可能暫停計時；分析跨 reset 的事件時保留清單順序，不能直接按 timestamp 數字重新排序。

ETMSP

Event Timestamp；事件發生時保存的 Timestamp 值與屬性。

主機要追蹤實際資料，而不是只記一個 PID

14.02.同一 PID 在 RU 寫滿或 Update 後會指向新 RU。若要在舊 RU 資料一起失效時通知控制器，主機需知道那一批實際寫了哪些 LBA 範圍。單看目前 PID 並無法重新找回所有舊批次的 LBA；規格介面沒有把 PID 當成可直接刪整批資料的鍵。

DSM 的範圍描述有自己的計數規則

14.03.AD=1 表示主機提供解除配置建議；每個 range 有 SLBA 與直接計數的 LLB，命令 NR 則是 range 數減 1。把兩個不連續範圍拆成兩列，才能正確表達哪些邏輯資料不再需要。此命令是 advisory，不能保證提交後立刻擦除媒體，也不能當成 Sanitize。

advisory

建議性；符合規格的控制器可選擇不依該提示採取動作。

LLB

Length in Logical Blocks；DSM 單一範圍的區塊數，直接計數。

NR

Number of Ranges；DSM 的範圍項目數減 1。

操作	主要改變	不能由此推論
RUH Update	未來寫入使用的 RU 參照	舊資料已失效或已擦除
DSM / AD=1	向控制器提供不再需要的 LBA 範圍	立即擦除，或改了 PH→RUH 映射
變更 FID1Dh	群組 FDP 配置；清事件與統計	可在現有 namespace 尚存時任意切換

大小限制會影響一次能處理多少範圍

14.04.先確認 NVMDSMSV 與 DSM 限制欄位所表示的命令支援，再以非零 DMRL、DMRSL、DMSL 分別判斷 range 數、單一 range blocks、整命令 blocks。NVMDSMSV=1 時限制欄位 0 表示未回報該限制；NVMDSMSV=0 時欄位 0 表示不支援命令。超出非零限制的部分可能不處理。主機需要分批並在既有資料已不再使用時發出；不能只因為清單完整，就推論一個超大命令必然處理全部內容。

NVMDSMSV

Dataset Management Support Variants；決定如何連同限制欄位判斷 DSM 支援。

DMRSL

Dataset Management Range Size Limit；每個範圍的 logical block 數限制。

DMRL

Dataset Management Ranges Limit；範圍項目數的限制。

DMSL

Dataset Management Size Limit；整筆命令的 logical block 總數限制。

Reset 後沿資訊依存關係恢復

14.05.先 Get FID 1Dh 確認 ENDGID 的 FDPE／FDPCIDX，再查 LID 20h 取得該配置，接著查並設定所需 FDP events；對各 namespace 查 RUH Status 與 CNS08h cache 資訊。Data Placement 的 enable 狀態可保留，但 RUH 參照與 RUAMW 仍可能變動，舊快照不能直接接著使用。

結束一批資料，與更換整份配置不同

14.06.Update 是單一或多個 PID 的參照更新；DSM 是指定不再需要的邏輯範圍；改 FID 1Dh 是 Endurance Group 配置更動，需先無 namespace，並清事件與統計。把這三種操作分開，才能說清楚誰改了什麼、哪些資料仍可讀，以及哪些累計值還能前後比較。