Bouncy Castle Provider 1.77 · org.bouncycastle.crypto.modes.CBCBlockCipher

Modifier and Type	Field and Description
private int	blockSize
private byte[]	cbcNextV
private byte[]	cbcV
private BlockCipher	cipher
private boolean	encrypting
private byte[]	IV

Access	Constructor and Description
public	CBCBlockCipher(BlockCipher the block cipher to be used as the basis of chaining. cipher) Deprecated use the CBCBlockCipher.newInstance() static method. Basic constructor.

Method Summary

Modifier and Type	Method and Description
private int	Returns: the number of bytes processed and produced. decryptBlock(byte[] the array containing the data to be decrypted. in, int offset into the in array the data starts at. inOff, byte[] the array the decrypted data will be copied into. out, int the offset into the out array the output will start at. outOff) Do the appropriate chaining step for CBC mode decryption.
private int	Returns: the number of bytes processed and produced. encryptBlock(byte[] the array containing the data to be encrypted. in, int offset into the in array the data starts at. inOff, byte[] the array the encrypted data will be copied into. out, int the offset into the out array the output will start at. outOff) Do the appropriate chaining step for CBC mode encryption.
public String	Returns: the name of the underlying algorithm followed by "/CBC". getAlgorithmName() Implements org.bouncycastle.crypto.BlockCipher.getAlgorithmName. return the algorithm name and mode.
public int	Returns: the block size of the underlying cipher. getBlockSize() Implements org.bouncycastle.crypto.BlockCipher.getBlockSize. return the block size of the underlying cipher.
public BlockCipher	Returns: the underlying block cipher that we are wrapping. getUnderlyingCipher() Implements org.bouncycastle.crypto.modes.CBCModeCipher.getUnderlyingCipher. return the underlying block cipher that we are wrapping.
public void	init(boolean if true the cipher is initialised for encryption, if false for decryption. encrypting, CipherParameters the key and other data required by the cipher. params) Implements org.bouncycastle.crypto.BlockCipher.init. Initialise the cipher and, possibly, the initialisation vector (IV).
public static CBCModeCipher	newInstance(BlockCipher the base cipher for the CBC mode. cipher) Return a new CBC mode cipher based on the passed in base cipher
public int	Returns: the number of bytes processed and produced. processBlock(byte[] the array containing the input data. in, int offset into the in array the data starts at. inOff, byte[] the array the output data will be copied into. out, int the offset into the out array the output will start at. outOff) Implements org.bouncycastle.crypto.BlockCipher.processBlock. Process one block of input from the array in and write it to the out array.
public void	reset() Implements org.bouncycastle.crypto.BlockCipher.reset. reset the chaining vector back to the IV and reset the underlying cipher.

Inherited from org.bouncycastle.crypto.DefaultMultiBlockCipher:: getMultiBlockSize processBlocks

blockSize	back to summary
private int blockSize

cbcNextV	back to summary
private byte[] cbcNextV

cbcV	back to summary
private byte[] cbcV

cipher	back to summary
private BlockCipher cipher

encrypting	back to summary
private boolean encrypting

IV	back to summary
private byte[] IV

CBCBlockCipher	back to summary
public CBCBlockCipher(BlockCipher cipher) Deprecated use the CBCBlockCipher.newInstance() static method. Basic constructor. Parameters cipher:BlockCipher the block cipher to be used as the basis of chaining.

Method Detail

decryptBlock	back to summary
private int decryptBlock(byte[] in, int inOff, byte[] out, int outOff) throws DataLengthException, IllegalStateException Do the appropriate chaining step for CBC mode decryption. Parameters in:byte[] the array containing the data to be decrypted. inOff:int offset into the in array the data starts at. out:byte[] the array the decrypted data will be copied into. outOff:int the offset into the out array the output will start at. Returns:int the number of bytes processed and produced. Exceptions DataLengthException: if there isn't enough data in in, or space in out. IllegalStateException: if the cipher isn't initialised.

decryptBlock

back to summary

private int decryptBlock(byte[] in, int inOff, byte[] out, int outOff) throws DataLengthException, IllegalStateException

Do the appropriate chaining step for CBC mode decryption.

Parameters

in:byte[]: the array containing the data to be decrypted.
inOff:int: offset into the in array the data starts at.
out:byte[]: the array the decrypted data will be copied into.
outOff:int: the offset into the out array the output will start at.

Returns:int

the number of bytes processed and produced.

Exceptions

DataLengthException:: if there isn't enough data in in, or space in out.
IllegalStateException:: if the cipher isn't initialised.

encryptBlock	back to summary
private int encryptBlock(byte[] in, int inOff, byte[] out, int outOff) throws DataLengthException, IllegalStateException Do the appropriate chaining step for CBC mode encryption. Parameters in:byte[] the array containing the data to be encrypted. inOff:int offset into the in array the data starts at. out:byte[] the array the encrypted data will be copied into. outOff:int the offset into the out array the output will start at. Returns:int the number of bytes processed and produced. Exceptions DataLengthException: if there isn't enough data in in, or space in out. IllegalStateException: if the cipher isn't initialised.

encryptBlock

back to summary

private int encryptBlock(byte[] in, int inOff, byte[] out, int outOff) throws DataLengthException, IllegalStateException

Do the appropriate chaining step for CBC mode encryption.

Parameters

in:byte[]: the array containing the data to be encrypted.
inOff:int: offset into the in array the data starts at.
out:byte[]: the array the encrypted data will be copied into.
outOff:int: the offset into the out array the output will start at.

Returns:int

the number of bytes processed and produced.

Exceptions

DataLengthException:: if there isn't enough data in in, or space in out.
IllegalStateException:: if the cipher isn't initialised.

getAlgorithmName	back to summary
public String getAlgorithmName() Implements org.bouncycastle.crypto.BlockCipher.getAlgorithmName. return the algorithm name and mode. Returns:String the name of the underlying algorithm followed by "/CBC".

getAlgorithmName

back to summary

public String getAlgorithmName()

Implements org.bouncycastle.crypto.BlockCipher.getAlgorithmName.

return the algorithm name and mode.

Returns:String: the name of the underlying algorithm followed by "/CBC".

getBlockSize	back to summary
public int getBlockSize() Implements org.bouncycastle.crypto.BlockCipher.getBlockSize. return the block size of the underlying cipher. Returns:int the block size of the underlying cipher.

getBlockSize

back to summary

public int getBlockSize()

Implements org.bouncycastle.crypto.BlockCipher.getBlockSize.

return the block size of the underlying cipher.

Returns:int: the block size of the underlying cipher.

getUnderlyingCipher	back to summary
public BlockCipher getUnderlyingCipher() Implements org.bouncycastle.crypto.modes.CBCModeCipher.getUnderlyingCipher. return the underlying block cipher that we are wrapping. Returns:BlockCipher the underlying block cipher that we are wrapping.

getUnderlyingCipher

back to summary

public BlockCipher getUnderlyingCipher()

Implements org.bouncycastle.crypto.modes.CBCModeCipher.getUnderlyingCipher.

return the underlying block cipher that we are wrapping.

Returns:BlockCipher: the underlying block cipher that we are wrapping.

init	back to summary
public void init(boolean encrypting, CipherParameters params) throws IllegalArgumentException Implements org.bouncycastle.crypto.BlockCipher.init. Initialise the cipher and, possibly, the initialisation vector (IV). If an IV isn't passed as part of the parameter, the IV will be all zeros. Parameters encrypting:boolean if true the cipher is initialised for encryption, if false for decryption. params:CipherParameters the key and other data required by the cipher. Exceptions IllegalArgumentException: if the params argument is inappropriate.

init

back to summary

public void init(boolean encrypting, CipherParameters params) throws IllegalArgumentException

Implements org.bouncycastle.crypto.BlockCipher.init.

Initialise the cipher and, possibly, the initialisation vector (IV). If an IV isn't passed as part of the parameter, the IV will be all zeros.

Parameters

encrypting:boolean: if true the cipher is initialised for encryption, if false for decryption.
params:CipherParameters: the key and other data required by the cipher.

Exceptions

IllegalArgumentException:: if the params argument is inappropriate.

newInstance	back to summary
public static CBCModeCipher newInstance(BlockCipher cipher) Return a new CBC mode cipher based on the passed in base cipher Parameters cipher:BlockCipher the base cipher for the CBC mode.

newInstance

back to summary

public static CBCModeCipher newInstance(BlockCipher cipher)

Return a new CBC mode cipher based on the passed in base cipher

Parameters

cipher:BlockCipher: the base cipher for the CBC mode.

processBlock	back to summary
public int processBlock(byte[] in, int inOff, byte[] out, int outOff) throws DataLengthException, IllegalStateException Implements org.bouncycastle.crypto.BlockCipher.processBlock. Process one block of input from the array in and write it to the out array. Parameters in:byte[] the array containing the input data. inOff:int offset into the in array the data starts at. out:byte[] the array the output data will be copied into. outOff:int the offset into the out array the output will start at. Returns:int the number of bytes processed and produced. Exceptions DataLengthException: if there isn't enough data in in, or space in out. IllegalStateException: if the cipher isn't initialised.

processBlock

back to summary

public int processBlock(byte[] in, int inOff, byte[] out, int outOff) throws DataLengthException, IllegalStateException

Implements org.bouncycastle.crypto.BlockCipher.processBlock.

Process one block of input from the array in and write it to the out array.

Parameters

in:byte[]: the array containing the input data.
inOff:int: offset into the in array the data starts at.
out:byte[]: the array the output data will be copied into.
outOff:int: the offset into the out array the output will start at.

Returns:int

the number of bytes processed and produced.

Exceptions

DataLengthException:: if there isn't enough data in in, or space in out.
IllegalStateException:: if the cipher isn't initialised.

reset	back to summary
public void reset() Implements org.bouncycastle.crypto.BlockCipher.reset. reset the chaining vector back to the IV and reset the underlying cipher.

reset

back to summary

public void reset()

Implements org.bouncycastle.crypto.BlockCipher.reset.

reset the chaining vector back to the IV and reset the underlying cipher.

public Class CBCBlockCipher

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail