TAO_SSLIOP_Endpoint Class Reference

#include <SSLIOP_Endpoint.h>

Inheritance diagram for TAO_SSLIOP_Endpoint:

[legend]Collaboration diagram for TAO_SSLIOP_Endpoint:

[legend]List of all members.

Public Member Functions
	TAO_SSLIOP_Endpoint (const ::SSLIOP::SSL *ssl_component, TAO_IIOP_Endpoint *iiop_endp)
	Constructor.
	~TAO_SSLIOP_Endpoint (void)
	Destructor.
int	credentials_set (void) const
TAO_Endpoint Methods
See Endpoint.h for their documentation.
virtual TAO_Endpoint *	next (void)
virtual int	addr_to_string (char *buffer, size_t length)
CORBA::Boolean	is_equivalent (const TAO_Endpoint *other_endpoint)
virtual TAO_Endpoint *	duplicate (void)
virtual CORBA::ULong	hash (void)
	Return a hash value for this object.
SSLIOP_Endpoint-specific Methods
const ::SSLIOP::SSL &	ssl_component (void) const
	Return SSL component corresponding to this endpoint.
TAO_IIOP_Endpoint *	iiop_endpoint (void) const
	Accessor to our IIOP counterpart.
void	iiop_endpoint (TAO_IIOP_Endpoint *endpoint, bool destroy)
	Mutator to our IIOP counterpart.
const ACE_INET_Addr &	object_addr (void) const
	Return the SSLIOP-specific ACE_INET_Addr.
void	set_sec_attrs (::Security::QOP qop, const ::Security::EstablishTrust &trust, TAO::SSLIOP::OwnCredentials_ptr creds)
::Security::QOP	qop (void) const
	Get the Quality-of-Protection settings for this endpoint.
::Security::EstablishTrust	trust (void) const
	Get the establishment of trust settings for this endpoint.
TAO::SSLIOP::OwnCredentials *	credentials (void) const
	Get the credentials for this endpoint.
Private Attributes
::SSLIOP::SSL	ssl_component_
ACE_INET_Addr	object_addr_
TAO_SSLIOP_Endpoint *	next_
TAO_IIOP_Endpoint *	iiop_endpoint_
	IIOP counterpart.
bool	destroy_iiop_endpoint_
::Security::QOP	qop_
	Quailty-of-Protection settings for this endpoint object.
::Security::EstablishTrust	trust_
	Establishment of trust settings for this endpoint object.
TAO::SSLIOP::OwnCredentials_var	credentials_
	SSLIOP-specific credentials for this endpoint object.
int	credentials_set_
	A flag indicating that credentials_ was explicitly initialized.
Friends
class	TAO_SSLIOP_Profile

---

Constructor & Destructor Documentation

TAO_SSLIOP_Endpoint::TAO_SSLIOP_Endpoint (  const ::SSLIOP::SSL *  ssl_component, TAO_IIOP_Endpoint *  iiop_endp )

Constructor.

TAO_SSLIOP_Endpoint::~TAO_SSLIOP_Endpoint (  void   )

Destructor.

---

Member Function Documentation

int TAO_SSLIOP_Endpoint::addr_to_string (  char *  buffer, size_t  length )  [virtual]

Implements TAO_Endpoint.

ACE_INLINE TAO::SSLIOP::OwnCredentials * TAO_SSLIOP_Endpoint::credentials (  void   )  const

Get the credentials for this endpoint. Note: This method does not follow C++ mapping memory management rules. Specifically, no duplication or reference counting occurs in this method. This is so that no additional locks occur when checking the transport cache.

ACE_INLINE int TAO_SSLIOP_Endpoint::credentials_set (  void   )  const

Credentials are not supplied by the constructor, and it is valid to have a nil credential, for instance if the SSL_use_certificate() method returns 0. Therefore it is necessary to have a new method to distinguish between a credential that is nil because it has not been set, vs one that was set to nil explicitly.

TAO_Endpoint * TAO_SSLIOP_Endpoint::duplicate (  void   )  [virtual]

Return a copy of the corresponding endpoints by allocating memory. Implements TAO_Endpoint.

CORBA::ULong TAO_SSLIOP_Endpoint::hash (  void   )  [virtual]

Return a hash value for this object. Implements TAO_Endpoint.

ACE_INLINE void TAO_SSLIOP_Endpoint::iiop_endpoint (  TAO_IIOP_Endpoint *  endpoint, bool  destroy )

Mutator to our IIOP counterpart. Parameters: destroy  If set to true, the TAO::SSLIOP::Endpoint object retains ownership of the given TAO_IIOP_Endpoint.

ACE_INLINE TAO_IIOP_Endpoint * TAO_SSLIOP_Endpoint::iiop_endpoint (  void   )  const

Accessor to our IIOP counterpart.

CORBA::Boolean TAO_SSLIOP_Endpoint::is_equivalent (  const TAO_Endpoint *  other_endpoint  )  [virtual]

Two endpoints are equivalent iff their iiop counterparts are equivalent, and, if both have non-zero ssl ports, their ssl ports are the same. Implements TAO_Endpoint.

TAO_Endpoint * TAO_SSLIOP_Endpoint::next (  void   )  [virtual]

Implements TAO_Endpoint.

const ACE_INET_Addr & TAO_SSLIOP_Endpoint::object_addr (  void   )  const

Return the SSLIOP-specific ACE_INET_Addr.

ACE_INLINE::Security::QOP TAO_SSLIOP_Endpoint::qop (  void   )  const

Get the Quality-of-Protection settings for this endpoint.

void TAO_SSLIOP_Endpoint::set_sec_attrs (  ::Security::QOP  qop, const ::Security::EstablishTrust &  trust, TAO::SSLIOP::OwnCredentials_ptr  creds )

Set the Quality-of-Protection, establishment of trust, and credentials for this endpoint. This is all done in one function so that the guard may be used uniformly.

ACE_INLINEconst ::SSLIOP::SSL & TAO_SSLIOP_Endpoint::ssl_component (  void   )  const

Return SSL component corresponding to this endpoint.

ACE_INLINE::Security::EstablishTrust TAO_SSLIOP_Endpoint::trust (  void   )  const

Get the establishment of trust settings for this endpoint.

---

Friends And Related Function Documentation

friend class TAO_SSLIOP_Profile [friend]

---

Member Data Documentation

TAO::SSLIOP::OwnCredentials_var TAO_SSLIOP_Endpoint::credentials_ [private]

SSLIOP-specific credentials for this endpoint object.

int TAO_SSLIOP_Endpoint::credentials_set_ [private]

A flag indicating that credentials_ was explicitly initialized.

bool TAO_SSLIOP_Endpoint::destroy_iiop_endpoint_ [private]

Flag that determines whether or not the iiop_endpoint_ member is deallocated with delete().

TAO_IIOP_Endpoint* TAO_SSLIOP_Endpoint::iiop_endpoint_ [private]

IIOP counterpart. Since SSLIOP is an 'extension' of IIOP, each SSLIOP_Endpoint contains SSL-specific information plus a pointer to the IIOP_Endpoint containing the IIOP portion of our address.

TAO_SSLIOP_Endpoint* TAO_SSLIOP_Endpoint::next_ [private]

IIOP Endpoints can be stringed into a list. Return the next endpoint in the list, if any.

ACE_INET_Addr TAO_SSLIOP_Endpoint::object_addr_ [mutable, private]

Cached instance of ACE_INET_Addr for use in making invocations, etc.

::Security::QOP TAO_SSLIOP_Endpoint::qop_ [private]

Quailty-of-Protection settings for this endpoint object.

::SSLIOP::SSL TAO_SSLIOP_Endpoint::ssl_component_ [private]

Cache the SSL tagged component in a decoded format. Notice that we do not need to marshal this object!

::Security::EstablishTrust TAO_SSLIOP_Endpoint::trust_ [private]

Establishment of trust settings for this endpoint object.

---

The documentation for this class was generated from the following files:

• SSLIOP_Endpoint.h
• SSLIOP_Endpoint.cpp
• SSLIOP_Endpoint.i

---