SmbDriver.h

/****************************************************************************
 * Platform Abstraction Layer
 * Daryl Borth 2026
 * SmbDriver.h
 *
 * Network-share driver. Exactly one instance is owned by each platform's
 * FileSystemDriver and returned from FileSystemDriver::getSmb().
 *
 * On a successful connect(), a devoptab-style mount path is available via
 * getMountPath() and the rest of the app reads through it with ordinary
 * POSIX calls.
 ***************************************************************************/
#pragma once

struct SmbShareInfo
{
    char host[64];      
    char share[64];     
    char user[32];      
    char password[32];  
};

enum class SmbConnectResult
{
    Success,
    InvalidSettings,     
    NetworkUnavailable,  
    ConnectFailed        
};

class SmbDriver
{
    public:
        virtual ~SmbDriver() = default;

        virtual void init() = 0;
        virtual void shutdown() = 0;

        virtual bool isNetworkUp() const = 0;

        virtual bool ensureNetworkUp() = 0;

        virtual SmbConnectResult connect(const SmbShareInfo & info) = 0;

        virtual void disconnect() = 0;

        virtual bool isConnected() const = 0;

        virtual const char * getMountPath() const = 0;

        virtual const char * connectResultMessage(SmbConnectResult result) const = 0;

        virtual const char * getLastError() const { return ""; }
};