connectionSet.h

/* Copyright (c) 2005-2014, Stefan Eilemann <eile@equalizergraphics.com>
 *
 * This file is part of Collage <https://github.com/Eyescale/Collage>
 *
 * This library is free software; you can redistribute it and/or modify it under
 * the terms of the GNU Lesser General Public License version 2.1 as published
 * by the Free Software Foundation.
 *
 * This library is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
 * FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public License for more
 * details.
 *
 * You should have received a copy of the GNU Lesser General Public License
 * along with this library; if not, write to the Free Software Foundation, Inc.,
 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
 */

#ifndef CO_CONNECTION_SET_H
#define CO_CONNECTION_SET_H

#include <boost/noncopyable.hpp>
#include <co/api.h>
#include <co/types.h>
#include <lunchbox/thread.h> // for LB_TS_VAR

namespace co
{
namespace detail
{
class ConnectionSet;
}

class ConnectionSet : public boost::noncopyable
{
public:
    enum Event 
    {
        EVENT_NONE = 0,       
        EVENT_CONNECT,        
        EVENT_DISCONNECT,     
        EVENT_DATA,           
        EVENT_TIMEOUT,        
        EVENT_INTERRUPT,      
        EVENT_ERROR,          
        EVENT_SELECT_ERROR,   
        EVENT_INVALID_HANDLE, 
        EVENT_ALL
    };

    CO_API ConnectionSet();

    CO_API ~ConnectionSet();

    CO_API void addConnection(ConnectionPtr connection);

    CO_API bool removeConnection(ConnectionPtr connection);

    CO_API size_t getSize() const;

    CO_API bool isEmpty() const;

    CO_API const Connections& getConnections() const;

    CO_API Event select(const uint32_t timeout = LB_TIMEOUT_INDEFINITE);

    CO_API void interrupt();

    CO_API int getError() const;

    CO_API ConnectionPtr getConnection();

    void setDirty();

private:
    detail::ConnectionSet* const _impl;

    void _clear();
    bool _setupFDSet();
    bool _buildFDSet();

    Event _getSelectResult(const uint32_t index);
    Event _parseSelect(const uint32_t index);
    LB_TS_VAR(_selectThread);
};

CO_API std::ostream& operator<<(std::ostream&, const ConnectionSet&);

CO_API std::ostream& operator<<(std::ostream&, const ConnectionSet::Event);
}

#endif // CO_CONNECTION_SET_H