memspy/Engine/Source/Sink/MemSpyEngineOutputSinkFile.cpp
changeset 0 a03f92240627
child 20 ca8a1b6995f6
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/memspy/Engine/Source/Sink/MemSpyEngineOutputSinkFile.cpp	Tue Feb 02 01:57:15 2010 +0200
@@ -0,0 +1,745 @@
+/*
+* Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies). 
+* All rights reserved.
+* This component and the accompanying materials are made available
+* under the terms of "Eclipse Public License v1.0"
+* which accompanies this distribution, and is available
+* at the URL "http://www.eclipse.org/legal/epl-v10.html".
+*
+* Initial Contributors:
+* Nokia Corporation - initial contribution.
+*
+* Contributors:
+*
+* Description:
+*
+*/
+
+#include "MemSpyEngineOutputSinkFile.h"
+
+// System includes
+#include <e32svr.h>
+
+// User includes
+#include <memspy/engine/memspyenginelogger.h>
+#include <memspy/engine/memspyengineutils.h>
+
+// Constants
+const TInt KMemSpyLineBufferLength = 1024;
+const TInt KMemSpyFileServerBufferExpandSize = 1024 * 32;
+
+// Literal constants
+_LIT8( KMemSpyCRLF, "\r\n" );
+
+
+CMemSpyEngineOutputSinkFile::CMemSpyEngineOutputSinkFile( CMemSpyEngine& aEngine )
+:   CMemSpyEngineOutputSink( aEngine )
+    {
+    }
+
+
+CMemSpyEngineOutputSinkFile::~CMemSpyEngineOutputSinkFile()
+    {
+    TRACE( RDebug::Printf( "CMemSpyEngineOutputSinkFile::~CMemSpyEngineOutputSinkFile() - START" ) );
+
+    TRACE( RDebug::Printf( "CMemSpyEngineOutputSinkFile::~CMemSpyEngineOutputSinkFile() - destroying normal logs..." ) );
+    iLogs.ResetAndDestroy();
+    iLogs.Close();
+
+    TRACE( RDebug::Printf( "CMemSpyEngineOutputSinkFile::~CMemSpyEngineOutputSinkFile() - destroying limbo logs..." ) );
+    iLogsPendingDestruction.ResetAndDestroy();
+    iLogsPendingDestruction.Close();
+
+    iFsSession.Close();
+
+    TRACE( RDebug::Printf( "CMemSpyEngineOutputSinkFile::~CMemSpyEngineOutputSinkFile() - END" ) );
+    }
+
+
+void CMemSpyEngineOutputSinkFile::ConstructL()
+    {
+    TRACE( RDebug::Printf( "CMemSpyEngineOutputSinkFile::ConstructL() - START" ) );
+
+    BaseConstructL();
+
+    // Identify the file server process id
+    TRACE( RDebug::Printf( "CMemSpyEngineOutputSinkFile::ConstructL() - identifying f32 process id..." ) );
+    iFileServerProcessId = MemSpyEngineUtils::IdentifyFileServerProcessIdL();
+
+    // Create the standard output file
+    TRACE( RDebug::Printf( "CMemSpyEngineOutputSinkFile::ConstructL() - connecting to f32..." ) );
+    User::LeaveIfError( iFsSession.Connect() );
+    
+    // Make default log file
+    TRACE( RDebug::Printf( "CMemSpyEngineOutputSinkFile::ConstructL() - preparing default log..." ) );
+    ConstructDefaultLogFileL();
+
+    TRACE( RDebug::Printf( "CMemSpyEngineOutputSinkFile::ConstructL() - END" ) );
+    }
+
+
+CMemSpyEngineOutputSinkFile* CMemSpyEngineOutputSinkFile::NewL( CMemSpyEngine& aEngine )
+    {
+    CMemSpyEngineOutputSinkFile* self = new(ELeave) CMemSpyEngineOutputSinkFile( aEngine );
+    CleanupStack::PushL( self );
+    self->ConstructL();
+    CleanupStack::Pop( self );
+    return self;
+    }
+
+
+void CMemSpyEngineOutputSinkFile::ProcessSuspendedL( TProcessId aId )
+    {
+    TRACE( RDebug::Print( _L("CMemSpyEngineOutputSinkFile::ProcessSuspendedL() - START - aId: %d, iFileServerSuspended: %d, iFileServerProcessId: %d"), (TUint) aId, iFileServerSuspended, (TUint) iFileServerProcessId ) );
+
+    iFileServerSuspended = ( (TUint) aId == iFileServerProcessId );
+    if  ( iFileServerSuspended )
+        {
+        const TInt count = iLogs.Count();
+        TRACE( RDebug::Print( _L("CMemSpyEngineOutputSinkFile::ProcessSuspendedL() - enabling buffers for %d logs"), count ) );
+        for( TInt i=0; i<count; i++ )
+            {
+            CMemSpyEngineFileHolder* log = iLogs[i];
+            log->EnableBufferL();
+            }
+        }
+
+    TRACE( RDebug::Print( _L("CMemSpyEngineOutputSinkFile::ProcessSuspendedL() - END - aId: %d, iFileServerSuspended: %d"), (TUint) aId, iFileServerSuspended ) );
+    }
+
+
+void CMemSpyEngineOutputSinkFile::ProcessResumed( TProcessId aId )
+    {
+    const TBool isF32Process = ( (TUint) aId == iFileServerProcessId );
+    TRACE( RDebug::Print( _L("CMemSpyEngineOutputSinkFile::ProcessResumed() - START - aId: %d, iFileServerSuspended: %d, isF32Process: %d"), (TUint) aId, iFileServerSuspended, isF32Process ) );
+    //
+    if  ( iFileServerSuspended )
+        {
+        __ASSERT_ALWAYS( isF32Process, User::Invariant() );
+
+        TRAPD( err, DisableAllBuffersAfterFileServerResumedL() );
+        if ( err != KErrNone )
+            {
+            TRACE( RDebug::Printf( "CMemSpyEngineOutputSinkFile::ProcessResumed() - disabled all buffers, completed with err: %d", err ) );
+            }
+
+        iLogsPendingDestruction.ResetAndDestroy();
+        TRACE( RDebug::Printf( "CMemSpyEngineOutputSinkFile::ProcessResumed() - deleted all pending destruction logs..." ) );
+
+        // Indicate file server is no longer suspended
+        iFileServerSuspended = EFalse;
+        }
+    
+    TRACE( RDebug::Print( _L("CMemSpyEngineOutputSinkFile::ProcessResumed() - END - aId: %d, iFileServerSuspended: %d, isF32Process: %d"), (TUint) aId, iFileServerSuspended, isF32Process ) );
+    }
+
+
+TMemSpySinkType CMemSpyEngineOutputSinkFile::Type() const
+    {
+    return ESinkTypeFile;
+    }
+
+
+void CMemSpyEngineOutputSinkFile::DataStreamBeginL( const TDesC& aContext, const TDesC& aFolder, const TDesC& aExtension )
+    {
+    DataStreamBeginL( aContext, aFolder, aExtension, ETrue );
+    }
+
+
+void CMemSpyEngineOutputSinkFile::DataStreamBeginL( const TDesC& aContext, const TDesC& aFolder, const TDesC& aExtension, TBool aOverwrite )
+    {
+    DataStreamBeginL( aContext, aFolder, aExtension, aOverwrite, ETrue );
+    }
+
+
+void CMemSpyEngineOutputSinkFile::DataStreamBeginL( const TDesC& aContext, const TDesC& aFolder, const TDesC& aExtension, TBool aOverwrite, TBool aUseTimeStamp )
+    {
+    CMemSpyEngineSinkMetaData* meta = CMemSpyEngineSinkMetaData::NewL( aContext, aFolder, aExtension, aOverwrite, aUseTimeStamp );
+    CleanupStack::PushL( meta );
+
+    TRACE( RDebug::Printf( "CMemSpyEngineOutputSinkFile::DataStreamBeginL() - START - log count: %d, iFileServerSuspended: %d", iLogs.Count(), iFileServerSuspended ) );
+    //
+    CMemSpyEngineFileHolder* log = NULL;
+    if  ( iFileServerSuspended )
+        {
+        TRACE( RDebug::Printf( "CMemSpyEngineOutputSinkFile::DataStreamBeginL() - F32 SUSPENDED!" ) );
+        log = CMemSpyEngineFileHolder::NewLogToRAML( *this, meta );
+        }
+    else
+        {
+        log = CMemSpyEngineFileHolder::NewL( *this, meta );
+        }
+    //
+    TRACE( RDebug::Printf( "CMemSpyEngineOutputSinkFile::DataStreamBeginL() - log: 0x%08x", log ) );
+    CleanupStack::Pop( meta );
+    CleanupStack::PushL( log );
+    iLogs.AppendL( log );
+    CleanupStack::Pop( log );
+    //
+    TRACE( RDebug::Print( _L("CMemSpyEngineOutputSinkFile::DataStreamBeginL() - END - log count: %d, iFileServerSuspended: %d, fileName: [%S]"), iLogs.Count(), iFileServerSuspended, &log->FileName() ) );
+    }
+
+
+void CMemSpyEngineOutputSinkFile::DataStreamEndL()
+    {
+    const TInt count = iLogs.Count();
+    TRACE( RDebug::Printf( "CMemSpyEngineOutputSinkFile::DataStreamEndL() - count: %d", count ) );
+
+    __ASSERT_ALWAYS( count > 1, User::Invariant() );
+
+    CMemSpyEngineFileHolder* headLog = iLogs[ count - 1 ];
+    iLogs.Remove( count - 1 );
+    TRACE( RDebug::Printf( "CMemSpyEngineOutputSinkFile::DataStreamEndL() - headLog: 0x%08x", headLog ) );
+
+    if  ( headLog->UsingBuffer() )
+        {
+        TRACE( RDebug::Printf( "CMemSpyEngineOutputSinkFile::DataStreamEndL() - headLog is using buffer so doing deferred delete when F32 is not suspended anymore..." ) );
+
+        // Must save the log until after its safe to resume 
+        // writing to disk.
+        CleanupStack::PushL( headLog );
+        iLogsPendingDestruction.AppendL( headLog );
+        CleanupStack::Pop( headLog );
+        }
+    else
+        {
+        TRACE( RDebug::Printf( "CMemSpyEngineOutputSinkFile::DataStreamEndL() - deleting head log immediately!" ) );
+        delete headLog;
+        }
+
+    TRACE( RDebug::Printf( "CMemSpyEngineOutputSinkFile::DataStreamEndL() - END" ) );
+    }
+
+
+void CMemSpyEngineOutputSinkFile::DoOutputLineL( const TDesC& aLine )
+    {
+    HeadLog().WriteLineL( aLine );
+    }
+
+
+void CMemSpyEngineOutputSinkFile::DoOutputRawL( const TDesC8& aData )
+    {
+    HeadLog().WriteRawL( aData );
+    }
+
+
+TBool CMemSpyEngineOutputSinkFile::IsPrefixAllowed( const TDesC& /*aPrefix*/ )
+    {
+    // If we are outputting to the main log, then we must allow
+    // the prefix. If we are outputting to a child log, then we don't
+    // need it.
+    return HeadLog().IsMainLog();
+    }
+
+
+void CMemSpyEngineOutputSinkFile::ConstructDefaultLogFileL()
+    {
+    CMemSpyEngineFileHolder* log = CMemSpyEngineFileHolder::NewLC( *this );
+
+    TRACE( RDebug::Printf( "CMemSpyEngineOutputSinkFile::ConstructDefaultLogFileL() - START - headLog: 0x%08x", log ) );
+    iLogs.AppendL( log );
+    CleanupStack::Pop( log );
+
+    TRACE( RDebug::Printf( "CMemSpyEngineOutputSinkFile::ConstructDefaultLogFileL() - END - headLog: 0x%08x", log ) );
+    }
+
+
+void CMemSpyEngineOutputSinkFile::DisableAllBuffersAfterFileServerResumedL()
+    {
+    const TInt count = iLogs.Count();
+    const TInt count2 = iLogsPendingDestruction.Count();
+
+    TRACE( RDebug::Printf( "CMemSpyEngineOutputSinkFile::DisableAllBuffersAfterFileServerResumedL() - START - logs: %d, pending: %d", count, count2 ) );
+
+    TInt err = KErrNone;
+
+    // Inform logging object that they should stop logging to RAM. This may cause files
+    // to be opened and data flushed.
+    for( TInt i=0; i<count; i++ )
+        {
+        CMemSpyEngineFileHolder* log = iLogs[ i ];
+        TRACE( RDebug::Print( _L("CMemSpyEngineOutputSinkFile::DisableAllBuffersAfterFileServerResumedL() -  logN[%2d]: 0x%08x, name: %S"), i, log, &log->FileName() ) );
+        TRAP(err, log->DisableBufferL() );
+        if  ( err != KErrNone )
+            {
+            TRACE( RDebug::Printf( "CMemSpyEngineOutputSinkFile::DisableAllBuffersAfterFileServerResumedL() - error whilst closing log: %d", err ) );
+            }
+        }
+
+    // Finalise any pending destruction log objects. These are log objects
+    // that were created and finalised whilst the file server was suspended.
+    for( TInt ii = count2-1; ii>=0; ii--)
+        {
+        CMemSpyEngineFileHolder* log = iLogsPendingDestruction[ ii ];
+        TRACE( RDebug::Print( _L("CMemSpyEngineOutputSinkFile::DisableAllBuffersAfterFileServerResumedL() - logPD[%2d]: 0x%08x, name: %S"), ii, log, &log->FileName() ) );
+        TRAP(err, log->DisableBufferL() );
+        if  ( err != KErrNone )
+            {
+            TRACE( RDebug::Printf( "CMemSpyEngineOutputSinkFile::DisableAllBuffersAfterFileServerResumedL() - error whilst closing log: %d", err ) );
+            }
+        }
+
+    TRACE( RDebug::Printf( "CMemSpyEngineOutputSinkFile::DisableAllBuffersAfterFileServerResumedL() - END" ) );
+    }
+
+
+CMemSpyEngineFileHolder& CMemSpyEngineOutputSinkFile::HeadLog() const
+    {
+    // Head log is always the first log
+    const TInt count = iLogs.Count();
+    __ASSERT_ALWAYS( count >= 1, User::Invariant() );
+    CMemSpyEngineFileHolder* headLog = iLogs[ count - 1 ];
+
+    //TRACE( RDebug::Print( _L("CMemSpyEngineOutputSinkFile::HeadLog() - headLog: 0x%08x %S"), headLog, &headLog->FileName() ) );
+    return *headLog;
+    }
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+CMemSpyEngineFileHolder::CMemSpyEngineFileHolder( CMemSpyEngineOutputSinkFile& aParent, CMemSpyEngineSinkMetaData* aMetaData )
+:   iParent( aParent ), iMetaData( aMetaData )
+    {
+    }
+
+
+CMemSpyEngineFileHolder::~CMemSpyEngineFileHolder()
+    {
+    TPtrC pFileName( KNullDesC );
+    if  ( iFileName != NULL )
+        {
+        pFileName.Set( *iFileName );
+        }
+    TRACE( RDebug::Print( _L("CMemSpyEngineFileHolder::~CMemSpyEngineFileHolder() - START - this: 0x%08x, iFileName: %S, handle: 0x%08x, iEntireFileBuffer: 0x%08x, iIsMainLog: %d"), this, &pFileName, iFile.SubSessionHandle(), iEntireFileBuffer, iIsMainLog ) );
+
+    if  ( iEntireFileBuffer || iWorkingBuffer )
+        {
+        // This may actually open the file
+        TRACE( RDebug::Printf( "CMemSpyEngineFileHolder::~CMemSpyEngineFileHolder() - disabling file buffers..." ) );
+        TRAP_IGNORE( DisableBufferL() );
+        }
+
+    // Now close the file, deleting anything that is empty
+    if  ( iFile.SubSessionHandle() != KNullHandle )
+        {
+        TRACE( RDebug::Printf( "CMemSpyEngineFileHolder::~CMemSpyEngineFileHolder() - flushing file..." ) );
+
+        // Flush anything that is pending and then check whether 
+        // the file is empty. If so, delete it.
+        iFile.Flush(); // Ignore error
+       
+        // Delete empty files
+        TInt size = 0;
+        TInt err = iFile.Size( size );
+        TRACE( RDebug::Printf( "CMemSpyEngineFileHolder::~CMemSpyEngineFileHolder() - size: %d, err: %d", size, err ) );
+
+        if  ( err == KErrNone && size == 0 )
+            {
+            // Close the file and get F32 to delete it...
+            TRACE( RDebug::Printf( "CMemSpyEngineFileHolder::~CMemSpyEngineFileHolder() - deleting empty file!" ) );
+            iFile.Close();
+            err = FsSession().Delete( *iFileName );
+            TRACE( RDebug::Printf( "CMemSpyEngineFileHolder::~CMemSpyEngineFileHolder() - delete err: %d", err ) );
+            }
+        }
+    //
+    iFile.Close();
+    //
+    delete iLineBuffer;
+    delete iWorkingBuffer;
+    delete iEntireFileBuffer;
+    TRACE( RDebug::Print( _L("CMemSpyEngineFileHolder::~CMemSpyEngineFileHolder() - END - this: 0x%08x, iFileName: %S, iIsMainLog: %d"), this, &pFileName, iIsMainLog ) );
+    delete iFileName;
+    delete iMetaData;
+    }
+
+
+void CMemSpyEngineFileHolder::CommonConstructL()
+    {
+    if  ( iLineBuffer == NULL )
+        {
+        iLineBuffer = HBufC8::NewL( KMemSpyLineBufferLength );
+        }
+    if  ( iWorkingBuffer == NULL )
+        {
+        iWorkingBuffer = CBufFlat::NewL( KMemSpyFileServerBufferExpandSize );
+        }
+    }
+
+
+void CMemSpyEngineFileHolder::ConstructL()
+    {
+    TRACE( RDebug::Printf( "CMemSpyEngineFileHolder::ConstructL(D) - START" ) );
+    iIsMainLog = ETrue;
+
+    // Make emtpy meta data
+    ASSERT( !iMetaData );
+    iMetaData = CMemSpyEngineSinkMetaData::NewL( KNullDesC, KNullDesC, KNullDesC, ETrue, ETrue );
+
+    // Prepare common details
+    CommonConstructL();
+    TRACE( RDebug::Printf( "CMemSpyEngineFileHolder::ConstructL(D) - CommonConstructL() completed okay..." ) );
+
+    // Construct the default log file.
+    TRACE( RDebug::Printf( "CMemSpyEngineFileHolder::ConstructL(D) - calling OpenFileL()..." ) );
+    OpenFileL();
+    TRACE( RDebug::Printf( "CMemSpyEngineFileHolder::ConstructL(D) - called OpenFileL()" ) );
+
+    TRACE( RDebug::Printf( "CMemSpyEngineFileHolder::ConstructL(D) - END - iIsMainLog: %d", iIsMainLog ) );
+    }
+
+
+
+CMemSpyEngineFileHolder* CMemSpyEngineFileHolder::NewLC( CMemSpyEngineOutputSinkFile& aParent )
+    {
+    TRACE( RDebug::Printf( "CMemSpyEngineFileHolder::NewLC() - START") );
+    CMemSpyEngineFileHolder* self = new(ELeave) CMemSpyEngineFileHolder( aParent, NULL );
+    CleanupStack::PushL( self );
+    self->ConstructL();
+    return self;
+    }
+
+
+CMemSpyEngineFileHolder* CMemSpyEngineFileHolder::NewL( CMemSpyEngineOutputSinkFile& aParent, CMemSpyEngineSinkMetaData* aMetaData )
+    {
+    TRACE( RDebug::Printf( "CMemSpyEngineFileHolder::NewL() - START") );
+    CMemSpyEngineFileHolder* self = new(ELeave) CMemSpyEngineFileHolder( aParent, aMetaData );
+    CleanupStack::PushL( self );
+    self->CommonConstructL();
+    self->OpenFileL();
+    CleanupStack::Pop( self );
+    return self;
+    }
+
+
+CMemSpyEngineFileHolder* CMemSpyEngineFileHolder::NewLogToRAML( CMemSpyEngineOutputSinkFile& aParent, CMemSpyEngineSinkMetaData* aMetaData )
+    {
+    TRACE( RDebug::Printf( "CMemSpyEngineFileHolder::NewLogToRAML() - START") );
+    CMemSpyEngineFileHolder* self = new(ELeave) CMemSpyEngineFileHolder( aParent, aMetaData );
+    CleanupStack::PushL( self );
+    self->CommonConstructL();
+    self->EnableBufferL();
+    CleanupStack::Pop( self );
+    return self;
+    }
+
+
+void CMemSpyEngineFileHolder::OpenFileL()
+    {
+    TInt err = KErrNone;
+
+    TRACE( RDebug::Printf( "CMemSpyEngineFileHolder::OpenFileL() - START - iMetaData: 0x%08x", iMetaData ) );
+    ASSERT( iMetaData );
+
+    delete iFileName;
+    iFileName = NULL;
+    if  ( iFile.SubSessionHandle() != KNullHandle )
+        {
+        TRACE( RDebug::Printf( "CMemSpyEngineFileHolder::OpenFileL() - closing existing file..." ) );
+        iFile.Flush();
+        iFile.Close();
+        }
+    
+    // First try, with current external drive
+    TRAP( err, PrepareFileL() );
+    TRACE( RDebug::Printf( "CMemSpyEngineFileHolder::OpenFileL() - PrepareFileL(1) - err: %d", err ) );
+    
+    if  ( err != KErrNone )
+        {
+        TRACE( RDebug::Printf( "CMemSpyEngineFileHolder::OpenFileL() - trying with forced C:\\ ..." ) );
+
+        // Try again with C:\ instead...
+        const TDriveNumber cDrive = EDriveC;
+        TRAP(err, PrepareFileL( &cDrive ) );
+        TRACE( RDebug::Printf( "CMemSpyEngineFileHolder::OpenFileL() - PrepareFileL(2) - err: %d", err ) );
+        }
+
+    TRACE( RDebug::Printf( "CMemSpyEngineFileHolder::OpenFileL() - final err: %d", err ) );
+    User::LeaveIfError( err );
+
+    TRACE( RDebug::Printf( "CMemSpyEngineFileHolder::OpenFileL() - END - OK - iIsMainLog: %d", iIsMainLog ) );
+    }
+
+
+void CMemSpyEngineFileHolder::PrepareFileL( const TDriveNumber* aForceDrive )
+    {
+    TRACE( RDebug::Printf( "CMemSpyEngineFileHolder::PrepareFileL() - START - this: 0x%08x", this ) );
+    ASSERT( iMetaData );
+
+    iFileName = GenerateFileNameLC( aForceDrive );
+    CleanupStack::Pop( iFileName );
+
+    // Try to make log directory - ignore if already exists
+    TInt error = FsSession().MkDirAll( *iFileName );
+    TRACE( RDebug::Print( _L("CMemSpyEngineFileHolder::PrepareFileL() - iFileName: %S, mkDir: %d, aOverwrite: %d"), iFileName, error, iMetaData->Overwrite() ) );
+
+    if  ( error == KErrNone || error == KErrAlreadyExists )
+        {
+        if  ( iMetaData->Overwrite() )
+            {
+            error = iFile.Replace( FsSession(), *iFileName, EFileWrite );
+            TRACE( RDebug::Printf( "CMemSpyEngineFileHolder::PrepareFileL() - overwrite/replace error: %d", error ) );
+            }
+        else
+            {
+            error = iFile.Open( FsSession(), *iFileName, EFileWrite );
+            TRACE( RDebug::Printf( "CMemSpyEngineFileHolder::PrepareFileL() - open error: %d", error ) );
+            
+            // Try creating it then...
+            if  ( error == KErrNotFound )
+                {
+                error = iFile.Create( FsSession(), *iFileName, EFileWrite );
+                TRACE( RDebug::Printf( "CMemSpyEngineFileHolder::PrepareFileL() - create error: %d", error ) );
+                }
+            }
+            
+        // Seek to end of file
+        TRACE( RDebug::Printf( "CMemSpyEngineFileHolder::PrepareFileL() - final error: %d", error ) );
+        if  ( error == KErrNone )
+            {
+            TInt pos = 0;
+            error = iFile.Seek( ESeekEnd, pos );
+            TRACE( RDebug::Printf( "CMemSpyEngineFileHolder::PrepareFileL() - seek error: %d", error ) );
+            }
+        }
+
+    TRACE( RDebug::Printf( "CMemSpyEngineFileHolder::PrepareFileL() - END - this: 0x%08x, error: %d", this, error ) );
+    User::LeaveIfError( error );
+    }
+
+
+void CMemSpyEngineFileHolder::WriteLineL( const TDesC& aData )
+    {
+    TPtr8 pText( iLineBuffer->Des() );
+    pText.Copy( aData );
+    pText.Append( KMemSpyCRLF );
+
+    if  ( iWorkingBuffer != NULL )
+        {
+        AddToWorkingBufferL( pText );
+        }
+    else if ( iFile.SubSessionHandle() != KNullHandle )
+        {
+        const TInt error = iFile.Write( pText );
+        if  ( error != KErrNone )
+            {
+            TRACE( RDebug::Printf( "CMemSpyEngineFileHolder::WriteLineL() - FILE WRITE ERROR - this: 0x%08x, error: %d", this, error ) );
+            }
+        User::LeaveIfError( error );
+        }
+    else
+        {
+        TRACE( RDebug::Printf( "CMemSpyEngineFileHolder::WriteLineL() - DISCARDING LINE!" ) );
+        }
+    }
+
+
+void CMemSpyEngineFileHolder::WriteRawL( const TDesC8& aData )
+    {
+    const TInt error = iFile.Write( aData );
+    User::LeaveIfError( error );
+    }
+
+
+void CMemSpyEngineFileHolder::EnableBufferL()
+    {
+    TRACE( RDebug::Printf( "CMemSpyEngineFileHolder::EnableBufferL() - START - this: 0x%08x", this ) );
+    if  ( iEntireFileBuffer == NULL )
+        {
+        iEntireFileBuffer = CBufFlat::NewL( KMemSpyFileServerBufferExpandSize );
+        }
+    //
+    iEntireFileBuffer->Reset();
+    TRACE( RDebug::Printf( "CMemSpyEngineFileHolder::EnableBufferL() - END - this: 0x%08x", this ) );
+    }
+
+
+void CMemSpyEngineFileHolder::DisableBufferL()
+    {
+#ifdef _DEBUG
+    TInt size = 0;
+    if  ( iFile.SubSessionHandle() != KNullHandle )
+        {
+        iFile.Size( size );
+        }
+    TInt ramBufferSize = 0;
+    if  ( iEntireFileBuffer )
+        {
+        ramBufferSize = iEntireFileBuffer->Size();
+        }
+    //
+    RDebug::Printf( "CMemSpyEngineFileHolder::DisableBufferL() - START - file handle: 0x%08x, iEntireFileBuffer: 0x%08x, fileSize: %d, ramBufferSize: %d", iFile.SubSessionHandle(), iEntireFileBuffer, size, ramBufferSize );
+#endif
+
+    // This will also open the file if necessary
+    FlushWorkingBufferL();
+    //
+    if  ( iEntireFileBuffer != NULL )
+        {
+        // Probably need to open the file...
+        if  ( iFile.SubSessionHandle() == KNullHandle )
+            {
+            TRACE( RDebug::Printf( "CMemSpyEngineFileHolder::DisableBufferL() - FILE IS NOT YET OPEN!" ) );
+            OpenFileL();
+            TRACE( RDebug::Printf( "CMemSpyEngineFileHolder::DisableBufferL() - file opened okay." ) );
+            }
+
+        TRACE( RDebug::Print( _L("CMemSpyEngineFileHolder::DisableBufferL() - about to write entire file buffer - file: %S"), &FileName() ) );
+        const TPtr8 pBuffer( iEntireFileBuffer->Ptr( 0 ) );
+        const TInt error = iFile.Write( pBuffer );
+        TRACE( RDebug::Printf( "CMemSpyEngineFileHolder::DisableBufferL() - write result: %d", error ) );
+        //
+        delete iEntireFileBuffer;
+        iEntireFileBuffer = NULL;
+        //
+        User::LeaveIfError( error );
+        }
+    
+    TRACE( RDebug::Printf( "CMemSpyEngineFileHolder::DisableBufferL() - END" ) );
+    }
+
+
+void CMemSpyEngineFileHolder::FlushWorkingBufferL()
+    {
+    TRACE( RDebug::Print( _L("CMemSpyEngineFileHolder::FlushWorkingBufferL() - START - fileName: [%S], file handle: 0x%08x, iWorkingBuffer: 0x%08x"), &FileName(), iFile.SubSessionHandle(), iWorkingBuffer ) );
+    __ASSERT_ALWAYS( iWorkingBuffer, MemSpyEngineUtils::Panic( EMemSpyEnginePanicSinkFileWorkingFileBufferIsNull ) );
+
+    // The underlying file may not be open - it could be that we are buffering everything
+    // to RAM (i.e. the file server is currently suspended).
+    const TPtr8 pBuffer( iWorkingBuffer->Ptr(0) );
+    //
+    if  ( iEntireFileBuffer )
+        {
+        __ASSERT_ALWAYS( iEntireFileBuffer, MemSpyEngineUtils::Panic( EMemSpyEnginePanicSinkFileEntireFileBufferNull ) );
+
+        TRACE( RDebug::Printf( "CMemSpyEngineFileHolder::FlushWorkingBufferL() - file not open or we are currently bufferring to RAM - copying %d bytes to entire file buffer (%d)", pBuffer.Length(), iEntireFileBuffer->Size() ) );
+        iEntireFileBuffer->InsertL( iEntireFileBuffer->Size(), pBuffer );
+        }
+    else if ( iFile.SubSessionHandle() != KNullHandle )
+        {
+        const TInt error = iFile.Write( pBuffer );
+        if  ( error != KErrNone )
+            {
+            TRACE( RDebug::Printf( "CMemSpyEngineFileHolder::FlushWorkingBufferL() - write result: %d", error ) );
+            }
+        User::LeaveIfError( error );
+        }
+
+    iWorkingBuffer->Reset();
+    TRACE( RDebug::Print( _L("CMemSpyEngineFileHolder::FlushWorkingBufferL() - END - fileName: %S"), &FileName() ) );
+    }
+
+
+void CMemSpyEngineFileHolder::AddToWorkingBufferL( const TDesC8& aText )
+    {
+    if  ( iWorkingBuffer->Size() + aText.Length() > KMemSpyFileServerBufferExpandSize )
+        {
+        FlushWorkingBufferL();
+        }
+    //
+    iWorkingBuffer->InsertL( iWorkingBuffer->Size(), aText );
+    }
+
+
+HBufC* CMemSpyEngineFileHolder::CleanContextInfoLC( const TDesC& aContext )
+    {
+    TRACE( RDebug::Print( _L("CMemSpyEngineFileHolder::CleanContextInfoLC() - START - %S"), &aContext ) );
+    TFileName fileName;
+
+    TBool seenDoubleColon = EFalse;
+    const TInt length = aContext.Length();
+    for( TInt i=0; i<length; i++ )
+        {
+        const TChar c( aContext[ i ] );
+        const TBool haveNextChar = ( i+1 < length );
+        //
+        //TRACE( RDebug::Print( _L("CMemSpyEngineFileHolder::CleanContextInfoLC() - c[%03d]: \'%c\', haveNextChar: %d, seenDoubleColon: %d"), i, (TUint32) c, haveNextChar, seenDoubleColon ) );
+        //
+        if  ( c == ':' && haveNextChar && aContext[ i + 1 ] == ':' )
+            {
+            // Skip double colon
+            i++;
+            fileName.Append( '-' );
+            seenDoubleColon = ETrue;
+            }
+        else if ( c == '.' )
+            {
+            if  ( seenDoubleColon )
+                {
+                break;
+                }
+            else
+                {
+                fileName.Append( '-' );
+                }
+            }
+        else
+            {
+            fileName.Append( c );
+            }
+        }
+
+    TRACE( RDebug::Print( _L("CMemSpyEngineFileHolder::CleanContextInfoLC() - END - %S"), &fileName ) );
+    return fileName.AllocLC();
+    }
+
+
+HBufC* CMemSpyEngineFileHolder::GenerateFileNameLC( const TDriveNumber* aForceDrive )
+    {
+    TFileName name;
+    MemSpyEngineUtils::GetFolderL( FsSession(), name, *iMetaData, aForceDrive );
+    return name.AllocLC();
+    }
+
+
+RFs& CMemSpyEngineFileHolder::FsSession()
+    {
+    return iParent.iFsSession;
+    }
+
+
+const TDesC& CMemSpyEngineFileHolder::FileName() const 
+    {
+    if  ( iFileName )
+        {
+        return *iFileName;
+        }
+    //
+    return KNullDesC;
+    }
+