NAME

FBB::CryptBuf - std::streambuf derived base class for DecryptBuf and EncryptBuf

SYNOPSIS

#include <bobcat/cryptbuf>
Linking option: -lbobcat -lcrypto

DESCRIPTION

The class CryptBuf inherits from EoiBuf and may therefore be used as a base class of classes specializing std::streambuf. It is used as base class for the classes DecryptBuf and EncryptBuf, offering a protected member for accessing cipher information.

NAMESPACE

FBB
All constructors, members, operators and manipulators, mentioned in this man-page, are defined in the namespace FBB.

INHERITS FROM

EoiBuf (and thus from: std::streambuf)

PROTECTED CONSTRUCTOR

Analogously to std::streambuf only a protected constructor is available.

o

CryptBuf(char const *type, size_t bufSize):
The type is a null-terminated byte string specifying the de/encryption method. E.g., aes-128-cbc. For an overview see the encryptbuf(3bobcat) man-page. The bufSize parameter defines the initial size of the internally used buffer (defined by EoiBuf).

Copy and move constructors (and assignment operators) are not available.

PROTECTED MEMBER FUNCTION

All members of std:streambuf and EoiBuf are available, as FBB::CryptBuf inherits from these classes.

o

EVP_CIPHER const *md() const:
A pointer to the cipher information is returned.

EXAMPLE

Here is an example from the implementation of EncryptBuf’s constructor:

#include "encryptbuf.ih"
EncryptBuf::EncryptBuf(ostream &outStream, char const *type, 


                       string key, string const &iv, size_t size)
:


    CryptBuf(type, size),


    d_ctx(EVP_CIPHER_CTX_new()),


    d_encrypted(size + EVP_MAX_BLOCK_LENGTH, 0),


    d_iv(iv),


    d_key(key),


    d_outStream(outStream)
{


    prepareIV();


    if (


        not EVP_EncryptInit_ex(d_ctx, md(), 0, ucharPtr(d_key), 


                                               ucharPtr(d_iv))


    )


        throw Exception{ 1 } << "Encrypt initialization failed";


    setp();
}

FILES

bobcat/cryptbuf - defines the class interface

SEE ALSO

bobcat(7), decryptbuf(3bobcat), encryptbuf(3bobcat), eoibuf(3bobcat), eoi(3bobcat)

BUGS

None Reported.

BOBCAT PROJECT FILES

o

https://fbb-git.gitlab.io/bobcat/: gitlab project page;

o

bobcat_5.07.00-x.dsc: detached signature;

o

bobcat_5.07.00-x.tar.gz: source archive;

o

bobcat_5.07.00-x_i386.changes: change log;

o

libbobcat1_5.07.00-x_*.deb: debian package containing the libraries;

o

libbobcat1-dev_5.07.00-x_*.deb: debian package containing the libraries, headers and manual pages;

BOBCAT

Bobcat is an acronym of `Brokken’s Own Base Classes And Templates’.

COPYRIGHT

This is free software, distributed under the terms of the GNU General Public License (GPL).

AUTHOR

Frank B. Brokken (f.b.brokken@rug.nl).