Namespaces
	command_interest

	detail

	dns

	encoding

	ethernet

	exception

	io

	literals

	lp

	mgmt

	name

	net

	nfd

	random

	scheduler

	security

	signed_interest

	time

	tlv
	Namespace defining NDN Packet Format related constants and procedures.

	util

Classes
class	AsHex
	Helper class to convert a number to hexadecimal format, for use with stream insertion operators. More...

class	Block
	Represents a TLV element of NDN packet format. More...

class	Buffer
	General-purpose automatically managed/resized buffer. More...

class	ConfigFile
	System configuration file for NDN platform. More...

class	Data
	Represents a Data packet. More...

class	Delegation
	Represents a Delegation. More...

class	DelegationList
	represents a list of Delegations More...

class	DigestSha256
	Represents a signature of DigestSha256 type. More...

class	Face
	Provide a communication channel with local or remote NDN forwarder. More...

class	FaceUri
	represents the underlying protocol and address used by a Face More...

class	InMemoryStorage
	Represents in-memory storage. More...

class	InMemoryStorageEntry
	Represents an in-memory storage entry. More...

class	InMemoryStorageFifo
	Provides in-memory storage employing First-In-First-Out (FIFO) replacement policy. More...

class	InMemoryStorageLfu
	Provides an in-memory storage with Least Frequently Used (LFU) replacement policy. More...

class	InMemoryStorageLru
	Provides in-memory storage employing Least Recently Used (LRU) replacement policy. More...

class	InMemoryStoragePersistent
	Provides application cache with persistent storage, of which no replacement policy will be employed. More...

class	Interest
	Represents an Interest packet. More...

class	InterestFilter
	declares the set of Interests a producer can serve, which starts with a name prefix, plus an optional regular expression More...

class	InterestFilterHandle
	A handle of registered Interest filter. More...

class	KeyLocator

class	KeyParams
	Base class for key parameters. More...

class	Link
	represents a Link object More...

class	MetadataObject
	Class for RDR-style metadata encoding/decoding. More...

class	MetaInfo
	A MetaInfo holds the meta info which is signed inside the data packet. More...

class	Name
	Represents an absolute name. More...

class	NotificationStreamItem
	concept check for an item in a Notification Stream More...

class	OBufferStream
	implements an output stream that constructs `ndn::Buffer` More...

class	ostream_joiner

class	PacketBase
	base class to allow simple management of packet tags More...

class	PendingInterestHandle
	A handle of pending Interest. More...

class	PrefixAnnouncement
	A prefix announcement object that represents an application's intent of registering a prefix toward itself. More...

class	RegexBackrefManager

class	RegexBackrefMatcher

class	RegexComponentMatcher

class	RegexComponentSetMatcher

class	RegexMatcher

class	RegexPatternListMatcher

class	RegexPseudoMatcher

class	RegexRepeatMatcher

class	RegexTopMatcher

class	RegisteredPrefixHandle
	A handle of registered prefix. More...

class	Signature
	Holds SignatureInfo and SignatureValue in a Data packet. More...

class	SignatureInfo
	Represents a SignatureInfo TLV element. More...

class	SignatureSha256WithEcdsa
	Represents a signature of Sha256WithEcdsa type. More...

class	SignatureSha256WithRsa
	Represents a signature of Sha256WithRsa type. More...

class	SimplePublicKeyParams
	SimplePublicKeyParams is a template for public keys with only one parameter: size. More...

class	SimpleSymmetricKeyParams
	SimpleSymmetricKeyParams is a template for symmetric keys with only one parameter: size. More...

class	SimpleTag
	provides a tag type for simple types More...

class	StatusDatasetItem
	concept check for an item in a Status Dataset More...

class	StringHelperError

class	Tag
	Base class for packet tags that can hold any arbitrary information. More...

class	TagHost
	Base class to store tag information (e.g., inside Interest and Data packets) More...

class	TcpTransport
	a transport using TCP socket More...

class	Transport
	Provides TLV-block delivery service. More...

class	UnixTransport
	a transport using Unix stream socket More...

class	WireDecodable
	a concept check for TLV abstraction with .wireDecode method and constructible from Block More...

class	WireEncodable
	a concept check for TLV abstraction with .wireEncode method More...

class	WireEncodableWithEncodingBuffer
	a concept check for TLV abstraction with .wireEncode method More...

Typedefs
typedef SimpleSymmetricKeyParams< detail::AesKeyParamsInfo >	AesKeyParams
	AesKeyParams carries parameters for AES key. More...

using	BufferPtr = shared_ptr< Buffer >

using	CanonizeProviders = boost::mpl::vector< UdpCanonizeProvider , TcpCanonizeProvider , EtherCanonizeProvider , DevCanonizeProvider , UdpDevCanonizeProvider * >

using	CanonizeProviderTable = std::map< std::string, shared_ptr< CanonizeProvider > >

using	ConstBufferPtr = shared_ptr< const Buffer >

typedef function< void(const Interest &, const Data &)>	DataCallback
	Callback invoked when expressed Interest gets satisfied with a Data packet. More...

typedef SimplePublicKeyParams< detail::EcKeyParamsInfo >	EcKeyParams
	EcKeyParams carries parameters for EC key. More...

typedef SimpleSymmetricKeyParams< detail::HmacKeyParamsInfo >	HmacKeyParams
	HmacKeyParams carries parameters for HMAC key. More...

typedef function< void(const InterestFilter &, const Interest &)>	InterestCallback
	Callback invoked when incoming Interest matches the specified InterestFilter. More...

typedef function< void(const Interest &, const lp::Nack &)>	NackCallback
	Callback invoked when Nack is sent in response to expressed Interest. More...

using	PartialName = Name
	Represents an arbitrary sequence of name components. More...

typedef RegexTopMatcher	Regex

typedef function< void(const Name &, const std::string &)>	RegisterPrefixFailureCallback
	Callback invoked when registerPrefix or setInterestFilter command fails. More...

typedef function< void(const Name &)>	RegisterPrefixSuccessCallback
	Callback invoked when registerPrefix or setInterestFilter command succeeds. More...

typedef SimplePublicKeyParams< detail::RsaKeyParamsInfo >	RsaKeyParams
	RsaKeyParams carries parameters for RSA key. More...

using	ScopedInterestFilterHandle = detail::ScopedCancelHandle< InterestFilterHandle >
	A scoped handle of registered Interest filter. More...

using	ScopedPendingInterestHandle = detail::ScopedCancelHandle< PendingInterestHandle >
	A scoped handle of pending Interest. More...

using	ScopedRegisteredPrefixHandle = detail::ScopedCancelHandle< RegisteredPrefixHandle >
	A scoped handle of registered prefix. More...

typedef function< void(const Interest &)>	TimeoutCallback
	Callback invoked when expressed Interest times out. More...

typedef function< void(const std::string &)>	UnregisterPrefixFailureCallback
	Callback invoked when unregisterPrefix or unsetInterestFilter command fails. More...

typedef function< void()>	UnregisterPrefixSuccessCallback
	Callback invoked when unregisterPrefix or unsetInterestFilter command succeeds. More...

Enumerations
enum	BlockCipherAlgorithm { BlockCipherAlgorithm::NONE, BlockCipherAlgorithm::AES_CBC }

enum	CipherOperator { CipherOperator::DECRYPT, CipherOperator::ENCRYPT }

enum	DigestAlgorithm { DigestAlgorithm::NONE = 0, DigestAlgorithm::SHA224, DigestAlgorithm::SHA256, DigestAlgorithm::SHA384, DigestAlgorithm::SHA512, DigestAlgorithm::BLAKE2B_512, DigestAlgorithm::BLAKE2S_256, DigestAlgorithm::SHA3_224, DigestAlgorithm::SHA3_256, DigestAlgorithm::SHA3_384, DigestAlgorithm::SHA3_512 }

enum	KeyIdType { KeyIdType::USER_SPECIFIED = 0, KeyIdType::SHA256 = 1, KeyIdType::RANDOM = 2 }
	The type of KeyId component in a key name. More...

enum	KeyType { KeyType::NONE = 0, KeyType::RSA, KeyType::EC, KeyType::AES, KeyType::HMAC }
	The type of a cryptographic key. More...

Functions
template<typename T , typename Compare >
constexpr const T &	clamp (const T &v, const T &lo, const T &hi, Compare comp)

template<typename T >
constexpr const T &	clamp (const T &v, const T &lo, const T &hi)

template size_t	Data::wireEncode< encoding::EncoderTag > (EncodingBuffer &, bool) const

template size_t	Data::wireEncode< encoding::EstimatorTag > (EncodingEstimator &, bool) const

template size_t	DelegationList::wireEncode< encoding::EncoderTag > (EncodingBuffer &, uint32_t) const

template size_t	DelegationList::wireEncode< encoding::EstimatorTag > (EncodingEstimator &, uint32_t) const

std::string	escape (const std::string &str)
	Percent-encode a string. More...

void	escape (std::ostream &os, const char *str, size_t len)

template<typename NetPkt >
static void	extractLpLocalFields (NetPkt &netPacket, const lp::Packet &lpPacket)
	extract local fields from NDNLPv2 packet and tag onto a network layer packet More...

shared_ptr< Buffer >	fromHex (const std::string &hexString)
	Convert the hex string to buffer. More...

constexpr int	fromHexChar (char c) noexcept
	Convert the hex character `c` to an integer in [0, 15], or -1 if it's not a hex character. More...

static const CanonizeProvider *	getCanonizeProvider (const std::string &scheme)

template size_t	Interest ::wireEncode<::ndn::encoding::EncoderTag > (::ndn::EncodingBuffer &) const

template size_t	Interest ::wireEncode<::ndn::encoding::EstimatorTag > (::ndn::EncodingEstimator &) const

template size_t	KeyLocator ::wireEncode<::ndn::encoding::EncoderTag > (::ndn::EncodingBuffer &) const

template size_t	KeyLocator ::wireEncode<::ndn::encoding::EstimatorTag > (::ndn::EncodingEstimator &) const

template<typename CharT , typename Traits , typename DelimT >
ostream_joiner< std::decay_t< DelimT >, CharT, Traits >	make_ostream_joiner (std::basic_ostream< CharT, Traits > &os, DelimT &&delimiter)

template size_t	MetaInfo ::wireEncode<::ndn::encoding::EncoderTag > (::ndn::EncodingBuffer &) const

template size_t	MetaInfo ::wireEncode<::ndn::encoding::EstimatorTag > (::ndn::EncodingEstimator &) const

template size_t	Name ::wireEncode<::ndn::encoding::EncoderTag > (::ndn::EncodingBuffer &) const

template size_t	Name ::wireEncode<::ndn::encoding::EstimatorTag > (::ndn::EncodingEstimator &) const

bool	operator!= (const PrefixAnnouncement &lhs, const PrefixAnnouncement &rhs)

bool	operator!= (const SignatureInfo &lhs, const SignatureInfo &rhs)

bool	operator!= (const Data &lhs, const Data &rhs)

bool	operator!= (const Block &lhs, const Block &rhs)

Block	operator"" _block (const char *input, std::size_t len)
	Construct a Block from hexadecimal `input`. More...

std::ostream &	operator<< (std::ostream &os, KeyIdType keyIdType)

std::ostream &	operator<< (std::ostream &os, const AsHex &hex)

std::ostream &	operator<< (std::ostream &os, KeyType keyType)

std::ostream &	operator<< (std::ostream &os, DigestAlgorithm algorithm)

std::ostream &	operator<< (std::ostream &os, const InterestFilter &filter)

std::ostream &	operator<< (std::ostream &os, const RegexMatcher &rm)

std::ostream &	operator<< (std::ostream &os, BlockCipherAlgorithm algorithm)

std::ostream &	operator<< (std::ostream &os, CipherOperator op)

std::ostream &	operator<< (std::ostream &os, const PrefixAnnouncement &pa)
	Print prefix announcement to a stream. More...

std::ostream &	operator<< (std::ostream &os, const KeyLocator &keyLocator)

std::ostream &	operator<< (std::ostream &os, const FaceUri &uri)

std::ostream &	operator<< (std::ostream &os, const DelegationList &dl)

std::ostream &	operator<< (std::ostream &os, const MetaInfo &info)

std::ostream &	operator<< (std::ostream &os, const SignatureInfo &info)

std::ostream &	operator<< (std::ostream &os, const Data &data)

std::ostream &	operator<< (std::ostream &os, const Block &block)

std::ostream &	operator<< (std::ostream &os, const Interest &interest)

bool	operator== (const PrefixAnnouncement &lhs, const PrefixAnnouncement &rhs)
	Test whether two prefix announcements has the same name, expiration period, and validity period. More...

bool	operator== (const SignatureInfo &lhs, const SignatureInfo &rhs)

bool	operator== (const Data &lhs, const Data &rhs)

bool	operator== (const Block &lhs, const Block &rhs)
	Compare whether two Blocks have same TLV-TYPE, TLV-LENGTH, and TLV-VALUE. More...

std::istream &	operator>> (std::istream &is, Name &name)
	Parse URI from stream as Name. More...

void	printHex (std::ostream &os, uint64_t num, bool wantUpperCase=false)
	Output the hex representation of `num` to the output stream `os`. More...

void	printHex (std::ostream &os, const uint8_t *buffer, size_t length, bool wantUpperCase=true)
	Output the hex representation of the bytes in `buffer` to the output stream `os`. More...

void	printHex (std::ostream &os, const Buffer &buffer, bool wantUpperCase=true)
	Output the hex representation of the bytes in `buffer` to the output stream `os`. More...

template size_t	SignatureInfo ::wireEncode<::ndn::encoding::EncoderTag > (::ndn::EncodingBuffer &) const

template size_t	SignatureInfo ::wireEncode<::ndn::encoding::EstimatorTag > (::ndn::EncodingEstimator &) const

template<typename T >
std::string	to_string (const T &val)

template<typename T >
constexpr std::underlying_type_t< T >	to_underlying (T val) noexcept

std::string	toHex (const uint8_t *buffer, size_t length, bool wantUpperCase=true)
	Return a string containing the hex representation of the bytes in `buffer`. More...

std::string	toHex (const Buffer &buffer, bool wantUpperCase=true)
	Return a string containing the hex representation of the bytes in `buffer`. More...

constexpr char	toHexChar (unsigned int n, bool wantUpperCase=true) noexcept
	Convert (the least significant nibble of) `n` to the corresponding hex character. More...

std::string	unescape (const std::string &str)
	Decode a percent-encoded string. More...

void	unescape (std::ostream &os, const char *str, size_t len)

static void	warnOnceCanBePrefixUnset ()

Variables
const time::milliseconds	DEFAULT_FRESHNESS_PERIOD = time::milliseconds::zero()

const time::milliseconds	DEFAULT_INTEREST_LIFETIME = 4_s
	default value for InterestLifetime More...

const name::Component	KEYWORD_METADATA_COMP = "20 08 6D65746164617461"_block

static const name::Component	KEYWORD_PA_COMP = "20025041"_block

const size_t	MAX_KEY_DIGEST_OCTETS_TO_SHOW = 5

const size_t	MAX_NDN_PACKET_SIZE = 8800
	practical limit of network layer packet size More...

const size_t	MAX_SIZE_OF_BLOCK_FROM_STREAM = MAX_NDN_PACKET_SIZE

constexpr detail::make_overload_t	overload {}

static constexpr uint8_t	SHA256_OF_EMPTY_STRING []

Typedef Documentation

◆ AesKeyParams

typedef SimpleSymmetricKeyParams<detail::AesKeyParamsInfo> ndn::AesKeyParams

AesKeyParams carries parameters for AES key.

Definition at line 306 of file key-params.hpp.

◆ BufferPtr

using ndn::BufferPtr = typedef shared_ptr<Buffer>

Definition at line 125 of file buffer.hpp.

◆ CanonizeProviders

using ndn::CanonizeProviders = typedef boost::mpl::vector<UdpCanonizeProvider*, TcpCanonizeProvider*, EtherCanonizeProvider*, DevCanonizeProvider*, UdpDevCanonizeProvider*>

Definition at line 567 of file face-uri.cpp.

◆ CanonizeProviderTable

using ndn::CanonizeProviderTable = typedef std::map<std::string, shared_ptr<CanonizeProvider> >

Definition at line 568 of file face-uri.cpp.

◆ ConstBufferPtr

using ndn::ConstBufferPtr = typedef shared_ptr<const Buffer>

Definition at line 126 of file buffer.hpp.

◆ DataCallback

typedef function<void(const Interest&, const Data&)> ndn::DataCallback

Callback invoked when expressed Interest gets satisfied with a Data packet.

Definition at line 44 of file face.hpp.

◆ EcKeyParams

typedef SimplePublicKeyParams<detail::EcKeyParamsInfo> ndn::EcKeyParams

EcKeyParams carries parameters for EC key.

Definition at line 202 of file key-params.hpp.

◆ HmacKeyParams

typedef SimpleSymmetricKeyParams<detail::HmacKeyParamsInfo> ndn::HmacKeyParams

HmacKeyParams carries parameters for HMAC key.

Definition at line 309 of file key-params.hpp.

◆ InterestCallback

typedef function<void(const InterestFilter&, const Interest&)> ndn::InterestCallback

Callback invoked when incoming Interest matches the specified InterestFilter.

Definition at line 64 of file face.hpp.

◆ NackCallback

typedef function<void(const Interest&, const lp::Nack&)> ndn::NackCallback

Callback invoked when Nack is sent in response to expressed Interest.

Definition at line 54 of file face.hpp.

◆ PartialName

using ndn::PartialName = typedef Name

Represents an arbitrary sequence of name components.

Definition at line 39 of file name.hpp.

◆ Regex

typedef RegexTopMatcher ndn::Regex

Definition at line 31 of file regex.hpp.

◆ RegisterPrefixFailureCallback

typedef function<void(const Name&, const std::string&)> ndn::RegisterPrefixFailureCallback

Callback invoked when registerPrefix or setInterestFilter command fails.

Definition at line 74 of file face.hpp.

◆ RegisterPrefixSuccessCallback

typedef function<void(const Name&)> ndn::RegisterPrefixSuccessCallback

Callback invoked when registerPrefix or setInterestFilter command succeeds.

Definition at line 69 of file face.hpp.

◆ RsaKeyParams

typedef SimplePublicKeyParams<detail::RsaKeyParamsInfo> ndn::RsaKeyParams

RsaKeyParams carries parameters for RSA key.

Definition at line 199 of file key-params.hpp.

◆ ScopedInterestFilterHandle

using ndn::ScopedInterestFilterHandle = typedef detail::ScopedCancelHandle<InterestFilterHandle>

A scoped handle of registered Interest filter.

Upon destruction of this handle, the Interest filter is unset automatically. Most commonly, the application keeps a ScopedInterestFilterHandle as a class member field, so that it can cleanup its Interest filter when the class instance is destructed.

{
  ScopedInterestFilterHandle hdl = face.setInterestFilter(prefix, onInterest);
} // hdl goes out of scope, unsetting the Interest filter

Warning: Unsetting an Interest filter after the face has been destructed may trigger undefined behavior.

Definition at line 647 of file face.hpp.

◆ ScopedPendingInterestHandle

using ndn::ScopedPendingInterestHandle = typedef detail::ScopedCancelHandle<PendingInterestHandle>

A scoped handle of pending Interest.

Upon destruction of this handle, the pending Interest is canceled automatically. Most commonly, the application keeps a ScopedPendingInterestHandle as a class member field, so that it can cleanup its pending Interest when the class instance is destructed.

{
  ScopedPendingInterestHandle hdl = face.expressInterest(interest, satisfyCb, nackCb, timeoutCb);
} // hdl goes out of scope, canceling the pending Interest

Warning: Canceling a pending Interest after the face has been destructed may trigger undefined behavior.

Definition at line 568 of file face.hpp.

◆ ScopedRegisteredPrefixHandle

using ndn::ScopedRegisteredPrefixHandle = typedef detail::ScopedCancelHandle<RegisteredPrefixHandle>

A scoped handle of registered prefix.

Upon destruction of this handle, the prefix is unregistered automatically. Most commonly, the application keeps a ScopedRegisteredPrefixHandle as a class member field, so that it can cleanup its prefix registration when the class instance is destructed. The application will not be notified whether the unregistration was successful.

{
  ScopedRegisteredPrefixHandle hdl = face.registerPrefix(prefix, onSuccess, onFailure);
} // hdl goes out of scope, unregistering the prefix

Warning: Unregistering a prefix after the face has been destructed may trigger undefined behavior.

Definition at line 612 of file face.hpp.

◆ TimeoutCallback

typedef function<void(const Interest&)> ndn::TimeoutCallback

Callback invoked when expressed Interest times out.

Definition at line 59 of file face.hpp.

◆ UnregisterPrefixFailureCallback

typedef function<void(const std::string&)> ndn::UnregisterPrefixFailureCallback

Callback invoked when unregisterPrefix or unsetInterestFilter command fails.

Definition at line 84 of file face.hpp.

◆ UnregisterPrefixSuccessCallback

typedef function<void()> ndn::UnregisterPrefixSuccessCallback

Callback invoked when unregisterPrefix or unsetInterestFilter command succeeds.

Definition at line 79 of file face.hpp.

Enumeration Type Documentation

◆ BlockCipherAlgorithm

enum ndn::BlockCipherAlgorithm

strong

Enumerator
NONE
AES_CBC

Definition at line 113 of file security-common.hpp.

◆ CipherOperator

enum ndn::CipherOperator

strong

Enumerator
DECRYPT
ENCRYPT

Definition at line 121 of file security-common.hpp.

◆ DigestAlgorithm

enum ndn::DigestAlgorithm

strong

Enumerator
NONE
SHA224
SHA256
SHA384
SHA512
BLAKE2B_512
BLAKE2S_256
SHA3_224
SHA3_256
SHA3_384
SHA3_512

Definition at line 96 of file security-common.hpp.

◆ KeyIdType

enum ndn::KeyIdType

strong

The type of KeyId component in a key name.

Enumerator

USER_SPECIFIED

User-specified key id.

It is the user's responsibility to ensure the uniqueness of the key names.

SHA256

Use the SHA256 hash of the public key as key id.

This KeyIdType guarantees the uniqueness of the key names.

RANDOM

Use a 64-bit random number as key id.

This KeyIdType provides uniqueness (with very high probability) of the key names.

Definition at line 58 of file security-common.hpp.

◆ KeyType

enum ndn::KeyType

strong

The type of a cryptographic key.

Enumerator
NONE	Unknown or unsupported key type.
RSA	RSA key, supports sign/verify and encrypt/decrypt operations.
EC	Elliptic Curve key (e.g. for ECDSA), supports sign/verify operations.
AES	AES key, supports encrypt/decrypt operations.
HMAC	HMAC key, supports sign/verify operations.

Definition at line 85 of file security-common.hpp.

Function Documentation

◆ clamp() [1/2]

template<typename T , typename Compare >

constexpr const T& ndn::clamp	(	const T &	v,
		const T &	lo,
		const T &	hi,
		Compare	comp
	)

Definition at line 117 of file backports.hpp.

◆ clamp() [2/2]

template<typename T >

constexpr const T& ndn::clamp	(	const T &	v,
		const T &	lo,
		const T &	hi
	)

Definition at line 125 of file backports.hpp.

◆ Data::wireEncode< encoding::EncoderTag >()

template size_t ndn::Data::wireEncode< encoding::EncoderTag >	(	EncodingBuffer &	,
		bool
	)		const

◆ Data::wireEncode< encoding::EstimatorTag >()

template size_t ndn::Data::wireEncode< encoding::EstimatorTag >	(	EncodingEstimator &	,
		bool
	)		const

◆ DelegationList::wireEncode< encoding::EncoderTag >()

template size_t ndn::DelegationList::wireEncode< encoding::EncoderTag >	(	EncodingBuffer &	,
		uint32_t
	)		const

◆ DelegationList::wireEncode< encoding::EstimatorTag >()

template size_t ndn::DelegationList::wireEncode< encoding::EstimatorTag >	(	EncodingEstimator &	,
		uint32_t
	)		const

◆ escape() [1/2]

std::string ndn::escape ( const std::string & str )

Percent-encode a string.

See also: RFC 3986 section 2

This function will encode all characters that are not one of the following: ALPHA ("a" to "z" and "A" to "Z") / DIGIT (0 to 9) / "-" / "." / "_" / "~"

The hex encoding uses the numbers 0-9 and the uppercase letters A-F.

Examples:

escape("hello world") == "hello%20world"

escape("100%") == "100%25"

Definition at line 97 of file string-helper.cpp.

◆ escape() [2/2]

void ndn::escape	(	std::ostream &	os,
		const char *	str,
		size_t	len
	)

Definition at line 105 of file string-helper.cpp.

◆ extractLpLocalFields()

template<typename NetPkt >

static void ndn::extractLpLocalFields	(	NetPkt &	netPacket,
		const lp::Packet &	lpPacket
	)

static

extract local fields from NDNLPv2 packet and tag onto a network layer packet

Definition at line 337 of file face.cpp.

◆ fromHex()

shared_ptr< Buffer > ndn::fromHex ( const std::string & hexString )

Convert the hex string to buffer.

Parameters

hexString sequence of pairs of hex numbers (lower and upper case can be mixed) without any whitespace separators (e.g., "48656C6C6F2C20776F726C6421")

Exceptions

StringHelperError if input is invalid

Definition at line 81 of file string-helper.cpp.

◆ fromHexChar()

constexpr int ndn::fromHexChar ( char c )

noexcept

Convert the hex character c to an integer in [0, 15], or -1 if it's not a hex character.

Definition at line 164 of file string-helper.hpp.

◆ getCanonizeProvider()

static const CanonizeProvider* ndn::getCanonizeProvider ( const std::string & scheme )

static

Definition at line 598 of file face-uri.cpp.

◆ Interest ::wireEncode<::ndn::encoding::EncoderTag >()

template size_t ndn::Interest ::wireEncode<::ndn::encoding::EncoderTag > ( ::ndn::EncodingBuffer & ) const

◆ Interest ::wireEncode<::ndn::encoding::EstimatorTag >()

template size_t ndn::Interest ::wireEncode<::ndn::encoding::EstimatorTag > ( ::ndn::EncodingEstimator & ) const

◆ KeyLocator ::wireEncode<::ndn::encoding::EncoderTag >()

template size_t ndn::KeyLocator ::wireEncode<::ndn::encoding::EncoderTag > ( ::ndn::EncodingBuffer & ) const

◆ KeyLocator ::wireEncode<::ndn::encoding::EstimatorTag >()

template size_t ndn::KeyLocator ::wireEncode<::ndn::encoding::EstimatorTag > ( ::ndn::EncodingEstimator & ) const

◆ make_ostream_joiner()

template<typename CharT , typename Traits , typename DelimT >

ostream_joiner<std::decay_t<DelimT>, CharT, Traits> ndn::make_ostream_joiner	(	std::basic_ostream< CharT, Traits > &	os,
		DelimT &&	delimiter
	)

inline

Definition at line 117 of file ostream-joiner.hpp.

◆ MetaInfo ::wireEncode<::ndn::encoding::EncoderTag >()

template size_t ndn::MetaInfo ::wireEncode<::ndn::encoding::EncoderTag > ( ::ndn::EncodingBuffer & ) const

◆ MetaInfo ::wireEncode<::ndn::encoding::EstimatorTag >()

template size_t ndn::MetaInfo ::wireEncode<::ndn::encoding::EstimatorTag > ( ::ndn::EncodingEstimator & ) const

◆ Name ::wireEncode<::ndn::encoding::EncoderTag >()

template size_t ndn::Name ::wireEncode<::ndn::encoding::EncoderTag > ( ::ndn::EncodingBuffer & ) const

◆ Name ::wireEncode<::ndn::encoding::EstimatorTag >()

template size_t ndn::Name ::wireEncode<::ndn::encoding::EstimatorTag > ( ::ndn::EncodingEstimator & ) const

◆ operator!=() [1/4]

bool ndn::operator!=	(	const PrefixAnnouncement &	lhs,
		const PrefixAnnouncement &	rhs
	)

inline

Definition at line 133 of file prefix-announcement.hpp.

◆ operator!=() [2/4]

bool ndn::operator!=	(	const SignatureInfo &	lhs,
		const SignatureInfo &	rhs
	)

inline

Definition at line 168 of file signature-info.hpp.

◆ operator!=() [3/4]

bool ndn::operator!=	(	const Data &	lhs,
		const Data &	rhs
	)

inline

Definition at line 262 of file data.hpp.

◆ operator!=() [4/4]

bool ndn::operator!=	(	const Block &	lhs,
		const Block &	rhs
	)

inline

Definition at line 498 of file block.hpp.

◆ operator"" _block()

Block ndn::operator"" _block	(	const char *	input,
		std::size_t	len
	)

Construct a Block from hexadecimal input.

Parameters

input	a string containing hexadecimal bytes and comments. 0-9 and upper-case A-F are input; all other characters are comments.
len	length of `input`.

Exceptions

std::invalid_argument	input is empty or has an odd number of hexadecimal digits.
tlv::Error	`input` cannot be parsed into a valid Block.

Example

Block nameBlock = "0706 080141 080142"_block;

Block nackBlock = "FD032005 reason(no-route)=FD03210196"_block;

Definition at line 514 of file block.cpp.

◆ operator<<() [1/17]

std::ostream & ndn::operator<<	(	std::ostream &	os,
		KeyIdType	keyIdType
	)

Definition at line 29 of file security-common.cpp.

◆ operator<<() [2/17]

std::ostream & ndn::operator<<	(	std::ostream &	os,
		const AsHex &	hex
	)

Definition at line 35 of file string-helper.cpp.

◆ operator<<() [3/17]

std::ostream & ndn::operator<<	(	std::ostream &	os,
		KeyType	keyType
	)

Definition at line 43 of file security-common.cpp.

◆ operator<<() [4/17]

std::ostream & ndn::operator<<	(	std::ostream &	os,
		DigestAlgorithm	algorithm
	)

Definition at line 61 of file security-common.cpp.

◆ operator<<() [5/17]

std::ostream & ndn::operator<<	(	std::ostream &	os,
		const InterestFilter &	filter
	)

Definition at line 66 of file interest-filter.cpp.

◆ operator<<() [6/17]

std::ostream & ndn::operator<<	(	std::ostream &	os,
		const RegexMatcher &	rm
	)

Definition at line 75 of file regex-matcher.cpp.

◆ operator<<() [7/17]

std::ostream & ndn::operator<<	(	std::ostream &	os,
		BlockCipherAlgorithm	algorithm
	)

Definition at line 91 of file security-common.cpp.

◆ operator<<() [8/17]

std::ostream & ndn::operator<<	(	std::ostream &	os,
		CipherOperator	op
	)

Definition at line 103 of file security-common.cpp.

◆ operator<<() [9/17]

std::ostream & ndn::operator<<	(	std::ostream &	os,
		const PrefixAnnouncement &	pa
	)

Print prefix announcement to a stream.

This string is for debugging purpose. Its syntax is not public API.

Definition at line 126 of file prefix-announcement.cpp.

◆ operator<<() [10/17]

std::ostream & ndn::operator<<	(	std::ostream &	os,
		const KeyLocator &	keyLocator
	)

Definition at line 193 of file key-locator.cpp.

◆ operator<<() [11/17]

std::ostream & ndn::operator<<	(	std::ostream &	os,
		const FaceUri &	uri
	)

Definition at line 196 of file face-uri.cpp.

◆ operator<<() [12/17]

std::ostream & ndn::operator<<	(	std::ostream &	os,
		const DelegationList &	dl
	)

Definition at line 224 of file delegation-list.cpp.

◆ operator<<() [13/17]

std::ostream & ndn::operator<<	(	std::ostream &	os,
		const MetaInfo &	info
	)

Definition at line 226 of file meta-info.cpp.

◆ operator<<() [14/17]

std::ostream & ndn::operator<<	(	std::ostream &	os,
		const SignatureInfo &	info
	)

Definition at line 230 of file signature-info.cpp.

◆ operator<<() [15/17]

std::ostream & ndn::operator<<	(	std::ostream &	os,
		const Data &	data
	)

Definition at line 322 of file data.cpp.

◆ operator<<() [16/17]

std::ostream& ndn::operator<<	(	std::ostream &	os,
		const Block &	block
	)

Default-constructed Block is printed as: [invalid]. Zero-length Block is printed as: TT[empty], where TT is TLV-TYPE in decimal. Non-zero-length Block on which parse() has not been called is printed as: TT[LL]=VVVV, where LL is TLV-LENGTH in decimal, and VVVV is TLV-VALUE in hexadecimal. Block on which parse() has been called is printed as: TT[LL]={SUB,SUB}, where each SUB is a sub-element printed using this format.

Definition at line 487 of file block.cpp.

◆ operator<<() [17/17]

std::ostream & ndn::operator<<	(	std::ostream &	os,
		const Interest &	interest
	)

Definition at line 598 of file interest.cpp.

◆ operator==() [1/4]

bool ndn::operator==	(	const PrefixAnnouncement &	lhs,
		const PrefixAnnouncement &	rhs
	)

Test whether two prefix announcements has the same name, expiration period, and validity period.

Definition at line 118 of file prefix-announcement.cpp.

◆ operator==() [2/4]

bool ndn::operator==	(	const SignatureInfo &	lhs,
		const SignatureInfo &	rhs
	)

Definition at line 221 of file signature-info.cpp.

◆ operator==() [3/4]

bool ndn::operator==	(	const Data &	lhs,
		const Data &	rhs
	)

Definition at line 312 of file data.cpp.

◆ operator==() [4/4]

bool ndn::operator==	(	const Block &	lhs,
		const Block &	rhs
	)

Compare whether two Blocks have same TLV-TYPE, TLV-LENGTH, and TLV-VALUE.

Definition at line 478 of file block.cpp.

◆ operator>>()

std::istream & ndn::operator>>	(	std::istream &	is,
		Name &	name
	)

Parse URI from stream as Name.

See also: https://named-data.net/doc/NDN-packet-spec/current/name.html#ndn-uri-scheme

Definition at line 370 of file name.cpp.

◆ printHex() [1/3]

void ndn::printHex	(	std::ostream &	os,
		uint64_t	num,
		bool	wantUpperCase = `false`
	)

Output the hex representation of num to the output stream os.

Parameters

os	Output stream
num	Number to print in hexadecimal format
wantUpperCase	if true, print uppercase hex chars; the default is to use lowercase

The output string is a continuous sequence of hex characters without any whitespace separators.

Definition at line 42 of file string-helper.cpp.

◆ printHex() [2/3]

void ndn::printHex	(	std::ostream &	os,
		const uint8_t *	buffer,
		size_t	length,
		bool	wantUpperCase = `true`
	)

Output the hex representation of the bytes in buffer to the output stream os.

Parameters

os	Output stream
buffer	Pointer to an array of bytes
length	Size of the array
wantUpperCase	if true (the default) print uppercase hex chars

Examples:

printHex(std::cout, "Hello, World!"); // outputs "48656C6C6F2C20776F726C6421"

printHex(std::cout, "Hello, World!", false); // outputs "48656c6c6f2c20776f726c6421"

Each octet is always represented as two hex characters ("00" for octet==0).

The output string is a continuous sequence of hex characters without any whitespace separators.

Definition at line 53 of file string-helper.cpp.

◆ printHex() [3/3]

void ndn::printHex	(	std::ostream &	os,
		const Buffer &	buffer,
		bool	wantUpperCase = `true`
	)

Output the hex representation of the bytes in buffer to the output stream os.

Parameters

os	Output stream
buffer	Buffer of bytes to print in hexadecimal format
wantUpperCase	if true (the default) print uppercase hex chars

Definition at line 61 of file string-helper.cpp.

◆ SignatureInfo ::wireEncode<::ndn::encoding::EncoderTag >()

template size_t ndn::SignatureInfo ::wireEncode<::ndn::encoding::EncoderTag > ( ::ndn::EncodingBuffer & ) const

◆ SignatureInfo ::wireEncode<::ndn::encoding::EstimatorTag >()

template size_t ndn::SignatureInfo ::wireEncode<::ndn::encoding::EstimatorTag > ( ::ndn::EncodingEstimator & ) const

◆ to_string()

template<typename T >

std::string ndn::to_string ( const T & val )

inline

Definition at line 102 of file backports.hpp.

◆ to_underlying()

template<typename T >

constexpr std::underlying_type_t<T> ndn::to_underlying ( T val )

noexcept

Definition at line 141 of file backports.hpp.

◆ toHex() [1/2]

std::string ndn::toHex	(	const uint8_t *	buffer,
		size_t	length,
		bool	wantUpperCase = `true`
	)

Return a string containing the hex representation of the bytes in buffer.

Parameters

buffer	Pointer to an array of bytes
length	Size of the array
wantUpperCase	if true (the default) use uppercase hex chars

Examples:

toHex("Hello, World!") == "48656C6C6F2C20776F726C6421"

toHex("Hello, World!", false) == "48656c6c6f2c20776f726c6421"

Each octet is always represented as two hex characters ("00" for octet==0).

The output string is a continuous sequence of hex characters without any whitespace separators.

Definition at line 67 of file string-helper.cpp.

◆ toHex() [2/2]

std::string ndn::toHex	(	const Buffer &	buffer,
		bool	wantUpperCase = `true`
	)

Return a string containing the hex representation of the bytes in buffer.

Parameters

buffer	Buffer of bytes to convert to hexadecimal format
wantUpperCase	if true (the default) use uppercase hex chars

Definition at line 75 of file string-helper.cpp.

◆ toHexChar()

constexpr char ndn::toHexChar	(	unsigned int	n,
		bool	wantUpperCase = `true`
	)

noexcept

Convert (the least significant nibble of) n to the corresponding hex character.

Definition at line 153 of file string-helper.hpp.

◆ unescape() [1/2]

std::string ndn::unescape ( const std::string & str )

Decode a percent-encoded string.

See also: RFC 3986 section 2

When % is not followed by two hex characters, the output is not transformed.

Examples:

unescape("hello%20world") == "hello world"

unescape("hello%20world%FooBar") == "hello world%FooBar"

Definition at line 126 of file string-helper.cpp.

◆ unescape() [2/2]

void ndn::unescape	(	std::ostream &	os,
		const char *	str,
		size_t	len
	)

Definition at line 134 of file string-helper.cpp.

◆ warnOnceCanBePrefixUnset()

static void ndn::warnOnceCanBePrefixUnset ( )

static

Definition at line 70 of file interest.cpp.

Variable Documentation

◆ DEFAULT_FRESHNESS_PERIOD

const time::milliseconds ndn::DEFAULT_FRESHNESS_PERIOD = time::milliseconds::zero()

Definition at line 34 of file meta-info.hpp.

◆ DEFAULT_INTEREST_LIFETIME

const unspecified_duration_type ndn::DEFAULT_INTEREST_LIFETIME = 4_s

default value for InterestLifetime

Definition at line 39 of file interest.hpp.

◆ KEYWORD_METADATA_COMP

const name::Component ndn::KEYWORD_METADATA_COMP = "20 08 6D65746164617461"_block

Definition at line 29 of file metadata-object.cpp.

◆ KEYWORD_PA_COMP

const name::Component ndn::KEYWORD_PA_COMP = "20025041"_block

static

Definition at line 27 of file prefix-announcement.cpp.

◆ MAX_KEY_DIGEST_OCTETS_TO_SHOW

const size_t ndn::MAX_KEY_DIGEST_OCTETS_TO_SHOW = 5

Definition at line 36 of file key-locator.cpp.

◆ MAX_NDN_PACKET_SIZE

const size_t ndn::MAX_NDN_PACKET_SIZE = 8800

practical limit of network layer packet size

If a packet is longer than this size, library and application MAY drop it.

Definition at line 41 of file tlv.hpp.

◆ MAX_SIZE_OF_BLOCK_FROM_STREAM

const size_t ndn::MAX_SIZE_OF_BLOCK_FROM_STREAM = MAX_NDN_PACKET_SIZE

Definition at line 40 of file block.cpp.

◆ overload

constexpr detail::make_overload_t ndn::overload {}

Definition at line 108 of file overload.hpp.

◆ SHA256_OF_EMPTY_STRING

constexpr uint8_t ndn::SHA256_OF_EMPTY_STRING[]

static

Initial value:

= {
  0xe3, 0xb0, 0xc4, 0x42, 0x98, 0xfc, 0x1c, 0x14,
  0x9a, 0xfb, 0xf4, 0xc8, 0x99, 0x6f, 0xb9, 0x24,
  0x27, 0xae, 0x41, 0xe4, 0x64, 0x9b, 0x93, 0x4c,
  0xa4, 0x95, 0x99, 0x1b, 0x78, 0x52, 0xb8, 0x55,
}

Definition at line 254 of file name.cpp.

ndn-cxx: NDN C++ library with eXperimental eXtensions 0.7.0 documentation

Namespaces

Classes

Typedefs

Enumerations

Functions

Variables

Typedef Documentation

◆ AesKeyParams

◆ BufferPtr

◆ CanonizeProviders

◆ CanonizeProviderTable

◆ ConstBufferPtr

◆ DataCallback

◆ EcKeyParams

◆ HmacKeyParams

◆ InterestCallback

◆ NackCallback

◆ PartialName

◆ Regex

◆ RegisterPrefixFailureCallback

◆ RegisterPrefixSuccessCallback

◆ RsaKeyParams

◆ ScopedInterestFilterHandle

◆ ScopedPendingInterestHandle

◆ ScopedRegisteredPrefixHandle

◆ TimeoutCallback

◆ UnregisterPrefixFailureCallback

◆ UnregisterPrefixSuccessCallback

Enumeration Type Documentation

◆ BlockCipherAlgorithm

◆ CipherOperator

◆ DigestAlgorithm

◆ KeyIdType

◆ KeyType

Function Documentation

◆ clamp() [1/2]

◆ clamp() [2/2]

◆ Data::wireEncode< encoding::EncoderTag >()

◆ Data::wireEncode< encoding::EstimatorTag >()

◆ DelegationList::wireEncode< encoding::EncoderTag >()

◆ DelegationList::wireEncode< encoding::EstimatorTag >()

◆ escape() [1/2]

◆ escape() [2/2]

◆ extractLpLocalFields()

◆ fromHex()

◆ fromHexChar()

◆ getCanonizeProvider()

◆ Interest ::wireEncode<::ndn::encoding::EncoderTag >()

◆ Interest ::wireEncode<::ndn::encoding::EstimatorTag >()

◆ KeyLocator ::wireEncode<::ndn::encoding::EncoderTag >()

◆ KeyLocator ::wireEncode<::ndn::encoding::EstimatorTag >()

◆ make_ostream_joiner()

◆ MetaInfo ::wireEncode<::ndn::encoding::EncoderTag >()

◆ MetaInfo ::wireEncode<::ndn::encoding::EstimatorTag >()

◆ Name ::wireEncode<::ndn::encoding::EncoderTag >()

◆ Name ::wireEncode<::ndn::encoding::EstimatorTag >()

◆ operator!=() [1/4]

◆ operator!=() [2/4]

◆ operator!=() [3/4]

◆ operator!=() [4/4]

◆ operator"" _block()

◆ operator<<() [1/17]

◆ operator<<() [2/17]

◆ operator<<() [3/17]

◆ operator<<() [4/17]

◆ operator<<() [5/17]

◆ operator<<() [6/17]

◆ operator<<() [7/17]

◆ operator<<() [8/17]

◆ operator<<() [9/17]

◆ operator<<() [10/17]

◆ operator<<() [11/17]

◆ operator<<() [12/17]

◆ operator<<() [13/17]

◆ operator<<() [14/17]

◆ operator<<() [15/17]

◆ operator<<() [16/17]

◆ operator<<() [17/17]

◆ operator==() [1/4]