QCA::ConsoleReference Class Reference
[QCA user API]

Manager for a Console. More...

#include <QtCrypto>

Collaboration diagram for QCA::ConsoleReference:
Collaboration graph
[legend]

List of all members.

Public Types

enum  SecurityMode { SecurityDisabled, SecurityEnabled }

Signals

void bytesWritten (int bytes)
void inputClosed ()
void outputClosed ()
void readyRead ()

Public Member Functions

int bytesAvailable () const
int bytesToWrite () const
void closeOutput ()
Console * console () const
 ConsoleReference (QObject *parent=0)
QByteArray read (int bytes=-1)
SecureArray readSecure (int bytes=-1)
SecurityMode securityMode () const
bool start (Console *console, SecurityMode mode=SecurityDisabled)
void stop ()
void write (const QByteArray &a)
void writeSecure (const SecureArray &a)

Friends

class Console
class ConsoleReferencePrivate

Detailed Description

Manager for a Console.

Note:
Only one ConsoleReference object can be active at a time

Member Enumeration Documentation

The security setting to use for the Console being managed.


Constructor & Destructor Documentation

QCA::ConsoleReference::ConsoleReference ( QObject *  parent = 0  ) 

Standard constructor.

Parameters:
parent the parent object for this object

Member Function Documentation

bool QCA::ConsoleReference::start ( Console *  console,
SecurityMode  mode = SecurityDisabled 
)

Set the Console object to be managed, and start processing.

You typically want to use Console::ttyInstance() or Console::stdioInstance() to obtain the required Console reference.

Parameters:
console reference to the Console to be managed
mode the SecurityMode to use for this Console.
See also:
QCA::Console for more information on how to handle the console aspects of your application or library code.
void QCA::ConsoleReference::stop (  ) 

Stop processing, and release the Console.

Console* QCA::ConsoleReference::console (  )  const

The Console object managed by this object.

See also:
start() to set the Console to be managed
SecurityMode QCA::ConsoleReference::securityMode (  )  const

The security mode setting for the Console object managed by this object.

See also:
start() to set the SecurityMode
QByteArray QCA::ConsoleReference::read ( int  bytes = -1  ) 

Read data from the Console.

Parameters:
bytes the number of bytes to read. The default is to read all available bytes
See also:
readSecure() for a method suitable for reading sensitive data.
void QCA::ConsoleReference::write ( const QByteArray &  a  ) 

Write data to the Console.

Parameters:
a the array of data to write to the Console
See also:
writeSecure() for a method suitable for writing sensitive data.
SecureArray QCA::ConsoleReference::readSecure ( int  bytes = -1  ) 

Read secure data from the Console.

Parameters:
bytes the number of bytes to read. The default is to read all available bytes
See also:
read() which is suitable for non-sensitive data
void QCA::ConsoleReference::writeSecure ( const SecureArray &  a  ) 

Write secure data to the Console.

Parameters:
a the array of data to write to the Console
See also:
write() which is suitable for non-sensitive data
void QCA::ConsoleReference::closeOutput (  ) 

Close the write channel.

You only need to call this if writing is enabled on the Console being managed.

int QCA::ConsoleReference::bytesAvailable (  )  const

The number of bytes available to read from the Console being managed.

int QCA::ConsoleReference::bytesToWrite (  )  const

The number of bytes remaining to be written to the Console being managed.

void QCA::ConsoleReference::readyRead (  )  [signal]

Emitted when there are bytes available to read from the Console being managed.

void QCA::ConsoleReference::bytesWritten ( int  bytes  )  [signal]

Emitted when bytes are written to the Console.

Parameters:
bytes the number of bytes that were written
See also:
bytesAvailable()
void QCA::ConsoleReference::inputClosed (  )  [signal]

Emitted when the console input is closed.

void QCA::ConsoleReference::outputClosed (  )  [signal]

Emitted when the console output is closed.


The documentation for this class was generated from the following file:
Generated on Sat Nov 27 13:41:18 2010 for Qt Cryptographic Architecture by  doxygen 1.6.3