특정 네임스페이스와 관련된 기능 및 설정을 나타내는 값을 포함합니다.
모든 네임스페이스에 공통적인 기능 및 설정은 네임스페이스 식별자가 0xFFFFFFFF있는 네임스페이스의 NVME_IDENTIFY_NAMESPACE_DATA 데이터 구조에 포함됩니다.
nvme.h 헤더 파일은 상수 NVME_NAMESPACE_ALL 값0xFFFFFFFF으로 정의합니다.
컨트롤러가 네임스페이스 관리를 지원하고 NVME_COMMAND 구조의 NSID(네임스페이스 식별자) 필드가 NVME_NAMESPACE_ALL 설정되면 컨트롤러는 모든 네임스페이스에서 공통적인 기능을 지정하는 NVME_IDENTIFY_NAMESPACE_DATA 데이터 구조를 반환합니다.
Syntax
typedef struct {
ULONGLONG NSZE;
ULONGLONG NCAP;
ULONGLONG NUSE;
struct {
UCHAR ThinProvisioning : 1;
UCHAR NameSpaceAtomicWriteUnit : 1;
UCHAR DeallocatedOrUnwrittenError : 1;
UCHAR SkipReuseUI : 1;
UCHAR NameSpaceIoOptimization : 1;
UCHAR Reserved : 3;
} NSFEAT;
UCHAR NLBAF;
struct {
UCHAR LbaFormatIndex : 4;
UCHAR MetadataInExtendedDataLBA : 1;
UCHAR Reserved : 3;
} FLBAS;
struct {
UCHAR MetadataInExtendedDataLBA : 1;
UCHAR MetadataInSeparateBuffer : 1;
UCHAR Reserved : 6;
} MC;
struct {
UCHAR ProtectionInfoType1 : 1;
UCHAR ProtectionInfoType2 : 1;
UCHAR ProtectionInfoType3 : 1;
UCHAR InfoAtBeginningOfMetadata : 1;
UCHAR InfoAtEndOfMetadata : 1;
UCHAR Reserved : 3;
} DPC;
struct {
UCHAR ProtectionInfoTypeEnabled : 3;
UCHAR InfoAtBeginningOfMetadata : 1;
UCHAR Reserved : 4;
} DPS;
struct {
UCHAR SharedNameSpace : 1;
UCHAR Reserved : 7;
} NMIC;
NVM_RESERVATION_CAPABILITIES RESCAP;
struct {
UCHAR PercentageRemained : 7;
UCHAR Supported : 1;
} FPI;
struct {
UCHAR ReadBehavior : 3;
UCHAR WriteZeroes : 1;
UCHAR GuardFieldWithCRC : 1;
UCHAR Reserved : 3;
} DLFEAT;
USHORT NAWUN;
USHORT NAWUPF;
USHORT NACWU;
USHORT NABSN;
USHORT NABO;
USHORT NABSPF;
USHORT NOIOB;
UCHAR NVMCAP[16];
USHORT NPWG;
USHORT NPWA;
USHORT NPDG;
USHORT NPDA;
USHORT NOWS;
USHORT MSSRL;
ULONG MCL;
UCHAR MSRC;
UCHAR Reserved2[11];
ULONG ANAGRPID;
UCHAR Reserved3[3];
struct {
UCHAR WriteProtected : 1;
UCHAR Reserved : 7;
} NSATTR;
USHORT NVMSETID;
USHORT ENDGID;
UCHAR NGUID[16];
UCHAR EUI64[8];
NVME_LBA_FORMAT LBAF[16];
UCHAR Reserved4[192];
UCHAR VS[3712];
} NVME_IDENTIFY_NAMESPACE_DATA, *PNVME_IDENTIFY_NAMESPACE_DATA;
Members
NSZE
논리 블록에 있는 네임스페이스의 총 크기를 나타냅니다.
n 크기의 네임스페이스는 LBA(논리 블록 주소) 0 를 통해 (n - 1)구성됩니다. 논리 블록의 수는 형식이 지정된 LBA 크기를 기반으로 합니다. 이 필드는 네임스페이스의 서식을 지정하기 전에 정의되지 않습니다.
NCAP
언제든지 네임스페이스에 할당될 수 있는 논리 블록의 최대 수를 나타냅니다.
논리 블록의 수는 형식이 지정된 LBA 크기를 기반으로 합니다. 이 필드는 네임스페이스의 서식을 지정하기 전에 정의되지 않습니다.
NCAP 필드는 씬 프로비전의 경우 사용되며 NSZE(네임스페이스 크기)보다 작거나 같은 값을 보고합니다.
예비 LBA는 이 필드의 일부로 보고되지 않습니다.
NCAP(네임스페이스 용량)의 0h 값은 네임스페이스 ID가 비활성 네임스페이스 ID임을 나타냅니다. 논리 블록은 쓰기 또는 쓰기 수정할 수 없는 명령으로 작성될 때 할당됩니다. 데이터 세트 관리 명령을 사용하여 논리 블록의 할당을 취소할 수 있습니다.
NUSE
네임스페이스에 할당된 현재 논리 블록 수를 나타냅니다.
이 필드의 값은 네임스페이스 용량 NCAP 필드의 값보다 작거나 같습니다.
논리 블록의 수는 형식이 지정된 LBA 크기를 기반으로 합니다. NVM 명령 집합을 사용하는 경우: 쓰기 또는 쓰기 수정할 수 없는 명령으로 작성할 때 논리 블록이 할당됩니다. 데이터 세트 관리 명령을 사용하여 논리 블록의 할당을 취소할 수 있습니다.
제품이 씬 프로비저닝 환경의 대상이 아닌 경우 컨트롤러는 항상 NCAP 값과 동일한 NUSE 값을 보고할 수 있습니다.
NSFEAT
네임스페이스의 기능을 정의하는 필드를 포함하는 NSFEAT(네임스페이스 기능) 구조체입니다.
NSFEAT.ThinProvisioning
NSFEAT 구조의 비트 0은 네임스페이스가 씬 프로비저닝을 지원하는지 여부를 나타냅니다.
이 값을 설정 1하면 네임스페이스가 씬 프로비저닝을 지원합니다. 특히 보고된 NCAP(네임스페이스 용량)가 NSZE(네임스페이스 크기)보다 작을 수 있습니다. 이 기능이 지원되고 데이터 세트 관리 명령이 지원되면 NUSE(네임스페이스 사용률) 필드에 할당 취소가 반영됩니다.
이 값이 지워 0지면 씬 프로비저닝이 지원되지 않으며 NSZE 및 NCAP 필드가 동일한 값을 보고함을 나타냅니다.
NSFEAT.NameSpaceAtomicWriteUnit
NSFEAT 구조의 비트 1은 네임스페이스 원자성 경계 매개 변수가 이 네임스페이스에 대해 정의되어 있는지 여부를 나타냅니다.
이 값을 설정1하면 NAWUN, NAWUPF 및 NACWU 필드가 이 네임스페이스에 대해 정의되며, 컨트롤러 식별 데이터 구조의 AWUN, AWUPF 및 ACWU 필드 대신 이 네임스페이스에 대한 호스트에서 사용해야 합니다.
이 값이 지워 0지면 컨트롤러는 이 네임스페이스에 대한 NAWUN, NAWUPF 및 NACWU 필드를 지원하지 않습니다. 이 경우 호스트는 컨트롤러 식별 데이터 구조에 정의된 AWUN, AWUPF 및 ACWU 필드를 사용해야 합니다.
NSFEAT.DeallocatedOrUnwrittenError
NSFEAT 구조의 비트 2는 컨트롤러가 이 네임스페이스에 대해 할당 취소 또는 기록되지 않은 논리 블록 오류를 지원하는지 여부를 나타냅니다.
이 값을 설정 1하면 컨트롤러는 이 네임스페이스에 대해 할당 취소 또는 기록되지 않은 논리 블록(NVME_STATUS_NVM_DEALLOCATED_OR_UNWRITTEN_LOGICAL_BLOCK) 오류를 지원합니다. 이 값이 지워 0지면 컨트롤러는 이 네임스페이스에 대한 NVME_STATUS_NVM_DEALLOCATED_OR_UNWRITTEN_LOGICAL_BLOCK 오류를 지원하지 않습니다.
NSFEAT.SkipReuseUI
NSFEAT 구조의 비트 3은 UI 다시 사용 건너뛰기 기능에 대한 설정입니다.
NSFEAT.NameSpaceIoOptimization
NSFEAT.Reserved
NSFEAT 구조체의 비트 4:7은 예약되어 있습니다.
NLBAF
네임스페이스에서 지원하는 지원되는 LBA 데이터 크기 및 메타데이터 크기 조합의 수를 정의합니다.
LBA 형식은 순서대로 할당되고(0부터 시작) 순차적으로 압축됩니다. 0의 기반 값입니다. 지원되는 것으로 표시될 수 있는 LBA 형식의 최대 수는 16개입니다.
지원되는 LBA 형식은 LBAF 필드(이 데이터 구조의 바이트 128 – 191)에 표시됩니다. 메타데이터는 LBA의 일부로 전송되거나(애플리케이션에 노출되는 더 큰 LBA 크기인 확장된 LBA 만들기) 별도의 연속 데이터 버퍼로 전송될 수 있습니다. 메타데이터는 LBA와 별도의 메타데이터 버퍼 간에 분할할 수 없습니다.
소프트웨어 및 컨트롤러는 컨트롤러에서 ECC 효율성을 위해 4KB 이상의 LBA 크기로 전환하는 것이 좋습니다. 메타데이터를 제공하는 경우 엔드 투 엔드 데이터 보호와 함께 사용할 수 있도록 논리 블록당 최소 8바이트를 제공하는 것이 좋습니다.
FLBAS
네임스페이스의 형식이 지정된 LBA 데이터 크기 및 메타데이터 크기 조합을 나타내는 필드를 포함하는 FLBAS(Formatted LBA Size) 구조체입니다.
FLBAS.LbaFormatIndex
FLBAS 구조체의 비트 0:3은 이 데이터 구조에 표시된 16개의 지원되는 LBA 형식 중 하나를 지정합니다.
FLBAS.MetadataInExtendedDataLBA
FLBAS 구조의 비트 4는 데이터 LBA의 끝에서 메타데이터가 전송되어 확장된 데이터 LBA를 만드는지 여부를 나타냅니다.
이 값을 설정 1하면 데이터 LBA의 끝에 메타데이터가 전송되어 확장된 데이터 LBA가 만들어집니다. 이 값이 지워 0지면 명령에 대한 모든 메타데이터가 별도의 연속 데이터 버퍼로 전송됨을 나타냅니다.
메타데이터가 없는 경우 비트 4를 적용할 수 없습니다.
FLBAS.Reserved
FLBAS 구조체의 비트 5:7은 예약되어 있습니다.
MC
메타데이터의 기능을 나타내는 필드를 포함하는 MC(메타데이터 기능) 구조체입니다.
MC.MetadataInExtendedDataLBA
MC 구조의 비트 0은 네임스페이스가 확장 데이터 LBA의 일부로 전송되는 메타데이터를 지원하는지 여부를 나타냅니다.
이 값을 설정 1하면 네임스페이스는 확장 데이터 LBA의 일부로 전송되는 메타데이터를 지원합니다. 이 값이 지워 0지면 네임스페이스가 확장 데이터 LBA의 일부로 전송되는 메타데이터를 지원하지 않음을 나타냅니다.
MC.MetadataInSeparateBuffer
MC 구조의 비트 1은 네임스페이스가 별도의 버퍼의 일부로 전송되는 메타데이터를 지원하는지 여부를 나타냅니다.
이 값을 설정1하면 네임스페이스는 명령 구조의 MPTR(메타데이터 포인터) 필드에 지정된 별도의 버퍼의 일부로 전송되는 메타데이터를 지원합니다. 이 값이 지워 0지면 네임스페이스는 별도의 버퍼의 일부로 전송되는 메타데이터를 지원하지 않습니다.
MC.Reserved
MC 구조의 비트 7:2가 예약되어 있습니다.
DPC
엔드 투 엔드 데이터 보호 기능에 대한 기능을 나타내는 필드를 포함하는 DPC(엔드 투 엔드 데이터 보호 기능) 구조체입니다.
이 필드에 여러 비트를 설정할 수 있습니다.
DPC.ProtectionInfoType1
DPC 구조의 비트 0은 네임스페이스가 보호 정보 유형 1을 지원하는지 여부를 나타냅니다.
이 값을 설정 1하면 네임스페이스는 보호 정보 유형 1을 지원합니다. 이 값이 지워 0지면 네임스페이스는 보호 정보 유형 1을 지원하지 않습니다.
DPC.ProtectionInfoType2
DPC 구조의 비트 1은 네임스페이스가 보호 정보 유형 2를 지원하는지 여부를 나타냅니다.
이 값을 설정 1하면 네임스페이스는 보호 정보 유형 2를 지원합니다. 이 값이 지워 0지면 네임스페이스는 보호 정보 유형 2를 지원하지 않습니다.
DPC.ProtectionInfoType3
DPC 구조의 비트 2는 네임스페이스가 보호 정보 유형 3을 지원하는지 여부를 나타냅니다.
이 값을 설정 1하면 네임스페이스는 보호 정보 유형 3을 지원합니다. 이 값이 지워 0지면 네임스페이스는 보호 정보 유형 3을 지원하지 않습니다.
DPC.InfoAtBeginningOfMetadata
DPC 구조의 비트 3은 네임스페이스가 처음 8바이트의 메타데이터로 전송된 보호 정보를 지원하는지 여부를 나타냅니다.
이 값을 설정 1하면 네임스페이스는 처음 8바이트의 메타데이터로 전송되는 보호 정보를 지원합니다. 이 값이 지워 0지면 네임스페이스는 메타데이터의 처음 8바이트로 전송된 보호 정보를 지원하지 않습니다.
DPC.InfoAtEndOfMetadata
DPC 구조의 비트 4는 네임스페이스가 메타데이터의 마지막 8바이트로 전송된 보호 정보를 지원하는지 여부를 나타냅니다.
이 값을 설정 1하면 네임스페이스는 메타데이터의 마지막 8바이트로 전송된 보호 정보를 지원합니다. 이 값이 지워 0지면 네임스페이스는 메타데이터의 마지막 8바이트로 전송된 보호 정보를 지원하지 않습니다.
DPC.Reserved
DPC 구조의 비트 7:5가 예약되어 있습니다.
DPS
엔드 투 엔드 데이터 보호 기능에 대한 형식 설정을 나타내는 필드를 포함하는 엔드 투 엔드 DPS(데이터 보호 형식 설정) 구조체입니다.
NVME_PROTECTION_INFORMATION_TYPES
DPS.ProtectionInfoTypeEnabled
DPS 구조의 비트 2:0은 보호 정보가 활성화되었는지 여부와 보호 정보의 유형을 나타내는 NVME_PROTECTION_INFORMATION_TYPES 값입니다.
DPS.InfoAtBeginningOfMetadata
DPS 구조의 비트 3은 보호 정보가 활성화된 경우 처음 8바이트의 메타데이터로 전송되는지 여부를 나타냅니다.
이 값을 설정 1하면 보호 정보가 활성화된 경우 처음 8바이트의 메타데이터로 전송됩니다. 이 값이 지워 0지면 보호 정보가 활성화된 경우 메타데이터의 마지막 8바이트로 전송됩니다.
DPS.Reserved
DPS 구조의 비트 7:4가 예약되어 있습니다.
NMIC
네임스페이스의 다중 경로 I/O 및 네임스페이스 공유 기능을 지정하는 필드를 포함하는 네임스페이스 다중 경로 I/O 및 NMIC(네임스페이스 공유 기능) 구조체입니다.
NMIC.SharedNameSpace
NMIC 구조의 비트 0은 네임스페이스가 공유 네임스페이스일 수 있는지 여부를 나타냅니다.
이 값을 설정 1하면 NVM 하위 시스템의 두 개 이상의 컨트롤러가 네임스페이스에 액세스할 수 있습니다. 이 값이 지워 0지면 네임스페이스는 프라이빗 네임스페이스이며 이 네임스페이스 데이터 구조를 반환한 컨트롤러에서만 액세스할 수 있습니다.
NMIC.Reserved
NMIC 구조의 비트 7:1은 예약되어 있습니다.
RESCAP
네임스페이스의 예약 기능을 지정하는 필드를 포함하는 RESCAP(예약 기능) 구조체입니다.
이 필드의 00h 값은 예약이 이 네임스페이스에서 지원되지 않음을 나타냅니다.
FPI
서식 작업이 진행 중일 때 서식이 지정되어야 하는 네임스페이스의 백분율을 나타내는 필드가 포함된 FPI(서식 진행률 표시기) 구조체입니다.
FPI.PercentageRemained
FPI 구조의 비트 0:6은 형식이 유지되는 네임스페이스의 백분율을 나타냅니다. 예를 들어 값은 25 네임스페이스의 75개% 형식이 지정되었고 25개의% 형식으로 유지됨을 나타냅니다.
값 0 은 네임스페이스가 이 데이터 구조의 FLBAS 및 DPS 필드에 지정된 형식으로 서식이 지정되었음을 나타냅니다.
FPI.Supported
FPI 구조의 비트 7은 네임스페이스가 FPI에서 정의한 서식 진행률 표시기를 지원하는지 여부를 나타냅니다. PercentageRemained 필드입니다.
이 값을 설정 1하면 네임스페이스는 FPI에서 정의한 서식 진행률 표시기를 지원합니다 . PercentageRemained 필드입니다. 이 값이 지워 0지면 네임스페이스는 서식 진행률 표시기 및 FPI를 지원하지 않습니다 . PercentageRemained 필드는 으로 지워 0h질 것입니다.
DLFEAT
DLFEAT.ReadBehavior
DLFEAT.WriteZeroes
DLFEAT.GuardFieldWithCRC
DLFEAT.Reserved
NAWUN
일반 작업 중에 NVM에 원자성으로 기록되도록 보장되는 쓰기 작업의 네임스페이스 특정 크기를 나타냅니다.
값 0h 은 이 네임스페이스의 크기가 컨트롤러 식별 데이터 구조의 AWUN 필드에 보고된 크기와 동일하다는 것을 나타냅니다. 다른 모든 값은 AWUN 필드와 동일한 인코딩을 사용하는 논리 블록 측면에서 크기를 지정합니다.
NAWUPF
전원 장애 또는 오류 조건 중에 NVM에 원자성으로 기록되도록 보장되는 쓰기 작업의 네임스페이스 특정 크기를 나타냅니다.
값 0h 은 이 네임스페이스의 크기가 컨트롤러 식별 데이터 구조의 AWUPF 필드에 보고된 크기와 동일하다는 것을 나타냅니다. 다른 모든 값은 AWUPF 필드와 동일한 인코딩을 사용하여 논리 블록 측면에서 크기를 지정합니다.
NACWU
비교 및 쓰기 융합 명령에 대해 NVM에 원자성으로 쓰도록 보장되는 쓰기 작업의 네임스페이스 특정 크기를 나타냅니다.
값 0h 은 이 네임스페이스의 크기가 컨트롤러 식별 데이터 구조의 ACWU 필드에 보고된 크기와 동일하다는 것을 나타냅니다. 다른 모든 값은 ACWU 필드와 동일한 인코딩을 사용하는 논리 블록 측면에서 크기를 지정합니다.
NABSN
NAWUN 값에 대한 이 네임스페이스의 원자성 경계 크기를 나타냅니다.
이 필드는 논리 블록에 지정됩니다. 원자성 경계를 넘어 다른 읽기 또는 쓰기 명령과 관련하여 NVM에 원자성으로 보장되지 않는 이 네임스페이스에 씁니다.
값은 0h 일반 쓰기 작업에 대한 원자성 경계가 없음을 나타냅니다. 다른 모든 값은 AWUN 필드와 동일한 인코딩을 사용하는 논리 블록 측면에서 크기를 지정합니다.
NABO
첫 번째 원자성 경계가 시작되는 이 네임스페이스의 LBA(논리 블록 주소)를 나타냅니다.
NABSN 및 NABSPF 필드가 지워0h지면 NABO 필드가 0h로 지워집니다.
NABO의 값은 NABSN 및 NABSPF보다 작거나 같아야 합니다.
NABSPF
네임스페이스 Atomic Write Unit Power Fail 값과 관련된 이 네임스페이스의 원자성 경계 크기를 나타냅니다.
이 필드는 논리 블록에 지정됩니다. 원자성 경계를 넘나드는 이 네임스페이스에 대한 쓰기는 다른 읽기 또는 쓰기 명령과 관련하여 원자성으로 보장되지 않으며 연결된 논리 블록의 후속 읽기에서 반환되는 데이터가 보장되지 않습니다.
값은 0h 전원 장애 또는 오류 조건에 대한 원자성 경계가 없음을 나타냅니다. 다른 모든 값은 AWUPF 필드와 동일한 인코딩을 사용하여 논리 블록 측면에서 크기를 지정합니다.
NOIOB
NOIOB(네임스페이스 최적 IO 경계)을 나타냅니다.
NVMCAP[16]
이 네임스페이스에 할당된 NVM의 총 크기를 나타냅니다.
이 필드의 값은 바이트 단위입니다. 네임스페이스 관리 및 네임스페이스 첨부 파일 명령이 지원되는 경우 이 필드가 지원됩니다.
참고: 이 필드는 NSZE(네임스페이스 크기) 필드를 곱한 논리 블록 크기에 해당하지 않을 수 있습니다. 씬 프로비저닝 또는 기타 설정(예: 지구력)으로 인해 이 필드는 보고된 NSZE 보다 크거나 작을 수 있습니다.
NPWG
NPWA
NPDG
NPDA
NOWS
MSSRL
MCL
MSRC
Reserved2[11]
예약 필드입니다.
ANAGRPID
Reserved3[3]
바이트 192:383A는 예약되어 있습니다.
NSATTR
NSATTR.WriteProtected
NSATTR.Reserved
NVMSETID
연결된 NVM SET 식별자(NVMSETID)를 나타냅니다.
ENDGID
ENDGID(연결된 지구력 그룹 식별자)를 나타냅니다.
NGUID[16]
네임스페이스를 만들 때 전역적으로 고유하고 네임스페이스에 할당된 128비트 값을 포함합니다.
네임스페이스 NGUID(Globally Unique Identifier) 필드는 네임스페이스의 수명 동안 고정된 상태로 유지되며 네임스페이스 및 컨트롤러 작업(예: 컨트롤러 재설정 및 네임스페이스 형식)에서 유지됩니다.
이 필드는 EUI-64 기반 16 바이트 지정자 형식을 사용합니다.
- 바이트 114:112에는 IEEE 등록 기관에서 할당한 24비트 company_id 값이 포함됩니다.
- 바이트 119:115에는 해당 조직에서 할당한 확장 identifer가 포함되어 있습니다.
- 바이트 111:104에는 해당 조직에서 할당한 공급업체별 확장 식별자가 포함됩니다.
자세한 내용은 IEEE EUI-64 지침을 참조하세요. 컨트롤러는 네임스페이스를 만들 때 이 필드에 전역적으로 고유한 네임스페이스 식별자 또는 EUI64 필드를 지정해야 합니다.
EUI64[8]
네임스페이스를 만들 때 전역적으로 고유하고 네임스페이스에 할당되는 64비트 IEEE EUI-64(확장 고유 식별자)를 포함합니다.
EUI64 필드는 네임스페이스의 수명 동안 고정된 상태로 유지되며 네임스페이스 및 컨트롤러 작업(예: 컨트롤러 재설정 및 네임스페이스 형식)에서 유지됩니다.
EUI-64는 IEEE 등록 기관에서 할당한 24비트 또는 36비트 company_id 값과 해당 조직에서 할당한 확장 식별자의 연결입니다. 자세한 내용은 IEEE EUI-64 지침을 참조하세요.
컨트롤러는 네임스페이스를 만들 때 이 필드 또는 NGUID 필드에 전역적으로 고유한 네임스페이스 식별자를 지정해야 합니다. 컨트롤러가 전역적으로 고유한 64비트 식별자를 할당할 수 없는 경우 이 필드는 지워집니다 0h.
LBAF[16]
16개의 NVME_LBA_FORMAT 구조체 배열을 포함합니다. 배열의 각 구조체는 LBA 형식을 지정하고 컨트롤러에서 지원됨을 나타냅니다.
배열에서 구조체의 0부터 시작하는 위치는 LBA 형식의 이름에 해당합니다. 즉, LBA 형식 0(LBAF0)은 위치 0, LBA 형식 1(LBAF1)은 위치 1, 위치 15의 LBA 형식 15(LBAF15)까지입니다.
Reserved4[192]
VS[3712]
이 바이트 범위(384:4095)는 VS(공급업체별) 사용에 할당됩니다.
요구 사항
| 요구 사항 | 가치 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 10 |
| Header | nvme.h |