ndn::security::ValidityPeriod Class Reference

Abstraction of validity period. More...

#include <validity-period.hpp>

Classes
class	Error

Public Member Functions
	ValidityPeriod ()
	Set validity period [UNIX epoch + 1 nanosecond, UNIX epoch] that is always invalid. More...
	ValidityPeriod (const Block &block)
	Create validity period from block. More...
	ValidityPeriod (const time::system_clock::TimePoint &notBefore, const time::system_clock::TimePoint &notAfter)
	Create validity period [notBefore, notAfter]. More...
bool	isValid (const time::system_clock::TimePoint &now=time::system_clock::now()) const
	Check if now falls within the validity period. More...
ValidityPeriod &	setPeriod (const time::system_clock::TimePoint &notBefore, const time::system_clock::TimePoint &notAfter)
	Set validity period [notBefore, notAfter]. More...
std::pair< time::system_clock::TimePoint, time::system_clock::TimePoint >	getPeriod () const
	Get the stored validity period. More...
template<encoding::Tag TAG>
size_t	wireEncode (EncodingImpl< TAG > &encoder) const
	Fast encoding or block size estimation. More...
const Block &	wireEncode () const
	Encode ValidityPeriod into TLV block. More...
void	wireDecode (const Block &wire)
	Decode ValidityPeriod from TLV block. More...

Friends
bool	operator== (const ValidityPeriod &lhs, const ValidityPeriod &rhs)
bool	operator!= (const ValidityPeriod &lhs, const ValidityPeriod &rhs)

Detailed Description

Abstraction of validity period.

See also

docs/specs/certificate-format.rst

Definition at line 37 of file validity-period.hpp.

Constructor & Destructor Documentation

ValidityPeriod() [1/3]

ndn::security::ValidityPeriod::ValidityPeriod

(

)

Set validity period [UNIX epoch + 1 nanosecond, UNIX epoch] that is always invalid.

Definition at line 42 of file validity-period.cpp.

ValidityPeriod() [2/3]

ndn::security::ValidityPeriod::ValidityPeriod ( const Block &  block )

explicit

Create validity period from block.

Definition at line 56 of file validity-period.cpp.

References wireDecode().

ValidityPeriod() [3/3]

ndn::security::ValidityPeriod::ValidityPeriod	(	const time::system_clock::TimePoint &	notBefore,
		const time::system_clock::TimePoint &	notAfter
	)

Create validity period [notBefore, notAfter].

Parameters

notBefore	exclusive beginning of the validity period range
notAfter	exclusive end of the validity period range

Note

The supplied time points will be rounded up to the whole seconds:

• notBefore is rounded up the next whole second
• notAfter is truncated to the previous whole second

Definition at line 48 of file validity-period.cpp.

Member Function Documentation

isValid()

bool ndn::security::ValidityPeriod::isValid

(

const time::system_clock::TimePoint &

now = time::system_clock::now()

)

const

Check if now falls within the validity period.

Parameters

now	Time point to check if it falls within the period

Returns

periodBegin <= now and now <= periodEnd

Definition at line 147 of file validity-period.cpp.

Referenced by ndn::security::v2::Certificate::isValid().

setPeriod()

ValidityPeriod & ndn::security::ValidityPeriod::setPeriod	(	const time::system_clock::TimePoint &	notBefore,
		const time::system_clock::TimePoint &	notAfter
	)

Set validity period [notBefore, notAfter].

Parameters

notBefore	exclusive beginning of the validity period range
notAfter	exclusive end of the validity period range

Note

The supplied time points will be rounded up to the whole seconds:

• notBefore is rounded up the next whole second
• notAfter is truncated to the previous whole second

Definition at line 130 of file validity-period.cpp.

References ndn::Block::reset().

getPeriod()

std::pair< time::system_clock::TimePoint, time::system_clock::TimePoint > ndn::security::ValidityPeriod::getPeriod

(

)

const

Get the stored validity period.

Definition at line 141 of file validity-period.cpp.

Referenced by ndn::security::v2::CertificateCache::insert(), ndn::security::v2::operator<<(), and ndn::security::operator<<().

wireEncode() [1/2]

template<encoding::Tag TAG>

size_t ndn::security::ValidityPeriod::wireEncode

(

EncodingImpl< TAG > &

encoder

)

const

Fast encoding or block size estimation.

Definition at line 63 of file validity-period.cpp.

References ndn::tlv::NotAfter, ndn::tlv::NotBefore, ndn::encoding::prependStringBlock(), ndn::time::toIsoString(), and ndn::tlv::ValidityPeriod.

Referenced by ndn::SignatureInfo::setValidityPeriod().

wireEncode() [2/2]

const Block & ndn::security::ValidityPeriod::wireEncode

(

)

const

Encode ValidityPeriod into TLV block.

Definition at line 78 of file validity-period.cpp.

References ndn::Block::hasWire(), and ndn::Block::parse().

wireDecode()

void ndn::security::ValidityPeriod::wireDecode

(

const Block &

wire

)

Decode ValidityPeriod from TLV block.

Exceptions

Error

when an invalid TLV block supplied

Definition at line 96 of file validity-period.cpp.

References ndn::Block::elements(), ndn::Block::elements_size(), ndn::time::fromIsoString(), ndn::Block::hasWire(), ndn::security::ISO_DATETIME_SIZE, NDN_THROW, ndn::security::NOT_AFTER_OFFSET, ndn::security::NOT_BEFORE_OFFSET, ndn::tlv::NotAfter, ndn::tlv::NotBefore, ndn::Block::parse(), ndn::encoding::readString(), ndn::Block::type(), and ndn::tlv::ValidityPeriod.

Referenced by ValidityPeriod().

Friends And Related Function Documentation

operator==

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

friend

Definition at line 113 of file validity-period.hpp.

operator!=

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

friend

Definition at line 119 of file validity-period.hpp.

---

The documentation for this class was generated from the following files:

• ndnSIM/ndn-cxx/ndn-cxx/security/validity-period.hpp
• ndnSIM/ndn-cxx/ndn-cxx/security/validity-period.cpp