Remote Access Control

ParameterParser Class Reference

---

Detailed Description

Class to parse and store command line parameters for this application.

Definition at line 56 of file createrxhex.cpp.

Public Member Functions
size_t	GetCounterSize () const
const std::string &	GetFilename () const
size_t	GetKeySize () const
size_t	GetMaxTransmitters () const
size_t	GetSerialNoSize () const
const std::vector< byte > &	GetSharedKey () const
std::string	GetSharedKeyString () const
	ParameterParser (size_t argc, const char **argv)
	~ParameterParser ()
Private Member Functions
std::string	CreateHexString (const std::vector< byte > &byteVector) const
std::vector< byte >	ParseHexString (const std::string &hexString) const
Private Attributes
size_t	m_counterSize
std::string	m_filename
size_t	m_keySize
size_t	m_maxTransmitters
size_t	m_serialNoSize
std::vector< byte >	m_sharedKey

---

Constructor & Destructor Documentation

ParameterParser::ParameterParser	(	size_t	argc,
		const char **	argv
	)

Ctor taking the argc and argv parameters typically given to any main() function.

Definition at line 136 of file createrxhex.cpp.

References m_counterSize, m_filename, m_keySize, m_maxTransmitters, m_serialNoSize, m_sharedKey, and ParseHexString().

{
        // Check that argument count is valid.
        if( argc != 7 ) {
                std::cout << "Parameters:\n"
                        "  filename        - Filename for resulting Intel HEX file\n"
                        "  keysize         - Size in bits of the AES secret and shared keys (128, 192 or 256)\n"
                        "  serialnosize    - Size in bytes of the serial number (1, 2 or 4)\n"
                        "  countersize     - Size in bytes of the sequential counter (1, 2 or 4)\n"
                        "  sharedkey       - Hex representation of the shared key (32, 48 or 64 digits)\n"
                        "  maxtransmitters - Maximum number of associated transmitters\n"
                        << std::endl;
                throw std::runtime_error( "Not exactly 6 parameters" );
        }

        //
        // Create strings or string streams from argument character arrays.
        //
        std::string arg1( argv[1] ); // Filename
        std::istringstream arg2( argv[2] ); // Key size
        std::istringstream arg3( argv[3] ); // Serial no size
        std::istringstream arg4( argv[4] ); // Counter size
        std::string arg5( argv[5] ); // Shared key
        std::istringstream arg6( argv[6] ); // Max transmitters

        //
        // Copy string arguments and parse non-string arguments.
        //
        m_filename = arg1;

        arg2 >> m_keySize;
        if( !arg2 ) {
                throw std::runtime_error( "Error parsing key size argument" );
        }

        arg3 >> m_serialNoSize;
        if( !arg3 ) {
                throw std::runtime_error( "Error parsing serial no size argument" );
        }

        arg4 >> m_counterSize;
        if( !arg4 ) {
                throw std::runtime_error( "Error parsing counter size argument" );
        }

        m_sharedKey = ParseHexString( arg5 );

        arg6 >> m_maxTransmitters;
        if( !arg6 ) {
                throw std::runtime_error( "Error parsing max transmitters argument" );
        }

        //
        // Check argument validity.
        //
        if( m_keySize != 128 && m_keySize != 192 && m_keySize != 256 ) {
                throw std::runtime_error( "Key size is not 128, 192 or 256 bits" );
        }

        if( m_serialNoSize != 1 && m_serialNoSize != 2 && m_serialNoSize != 4 ) {
                throw std::runtime_error( "Serial no is not 1, 2 or 4 bytes" );
        }

        if( m_counterSize != 1 && m_counterSize != 2 && m_counterSize != 4 ) {
                throw std::runtime_error( "Counter is not 1, 2 or 4 bytes" );
        }

        if( m_sharedKey.size() != m_keySize / 8 ) {
                throw std::runtime_error( "Shared key has invalid length" );
        }
}

Here is the call graph for this function:

ParameterParser::~ParameterParser

(

)

[inline]

Definition at line 74 of file createrxhex.cpp.

{}

---

Member Function Documentation

std::string ParameterParser::CreateHexString

(

const std::vector< byte > &

byteVector

)

const [private]

Creates an HEX string from a vector of data bytes. Space between every two digits, ie. byte.

Definition at line 116 of file createrxhex.cpp.

Referenced by GetSharedKeyString().

{
        std::ostringstream oss;
        oss << std::setfill('0') << std::hex;

        // Add all byte last byte with spaces in between.
        for( size_t idx = 0; idx < byteVector.size() - 1; ++idx ) {
                oss << std::setw(2) << byteVector.at( idx ) << ' ';
        }

        // Add last byte.
        if( byteVector.size() > 0 ) {
                oss << std::setw(2) << byteVector.at( byteVector.size()-1 );
        }

        return oss.str();
}

size_t ParameterParser::GetCounterSize

(

)

const [inline]

Definition at line 82 of file createrxhex.cpp.

References m_counterSize.

Referenced by CreateHEXFile(), and main().

{ return m_counterSize; }

const std::string& ParameterParser::GetFilename

(

)

const [inline]

Definition at line 79 of file createrxhex.cpp.

References m_filename.

Referenced by CreateHEXFile(), and main().

{ return m_filename; }

size_t ParameterParser::GetKeySize

(

)

const [inline]

Definition at line 80 of file createrxhex.cpp.

References m_keySize.

Referenced by CreateHEXFile(), and main().

{ return m_keySize; }

size_t ParameterParser::GetMaxTransmitters

(

)

const [inline]

Definition at line 84 of file createrxhex.cpp.

References m_maxTransmitters.

Referenced by CreateHEXFile(), and main().

{ return m_maxTransmitters; }

size_t ParameterParser::GetSerialNoSize

(

)

const [inline]

Definition at line 81 of file createrxhex.cpp.

References m_serialNoSize.

Referenced by CreateHEXFile(), and main().

{ return m_serialNoSize; }

const std::vector< byte >& ParameterParser::GetSharedKey

(

)

const [inline]

Definition at line 83 of file createrxhex.cpp.

References m_sharedKey.

Referenced by CreateHEXFile(), and GetSharedKeyString().

{ return m_sharedKey; }

std::string ParameterParser::GetSharedKeyString

(

)

const [inline]

Definition at line 86 of file createrxhex.cpp.

References CreateHexString(), and GetSharedKey().

Referenced by main().

{ return CreateHexString( GetSharedKey() ); }

Here is the call graph for this function:

std::vector< byte > ParameterParser::ParseHexString

(

const std::string &

hexString

)

const [private]

Parses an unformatted HEX number string. Must be pairs of HEX digits, ie. bytes.

Definition at line 91 of file createrxhex.cpp.

Referenced by ParameterParser().

{
        // String must be even number of hex digits.
        if( hexString.size() % 2 != 0 ) {
                throw std::runtime_error( "Hex string does not have even character count" );
        }

        //
        // Parse hex digit pairs and insert into byte vector.
        //
        std::vector< byte > bytes;
        for( size_t idx = 0; idx < hexString.size(); idx += 2 ) {
                std::istringstream iss( hexString.substr( idx, 2 ) );
                byte data;
                iss >> std::hex >> data;
                if( !iss ) {
                        throw std::runtime_error( "Error parsing hex string \"" + hexString + "\"" );
                }
                bytes.push_back( data );
        }
        return bytes;
}

---

Field Documentation

size_t ParameterParser::m_counterSize [private]

Stores synchronization counter size parameter.

Definition at line 62 of file createrxhex.cpp.

Referenced by GetCounterSize(), and ParameterParser().

std::string ParameterParser::m_filename [private]

Stores filename parameter.

Definition at line 59 of file createrxhex.cpp.

Referenced by GetFilename(), and ParameterParser().

size_t ParameterParser::m_keySize [private]

Stores key size parameter.

Definition at line 60 of file createrxhex.cpp.

Referenced by GetKeySize(), and ParameterParser().

size_t ParameterParser::m_maxTransmitters [private]

Stores maximum number of transmitters parameter.

Definition at line 64 of file createrxhex.cpp.

Referenced by GetMaxTransmitters(), and ParameterParser().

size_t ParameterParser::m_serialNoSize [private]

Stores serial number size parameter.

Definition at line 61 of file createrxhex.cpp.

Referenced by GetSerialNoSize(), and ParameterParser().

std::vector< byte > ParameterParser::m_sharedKey [private]

Stores shared key parameter.

Definition at line 63 of file createrxhex.cpp.

Referenced by GetSharedKey(), and ParameterParser().