userlibandfileserver/fileserver/automounter/automounter.h
changeset 9 96e5fb8b040d
child 6 0173bcd7697c
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/userlibandfileserver/fileserver/automounter/automounter.h	Thu Dec 17 09:24:54 2009 +0200
@@ -0,0 +1,236 @@
+// Copyright (c) 1998-2009 Nokia Corporation and/or its subsidiary(-ies).
+// All rights reserved.
+// This component and the accompanying materials are made available
+// under the terms of the License "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:
+
+/*
+    @file
+    @internalTechnology
+
+    "fs_auto_mounter" filesystem classes definition
+*/
+
+
+#ifndef AUTOMOUNTER_FILESYSTEM_H
+#define AUTOMOUNTER_FILESYSTEM_H
+
+#include <f32fsys.h>
+#include <f32dbg.h>
+
+
+IMPORT_C TUint32 DebugRegister();
+
+//-- define this for having logs disregarding DebugRegister() settings
+//#define FORCE_LOGS
+
+
+#if defined(_DEBUG) || defined(_DEBUG_RELEASE)
+//----------------- DEBUG mode -----------------
+
+#ifndef FORCE_LOGS 
+    #define __PRINT(t)          {if (DebugRegister()&KFSYS) RDebug::Print(t);}
+    #define __PRINT1(t,a)       {if (DebugRegister()&KFSYS) RDebug::Print(t,a);}
+    #define __PRINT2(t,a,b)     {if (DebugRegister()&KFSYS) RDebug::Print(t,a,b);}
+    #define __PRINT3(t,a,b,c)   {if (DebugRegister()&KFSYS) RDebug::Print(t,a,b,c);}
+    #define __PRINT4(t,a,b,c,d) {if (DebugRegister()&KFSYS) RDebug::Print(t,a,b,c,d);}
+#else
+    #define __PRINT(t)          {RDebug::Print(t);}
+    #define __PRINT1(t,a)       {RDebug::Print(t,a);}
+    #define __PRINT2(t,a,b)     {RDebug::Print(t,a,b);}
+    #define __PRINT3(t,a,b,c)   {RDebug::Print(t,a,b,c);}
+    #define __PRINT4(t,a,b,c,d) {RDebug::Print(t,a,b,c,d);}
+#endif
+
+#define DBG_STATEMENT(text) text
+
+#else
+//----------------- RELEASE mode -----------------
+#define __PRINT(t)
+#define __PRINT1(t,a)
+#define __PRINT2(t,a,b)
+#define __PRINT3(t,a,b,c)
+#define __PRINT4(t,a,b,c,d)
+#define __PRINT8BIT1(t,a)
+#define __PRINT1TEMP(t,a)
+
+#define DBG_STATEMENT(text)
+
+#endif //#if defined(_DEBUG) || defined(_DEBUG_RELEASE)
+
+
+//#######################################################################################################################################
+//#     constants definitions here
+//#######################################################################################################################################
+
+
+//-----------------------------------------------------------------------------
+
+const TUint32 K1KiloByte = 1<<10; 
+const TUint32 K1MegaByte = 1<<20; 
+
+const TUint32 K1uSec = 1;               ///< 1 microsecond in TTimeIntervalMicroSeconds32
+const TUint32 K1mSec = 1000;            ///< 1 millisecond in TTimeIntervalMicroSeconds32
+const TUint32 K1Sec  = 1000*K1mSec;     ///< 1 second in TTimeIntervalMicroSeconds32
+
+
+const TUint KBitsInByteLog2 = 3;
+const TUint KBitsInByte = 1<<KBitsInByteLog2;
+
+
+
+//-----------------------------------------------------------------------------
+
+/**
+Internal fault codes for Automounter.fsy
+*/
+enum TFault
+    {
+    ENotImplemented,
+    EWrongDriveAttributes,
+    EPluginInitialise,
+    EFileSysNotAdded,
+    EWrongConfiguration,
+    EIncompatibleFileSystems,
+
+    EMustNotBeCalled
+
+    };
+
+//-----------------------------------------------------------------------------
+
+void Fault(TFault aFault);
+
+
+//-----------------------------------------------------------------------------
+/**
+    This class is a container for child file system names that are supported by automounter.
+    Child FS names are stored in Upper Case to enable simple FSName hash calculations.
+    The names must be unique.
+*/
+class XStringArray
+    {
+ public:
+    XStringArray();
+    ~XStringArray();
+
+    void Reset();
+    const TDesC& operator[](TUint aIndex) const;
+    TInt Append(const TDesC& aString);
+    TUint Count() const {return iStrings.Count();}
+    TUint32 GetStringHash(TUint aIndex) const;
+
+
+ private:
+    XStringArray(const XStringArray&);
+    XStringArray& operator=(const XStringArray&);
+
+    /** panic codes */
+    enum TPanicCode
+        {
+        EIndexOutOfRange, ///< index out of range
+        ENotImplemented,  ///< functionality isn't implemented
+        };
+
+    void Panic(TPanicCode aPanicCode) const;
+
+ private:
+    RPointerArray<HBufC> iStrings;
+    
+    };
+
+
+//-----------------------------------------------------------------------------
+
+/**
+    File system class definition
+*/
+class CAutoMounterFileSystem : public CFileSystem, CFileSystem::MFileSystemExtInterface
+    {
+public:
+    static CAutoMounterFileSystem* New();
+    ~CAutoMounterFileSystem();
+public:
+    
+    //-- pure virtual interface implementation, overrides from CFileSystem
+    TInt Install();
+    CMountCB* NewMountL() const;
+    CFileCB* NewFileL() const;
+    CDirCB* NewDirL() const;
+    CFormatCB* NewFormatL() const;
+    void DriveInfo(TDriveInfo& anInfo,TInt aDriveNumber) const;
+    
+    //-- non-pure virtual interface, overrides from CFileSystem
+#ifdef _DEBUG
+    TInt Remove();
+    TBool QueryVersionSupported(const TVersion& aVer) const;
+#endif
+    
+    TBool IsExtensionSupported() const;
+    TInt DefaultPath(TDes& aPath) const;
+    TInt GetInterface(TInt aInterfaceId,TAny*& aInterface,TAny* aInput);
+    
+    
+    
+    
+protected:
+    CAutoMounterFileSystem();
+
+    TInt TryMountFilesystem(TDrive* apDrive, CMountCB** apMount, CFileSystem** apFS);
+
+
+    //-------------------------------
+    virtual CMountCB* NewMountExL(TDrive* apDrive, CFileSystem** apFileSystem, TBool aForceMount, TUint32 aFsNameHash);
+    virtual TInt GetSupportedFileSystemName(TInt aFsNumber, TDes& aFsName) const;   
+
+
+private:
+    
+    /** possible states of this object */
+    enum TState
+        {
+        EInvalid = 0,       ///< initial, invalid
+        ENotInitialised,
+        EInitialised, 
+        };
+
+    inline TState State() const {return iState;}
+    inline void SetState(TState aState) {iState = aState;}
+
+    
+    /** "default child" file system name index in the child names container. "default child" is used in some weir cases, when
+        it doesn't matter which particular child FS to use, e.g. getting access to the media driver for media unlocking. */
+    enum {KDefaultFSNo = 0}; 
+
+
+    CFileSystem* GetChildFileSystem(TUint aIndex) const;
+    CFileSystem* GetChildFileSysteByNameHash(TUint32 aFsNameHash) const;
+
+    void InitialiseFileSystem();
+    TInt DoProcessProxyDriveSupport();
+
+private:
+    
+    TState       iState;    ///< this object current state
+    XStringArray iFSNames;  ///< child file system names container.
+
+    };
+
+
+//-----------------------------------------------------------------------------
+
+#endif //AUTOMOUNTER_FILESYSTEM_H
+
+
+
+
+
+