connectionSet.h

/* Copyright (c) 2005-2012, 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 <co/api.h>
#include <co/types.h>
#include <lunchbox/thread.h> // for LB_TS_VAR

namespace co
{
namespace detail { class ConnectionSet; }

    class ConnectionSet
    {
    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 );
        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