version 1.80.2.2, 2007/12/14 20:56:54
|
version 1.81.8.12, 2006/10/18 04:24:42
|
|
|
// John Alex, IBM (johnalex@us.ibm.com) for Bug#3312 | // John Alex, IBM (johnalex@us.ibm.com) for Bug#3312 |
// | // |
//%///////////////////////////////////////////////////////////////////////////// | //%///////////////////////////////////////////////////////////////////////////// |
//NOCHKSRC |
|
| |
#include "Config.h" | #include "Config.h" |
#include "Constants.h" | #include "Constants.h" |
|
|
# include <netinet/tcp.h> | # include <netinet/tcp.h> |
# include <arpa/inet.h> | # include <arpa/inet.h> |
# include <sys/socket.h> | # include <sys/socket.h> |
|
|
# ifndef PEGASUS_DISABLE_LOCAL_DOMAIN_SOCKET | # ifndef PEGASUS_DISABLE_LOCAL_DOMAIN_SOCKET |
# include <unistd.h> | # include <unistd.h> |
# include <sys/un.h> | # include <sys/un.h> |
|
|
{ | { |
if (local) | if (local) |
{ | { |
|
|
|
#ifndef PEGASUS_OS_TYPE_WINDOWS |
#ifndef PEGASUS_DISABLE_LOCAL_DOMAIN_SOCKET | #ifndef PEGASUS_DISABLE_LOCAL_DOMAIN_SOCKET |
|
|
address = reinterpret_cast<struct sockaddr*>(new struct sockaddr_un); | address = reinterpret_cast<struct sockaddr*>(new struct sockaddr_un); |
address_size = sizeof(struct sockaddr_un); | address_size = sizeof(struct sockaddr_un); |
#else | #else |
PEGASUS_ASSERT(false); | PEGASUS_ASSERT(false); |
#endif | #endif |
|
|
|
#endif |
} | } |
else | else |
{ | { |
|
|
Mutex _connection_mut; | Mutex _connection_mut; |
| |
PEGASUS_SOCKET socket; | PEGASUS_SOCKET socket; |
|
|
|
// Added for NamedPipe implementation for windows |
|
#if defined PEGASUS_OS_TYPE_WINDOWS && !defined(PEGASUS_DISABLE_LOCAL_DOMAIN_SOCKET) |
|
NamedPipeServer* namedPipeServer; |
|
#endif |
Array<HTTPConnection*> connections; | Array<HTTPConnection*> connections; |
}; | }; |
| |
|
|
_portNumber(portNumber), | _portNumber(portNumber), |
_sslcontext(sslcontext), | _sslcontext(sslcontext), |
_exportConnection(exportConnection), | _exportConnection(exportConnection), |
_sslContextObjectLock(sslContextObjectLock), |
_sslContextObjectLock(sslContextObjectLock) |
_idleConnectionTimeoutSeconds(0) |
|
{ | { |
Socket::initializeInterface(); | Socket::initializeInterface(); |
| |
|
|
break; | break; |
} | } |
| |
|
// Added for NamedPipe implementation for windows |
|
#if defined PEGASUS_OS_TYPE_WINDOWS && !defined(PEGASUS_DISABLE_LOCAL_DOMAIN_SOCKET) |
|
case NAMEDPIPE_MESSAGE: |
|
{ |
|
NamedPipeMessage* namedPipeMessage = (NamedPipeMessage*)message; |
|
|
|
if (((namedPipeMessage->namedPipe.getPipe()) == ( _rep->namedPipeServer->getPipe())) && |
|
(namedPipeMessage->events & NamedPipeMessage::READ)) |
|
{ |
|
_acceptNamedPipeConnection(); |
|
} |
|
else |
|
{ |
|
// ATTN! this can't happen! |
|
Tracer::trace(TRC_DISCARDED_DATA, Tracer::LEVEL2, |
|
"HTTPAcceptor::handleEnqueue: Invalid NAMEDPIPE_MESSAGE received."); |
|
} |
|
break; |
|
} |
|
#endif |
|
// may Need to close connection for Named Pipe too.....?? |
case CLOSE_CONNECTION_MESSAGE: | case CLOSE_CONNECTION_MESSAGE: |
{ | { |
CloseConnectionMessage* closeConnectionMessage | CloseConnectionMessage* closeConnectionMessage |
|
|
for (Uint32 i = 0, n = _rep->connections.size(); i < n; i++) | for (Uint32 i = 0, n = _rep->connections.size(); i < n; i++) |
{ | { |
HTTPConnection* connection = _rep->connections[i]; | HTTPConnection* connection = _rep->connections[i]; |
|
// Added for NamedPipe implementation for windows |
|
#if defined PEGASUS_OS_TYPE_WINDOWS && !defined(PEGASUS_DISABLE_LOCAL_DOMAIN_SOCKET) |
|
if(!connection->isNamedPipeConnection()) |
|
{ |
|
#endif |
PEGASUS_SOCKET socket = connection->getSocket(); | PEGASUS_SOCKET socket = connection->getSocket(); |
| |
if (socket == closeConnectionMessage->socket) | if (socket == closeConnectionMessage->socket) |
|
|
delete connection; | delete connection; |
break; | break; |
} | } |
|
// Added for NamedPipe implementation for windows |
|
#if defined PEGASUS_OS_TYPE_WINDOWS && !defined(PEGASUS_DISABLE_LOCAL_DOMAIN_SOCKET) |
|
} |
|
else |
|
{ |
|
NamedPipe namedPipe = connection->getNamedPipe(); |
|
//NamedPipeMessage* namedPipeMessage = (NamedPipeMessage*)message; |
|
|
|
if (namedPipe.getPipe() == closeConnectionMessage->namedPipe.getPipe()) |
|
{ |
|
_monitor->unsolicitPipeMessages(namedPipe); |
|
_rep->connections.remove(i); |
|
delete connection; |
|
break; |
|
} |
|
} |
|
#endif |
} | } |
| |
break; | break; |
|
|
*/ | */ |
void HTTPAcceptor::_bind() | void HTTPAcceptor::_bind() |
{ | { |
|
#ifdef PEGASUS_LOCALDOMAINSOCKET_DEBUG |
|
{ |
|
AutoMutex automut(Monitor::_cout_mut); |
|
PEGASUS_STD(cout) << "in HTTPAcceptor::_bind at the begining" << PEGASUS_STD(endl); |
|
PEGASUS_STD(cout) << "in HTTPAcceptor::_bind before ASSERT" << PEGASUS_STD(endl); |
|
} |
|
#endif |
PEGASUS_ASSERT(_rep != 0); | PEGASUS_ASSERT(_rep != 0); |
// Create address: | // Create address: |
|
#ifdef PEGASUS_LOCALDOMAINSOCKET_DEBUG |
|
{ |
|
AutoMutex automut(Monitor::_cout_mut); |
|
PEGASUS_STD(cout) << "in HTTPAcceptor::_bind before memset" << PEGASUS_STD(endl); |
|
} |
|
#endif |
| |
|
|
|
#if defined PEGASUS_OS_TYPE_WINDOWS |
|
if (!_localConnection) |
|
{ |
|
#endif |
memset(_rep->address, 0, sizeof(*_rep->address)); | memset(_rep->address, 0, sizeof(*_rep->address)); |
|
#if defined PEGASUS_OS_TYPE_WINDOWS |
|
} |
|
#endif |
|
|
|
#ifdef PEGASUS_LOCALDOMAINSOCKET_DEBUG |
|
{ |
|
AutoMutex automut(Monitor::_cout_mut); |
|
PEGASUS_STD(cout) << "in HTTPAcceptor::_bind After memset" << PEGASUS_STD(endl); |
|
} |
|
#endif |
| |
if (_localConnection) | if (_localConnection) |
{ | { |
|
// Added for NamedPipe implementation for windows |
#ifndef PEGASUS_DISABLE_LOCAL_DOMAIN_SOCKET | #ifndef PEGASUS_DISABLE_LOCAL_DOMAIN_SOCKET |
|
|
|
# ifdef PEGASUS_OS_TYPE_WINDOWS |
|
# ifdef PEGASUS_LOCALDOMAINSOCKET_DEBUG |
|
{ |
|
AutoMutex automut(Monitor::_cout_mut); |
|
PEGASUS_STD(cout) << "in HTTPAcceptor::_bind before calling _createNamedPipe() " |
|
<< PEGASUS_STD(endl); |
|
} |
|
# endif |
|
_createNamedPipe(); |
|
# ifdef PEGASUS_LOCALDOMAINSOCKET_DEBUG |
|
{ |
|
AutoMutex automut(Monitor::_cout_mut); |
|
PEGASUS_STD(cout) << "in HTTPAcceptor::_bind after calling _createNamedPipe() " << PEGASUS_STD(endl); |
|
} |
|
# endif |
|
return; |
|
# else // Other than Windows platform |
reinterpret_cast<struct sockaddr_un*>(_rep->address)->sun_family = | reinterpret_cast<struct sockaddr_un*>(_rep->address)->sun_family = |
AF_UNIX; | AF_UNIX; |
strcpy(reinterpret_cast<struct sockaddr_un*>(_rep->address)->sun_path, |
strcpy( |
|
reinterpret_cast<struct sockaddr_un*>(_rep->address)->sun_path, |
PEGASUS_LOCAL_DOMAIN_SOCKET_PATH); | PEGASUS_LOCAL_DOMAIN_SOCKET_PATH); |
|
|
#ifdef PEGASUS_PLATFORM_OS400_ISERIES_IBM | #ifdef PEGASUS_PLATFORM_OS400_ISERIES_IBM |
AtoE(reinterpret_cast<struct sockaddr_un*>(_rep->address)->sun_path); | AtoE(reinterpret_cast<struct sockaddr_un*>(_rep->address)->sun_path); |
#endif | #endif |
::unlink(reinterpret_cast<struct sockaddr_un*>(_rep->address)->sun_path); | ::unlink(reinterpret_cast<struct sockaddr_un*>(_rep->address)->sun_path); |
|
# endif |
|
|
#else | #else |
PEGASUS_ASSERT(false); | PEGASUS_ASSERT(false); |
#endif | #endif |
|
|
} | } |
| |
// Create socket: | // Create socket: |
|
|
if (_localConnection) | if (_localConnection) |
{ | { |
_rep->socket = socket(AF_UNIX, SOCK_STREAM, 0); | _rep->socket = socket(AF_UNIX, SOCK_STREAM, 0); |
|
|
} | } |
#endif | #endif |
| |
|
|
// | // |
// Set the socket option SO_REUSEADDR to reuse the socket address so | // Set the socket option SO_REUSEADDR to reuse the socket address so |
// that we can rebind to a new socket using the same address when we | // that we can rebind to a new socket using the same address when we |
|
|
throw BindFailedException(parms); | throw BindFailedException(parms); |
} | } |
| |
|
|
// | // |
// Bind socket to port: | // Bind socket to port: |
// | // |
|
|
throw BindFailedException(parms); | throw BindFailedException(parms); |
} | } |
| |
|
|
// | // |
// Get the actual port value used if the caller specified a port value of 0. | // Get the actual port value used if the caller specified a port value of 0. |
// | // |
|
|
} | } |
} | } |
| |
|
|
// | // |
// Change permissions on Linux local domain socket to allow writes by others. | // Change permissions on Linux local domain socket to allow writes by others. |
// | // |
|
|
#endif | #endif |
| |
// Set up listening on the given socket: | // Set up listening on the given socket: |
|
|
//int const MAX_CONNECTION_QUEUE_LENGTH = 15; | //int const MAX_CONNECTION_QUEUE_LENGTH = 15; |
| |
if (listen(_rep->socket, MAX_CONNECTION_QUEUE_LENGTH) < 0) | if (listen(_rep->socket, MAX_CONNECTION_QUEUE_LENGTH) < 0) |
|
|
"HTTPAcceptor::_bind: Failed to solicit socket messages(2)."); | "HTTPAcceptor::_bind: Failed to solicit socket messages(2)."); |
throw BindFailedException(parms); | throw BindFailedException(parms); |
} | } |
|
#ifdef PEGASUS_LOCALDOMAINSOCKET_DEBUG |
|
{ |
|
AutoMutex automut(Monitor::_cout_mut); |
|
PEGASUS_STD(cout) << "in HTTPAcceptor::_bind at the End" << PEGASUS_STD(endl); |
|
} |
|
#endif |
|
|
} | } |
| |
/** | /** |
|
|
// Unlink Local Domain Socket Bug# 3312 | // Unlink Local Domain Socket Bug# 3312 |
if (_localConnection) | if (_localConnection) |
{ | { |
|
#ifndef PEGASUS_OS_TYPE_WINDOWS |
#ifndef PEGASUS_DISABLE_LOCAL_DOMAIN_SOCKET | #ifndef PEGASUS_DISABLE_LOCAL_DOMAIN_SOCKET |
PEG_TRACE_STRING(TRC_HTTP, Tracer::LEVEL2, | PEG_TRACE_STRING(TRC_HTTP, Tracer::LEVEL2, |
"HTTPAcceptor::closeConnectionSocket Unlinking local connection." ); | "HTTPAcceptor::closeConnectionSocket Unlinking local connection." ); |
|
|
#else | #else |
PEGASUS_ASSERT(false); | PEGASUS_ASSERT(false); |
#endif | #endif |
|
#endif |
} | } |
| |
} | } |
|
|
return _portNumber; | return _portNumber; |
} | } |
| |
void HTTPAcceptor::setSocketWriteTimeout(Uint32 socketWriteTimeout) |
|
{ |
|
_socketWriteTimeout = socketWriteTimeout; |
|
} |
|
|
|
void HTTPAcceptor::setIdleConnectionTimeout(Uint32 idleConnectionTimeoutSeconds) |
|
{ |
|
_idleConnectionTimeoutSeconds = idleConnectionTimeoutSeconds; |
|
} |
|
|
|
void HTTPAcceptor::unbind() | void HTTPAcceptor::unbind() |
{ | { |
if (_rep) | if (_rep) |
|
|
if (_localConnection) | if (_localConnection) |
{ | { |
#ifndef PEGASUS_DISABLE_LOCAL_DOMAIN_SOCKET | #ifndef PEGASUS_DISABLE_LOCAL_DOMAIN_SOCKET |
|
# ifndef PEGASUS_OS_TYPE_WINDOWS |
|
|
::unlink( | ::unlink( |
reinterpret_cast<struct sockaddr_un*>(_rep->address)->sun_path); | reinterpret_cast<struct sockaddr_un*>(_rep->address)->sun_path); |
|
# endif |
#else | #else |
PEGASUS_ASSERT(false); | PEGASUS_ASSERT(false); |
#endif | #endif |
|
|
for (Uint32 i = 0, n = _rep->connections.size(); i < n; i++) | for (Uint32 i = 0, n = _rep->connections.size(); i < n; i++) |
{ | { |
HTTPConnection* connection = _rep->connections[i]; | HTTPConnection* connection = _rep->connections[i]; |
|
// Added for NamedPipe implementation for windows |
|
#if defined PEGASUS_OS_TYPE_WINDOWS && !defined(PEGASUS_DISABLE_LOCAL_DOMAIN_SOCKET) |
|
if(!connection->isNamedPipeConnection()) |
|
{ |
|
#endif |
PEGASUS_SOCKET socket = connection->getSocket(); | PEGASUS_SOCKET socket = connection->getSocket(); |
| |
// Unsolicit SocketMessages: | // Unsolicit SocketMessages: |
| |
_monitor->unsolicitSocketMessages(socket); | _monitor->unsolicitSocketMessages(socket); |
| |
|
// Added for NamedPipe implementation for windows |
// Destroy the connection (causing it to close): | // Destroy the connection (causing it to close): |
|
#if defined PEGASUS_OS_TYPE_WINDOWS && !defined(PEGASUS_DISABLE_LOCAL_DOMAIN_SOCKET) |
|
} |
|
else |
|
{ |
|
NamedPipe namedPipe = connection->getNamedPipe(); |
|
_monitor->unsolicitPipeMessages(namedPipe); |
|
} |
|
#endif |
while (connection->refcount.get()) { } | while (connection->refcount.get()) { } |
delete connection; | delete connection; |
} | } |
|
|
return; | return; |
| |
// Accept the connection (populate the address): | // Accept the connection (populate the address): |
|
|
struct sockaddr* accept_address; | struct sockaddr* accept_address; |
PEGASUS_SOCKLEN_T address_size; | PEGASUS_SOCKLEN_T address_size; |
| |
if (_localConnection) | if (_localConnection) |
{ | { |
|
#ifndef PEGASUS_OS_TYPE_WINDOWS |
#ifndef PEGASUS_DISABLE_LOCAL_DOMAIN_SOCKET | #ifndef PEGASUS_DISABLE_LOCAL_DOMAIN_SOCKET |
accept_address = reinterpret_cast<struct sockaddr*>(new struct sockaddr_un); | accept_address = reinterpret_cast<struct sockaddr*>(new struct sockaddr_un); |
address_size = sizeof(struct sockaddr_un); | address_size = sizeof(struct sockaddr_un); |
#else | #else |
PEGASUS_ASSERT(false); | PEGASUS_ASSERT(false); |
#endif | #endif |
|
#endif |
} | } |
else | else |
{ | { |
|
|
AutoPtr<MP_Socket> mp_socket(new MP_Socket( | AutoPtr<MP_Socket> mp_socket(new MP_Socket( |
socket, _sslcontext, _sslContextObjectLock, _exportConnection)); | socket, _sslcontext, _sslContextObjectLock, _exportConnection)); |
| |
mp_socket->setSocketWriteTimeout(_socketWriteTimeout); |
|
|
|
// Perform the SSL handshake, if applicable. Make the socket non-blocking | // Perform the SSL handshake, if applicable. Make the socket non-blocking |
// for this operation so we can send it back to the Monitor's select() loop | // for this operation so we can send it back to the Monitor's select() loop |
// if it takes a while. | // if it takes a while. |
|
|
HTTPConnection* connection = new HTTPConnection(_monitor, mp_socket, | HTTPConnection* connection = new HTTPConnection(_monitor, mp_socket, |
this, static_cast<MessageQueue *>(_outputMessageQueue), _exportConnection); | this, static_cast<MessageQueue *>(_outputMessageQueue), _exportConnection); |
| |
if (_idleConnectionTimeoutSeconds) |
|
{ |
|
connection->_idleConnectionTimeoutSeconds = |
|
_idleConnectionTimeoutSeconds; |
|
connection->_idleStartTime = TimeValue::getCurrentTime(); |
|
} |
|
|
|
if (socketAcceptStatus == 0) | if (socketAcceptStatus == 0) |
{ | { |
PEG_TRACE_STRING(TRC_HTTP, Tracer::LEVEL2, | PEG_TRACE_STRING(TRC_HTTP, Tracer::LEVEL2, |
"HTTPAcceptor: SSL_accept() pending"); | "HTTPAcceptor: SSL_accept() pending"); |
connection->_acceptPending = true; | connection->_acceptPending = true; |
connection->_acceptPendingStartTime = TimeValue::getCurrentTime(); |
|
} | } |
| |
// Solicit events on this new connection's socket: | // Solicit events on this new connection's socket: |
|
|
_rep->connections.append(connection); | _rep->connections.append(connection); |
} | } |
| |
|
// Added for NamedPipe implementation for windows |
|
#if defined PEGASUS_OS_TYPE_WINDOWS && !defined(PEGASUS_DISABLE_LOCAL_DOMAIN_SOCKET) |
|
void HTTPAcceptor::_createNamedPipe() |
|
{ |
|
#ifdef PEGASUS_LOCALDOMAINSOCKET_DEBUG |
|
{ |
|
AutoMutex automut(Monitor::_cout_mut); |
|
PEGASUS_STD(cout) << "Entering HTTPAcceptor::_createNamedPipe()." << PEGASUS_STD(endl); |
|
} |
|
#endif |
|
_rep->namedPipeServer = new NamedPipeServer(PEGASUS_NAMEDPIPE_PATH); |
|
#ifdef PEGASUS_LOCALDOMAINSOCKET_DEBUG |
|
{ |
|
AutoMutex automut(Monitor::_cout_mut); |
|
PEGASUS_STD(cout) << "in HTTPAcceptor::_createNamedPipe() after calling the pipe server constructor" << PEGASUS_STD(endl); |
|
} |
|
|
|
{ |
|
AutoMutex automut(Monitor::_cout_mut); |
|
cout << "Named pipe...in _createNamedPipe..." << _rep->namedPipeServer->getPipe() << endl; |
|
} |
|
#endif |
|
// Register to receive Messages on Connection pipe: |
|
|
|
if ( -1 == ( _entry_index = _monitor->solicitPipeMessages( |
|
*_rep->namedPipeServer, |
|
NamedPipeMessage::READ | NamedPipeMessage::EXCEPTION, |
|
getQueueId(), |
|
Monitor::ACCEPTOR))) |
|
{ |
|
::CloseHandle(_rep->namedPipeServer->getPipe()); |
|
delete _rep; |
|
_rep = 0; |
|
//l10n |
|
MessageLoaderParms parms("Common.HTTPAcceptor.FAILED_SOLICIT_SOCKET_MESSAGES", |
|
"Failed to solicit socket messaeges"); |
|
PEG_TRACE_STRING(TRC_DISCARDED_DATA, Tracer::LEVEL2, |
|
"HTTPAcceptor::_bind: Failed to solicit pipe messages(2)."); |
|
throw BindFailedException(parms); |
|
#ifdef PEGASUS_LOCALDOMAINSOCKET_DEBUG |
|
{ |
|
AutoMutex automut(Monitor::_cout_mut); //added |
|
PEGASUS_STD(cout) << "in HTTPAcceptor::_createNamedPipe() _monitor->solicitSocketMessages failed" |
|
<< PEGASUS_STD(endl); |
|
} |
|
#endif |
|
} |
|
#ifdef PEGASUS_LOCALDOMAINSOCKET_DEBUG |
|
{ |
|
AutoMutex automut(Monitor::_cout_mut); |
|
PEGASUS_STD(cout) << "Leaving HTTPAcceptor::_createNamedPipe()." << PEGASUS_STD(endl); |
|
} |
|
#endif |
|
return; |
|
} |
|
|
|
void HTTPAcceptor::_acceptNamedPipeConnection() |
|
{ |
|
PEGASUS_ASSERT(_rep != 0); |
|
|
|
if (!_rep) |
|
return; |
|
#ifdef PEGASUS_LOCALDOMAINSOCKET_DEBUG |
|
{ |
|
AutoMutex automut(Monitor::_cout_mut); |
|
cout <<"In HTTPAcceptor::_acceptNamedPipeConnection " << endl; |
|
} |
|
#endif |
|
|
|
|
|
NamedPipeServerEndPiont nPSEndPoint = _rep->namedPipeServer->accept(); |
|
// Register to receive Messages on Connection pipe: |
|
#ifdef PEGASUS_LOCALDOMAINSOCKET_DEBUG |
|
{ |
|
AutoMutex automut(Monitor::_cout_mut); |
|
cout << " In _acceptNamedPipeConnection -- after calling namedPipeServer->accept()" << endl; |
|
} |
|
#endif |
|
HTTPConnection* connection = new HTTPConnection(_monitor, nPSEndPoint, |
|
this, static_cast<MessageQueue *>(_outputMessageQueue), _exportConnection); |
|
|
|
// Solicit events on this new connection's socket: |
|
int index; |
|
#ifdef PEGASUS_LOCALDOMAINSOCKET_DEBUG |
|
{ |
|
AutoMutex automut(Monitor::_cout_mut); |
|
cout << endl << connection->getNamedPipe().getName() << " has a this as a QueueID " << |
|
connection->getQueueId() << endl; |
|
} |
|
#endif |
|
if (-1 == (index = _monitor->solicitPipeMessages( |
|
connection->getNamedPipe(), |
|
NamedPipeMessage::READ | NamedPipeMessage::EXCEPTION, |
|
connection->getQueueId(), Monitor::ACCEPTOR)) ) |
|
{ |
|
// ATTN-DE-P2-2003100503::TODO::Need to enhance code to return |
|
// an error message to Client application. |
|
Tracer::trace(TRC_DISCARDED_DATA, Tracer::LEVEL2, |
|
"HTTPAcceptor::_acceptPipeConnection: Attempt to allocate entry in _entries table failed."); |
|
delete connection; |
|
return; |
|
} |
|
|
|
// Save the socket for cleanup later: |
|
connection->_entry_index = index; |
|
AutoMutex autoMut(_rep->_connection_mut); |
|
_rep->connections.append(connection); |
|
#ifdef PEGASUS_LOCALDOMAINSOCKET_DEBUG |
|
{ |
|
AutoMutex automut(Monitor::_cout_mut); |
|
PEGASUS_STD(cout) |
|
<< "in HTTPAcceptor::_acceptNamedPipeConnection() at the end" << PEGASUS_STD(endl); |
|
} |
|
#endif |
|
} |
|
#endif |
|
|
PEGASUS_NAMESPACE_END | PEGASUS_NAMESPACE_END |