Contributors: 8
Author Tokens Token Proportion Commits Commit Proportion
Keith Busch 62 28.70% 2 15.38%
Max Gurtovoy 42 19.44% 1 7.69%
Martin K. Petersen 41 18.98% 3 23.08%
Christoph Hellwig 24 11.11% 3 23.08%
Anuj Gupta 21 9.72% 1 7.69%
Caleb Sander 17 7.87% 1 7.69%
Dmitriy Monakhov 8 3.70% 1 7.69%
Greg Kroah-Hartman 1 0.46% 1 7.69%
Total 216 13 


/* SPDX-License-Identifier: GPL-2.0 */
#ifndef _LINUX_T10_PI_H
#define _LINUX_T10_PI_H

#include <linux/types.h>
#include <linux/blk-mq.h>
#include <linux/wordpart.h>

/*
 * A T10 PI-capable target device can be formatted with different
 * protection schemes.	Currently 0 through 3 are defined:
 *
 * Type 0 is regular (unprotected) I/O
 *
 * Type 1 defines the contents of the guard and reference tags
 *
 * Type 2 defines the contents of the guard and reference tags and
 * uses 32-byte commands to seed the latter
 *
 * Type 3 defines the contents of the guard tag only
 */
enum t10_dif_type {
	T10_PI_TYPE0_PROTECTION = 0x0,
	T10_PI_TYPE1_PROTECTION = 0x1,
	T10_PI_TYPE2_PROTECTION = 0x2,
	T10_PI_TYPE3_PROTECTION = 0x3,
};

static inline u64 full_pi_ref_tag(const struct request *rq)
{
	unsigned int shift = ilog2(queue_logical_block_size(rq->q));

	if (IS_ENABLED(CONFIG_BLK_DEV_INTEGRITY) &&
	    rq->q->limits.integrity.interval_exp)
		shift = rq->q->limits.integrity.interval_exp;
	return blk_rq_pos(rq) >> (shift - SECTOR_SHIFT);
}

/*
 * T10 Protection Information tuple.
 */
struct t10_pi_tuple {
	__be16 guard_tag;	/* Checksum */
	__be16 app_tag;		/* Opaque storage */
	__be32 ref_tag;		/* Target LBA or indirect LBA */
};

#define T10_PI_APP_ESCAPE cpu_to_be16(0xffff)
#define T10_PI_REF_ESCAPE cpu_to_be32(0xffffffff)

static inline u32 t10_pi_ref_tag(struct request *rq)
{
	return lower_32_bits(full_pi_ref_tag(rq));
}

struct crc64_pi_tuple {
	__be64 guard_tag;
	__be16 app_tag;
	__u8   ref_tag[6];
};

/**
 * lower_48_bits() - return bits 0-47 of a number
 * @n: the number we're accessing
 */
static inline u64 lower_48_bits(u64 n)
{
	return n & ((1ull << 48) - 1);
}

static inline u64 ext_pi_ref_tag(struct request *rq)
{
	return lower_48_bits(full_pi_ref_tag(rq));
}

#endif