// Filename: encryptStreamBuf.I
// Created by:  drose (09Dec04)
//
////////////////////////////////////////////////////////////////////
//
// PANDA 3D SOFTWARE
// Copyright (c) Carnegie Mellon University.  All rights reserved.
//
// All use of this software is subject to the terms of the revised BSD
// license.  You should have received a copy of this license along
// with this source code in a file named "LICENSE."
//
////////////////////////////////////////////////////////////////////


////////////////////////////////////////////////////////////////////
//     Function: EncryptStreamBuf::set_algorithm
//       Access: Public
//  Description: Specifies the encryption algorithm that should be
//               used for future calls to open_write().  The default
//               is whatever is specified by the encryption-algorithm
//               config variable.  The complete set of available
//               algorithms is defined by the current version of
//               OpenSSL.
//
//               If an invalid algorithm is specified, there is no
//               immediate error return code, but open_write() will
//               fail.
////////////////////////////////////////////////////////////////////
INLINE void EncryptStreamBuf::
set_algorithm(const string &algorithm) {
  _algorithm = algorithm;
}

////////////////////////////////////////////////////////////////////
//     Function: EncryptStreamBuf::get_algorithm
//       Access: Public
//  Description: Returns the encryption algorithm that was specified
//               by set_algorithm(), or was read from the stream by
//               the last successful open_read().
////////////////////////////////////////////////////////////////////
INLINE const string &EncryptStreamBuf::
get_algorithm() const {
  return _algorithm;
}

////////////////////////////////////////////////////////////////////
//     Function: EncryptStreamBuf::set_key_length
//       Access: Public
//  Description: Specifies the length of the key, in bits, that should
//               be used to encrypt the stream in future calls to
//               open_write().  The default is whatever is specified
//               by the encryption-key-length config variable.  
//
//               If an invalid key_length for the chosen algorithm is
//               specified, there is no immediate error return code,
//               but open_write() will fail.
////////////////////////////////////////////////////////////////////
INLINE void EncryptStreamBuf::
set_key_length(int key_length) {
  _key_length = key_length;
}

////////////////////////////////////////////////////////////////////
//     Function: EncryptStreamBuf::get_key_length
//       Access: Public
//  Description: Returns the encryption key length, in bits, that was
//               specified by set_key_length(), or was read from the
//               stream by the last successful open_read().
////////////////////////////////////////////////////////////////////
INLINE int EncryptStreamBuf::
get_key_length() const {
  return _key_length;
}

////////////////////////////////////////////////////////////////////
//     Function: EncryptStreamBuf::set_iteration_count
//       Access: Public
//  Description: Specifies the number of times to repeatedly hash the
//               key before writing it to the stream in future calls
//               to open_write().  Its purpose is to make it
//               computationally more expensive for an attacker to
//               search the key space exhaustively.  This should be a
//               multiple of 1,000 and should not exceed about 65
//               million; the value 0 indicates just one application
//               of the hashing algorithm.
//
//               The default is whatever is specified by the
//               encryption-iteration-count config variable.
////////////////////////////////////////////////////////////////////
INLINE void EncryptStreamBuf::
set_iteration_count(int iteration_count) {
  _iteration_count = iteration_count;
}

////////////////////////////////////////////////////////////////////
//     Function: EncryptStreamBuf::get_iteration_count
//       Access: Public
//  Description: Returns the value that was specified by
//               set_iteration_count(), or was read from the stream by
//               the last successful open_read().
////////////////////////////////////////////////////////////////////
INLINE int EncryptStreamBuf::
get_iteration_count() const {
  return _iteration_count;
}
