kerneltest/e32test/mmu/t_shbuf_perfserver.cpp
changeset 9 96e5fb8b040d
equal deleted inserted replaced
-1:000000000000 9:96e5fb8b040d
       
     1 // Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).
       
     2 // All rights reserved.
       
     3 // This component and the accompanying materials are made available
       
     4 // under the terms of the License "Eclipse Public License v1.0"
       
     5 // which accompanies this distribution, and is available
       
     6 // at the URL "http://www.eclipse.org/legal/epl-v10.html".
       
     7 //
       
     8 // Initial Contributors:
       
     9 // Nokia Corporation - initial contribution.
       
    10 //
       
    11 // Contributors:
       
    12 //
       
    13 // Description:
       
    14 // t_shbuf_perfserver.cpp
       
    15 //
       
    16 //
       
    17 
       
    18 /**
       
    19  *  @file
       
    20  * 
       
    21  *  Test server used for Performance Testing of shared buffers.
       
    22  */
       
    23 
       
    24 #include <e32std.h>
       
    25 #include <e32debug.h>
       
    26 #include <e32msgqueue.h>
       
    27 #include <e32shbuf.h>
       
    28 
       
    29 #include "t_shbuf_perfserver.h"
       
    30 
       
    31 
       
    32 /**
       
    33  *  Second phase constructor for sessions. Called by the CServer2 framework
       
    34  *  when a session is created (e.g. a connection is made to the server).
       
    35  */
       
    36 void CShBufTestServerSession::CreateL()
       
    37 	{
       
    38 	Server().AddSessionL(this);
       
    39 	} // CShBufTestServerSession::CreateL()
       
    40 
       
    41 
       
    42 /**
       
    43  *  Destructor for session classes. When this is called it indicates that
       
    44  *  a session is closing its connection with the server.
       
    45  */
       
    46 CShBufTestServerSession::~CShBufTestServerSession()
       
    47 	{
       
    48 	Server().DropSession(this);
       
    49 	} // CShBufTestServerSession::~CShBufTestServerSession()
       
    50 
       
    51 
       
    52 /**
       
    53  *  Handle message requests for this session. Leaving is handled by
       
    54  *  CShBufTestServer::RunError() which reports the error code to the client.
       
    55  *
       
    56  *  @param aMessage  RMessage2 reference which encapsulates a client request.
       
    57  */
       
    58 void CShBufTestServerSession::ServiceL(const RMessage2& aMessage)
       
    59 
       
    60 	{
       
    61 	switch (aMessage.Function())
       
    62 		{
       
    63 		case EShBufServerShutdownServer:
       
    64 			{
       
    65 			ShutdownServerL(aMessage);
       
    66 			}
       
    67 			break;
       
    68 
       
    69 		case EShBufServerFromTPtr8ProcessAndReturn:
       
    70 			{
       
    71 			FromTPtr8ProcessAndReturnL(aMessage);
       
    72 			}
       
    73 			break;
       
    74 
       
    75 		case EShBufServerFromTPtr8ProcessAndRelease:
       
    76 			{
       
    77 			FromTPtr8ProcessAndReleaseL(aMessage);
       
    78 			}
       
    79 			break;
       
    80 
       
    81 		case EShBufServerOpenRShBufPool:
       
    82 			{
       
    83 			OpenRShBufPoolL(aMessage);
       
    84 			}
       
    85 			break;
       
    86 
       
    87 		case EShBufServerCloseRShBufPool:
       
    88 			{
       
    89 			CloseRShBufPoolL(aMessage);
       
    90 			}
       
    91 			break;
       
    92 
       
    93 		case EShBufServerFromRShBufProcessAndReturn:
       
    94 			{
       
    95 			FromRShBufProcessAndReturnL(aMessage);
       
    96 			}
       
    97 			break;
       
    98 
       
    99 		case EShBufServerFromRShBufProcessAndRelease:
       
   100 			{
       
   101 			FromRShBufProcessAndReleaseL(aMessage);
       
   102 			}
       
   103 			break;
       
   104 
       
   105 		case EShBufServerDbgMarkHeap:
       
   106 			{
       
   107 			DbgMarkHeapL(aMessage);
       
   108 			}
       
   109 			break;
       
   110 
       
   111 		case EShBufServerDbgCheckHeap:
       
   112 			{
       
   113 			DbgCheckHeapL(aMessage);
       
   114 			}
       
   115 			break;
       
   116 
       
   117 		case EShBufServerDbgMarkEnd:
       
   118 			{
       
   119 			DbgMarkEndL(aMessage);
       
   120 			}
       
   121 			break;
       
   122 
       
   123 		case EShBufServerDbgFailNext:
       
   124 			{
       
   125 			DbgFailNextL(aMessage);
       
   126 			}
       
   127 			break;
       
   128 
       
   129 		default:
       
   130 			{
       
   131 			aMessage.Panic(KRShBufTestServerName, 999);
       
   132 			}
       
   133 			break;
       
   134 		}
       
   135 	} // CShBufTestServerSession::ServiceL()
       
   136 
       
   137 
       
   138 /**
       
   139  *  Completes a client request. This function provides a single point of
       
   140  *  message completion which benefits debugging and maintenance.
       
   141  *
       
   142  *  @param aMessage  The RMessage2 client request.
       
   143  *  @param aResult   Result of the request.
       
   144  */
       
   145 void CShBufTestServerSession::CompleteRequest(const RMessage2& aMessage,
       
   146 										      TInt aResult) const
       
   147 	{
       
   148 	if (aMessage.IsNull() == EFalse)
       
   149 		{
       
   150 	    aMessage.Complete(aResult);
       
   151 		}
       
   152     } // CShBufTestServerSession::CompleteRequest()
       
   153 
       
   154 
       
   155 /**
       
   156  *  Takes a buffer from the client, sends to the driver and back to the client.
       
   157  *
       
   158  *  @param aMessage  RMessage2 client request.
       
   159  */
       
   160 void CShBufTestServerSession::FromTPtr8ProcessAndReturnL(const RMessage2& aMessage)
       
   161 	{
       
   162 	//
       
   163 	// Read the client buffer...
       
   164 	//
       
   165 	TPtr8  bufPtr(iSessionTempBuffer, sizeof(iSessionTempBuffer));
       
   166 	
       
   167 	aMessage.ReadL(0, bufPtr); 
       
   168 
       
   169 	TUint bufSize;
       
   170 
       
   171 	bufSize = aMessage.Int1();
       
   172 
       
   173 	//
       
   174 	// Pass to the server to pass to the driver and back...
       
   175 	//
       
   176 	TInt  result;
       
   177 	
       
   178 	result = Server().FromTPtr8ProcessAndReturn(bufPtr, bufSize);
       
   179 
       
   180 	//
       
   181 	// Write the client buffer back...
       
   182 	//
       
   183 	aMessage.WriteL(0, bufPtr); 
       
   184 
       
   185 	//
       
   186 	// Complete the request...
       
   187 	//
       
   188 	CompleteRequest(aMessage, result);
       
   189 	} // CShBufTestServerSession::FromTPtr8ProcessAndReturnL
       
   190 
       
   191 
       
   192 /**
       
   193  *  Takes a buffer from the client and sends to the driver.
       
   194  *
       
   195  *  @param aMessage  RMessage2 client request.
       
   196  */
       
   197 void CShBufTestServerSession::FromTPtr8ProcessAndReleaseL(const RMessage2& aMessage)
       
   198 	{
       
   199 	//
       
   200 	// Read the client buffer...
       
   201 	//
       
   202 	TPtr8  bufPtr(iSessionTempBuffer, sizeof(iSessionTempBuffer));
       
   203 	
       
   204 	aMessage.ReadL(0, bufPtr); 
       
   205 
       
   206 	//
       
   207 	// Pass to the server to pass to the driver and back...
       
   208 	//
       
   209 	TInt  result;
       
   210 	
       
   211 	result = Server().FromTPtr8ProcessAndRelease(bufPtr);
       
   212 
       
   213 	//
       
   214 	// Complete the request...
       
   215 	//
       
   216 	CompleteRequest(aMessage, result);
       
   217 	} // CShBufTestServerSession::FromTPtr8ProcessAndReleaseL
       
   218 
       
   219 
       
   220 /**
       
   221  *  Allows the client to ask the test server to open a buffer pool.
       
   222  *
       
   223  *  @param aMessage  RMessage2 client request.
       
   224  */
       
   225 void CShBufTestServerSession::OpenRShBufPoolL(const RMessage2& aMessage)
       
   226 	{
       
   227 	//
       
   228 	// Read the handle...
       
   229 	//
       
   230 	TInt  poolHandle = aMessage.Int0();
       
   231 	
       
   232 	//
       
   233 	// Read the pool info...
       
   234 	//
       
   235 	TShPoolInfo  shPoolInfo;
       
   236 	TPckg<TShPoolInfo>  shPoolInfoPckg(shPoolInfo);
       
   237 	
       
   238 	aMessage.ReadL(1, shPoolInfoPckg); 
       
   239 
       
   240 	//
       
   241 	// Pass to the server to open the pool...
       
   242 	//
       
   243 	TInt  result = Server().OpenRShBufPool(poolHandle, shPoolInfo);
       
   244 
       
   245 	//
       
   246 	// Complete the request...
       
   247 	//
       
   248 	CompleteRequest(aMessage, result);
       
   249 	} // CShBufTestServerSession::OpenRShBufPoolL
       
   250 
       
   251 
       
   252 /**
       
   253  *  Allows the client to ask the test server to close a buffer pool.
       
   254  *
       
   255  *  @param aMessage  RMessage2 client request.
       
   256  */
       
   257 void CShBufTestServerSession::CloseRShBufPoolL(const RMessage2& aMessage)
       
   258 	{
       
   259 	//
       
   260 	// Pass to the server to close the pool...
       
   261 	//
       
   262 	TInt  result = Server().CloseRShBufPool();
       
   263 
       
   264 	//
       
   265 	// Complete the request...
       
   266 	//
       
   267 	CompleteRequest(aMessage, result);
       
   268 	} // CShBufTestServerSession::CloseRShBufPoolL
       
   269 
       
   270 
       
   271 /**
       
   272  *  Takes a buffer from the client, sends to the driver and back to the client.
       
   273  *
       
   274  *  @param aMessage  RMessage2 client request.
       
   275  */
       
   276 void CShBufTestServerSession::FromRShBufProcessAndReturnL(const RMessage2& aMessage)
       
   277 	{
       
   278 	//
       
   279 	// Read the client handle buffer...
       
   280 	//
       
   281 	RShBuf shBuf;
       
   282 	TUint bufSize;
       
   283 
       
   284 	bufSize = aMessage.Int1();
       
   285 
       
   286 	//
       
   287 	// Pass to the server to pass to the driver and back...
       
   288 	//
       
   289 	TInt  result;
       
   290 
       
   291 	result = Server().FromRShBufProcessAndReturn(shBuf, bufSize);
       
   292 
       
   293 	//
       
   294 	// Write the client buffer handle back...
       
   295 	//
       
   296 #ifdef CAN_TRANSFER_SHBUF_TO_ANOTHER_PROCESS
       
   297 	// TDBD aMessage.Complete(shbuf->Handle());
       
   298 #else
       
   299 	TPckg<TInt> handlePckg(shBuf.Handle());
       
   300 	aMessage.WriteL(0, handlePckg);
       
   301 #endif
       
   302 
       
   303 	//
       
   304 	// Complete the request...
       
   305 	//
       
   306 	CompleteRequest(aMessage, result);
       
   307 	} // CShBufTestServerSession::FromRShBufProcessAndReturnL
       
   308 
       
   309 
       
   310 /**
       
   311  *  Takes a buffer from the client and sends to the driver.
       
   312  *
       
   313  *  @param aMessage  RMessage2 client request.
       
   314  */
       
   315 void CShBufTestServerSession::FromRShBufProcessAndReleaseL(const RMessage2& aMessage)
       
   316 	{
       
   317 	//
       
   318 	// Read the client buffer handle...
       
   319 	//
       
   320 
       
   321 	RShBuf  shBuf;
       
   322 
       
   323 #ifdef CAN_TRANSFER_SHBUF_TO_ANOTHER_PROCESS
       
   324 	// TBD RShBuf.Open(aMessage, 0);
       
   325 #else
       
   326 	shBuf.SetReturnedHandle(aMessage.Int0());
       
   327 #endif
       
   328 
       
   329 	//
       
   330 	// Pass to the server to pass to the driver and back...
       
   331 	//
       
   332 	TInt  result;
       
   333 	
       
   334 	result = Server().FromRShBufProcessAndRelease(shBuf);
       
   335 
       
   336 	//
       
   337 	// Complete the request...
       
   338 	//
       
   339 	CompleteRequest(aMessage, result);
       
   340 	} // CShBufTestServerSession::FromRShBufProcessAndReleaseL
       
   341 
       
   342 
       
   343 /**
       
   344  *  Requests the server to mark the start of checking the server's heap.
       
   345  *  This function only works in debug releases and is a synchronous request
       
   346  *  which will be completed when the procedure returns.
       
   347  *
       
   348  *  @param aMessage  RMessage2 client request.
       
   349  */
       
   350 void CShBufTestServerSession::DbgMarkHeapL(const RMessage2& aMessage)
       
   351 	{
       
   352 	TInt  result;
       
   353 	
       
   354 	result = Server().DbgMarkHeap();
       
   355 
       
   356 	//
       
   357 	// Complete the request...
       
   358 	//
       
   359 	CompleteRequest(aMessage, result);
       
   360 	} // CShBufTestServerSession::DbgMarkHeapL()
       
   361 
       
   362 
       
   363 /**
       
   364  *  Requests the server to check that the number of allocated cells at the
       
   365  *  current nested level on the server's heap is the same as the specified value.
       
   366  *  This function only works for debug builds and is a synchronous request
       
   367  *  which will be completed when the procedure returns.
       
   368  *
       
   369  *  @param aMessage  RMessage2 client request.
       
   370  */
       
   371 void CShBufTestServerSession::DbgCheckHeapL(const RMessage2& aMessage)
       
   372 	{
       
   373 	TInt  count = aMessage.Int0();
       
   374 	TInt  result;
       
   375 	
       
   376 	result = Server().DbgCheckHeap(count);
       
   377 
       
   378 	//
       
   379 	// Complete the request...
       
   380 	//
       
   381 	CompleteRequest(aMessage, result);
       
   382 	} // CShBufTestServerSession::DbgCheckHeapL()
       
   383 
       
   384 
       
   385 /**
       
   386  *  Requests the server to mark the end of checking the server's heap. This
       
   387  *  function must match an earlier call to DbgMarkHeap() and only functions
       
   388  *  on debug releases. This is a synchronous request which will be completed
       
   389  *  when the procedure returns.
       
   390  *
       
   391  *  @param aMessage  RMessage2 client request.
       
   392  */
       
   393 void CShBufTestServerSession::DbgMarkEndL(const RMessage2& aMessage)
       
   394 	{
       
   395 	TInt  count = aMessage.Int0();
       
   396 	TInt  result;
       
   397 	
       
   398 	result = Server().DbgMarkEnd(count);
       
   399 
       
   400 	//
       
   401 	// Complete the request...
       
   402 	//
       
   403 	CompleteRequest(aMessage, result);
       
   404 	} // CShBufTestServerSession::DbgMarkEndL()
       
   405 
       
   406 
       
   407 /**
       
   408  *  Simulates heap allocation failure for the sever. The failure occurs on
       
   409  *  the next call to new or any of the functions which allocate memory from
       
   410  *  the heap. This is defined only for debug builds and is a synchronous
       
   411  *  request which will be completed when the procedure returns.
       
   412  *
       
   413  *  @param aMessage  RMessage2 client request.
       
   414  */
       
   415 void CShBufTestServerSession::DbgFailNextL(const RMessage2& aMessage)
       
   416 	{
       
   417 	TInt  count = aMessage.Int0();
       
   418 	TInt  result;
       
   419 	
       
   420 	result = Server().DbgFailNext(count);
       
   421 
       
   422 	//
       
   423 	// Complete the request...
       
   424 	//
       
   425 	CompleteRequest(aMessage, result);
       
   426 	} // CShBufTestServerSession::DbgFailNextL()
       
   427 
       
   428 
       
   429 /**
       
   430  *  Requests the server to shut down when it no longer has any connected
       
   431  *  sessions. This procedure is only premitted in debug builds for security
       
   432  *  reasons (e.g. to prevent a denial of service attack) and is provided
       
   433  *  for testing purposes. This is a synchronous request which will be
       
   434  *  completed when the procedure returns. The server will shutdown when the
       
   435  *  last session disconnects.
       
   436  *
       
   437  *  @param aMessage  RMessage2 client request.
       
   438  */
       
   439 void CShBufTestServerSession::ShutdownServerL(const RMessage2& aMessage)
       
   440 	{
       
   441 	TInt  result = Server().ShutdownServer();
       
   442 	
       
   443 	//
       
   444 	// Complete the request...
       
   445 	//
       
   446 	CompleteRequest(aMessage, result);
       
   447 	} // CShBufTestServerSession::ShutdownServerL()
       
   448 
       
   449 
       
   450 /**
       
   451  *  Static factory method used to create a CShBufTestServer object.
       
   452  *
       
   453  *  @return  Pointer to the created CShBufTestServer object, or NULL.
       
   454  */
       
   455 CShBufTestServer* CShBufTestServer::NewL()
       
   456 	{
       
   457 	CShBufTestServer* self = new (ELeave) CShBufTestServer();
       
   458 	CleanupStack::PushL(self);
       
   459 	self->ConstructL();
       
   460 	CleanupStack::Pop(self);
       
   461 
       
   462 	return self;
       
   463 	} // CShBufTestServer::NewL
       
   464 
       
   465 
       
   466 /**
       
   467  *  Standard constructor.
       
   468  */
       
   469 CShBufTestServer::CShBufTestServer()
       
   470 	: CServer2(EPriorityNormal),
       
   471 	iShouldShutdownServer(EFalse)
       
   472 	{
       
   473 	__DECLARE_NAME(_L("CShBufTestServer"));
       
   474 	} // CShBufTestServer::CShBufTestServer
       
   475 
       
   476 
       
   477 /**
       
   478  *  Second phase constructor. Ensures the server is created and ready to run.
       
   479  */
       
   480 void CShBufTestServer::ConstructL()
       
   481 	{
       
   482 	//
       
   483 	// Open the driver...
       
   484 	//
       
   485 	TInt  ret;
       
   486 	
       
   487 	ret = User::LoadLogicalDevice(_L("D_SHBUF_CLIENT.LDD"));
       
   488 	if (ret != KErrAlreadyExists)
       
   489 		{
       
   490 		User::LeaveIfError(ret);
       
   491 		}
       
   492 	
       
   493 	ret = User::LoadLogicalDevice(_L("D_SHBUF_OWN.LDD"));
       
   494 	if (ret != KErrAlreadyExists)
       
   495 		{
       
   496 		User::LeaveIfError(ret);
       
   497 		}
       
   498 	
       
   499 	User::LeaveIfError(iShBufLdd.Open(RShBufTestChannel::EClientThread));
       
   500 	
       
   501 	StartL(KRShBufTestServerName);
       
   502 	} // CShBufTestServer::ConstructL
       
   503 
       
   504 
       
   505 /**
       
   506  *  Destructor.
       
   507  */
       
   508 CShBufTestServer::~CShBufTestServer()
       
   509 	{
       
   510 	iSessionArray.Reset();
       
   511 	iShBufLdd.Close();
       
   512 	} // CShBufTestServer::~CShBufTestServer
       
   513 
       
   514 
       
   515 /**
       
   516  *  Create a new client session.
       
   517  */
       
   518 CSession2* CShBufTestServer::NewSessionL(const TVersion&, const RMessage2& /*aMessage*/) const
       
   519 	{
       
   520 	return new(ELeave) CShBufTestServerSession();
       
   521 	} // CShBufTestServer::NewSessionL
       
   522 
       
   523 
       
   524 /**
       
   525  *  Called by the session class when it is being created.
       
   526  *
       
   527  *  @param aSession  Server side session.
       
   528  */
       
   529 void CShBufTestServer::AddSessionL(CShBufTestServerSession* aSession)
       
   530 	{
       
   531 	//
       
   532 	// Store this session in the list of sessions...
       
   533 	//
       
   534 	iSessionArray.Append(aSession);
       
   535 	} // CShBufTestServer::AddSessionL
       
   536 
       
   537 
       
   538 /**
       
   539  *  Called by the session class when it is being destroyed.
       
   540  *
       
   541  *  @param aSession  Server side session.
       
   542  */
       
   543 void CShBufTestServer::DropSession(CShBufTestServerSession* aSession)
       
   544 	{
       
   545 	//
       
   546 	// Remove this session from the session array list...
       
   547 	//
       
   548 	TInt  position;
       
   549 	
       
   550 	position = iSessionArray.Find(aSession);
       
   551  	if (position != KErrNotFound) 
       
   552 		{
       
   553  		iSessionArray.Remove(position);
       
   554 		}
       
   555 
       
   556 	//
       
   557 	// If we are shuting down then unconfigure and stop...
       
   558 	//
       
   559 	if (iSessionArray.Count() == 0  &&  iShouldShutdownServer)
       
   560 		{
       
   561 		CActiveScheduler::Stop();
       
   562 		}
       
   563 	} // CShBufTestServer::DropSession
       
   564 
       
   565 
       
   566 TInt CShBufTestServer::FromTPtr8ProcessAndReturn(TDes8& aBuf, TUint aBufSize)
       
   567 	{
       
   568 	// clear cache
       
   569 	memset(iClearCache, 0xFF, sizeof(iClearCache));
       
   570 
       
   571 	return iShBufLdd.FromTPtr8ProcessAndReturn(aBuf, aBufSize);
       
   572 	} // CShBufTestServer::FromTPtr8ProcessAndReturn
       
   573 
       
   574 
       
   575 TInt CShBufTestServer::FromTPtr8ProcessAndRelease(TDes8& aBuf)
       
   576 	{
       
   577 	return iShBufLdd.FromTPtr8ProcessAndRelease(aBuf);
       
   578 	} // CShBufTestServer::FromTPtr8ProcessAndRelease
       
   579 
       
   580 
       
   581 TInt CShBufTestServer::OpenRShBufPool(TInt aHandle, const TShPoolInfo& aPoolInfo)
       
   582 	{
       
   583 	return iShBufLdd.OpenUserPool(aHandle, aPoolInfo);
       
   584 	} // CShBufTestServer::OpenRShBufPool
       
   585 
       
   586 	
       
   587 TInt CShBufTestServer::CloseRShBufPool()
       
   588 	{
       
   589 	return iShBufLdd.CloseUserPool();
       
   590 	} // CShBufTestServer::CloseRShBufPool
       
   591 
       
   592 	
       
   593 TInt CShBufTestServer::FromRShBufProcessAndReturn(RShBuf& aShBuf, TUint aBufSize)
       
   594 	{
       
   595 	TInt ret;
       
   596 
       
   597 	// clear cache
       
   598 	memset(iClearCache, 0xFF, sizeof(iClearCache));
       
   599 
       
   600 	ret = iShBufLdd.FromRShBufProcessAndReturn(aBufSize);
       
   601 
       
   602 	if (ret > 0)
       
   603 		{
       
   604 		aShBuf.SetReturnedHandle(ret);
       
   605 		return KErrNone;
       
   606 		}
       
   607 
       
   608 	return ret;
       
   609 	} // CShBufTestServer::FromRShBufProcessAndReturn
       
   610 
       
   611 
       
   612 TInt CShBufTestServer::FromRShBufProcessAndRelease(RShBuf& aShBuf)
       
   613 	{
       
   614 	return iShBufLdd.FromRShBufProcessAndRelease(aShBuf.Handle());
       
   615 	} // CShBufTestServer::FromRShBufProcessAndRelease 
       
   616 
       
   617 
       
   618 /**
       
   619  *  Marks the start of checking the server's heap. This function only works
       
   620  *  in debug releases.
       
   621  *
       
   622  *  Calls to this function can be nested but each call must be matched by
       
   623  *  corresponding DbgMarkEnd().
       
   624  *
       
   625  *  @return  KErrNone.
       
   626  */
       
   627 TInt CShBufTestServer::DbgMarkHeap() const
       
   628 	{
       
   629 #ifdef _DEBUG
       
   630 	__UHEAP_MARK;
       
   631 #endif
       
   632 
       
   633 	return(KErrNone);
       
   634 	} // CShBufTestServer::DbgMarkHeap
       
   635 
       
   636 
       
   637 /**
       
   638  *  Checks that the number of allocated cells at the current nested level on
       
   639  *  the server's heap is the same as the specified value. This function only
       
   640  *  works for debug builds.
       
   641  *
       
   642  *  @param aCount  The number of heap cells expected to be allocated at
       
   643  *                 the current nest level.
       
   644  *
       
   645  *  @return  KErrNone.
       
   646  */
       
   647 TInt CShBufTestServer::DbgCheckHeap(TInt aCount) const
       
   648 	{
       
   649 #ifdef _DEBUG 
       
   650 	__UHEAP_CHECK(aCount);
       
   651 #else
       
   652 	(void) aCount;
       
   653 #endif
       
   654 
       
   655 	return(KErrNone);
       
   656 	} // CShBufTestServer::DbgCheckHeap
       
   657 
       
   658 
       
   659 /**
       
   660  *  Marks the end of checking the current server's heap. 
       
   661  *
       
   662  *  The function expects aCount heap cells to remain allocated at the
       
   663  *  current nest level. This function must match an earlier call to
       
   664  *  DbgMarkHeap() and only functions on debug releases.
       
   665  *
       
   666  *  @param aCount  The number of heap cells expected to remain allocated
       
   667  *                 at the current nest level.
       
   668  *
       
   669  *  @return  KErrNone.
       
   670  */
       
   671 TInt CShBufTestServer::DbgMarkEnd(TInt aCount) const
       
   672 	{
       
   673 #ifdef _DEBUG
       
   674 	__UHEAP_MARKENDC(aCount);
       
   675 #else
       
   676 	(void) aCount;
       
   677 #endif
       
   678 
       
   679 	return(KErrNone);
       
   680 	} // CShBufTestServer::DbgMarkEnd
       
   681 
       
   682 
       
   683 /**
       
   684  *  Simulates heap allocation failure for the server.
       
   685  *
       
   686  *  The failure occurs on the next call to new or any of the functions which 
       
   687  *  allocate memory from the heap. This is defined only for debug builds.
       
   688  *
       
   689  *  @param aCount  Determines when the allocation will fail.
       
   690  *
       
   691  *  @return  KErrNone.
       
   692  */
       
   693 TInt CShBufTestServer::DbgFailNext(TInt aCount) const
       
   694 	{
       
   695 #ifdef _DEBUG
       
   696 	if (aCount == 0)
       
   697 		{
       
   698 		__UHEAP_RESET;
       
   699 		}
       
   700 	else
       
   701 		{
       
   702 		__UHEAP_FAILNEXT(aCount);
       
   703 		}
       
   704 #else
       
   705 	(void) aCount;
       
   706 #endif
       
   707 
       
   708 	return(KErrNone);
       
   709 	} // CShBufTestServer::DbgFailNext
       
   710 
       
   711 
       
   712 /**
       
   713  *  Requests the server to shut down when it no longer has any connected
       
   714  *  sessions. This procedure is only premitted in debug builds and is provided
       
   715  *  for testing purposes.
       
   716  *
       
   717  *  The server will shutdown when the last session disconnects.
       
   718  *
       
   719  *  @return KErrNone if the shutdown request was accepted, otherwise returns
       
   720  *          an error.
       
   721  */
       
   722 TInt CShBufTestServer::ShutdownServer()
       
   723 	{
       
   724 	iShouldShutdownServer = ETrue;
       
   725 
       
   726 	return(KErrNone);
       
   727 	} // CShBufTestServer::ShutdownServer
       
   728 
       
   729 
       
   730 
       
   731 /**
       
   732  *  Standard Active Object RunError() method, called when the RunL() method
       
   733  *  leaves, which will be when the CShBufTestServerSession::ServiceL() leaves.
       
   734  *
       
   735  *  Find the current message and complete it before restarting the server.
       
   736  *
       
   737  *  @param aError  Leave code from CShBufTestServerSession::ServiceL().
       
   738  *
       
   739  *  @return KErrNone
       
   740  */
       
   741 TInt CShBufTestServer::RunError(TInt aError)
       
   742 	{
       
   743 	//
       
   744 	// Complete the request with the available error code.
       
   745 	//
       
   746 	if (Message().IsNull() == EFalse)
       
   747 		{
       
   748 		Message().Complete(aError);
       
   749 		}
       
   750 
       
   751 	//
       
   752 	// The leave will result in an early return from CServer::RunL(), skipping
       
   753 	// the call to request another message. So do that now in order to keep the
       
   754 	// server running.
       
   755 	//
       
   756 	ReStart();
       
   757 
       
   758 	return KErrNone;
       
   759 	} // CShBufTestServer::RunError
       
   760 
       
   761 
       
   762 /**
       
   763  *  Perform all server initialisation, in particular creation of the
       
   764  *  scheduler and server and then run the scheduler.
       
   765  */
       
   766 static void RunServerL()
       
   767 	{
       
   768 	//
       
   769 	// Naming the server thread after the server helps to debug panics.
       
   770 	//
       
   771 	User::LeaveIfError(User::RenameThread(KRShBufTestServerName));
       
   772 
       
   773 	//
       
   774 	// Increase priority so that requests are handled promptly...
       
   775 	//
       
   776 	RThread().SetPriority(EPriorityMuchMore);
       
   777 
       
   778 	//	
       
   779 	// Create a new Active Scheduler...
       
   780 	//
       
   781 	CActiveScheduler*  scheduler = new CActiveScheduler();
       
   782 	CleanupStack::PushL(scheduler);	
       
   783 	CActiveScheduler::Install(scheduler);
       
   784 	
       
   785 	//
       
   786 	// Create a new PhoneBookServer...
       
   787 	//
       
   788 	CShBufTestServer*  server = CShBufTestServer::NewL();
       
   789 	CleanupStack::PushL(server);
       
   790 	
       
   791 	//
       
   792 	// Initialisation complete, now signal the client thread...
       
   793 	//
       
   794 #ifdef CAN_TRANSFER_SHBUF_TO_ANOTHER_PROCESS
       
   795 	RProcess::Rendezvous(KErrNone);
       
   796 #else
       
   797 	RThread::Rendezvous(KErrNone);
       
   798 #endif
       
   799 
       
   800 	//
       
   801 	// Run the server...
       
   802 	//
       
   803 	CActiveScheduler::Start();
       
   804 	
       
   805 	CleanupStack::PopAndDestroy(2, scheduler);
       
   806 	} // RunServerL
       
   807 
       
   808 
       
   809 /**
       
   810  *  Server process entry-point.
       
   811  *
       
   812  *  @return  KErrNone or a standard Symbian error code.
       
   813  */
       
   814 #ifdef CAN_TRANSFER_SHBUF_TO_ANOTHER_PROCESS
       
   815 TInt E32Main()
       
   816 #else
       
   817 TInt RShBufTestServerThread(TAny* /*aPtr*/)
       
   818 #endif
       
   819 	{
       
   820 	__UHEAP_MARK;
       
   821 
       
   822 	CTrapCleanup*  cleanup = CTrapCleanup::New();
       
   823 	TInt  ret(KErrNoMemory);
       
   824 
       
   825 	if (cleanup)
       
   826 		{
       
   827 		TRAP(ret, RunServerL());
       
   828 		delete cleanup;
       
   829 		}
       
   830 
       
   831 	__UHEAP_MARKEND;
       
   832 
       
   833 	return ret;
       
   834 	} // E32Main
       
   835 
       
   836 
       
   837