Peer Content Caching and Retrieval: Retrieval Protocol [MS-PCCRR]. More...

#include <stdint.h>

Data Structures
union	peerdist_msg_version
	Retrieval protocol version. More...
struct	peerdist_msg_versions
	Retrieval protocol supported versions. More...
struct	peerdist_msg_range
	Retrieval protocol block range. More...
struct	peerdist_msg_segment
	Retrieval protocol segment ID header. More...
struct	peerdist_msg_ranges
	Retrieval protocol block range list header. More...
struct	peerdist_msg_block
	Retrieval protocol data block header. More...
struct	peerdist_msg_iv
	Retrieval protocol initialisation vector header. More...
struct	peerdist_msg_useless_vrf
	Retrieval protocol useless VRF data header. More...
struct	peerdist_msg_header
	Retrieval protocol message header. More...
struct	peerdist_msg_transport_header
	Retrieval protocol transport response header. More...
struct	peerdist_msg_nego_req
	Retrieval protocol negotiation request. More...
struct	peerdist_msg_nego_resp
	Retrieval protocol negotiation response. More...
struct	peerdist_msg_getblklist
	Retrieval protocol block list request header. More...
struct	peerdist_msg_getblks
	Retrieval protocol block fetch request header. More...
struct	peerdist_msg_blklist
	Retrieval protocol block list response header. More...
struct	peerdist_msg_blk
	Retrieval protocol block fetch response header. More...
struct	peerdist_retrieval
	A retrieval protocol mechanism. More...

Macros
#define	PEERDIST_MAGIC_PATH "/116B50EB-ECE2-41ac-8429-9F9E963361B7/"
	Magic retrieval URI path.
#define	PEERDIST_MSG_VERSION_1_0 0x00000001UL
	Retrieval protocol version 1.0.
#define	PEERDIST_MSG_VERSION_2_0 0x00000002UL
	Retrieval protocol version 2.0.
#define	peerdist_msg_segment_t(digestsize)
	Retrieval protocol segment ID.
#define	peerdist_msg_ranges_t(count)
	Retrieval protocol block range list.
#define	peerdist_msg_block_t(len)
	Retrieval protocol data block.
#define	peerdist_msg_iv_t(blksize)
	Retrieval protocol initialisation vector.
#define	peerdist_msg_useless_vrf_t(vrf_len)
	Retrieval protocol useless VRF data.
#define	PEERDIST_MSG_NEGO_REQ_VERSION PEERDIST_MSG_VERSION_1_0
	Retrieval protocol negotiation request version.
#define	PEERDIST_MSG_NEGO_REQ_TYPE 0x00000000UL
	Retrieval protocol negotiation request type.
#define	PEERDIST_MSG_NEGO_RESP_VERSION PEERDIST_MSG_VERSION_1_0
	Retrieval protocol negotiation response version.
#define	PEERDIST_MSG_NEGO_RESP_TYPE 0x00000001UL
	Retrieval protocol negotiation response type.
#define	peerdist_msg_getblklist_t(digestsize, count)
	Retrieval protocol block list request.
#define	PEERDIST_MSG_GETBLKLIST_VERSION PEERDIST_MSG_VERSION_1_0
	Retrieval protocol block list request version.
#define	PEERDIST_MSG_GETBLKLIST_TYPE 0x00000002UL
	Retrieval protocol block list request type.
#define	peerdist_msg_getblks_t(digestsize, count, vrf_len)
	Retrieval protocol block fetch request.
#define	PEERDIST_MSG_GETBLKS_VERSION PEERDIST_MSG_VERSION_1_0
	Retrieval protocol block fetch request version.
#define	PEERDIST_MSG_GETBLKS_TYPE 0x00000003UL
	Retrieval protocol block fetch request type.
#define	peerdist_msg_blklist_t(digestsize, count)
	Retrieval protocol block list response.
#define	PEERDIST_MSG_BLKLIST_VERSION PEERDIST_MSG_VERSION_1_0
	Retrieval protocol block list response version.
#define	PEERDIST_MSG_BLKLIST_TYPE 0x00000004UL
	Retrieval protocol block list response type.
#define	peerdist_msg_blk_t(digestsize, len, vrf_len, blksize)
	Retrieval protocol block fetch response.
#define	PEERDIST_MSG_BLK_VERSION PEERDIST_MSG_VERSION_1_0
	Retrieval protocol block fetch response version.
#define	PEERDIST_MSG_BLK_TYPE 0x00000005UL
	Retrieval protocol block fetch response type.

Enumerations
enum	peerdist_msg_algorithm { PEERDIST_MSG_PLAINTEXT = 0x00000000UL , PEERDIST_MSG_AES_128_CBC = 0x00000001UL , PEERDIST_MSG_AES_192_CBC = 0x00000002UL , PEERDIST_MSG_AES_256_CBC = 0x00000003UL }
	Retrieval protocol cryptographic algorithm IDs. More...

Functions
	FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)
	FILE_SECBOOT (PERMITTED)
union peerdist_msg_version	__attribute__ ((packed))
	Major:minor version number.

Variables
uint16_t	minor
	Minor version number.
uint16_t	major
	Major version number.
uint32_t	raw
	Raw version number.
union peerdist_msg_version	min
	Minimum supported protocol version.
union peerdist_msg_version	max
	Maximum supported protocol version.
uint32_t	first
	First block in range.
uint32_t	count
	Number of blocks in range.
uint32_t	digestsize
	Digest size (i.e.
uint32_t	len
	Length of data block.
uint32_t	blksize
	Cipher block size.
union peerdist_msg_version	version
	Protocol version.
uint32_t	type
	Message type.
uint32_t	algorithm
	Cryptographic algorithm ID.
enum peerdist_msg_algorithm	__attribute__
struct peerdist_msg_header	hdr
	Message header.
struct peerdist_msg_versions	versions
	Supported versions.
struct peerdist_retrieval	peerdist_post
	PeerDist retrieval protocol using HTTP POST.
struct peerdist_retrieval	peerdist_get
	PeerDist retrieval protocol using HTTP GET or local file.

Detailed Description

Peer Content Caching and Retrieval: Retrieval Protocol [MS-PCCRR].

All fields are in network byte order.

Definition in file pccrr.h.

Macro Definition Documentation

◆ PEERDIST_MAGIC_PATH

#define PEERDIST_MAGIC_PATH "/116B50EB-ECE2-41ac-8429-9F9E963361B7/"

Magic retrieval URI path.

Definition at line 20 of file pccrr.h.

Referenced by peerdist_open_post().

◆ PEERDIST_MSG_VERSION_1_0

#define PEERDIST_MSG_VERSION_1_0 0x00000001UL

Retrieval protocol version 1.0.

Definition at line 36 of file pccrr.h.

◆ PEERDIST_MSG_VERSION_2_0

#define PEERDIST_MSG_VERSION_2_0 0x00000002UL

Retrieval protocol version 2.0.

Definition at line 39 of file pccrr.h.

◆ peerdist_msg_segment_t

#define peerdist_msg_segment_t ( digestsize )

Value:

struct {                                                        \
        struct peerdist_msg_segment segment;                    \
        uint8_t id[digestsize];                                 \
        uint8_t pad[ ( -(digestsize) ) & 0x3 ];                 \
} __attribute__ (( packed ))

Retrieval protocol segment ID.

Parameters

digestsize Digest size

Definition at line 72 of file pccrr.h.

#define peerdist_msg_segment_t( digestsize )                            \
        struct {                                                        \
                struct peerdist_msg_segment segment;                    \
                uint8_t id[digestsize];                                 \
                uint8_t pad[ ( -(digestsize) ) & 0x3 ];                 \
        } __attribute__ (( packed ))

◆ peerdist_msg_ranges_t

#define peerdist_msg_ranges_t ( count )

Value:

struct {                                                        \
        struct peerdist_msg_ranges ranges;                      \
        struct peerdist_msg_range range[count];                 \
} __attribute__ (( packed ))

Retrieval protocol block range list.

Parameters

count Number of ranges

Definition at line 93 of file pccrr.h.

#define peerdist_msg_ranges_t( count )                                  \
        struct {                                                        \
                struct peerdist_msg_ranges ranges;                      \
                struct peerdist_msg_range range[count];                 \
        } __attribute__ (( packed ))

◆ peerdist_msg_block_t

#define peerdist_msg_block_t ( len )

Value:

struct {                                                        \
        struct peerdist_msg_block block;                        \
        uint8_t data[len];                                      \
} __attribute__ (( packed ))

Retrieval protocol data block.

Definition at line 110 of file pccrr.h.

#define peerdist_msg_block_t( len )                                     \
        struct {                                                        \
                struct peerdist_msg_block block;                        \
                uint8_t data[len];                                      \
        } __attribute__ (( packed ))

◆ peerdist_msg_iv_t

#define peerdist_msg_iv_t ( blksize )

Value:

struct {                                                        \
        struct peerdist_msg_iv iv;                              \
        uint8_t data[blksize];                                  \
} __attribute__ (( packed ))

Retrieval protocol initialisation vector.

Definition at line 127 of file pccrr.h.

#define peerdist_msg_iv_t( blksize )                                    \
        struct {                                                        \
                struct peerdist_msg_iv iv;                              \
                uint8_t data[blksize];                                  \
        } __attribute__ (( packed ))

◆ peerdist_msg_useless_vrf_t

#define peerdist_msg_useless_vrf_t ( vrf_len )

Value:

struct {                                                        \
        struct peerdist_msg_useless_vrf vrf;                    \
        uint8_t data[vrf_len];                                  \
        uint8_t pad[ ( -(vrf_len) ) & 0x3 ];                    \
} __attribute__ (( packed ))

Retrieval protocol useless VRF data.

Definition at line 146 of file pccrr.h.

#define peerdist_msg_useless_vrf_t( vrf_len )                           \
        struct {                                                        \
                struct peerdist_msg_useless_vrf vrf;                    \
                uint8_t data[vrf_len];                                  \
                uint8_t pad[ ( -(vrf_len) ) & 0x3 ];                    \
        } __attribute__ (( packed ))

◆ PEERDIST_MSG_NEGO_REQ_VERSION

#define PEERDIST_MSG_NEGO_REQ_VERSION PEERDIST_MSG_VERSION_1_0

Retrieval protocol negotiation request version.

Definition at line 201 of file pccrr.h.

◆ PEERDIST_MSG_NEGO_REQ_TYPE

#define PEERDIST_MSG_NEGO_REQ_TYPE 0x00000000UL

Retrieval protocol negotiation request type.

Definition at line 204 of file pccrr.h.

◆ PEERDIST_MSG_NEGO_RESP_VERSION

#define PEERDIST_MSG_NEGO_RESP_VERSION PEERDIST_MSG_VERSION_1_0

Retrieval protocol negotiation response version.

Definition at line 215 of file pccrr.h.

◆ PEERDIST_MSG_NEGO_RESP_TYPE

#define PEERDIST_MSG_NEGO_RESP_TYPE 0x00000001UL

Retrieval protocol negotiation response type.

Definition at line 218 of file pccrr.h.

◆ peerdist_msg_getblklist_t

#define peerdist_msg_getblklist_t	(		digestsize,
			count )

Value:

struct {                                                        \
        struct peerdist_msg_getblklist getblklist;              \
        peerdist_msg_segment_t ( digestsize ) segment;          \
        peerdist_msg_ranges_t ( count ) ranges;                 \
} __attribute__ (( packed ))

Retrieval protocol block list request.

Parameters

digestsize	Digest size
count	Block range count

Definition at line 236 of file pccrr.h.

#define peerdist_msg_getblklist_t( digestsize, count )                  \
        struct {                                                        \
                struct peerdist_msg_getblklist getblklist;              \
                peerdist_msg_segment_t ( digestsize ) segment;          \
                peerdist_msg_ranges_t ( count ) ranges;                 \
        } __attribute__ (( packed ))

◆ PEERDIST_MSG_GETBLKLIST_VERSION

#define PEERDIST_MSG_GETBLKLIST_VERSION PEERDIST_MSG_VERSION_1_0

Retrieval protocol block list request version.

Definition at line 244 of file pccrr.h.

◆ PEERDIST_MSG_GETBLKLIST_TYPE

#define PEERDIST_MSG_GETBLKLIST_TYPE 0x00000002UL

Retrieval protocol block list request type.

Definition at line 247 of file pccrr.h.

◆ peerdist_msg_getblks_t

#define peerdist_msg_getblks_t	(	digestsize,
		count,
		vrf_len )

Value:

struct {                                                        \
        struct peerdist_msg_getblks getblks;                    \
        peerdist_msg_segment_t ( digestsize ) segment;          \
        peerdist_msg_ranges_t ( count ) ranges;                 \
        peerdist_msg_useless_vrf_t ( vrf_len );                 \
} __attribute__ (( packed ))

Retrieval protocol block fetch request.

Parameters

digestsize	Digest size
count	Block range count
vrf_len	Length of uselessness

Definition at line 268 of file pccrr.h.

#define peerdist_msg_getblks_t( digestsize, count, vrf_len )            \
        struct {                                                        \
                struct peerdist_msg_getblks getblks;                    \
                peerdist_msg_segment_t ( digestsize ) segment;          \
                peerdist_msg_ranges_t ( count ) ranges;                 \
                peerdist_msg_useless_vrf_t ( vrf_len );                 \
        } __attribute__ (( packed ))

Referenced by peerdist_open_post().

◆ PEERDIST_MSG_GETBLKS_VERSION

#define PEERDIST_MSG_GETBLKS_VERSION PEERDIST_MSG_VERSION_1_0

Retrieval protocol block fetch request version.

Definition at line 277 of file pccrr.h.

Referenced by peerdist_open_post().

◆ PEERDIST_MSG_GETBLKS_TYPE

#define PEERDIST_MSG_GETBLKS_TYPE 0x00000003UL

Retrieval protocol block fetch request type.

Definition at line 280 of file pccrr.h.

Referenced by peerdist_open_post().

◆ peerdist_msg_blklist_t

#define peerdist_msg_blklist_t	(		digestsize,
			count )

Value:

struct {                                                        \
        struct peerdist_msg_blklist blklist;                    \
        peerdist_msg_segment_t ( digestsize ) segment;          \
        peerdist_msg_ranges_t ( count ) ranges;                 \
        uint32_t next;                                          \
} __attribute__ (( packed ))

Retrieval protocol block list response.

Parameters

digestsize	Digest size
count	Block range count

Definition at line 300 of file pccrr.h.

#define peerdist_msg_blklist_t( digestsize, count )                     \
        struct {                                                        \
                struct peerdist_msg_blklist blklist;                    \
                peerdist_msg_segment_t ( digestsize ) segment;          \
                peerdist_msg_ranges_t ( count ) ranges;                 \
                uint32_t next;                                          \
        } __attribute__ (( packed ))

◆ PEERDIST_MSG_BLKLIST_VERSION

#define PEERDIST_MSG_BLKLIST_VERSION PEERDIST_MSG_VERSION_1_0

Retrieval protocol block list response version.

Definition at line 309 of file pccrr.h.

◆ PEERDIST_MSG_BLKLIST_TYPE

#define PEERDIST_MSG_BLKLIST_TYPE 0x00000004UL

Retrieval protocol block list response type.

Definition at line 312 of file pccrr.h.

◆ peerdist_msg_blk_t

#define peerdist_msg_blk_t	(	digestsize,
		len,
		vrf_len,
		blksize )

Value:

struct {                                                        \
        struct peerdist_msg_blk blk;                            \
        peerdist_msg_segment_t ( digestsize ) segment;          \
        uint32_t index;                                         \
        uint32_t next;                                          \
        peerdist_msg_block_t ( len ) block;                     \
        peerdist_msg_useless_vrf_t ( vrf_len ) vrf;             \
        peerdist_msg_iv_t ( blksize ) iv;                       \
} __attribute__ (( packed ))

Retrieval protocol block fetch response.

Parameters

digestsize	Digest size
len	Data block length
vrf_len	Length of uselessness
blksize	Cipher block size

Definition at line 338 of file pccrr.h.

#define peerdist_msg_blk_t( digestsize, len, vrf_len, blksize )         \
        struct {                                                        \
                struct peerdist_msg_blk blk;                            \
                peerdist_msg_segment_t ( digestsize ) segment;          \
                uint32_t index;                                         \
                uint32_t next;                                          \
                peerdist_msg_block_t ( len ) block;                     \
                peerdist_msg_useless_vrf_t ( vrf_len ) vrf;             \
                peerdist_msg_iv_t ( blksize ) iv;                       \
        } __attribute__ (( packed ))

◆ PEERDIST_MSG_BLK_VERSION

#define PEERDIST_MSG_BLK_VERSION PEERDIST_MSG_VERSION_1_0

Retrieval protocol block fetch response version.

Definition at line 350 of file pccrr.h.

◆ PEERDIST_MSG_BLK_TYPE

#define PEERDIST_MSG_BLK_TYPE 0x00000005UL

Retrieval protocol block fetch response type.

Definition at line 353 of file pccrr.h.

Referenced by peerblk_parse_header().

Enumeration Type Documentation

◆ peerdist_msg_algorithm

enum peerdist_msg_algorithm

Retrieval protocol cryptographic algorithm IDs.

Enumerator
PEERDIST_MSG_PLAINTEXT	No encryption.
PEERDIST_MSG_AES_128_CBC	AES-128 in CBC mode.
PEERDIST_MSG_AES_192_CBC	AES-192 in CBC mode.
PEERDIST_MSG_AES_256_CBC	AES-256 in CBC mode.

Definition at line 170 of file pccrr.h.

                            {
        /** No encryption */
        PEERDIST_MSG_PLAINTEXT = 0x00000000UL,
        /** AES-128 in CBC mode */
        PEERDIST_MSG_AES_128_CBC = 0x00000001UL,
        /** AES-192 in CBC mode */
        PEERDIST_MSG_AES_192_CBC = 0x00000002UL,
        /** AES-256 in CBC mode */
        PEERDIST_MSG_AES_256_CBC = 0x00000003UL,
};

Function Documentation

◆ FILE_LICENCE()

FILE_LICENCE ( GPL2_OR_LATER_OR_UBDL )

◆ FILE_SECBOOT()

FILE_SECBOOT ( PERMITTED )

◆ attribute()

union peerdist_msg_version __attribute__ ( (packed) )

Major:minor version number.

Variable Documentation

◆ minor

uint16_t minor

Minor version number.

Definition at line 1 of file pccrr.h.

◆ major

uint16_t major

Major version number.

Definition at line 3 of file pccrr.h.

◆ raw

uint32_t raw ( void )

Raw version number.

Definition at line 1 of file pccrr.h.

◆ min

union peerdist_msg_version min

Minimum supported protocol version.

Definition at line 1 of file pccrr.h.

◆ max

union peerdist_msg_version max

Maximum supported protocol version.

Definition at line 3 of file pccrr.h.

◆ first

uint32_t first

First block in range.

Definition at line 1 of file pccrr.h.

Referenced by bigint_swap_okx(), bigint_swap_sample(), dns_compare(), draw_editbox(), efi_paths(), inline_list_cut_position(), inline_list_splice(), inline_list_splice_tail(), ioremap_pages(), iounmap_pages(), memcmp(), memmove(), memswap(), pcicloud_api(), pcicloud_find(), peerdist_info_v1(), strcasecmp(), strcmp(), strncasecmp(), strncmp(), tls_new_ciphertext(), uhci_restart(), uristrcmp(), usb_describe(), usb_interface_association_descriptor(), usb_probe_all(), usb_score(), usbio_interfaces(), vmbus_consume(), vmbus_dump_channel(), vmbus_produce(), and x509_chain_okx().

◆ count

uint32_t count

Number of blocks in range.

Number of ranges.

Definition at line 3 of file pccrr.h.

◆ digestsize

uint32_t digestsize

Digest size (i.e.

length of segment ID)

Definition at line 1 of file pccrr.h.

Referenced by dummy_hash(), hkdf_expand(), hkdf_okx(), mdhash_final(), mdhash_init(), mdhash_update(), peerblk_open(), peerblk_parse_block(), peerblk_parse_iv(), peerblk_parse_useless(), peerblk_retrieval_open(), peerdist_info_block_okx(), peerdist_info_hash_ntoa(), peerdist_info_passphrase_okx(), peerdist_info_segment_hash(), peerdist_info_segment_okx(), peerdist_info_v1_block(), peerdist_info_v1_block_offset(), peerdist_info_v1_segment(), peerdist_info_v2_block(), peerdist_info_v2_cursor_next(), peerdist_info_v2_segment(), peerdist_open_get(), peerdist_open_post(), rfc8448_hrr_test(), rfc8448_resumed_test(), rfc8448_simple_test(), tlskey_bind(), tlskey_digest(), tlskey_finished(), tlskey_hash_expand(), tlskey_hash_master(), tlskey_hash_verify(), tlskey_hkdf_apply(), tlskey_hkdf_bind(), tlskey_hkdf_cipher(), tlskey_hkdf_finished(), tlskey_hkdf_load(), tlskey_hkdf_master(), tlskey_hkdf_reset(), tlskey_hkdf_save(), tlskey_hkdf_secretsize(), tlskey_hkdf_traffic(), tlskey_hkdf_verify(), tlskey_message(), and tlskey_start().

◆ len

uint32_t len

Length of data block.

Length (excluding this header).

Message size (including this header).

Length of useless VRF data.

This seems to be identical in both purpose and value to the length found within the message header, and therefore serves no useful purpose.

Definition at line 1 of file pccrr.h.

◆ blksize

uint32_t blksize

Cipher block size.

Definition at line 1 of file pccrr.h.

Referenced by disklog_init(), efi_null_pxe_mtftp(), efi_pxe_mtftp(), peerblk_parse_iv(), pxe_tftp_open(), sandev_parse_iso9660(), and tftp_send_rrq().

◆ version

union peerdist_msg_version version

Protocol version.

This is the protocol version in which the message type was first defined.

Definition at line 5 of file pccrr.h.

◆ type

uint32_t type

Message type.

Definition at line 7 of file pccrr.h.

◆ algorithm

uint32_t algorithm

Cryptographic algorithm ID.

Definition at line 11 of file pccrr.h.

◆ hdr

struct peerdist_msg_header hdr

Message header.

Definition at line 1 of file pccrr.h.

◆ versions

struct peerdist_msg_versions versions

Supported versions.

Definition at line 3 of file pccrr.h.

◆ peerdist_post

struct peerdist_retrieval peerdist_post

extern

PeerDist retrieval protocol using HTTP POST.

Definition at line 143 of file pccrr.c.

                                        {
        .name = "POST",
        .open = peerdist_open_post,
};

Referenced by peerdisc_create(), and peerdisc_socket_rx().

◆ peerdist_get

struct peerdist_retrieval peerdist_get

extern

PeerDist retrieval protocol using HTTP GET or local file.

Definition at line 190 of file pccrr.c.

                                       {
        .name = "GET",
        .open = peerdist_open_get,
};

Referenced by peerdisc_create().

Data Structures

Macros

Enumerations

Functions

Variables

Detailed Description

Macro Definition Documentation

◆ PEERDIST_MAGIC_PATH

◆ PEERDIST_MSG_VERSION_1_0

◆ PEERDIST_MSG_VERSION_2_0

◆ peerdist_msg_segment_t

◆ peerdist_msg_ranges_t

◆ peerdist_msg_block_t

◆ peerdist_msg_iv_t

◆ peerdist_msg_useless_vrf_t

◆ PEERDIST_MSG_NEGO_REQ_VERSION

◆ PEERDIST_MSG_NEGO_REQ_TYPE

◆ PEERDIST_MSG_NEGO_RESP_VERSION

◆ PEERDIST_MSG_NEGO_RESP_TYPE

◆ peerdist_msg_getblklist_t

◆ PEERDIST_MSG_GETBLKLIST_VERSION

◆ PEERDIST_MSG_GETBLKLIST_TYPE

◆ peerdist_msg_getblks_t

◆ PEERDIST_MSG_GETBLKS_VERSION

◆ PEERDIST_MSG_GETBLKS_TYPE

◆ peerdist_msg_blklist_t

◆ PEERDIST_MSG_BLKLIST_VERSION

◆ PEERDIST_MSG_BLKLIST_TYPE

◆ peerdist_msg_blk_t

◆ PEERDIST_MSG_BLK_VERSION

◆ PEERDIST_MSG_BLK_TYPE

Enumeration Type Documentation

◆ peerdist_msg_algorithm

Function Documentation

◆ FILE_LICENCE()

◆ FILE_SECBOOT()

◆ __attribute__()

Variable Documentation

◆ minor

◆ major

◆ raw

◆ min

◆ max

◆ first

◆ count

◆ digestsize

◆ len

◆ blksize

◆ version

◆ type

◆ algorithm

◆ hdr

◆ versions

◆ peerdist_post

◆ peerdist_get

◆ attribute()