ndn::security::transform::BlockCipher Class Reference

The module to encrypt data using block cipher. More...

#include <block-cipher.hpp>

Inheritance diagram for ndn::security::transform::BlockCipher:

Collaboration diagram for ndn::security::transform::BlockCipher:

Public Member Functions
	BlockCipher (BlockCipherAlgorithm algo, CipherOperator op, const uint8_t *key, size_t keyLen, const uint8_t *iv, size_t ivLen)
	Create a block cipher. More...
	~BlockCipher ()
void	end ()
	Close the input interface of a module. More...
size_t	getIndex () const
	Get the module index. More...
bool	isEnd () const
	Check if the input interface of a module is closed. More...
void	setIndex (size_t index)
	Set the module index. More...
size_t	write (const uint8_t *buf, size_t size)
	Accept input data and perform transformation. More...

Protected Types
typedef std::vector< uint8_t >	OBuffer

Protected Member Functions
void	appendChain (unique_ptr< Downstream > tail)
	connect to next transformation module More...
void	flushAllOutput ()
	Read the all the content from output buffer and write it into next module. More...
void	flushOutputBuffer ()
	Read the content from output buffer and write it into next module. More...
Downstream *	getNext ()
bool	isOutputBufferEmpty () const
	Check if output buffer is empty. More...
void	setOutputBuffer (unique_ptr< OBuffer > buffer)
	Set output buffer to buffer. More...

Protected Attributes
unique_ptr< Downstream >	m_next

Detailed Description

The module to encrypt data using block cipher.

The padding scheme of the block cipher is set to the OpenSSL default, which is PKCS padding.

Definition at line 38 of file block-cipher.hpp.

Member Typedef Documentation

typedef std::vector<uint8_t> ndn::security::transform::Transform::OBuffer

protectedinherited

Definition at line 190 of file transform-base.hpp.

Constructor & Destructor Documentation

ndn::security::transform::BlockCipher::BlockCipher	(	BlockCipherAlgorithm	algo,
		CipherOperator	op,
		const uint8_t *	key,
		size_t	keyLen,
		const uint8_t *	iv,
		size_t	ivLen
	)

Create a block cipher.

Parameters

algo	The block cipher algorithm to use.
op	Whether to encrypt or decrypt.
key	Pointer to the key.
keyLen	Size of the key.
iv	Pointer to the initialization vector.
ivLen	Length of the initialization vector.

Definition at line 52 of file block-cipher.cpp.

ndn::security::transform::BlockCipher::~BlockCipher ( )

default

Member Function Documentation

void ndn::security::transform::Upstream::appendChain ( unique_ptr< Downstream >  tail )

protectedinherited

connect to next transformation module

Definition at line 67 of file transform-base.cpp.

void ndn::security::transform::Downstream::end ( )

inherited

Close the input interface of a module.

This method will notify this module that there is no more input and that the module should finalize transformation.

Although end() can be invoked multiple times, only the first invocation takes effect.

Definition at line 52 of file transform-base.cpp.

void ndn::security::transform::Transform::flushAllOutput ( )

protectedinherited

Read the all the content from output buffer and write it into next module.

Postcondition

isOutputBufferEmpty() returns true.

Definition at line 96 of file transform-base.cpp.

void ndn::security::transform::Transform::flushOutputBuffer ( )

protectedinherited

Read the content from output buffer and write it into next module.

It is not guaranteed that all the content in output buffer will be flushed to next module.

Definition at line 85 of file transform-base.cpp.

size_t ndn::security::transform::Downstream::getIndex ( ) const

inlineinherited

Get the module index.

Definition at line 125 of file transform-base.hpp.

Downstream* ndn::security::transform::Upstream::getNext ( )

inlineprotectedinherited

Definition at line 173 of file transform-base.hpp.

bool ndn::security::transform::Downstream::isEnd ( ) const

inlineinherited

Check if the input interface of a module is closed.

Definition at line 107 of file transform-base.hpp.

bool ndn::security::transform::Transform::isOutputBufferEmpty ( ) const

protectedinherited

Check if output buffer is empty.

Definition at line 112 of file transform-base.cpp.

void ndn::security::transform::Downstream::setIndex ( size_t  index )

inlineinherited

Set the module index.

Definition at line 116 of file transform-base.hpp.

void ndn::security::transform::Transform::setOutputBuffer ( unique_ptr< OBuffer >  buffer )

protectedinherited

Set output buffer to buffer.

Definition at line 104 of file transform-base.cpp.

size_t ndn::security::transform::Downstream::write ( const uint8_t *  buf, size_t  size  )

inherited

Accept input data and perform transformation.

An upstream module should call this method to write data into this module. The written data will be transformed and the result will be written into the next downstream module.

An upstream module can keep calling this method to until end() is called, which indicates the end of input. After that, calling this method will cause Error.

If a Downstream implementation expects structured input (e.g., hex decoding requires byte-pair), it should not return less than size if final portion of input is not a complete record.

Returns

number of bytes that has been written into this module

Exceptions

Error

if this module is closed or transformation error happens.

Definition at line 41 of file transform-base.cpp.

Member Data Documentation

unique_ptr<Downstream> ndn::security::transform::Upstream::m_next

protectedinherited

Definition at line 179 of file transform-base.hpp.