/usr/include/giomm-2.4/giomm/threadedsocketservice.h is in libglibmm-2.4-dev 2.42.0-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 | // -*- c++ -*-
// Generated by gmmproc 2.42.0 -- DO NOT MODIFY!
#ifndef _GIOMM_THREADEDSOCKETSERVICE_H
#define _GIOMM_THREADEDSOCKETSERVICE_H
#include <glibmm/ustring.h>
#include <sigc++/sigc++.h>
// -*- Mode: C++; indent-tabs-mode: nil; c-basic-offset: 2 -*-
/* Copyright (C) 2010 Jonathon Jongsma
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* 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., 675 Mass Ave, Cambridge, MA 02139, USA.
*/
#include <giomm/socketservice.h>
#ifndef DOXYGEN_SHOULD_SKIP_THIS
typedef struct _GThreadedSocketService GThreadedSocketService;
typedef struct _GThreadedSocketServiceClass GThreadedSocketServiceClass;
#endif /* DOXYGEN_SHOULD_SKIP_THIS */
namespace Gio
{ class ThreadedSocketService_Class; } // namespace Gio
namespace Gio
{
/**
* A threaded GSocketService
*
* A ThreadedSocketService is a simple subclass of SocketService
* that handles incoming connections by creating a worker thread and
* dispatching the connection to it by emitting the run signal in
* the new thread.
*
* The signal handler may perform blocking IO and need not return
* until the connection is closed.
*
* The service is implemented using a thread pool, so there is a
* limited amount of threads availible to serve incomming requests.
* The service automatically stops the SocketService from accepting
* new connections when all threads are busy.
*
* As with SocketService, you may connect to ThreadedSocketService::signal_run(),
* or subclass and override the default handler.
*
* @newin{2,24}
* @ingroup NetworkIO
*/
class ThreadedSocketService : public Gio::SocketService
{
#ifndef DOXYGEN_SHOULD_SKIP_THIS
public:
typedef ThreadedSocketService CppObjectType;
typedef ThreadedSocketService_Class CppClassType;
typedef GThreadedSocketService BaseObjectType;
typedef GThreadedSocketServiceClass BaseClassType;
private: friend class ThreadedSocketService_Class;
static CppClassType threadedsocketservice_class_;
private:
// noncopyable
ThreadedSocketService(const ThreadedSocketService&);
ThreadedSocketService& operator=(const ThreadedSocketService&);
protected:
explicit ThreadedSocketService(const Glib::ConstructParams& construct_params);
explicit ThreadedSocketService(GThreadedSocketService* castitem);
#endif /* DOXYGEN_SHOULD_SKIP_THIS */
public:
virtual ~ThreadedSocketService();
/** Get the GType for this class, for use with the underlying GObject type system.
*/
static GType get_type() G_GNUC_CONST;
#ifndef DOXYGEN_SHOULD_SKIP_THIS
static GType get_base_type() G_GNUC_CONST;
#endif
///Provides access to the underlying C GObject.
GThreadedSocketService* gobj() { return reinterpret_cast<GThreadedSocketService*>(gobject_); }
///Provides access to the underlying C GObject.
const GThreadedSocketService* gobj() const { return reinterpret_cast<GThreadedSocketService*>(gobject_); }
///Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs.
GThreadedSocketService* gobj_copy();
private:
protected:
explicit ThreadedSocketService(int max_threads);
public:
static Glib::RefPtr<ThreadedSocketService> create(int max_threads);
/**
* @par Slot Prototype:
* <tt>bool on_my_%run(const Glib::RefPtr<SocketConnection>& connection, const Glib::RefPtr<Glib::Object>& source_object)</tt>
*
* The signal_run() signal is emitted in a worker thread in response to an
* incoming connection. This thread is dedicated to handling
* @a connection and may perform blocking IO. The signal handler need
* not return until the connection is closed.
*
* @param connection A new SocketConnection object.
* @param source_object The source_object passed to g_socket_listener_add_address().
* @return <tt>true</tt> to stop further signal handlers from being called.
*/
Glib::SignalProxy2< bool,const Glib::RefPtr<SocketConnection>&,const Glib::RefPtr<Glib::Object>& > signal_run();
#ifdef GLIBMM_PROPERTIES_ENABLED
/** The max number of threads handling clients for this service.
*
* You rarely need to use properties because there are get_ and set_ methods for almost all of them.
* @return A PropertyProxy_ReadOnly that allows you to get the value of the property,
* or receive notification when the value of the property changes.
*/
Glib::PropertyProxy_ReadOnly< int > property_max_threads() const;
#endif //#GLIBMM_PROPERTIES_ENABLED
public:
public:
//C++ methods used to invoke GTK+ virtual functions:
protected:
//GTK+ Virtual Functions (override these to change behaviour):
//Default Signal Handlers::
/// This is a default handler for the signal signal_run().
virtual bool on_run(const Glib::RefPtr<SocketConnection>& connection, const Glib::RefPtr<Glib::Object>& source_object);
};
} // namespace Gio
namespace Glib
{
/** A Glib::wrap() method for this object.
*
* @param object The C instance.
* @param take_copy False if the result should take ownership of the C instance. True if it should take a new copy or ref.
* @result A C++ instance that wraps this C instance.
*
* @relates Gio::ThreadedSocketService
*/
Glib::RefPtr<Gio::ThreadedSocketService> wrap(GThreadedSocketService* object, bool take_copy = false);
}
#endif /* _GIOMM_THREADEDSOCKETSERVICE_H */
|