tools/testing/selftests/ublk/test_integrity_01.sh

File Facts

System

Linux kernel

Corpus path

tools/testing/selftests/ublk/test_integrity_01.sh

Extension

.sh

Size

3954 bytes

Lines

106

Domain

Support Tooling And Documentation

Bucket

tools

Inferred role

Support Tooling And Documentation: tools

Status

atlas-only

Why This File Exists

Repository support layer: documentation, build tooling, samples, user-space helper tools, generated initramfs support, licenses, and validation utilities.

• Repository support layer: documentation, build tooling, samples, user-space helper tools, generated initramfs support, licenses, and validation utilities.

Dependency Surface

• No C-style include directives detected by the generator.

Detected Declarations

• No top-level syscall, struct, function, initcall, or export declaration detected by the generator.

Annotated Snippet

#!/bin/bash
# SPDX-License-Identifier: GPL-2.0

. "$(cd "$(dirname "$0")" && pwd)"/test_common.sh

ERR_CODE=0

_check_value() {
	local name=$1
	local actual=$2
	local expected=$3

	if [ "$actual" != "$expected" ]; then
		echo "$name $actual != $expected"
		ERR_CODE=255
		return 1
	fi
	return 0
}

_test_metadata_only() {
	local dev_id

	dev_id=$(_add_ublk_dev -t null -u --no_auto_part_scan --metadata_size 8)
	_check_add_dev "$TID" $?

	_check_value "metadata_size" "$(_get_metadata_size "$dev_id" metadata_size)" 8 &&
	_check_value "pi_offset" "$(_get_metadata_size "$dev_id" pi_offset)" 0 &&
	_check_value "pi_tuple_size" "$(_get_metadata_size "$dev_id" pi_tuple_size)" 0 &&
	_check_value "device_is_integrity_capable" \
		"$(cat "/sys/block/ublkb$dev_id/integrity/device_is_integrity_capable")" 0 &&
	_check_value "format" "$(cat "/sys/block/ublkb$dev_id/integrity/format")" nop &&
	_check_value "protection_interval_bytes" \
		"$(cat "/sys/block/ublkb$dev_id/integrity/protection_interval_bytes")" 512 &&
	_check_value "tag_size" "$(cat "/sys/block/ublkb$dev_id/integrity/tag_size")" 0

	_ublk_del_dev "${dev_id}"
}

_test_integrity_capable_ip() {
	local dev_id

	dev_id=$(_add_ublk_dev -t null -u --no_auto_part_scan --integrity_capable --metadata_size 64 --pi_offset 56 --csum_type ip)
	_check_add_dev "$TID" $?

	_check_value "metadata_size" "$(_get_metadata_size "$dev_id" metadata_size)" 64 &&
	_check_value "pi_offset" "$(_get_metadata_size "$dev_id" pi_offset)" 56 &&
	_check_value "pi_tuple_size" "$(_get_metadata_size "$dev_id" pi_tuple_size)" 8 &&
	_check_value "device_is_integrity_capable" \
		"$(cat "/sys/block/ublkb$dev_id/integrity/device_is_integrity_capable")" 1 &&
	_check_value "format" "$(cat "/sys/block/ublkb$dev_id/integrity/format")" T10-DIF-TYPE3-IP &&
	_check_value "protection_interval_bytes" \
		"$(cat "/sys/block/ublkb$dev_id/integrity/protection_interval_bytes")" 512 &&
	_check_value "tag_size" "$(cat "/sys/block/ublkb$dev_id/integrity/tag_size")" 0

	_ublk_del_dev "${dev_id}"
}

_test_integrity_reftag_t10dif() {
	local dev_id

	dev_id=$(_add_ublk_dev -t null -u --no_auto_part_scan --integrity_reftag --metadata_size 8 --csum_type t10dif)
	_check_add_dev "$TID" $?

	_check_value "metadata_size" "$(_get_metadata_size "$dev_id" metadata_size)" 8 &&
	_check_value "pi_offset" "$(_get_metadata_size "$dev_id" pi_offset)" 0 &&
	_check_value "pi_tuple_size" "$(_get_metadata_size "$dev_id" pi_tuple_size)" 8 &&
	_check_value "device_is_integrity_capable" \
		"$(cat "/sys/block/ublkb$dev_id/integrity/device_is_integrity_capable")" 0 &&
	_check_value "format" "$(cat "/sys/block/ublkb$dev_id/integrity/format")" T10-DIF-TYPE1-CRC &&

Annotation

• Atlas domain: Support Tooling And Documentation / tools.
• Implementation status: atlas-only.

Implementation Notes

• This generated page is the file-by-file coverage layer; curated subsystem chapters should link here when they synthesize a multi-file control flow.
• Core OS pages should be promoted from atlas-only to deep-reviewed when they explain data structures, invariants, locking, lifecycle, and C implementation snippets.
• Driver-family pages are intentionally pattern-oriented unless they are part of the selected PCIe/NVMe representative device path.