FileManager.hpp

Go to the documentation of this file.

// ======================================================================
// \title  FileManager.hpp
// \author bocchino
// \brief  hpp file for FileManager component implementation class
//
// \copyright
// Copyright 2009-2015, by the California Institute of Technology.
// ALL RIGHTS RESERVED.  United States Government Sponsorship
// acknowledged.
//
// ======================================================================

#ifndef Svc_FileManager_HPP
#define Svc_FileManager_HPP

#include "Os/FileSystem.hpp"
#include "Svc/FileManager/FileManagerComponentAc.hpp"

namespace Svc {

class FileManager final : public FileManagerComponentBase {
    friend class FileManagerTester;

  public:
    // ----------------------------------------------------------------------
    // Construction, initialization, and destruction
    // ----------------------------------------------------------------------

    FileManager(const char* const compName  
    );

    ~FileManager();

  private:
    // ----------------------------------------------------------------------
    // Command handler implementations
    // ----------------------------------------------------------------------

    void CreateDirectory_cmdHandler(const FwOpcodeType opCode,       
                                    const U32 cmdSeq,                
                                    const Fw::CmdStringArg& dirName  
    );

    void RemoveFile_cmdHandler(const FwOpcodeType opCode,         
                               const U32 cmdSeq,                  
                               const Fw::CmdStringArg& fileName,  
                               const bool ignoreErrors            
    );

    void MoveFile_cmdHandler(const FwOpcodeType opCode,               
                             const U32 cmdSeq,                        
                             const Fw::CmdStringArg& sourceFileName,  
                             const Fw::CmdStringArg& destFileName     
    );

    void RemoveDirectory_cmdHandler(const FwOpcodeType opCode,       
                                    const U32 cmdSeq,                
                                    const Fw::CmdStringArg& dirName  
    );

    void ShellCommand_cmdHandler(const FwOpcodeType opCode,           
                                 const U32 cmdSeq,                    
                                 const Fw::CmdStringArg& command,     
                                 const Fw::CmdStringArg& logFileName  
    );

    void AppendFile_cmdHandler(const FwOpcodeType opCode,       
                               const U32 cmdSeq,                
                               const Fw::CmdStringArg& source,  
                               const Fw::CmdStringArg& target   
    );

    void FileSize_cmdHandler(const FwOpcodeType opCode,        
                             const U32 cmdSeq,                 
                             const Fw::CmdStringArg& fileName  
    );

    void ListDirectory_cmdHandler(const FwOpcodeType opCode,       
                                  const U32 cmdSeq,                
                                  const Fw::CmdStringArg& dirName  
    );

    void pingIn_handler(const FwIndexType portNum, 
                        U32 key                    
    );

    void schedIn_handler(const FwIndexType portNum, 
                         U32 context                
    );

  private:
    // ----------------------------------------------------------------------
    // Helper methods
    // ----------------------------------------------------------------------

    int systemCall(const Fw::CmdStringArg& command,     
                   const Fw::CmdStringArg& logFileName  
    ) const;

    void emitTelemetry(const Os::FileSystem::Status status  
    );

    void sendCommandResponse(const FwOpcodeType opCode,           
                             const U32 cmdSeq,                    
                             const Os::FileSystem::Status status  
    );

  private:
    // ----------------------------------------------------------------------
    // Variables
    // ----------------------------------------------------------------------

    U32 commandCount;

    U32 errorCount;

    // ----------------------------------------------------------------------
    // Directory listing state machine variables
    // ----------------------------------------------------------------------
    // The FileManager uses an asynchronous state machine to process
    // directory listings through Rate Group 2. This prevents event
    // flooding and ensures bounded execution time by processing one
    // directory entry per rate tick (0.5Hz).

    enum ListDirectoryState {
        IDLE,                
        LISTING_IN_PROGRESS  
    };

    ListDirectoryState m_listState;

    Os::Directory m_currentDir;

    Fw::String m_currentDirName;

    U32 m_totalEntries;

    FwOpcodeType m_currentOpCode;

    U32 m_currentCmdSeq;
};

}  // end namespace Svc

#endif