connectionSet.h

/* Copyright (c) 2005-2012, Stefan Eilemann <eile@equalizergraphics.com> 
 *
 * 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/connectionListener.h> // base class
#include <lunchbox/thread.h> // for LB_TS_VAR

namespace co
{
namespace detail { class ConnectionSet; }

    class ConnectionSet : public ConnectionListener
    {
    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 void clear();
        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();

        void setDirty();

        CO_API int getError() const;
        CO_API ConnectionPtr getConnection();

    private:
        detail::ConnectionSet* const _impl;

        bool _setupFDSet();
        bool _buildFDSet();
        virtual void notifyStateChanged( Connection* );

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

    CO_API std::ostream& operator << ( std::ostream& os, 
                                       const ConnectionSet* set );
    CO_API std::ostream& operator << ( std::ostream& os, 
                                       const ConnectionSet::Event event );
}

#endif // CO_CONNECTION_SET_H