/usr/include/giomm-2.4/giomm/srvtarget.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 185 186 187 188 189 190 191 192 193 194 195 196 197 | // -*- c++ -*-
// Generated by gmmproc 2.42.0 -- DO NOT MODIFY!
#ifndef _GIOMM_SRVTARGET_H
#define _GIOMM_SRVTARGET_H
#include <glibmm/ustring.h>
#include <sigc++/sigc++.h>
/* Copyright (C) 2009 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 <glibmm/listhandle.h>
// unfortunately we need to include the C header for the type traits
// implementation
#include <gio/gio.h>
#ifndef DOXYGEN_SHOULD_SKIP_THIS
extern "C" { typedef struct _GSrvTarget GSrvTarget; }
#endif
namespace Gio
{
/** DNS SRV record target
*
* SRV (service) records are used by some network protocols to provide
* service-specific aliasing and load-balancing. For example, XMPP (Jabber) uses
* SRV records to locate the XMPP server for a domain; rather than connecting
* directly to "example.com" or assuming a specific server hostname like
* "xmpp.example.com", an XMPP client would look up the "xmpp-client" SRV record
* for "example.com", and then connect to whatever host was pointed to by that
* record.
*
* You can use Resolver::lookup_service() or Resolver::lookup_service_async()
* to find the SrvTargets for a given service. However, if you are simply
* planning to connect to the remote service, you can use NetworkService's
* SocketConnectable interface and not need to worry about SrvTarget at all.
*
* @newin{2,24}
* @ingroup NetworkIO
*/
class SrvTarget
{
public:
#ifndef DOXYGEN_SHOULD_SKIP_THIS
typedef SrvTarget CppObjectType;
typedef GSrvTarget BaseObjectType;
#endif /* DOXYGEN_SHOULD_SKIP_THIS */
/** Get the GType for this class, for use with the underlying GObject type system.
*/
static GType get_type() G_GNUC_CONST;
SrvTarget();
explicit SrvTarget(GSrvTarget* gobject, bool make_a_copy = true);
SrvTarget(const SrvTarget& other);
SrvTarget& operator=(const SrvTarget& other);
~SrvTarget();
void swap(SrvTarget& other);
///Provides access to the underlying C instance.
GSrvTarget* gobj() { return gobject_; }
///Provides access to the underlying C instance.
const GSrvTarget* gobj() const { return gobject_; }
///Provides access to the underlying C instance. The caller is responsible for freeing it. Use when directly setting fields in structs.
GSrvTarget* gobj_copy() const;
protected:
GSrvTarget* gobject_;
private:
public:
SrvTarget(const Glib::ustring& hostname, guint16 port, guint16 priority, guint16 weight);
/** Gets @a target's hostname (in ASCII form; if you are going to present
* this to the user, you should use Glib::hostname_is_ascii_encoded() to
* check if it contains encoded Unicode segments, and use
* Glib::hostname_to_unicode() to convert it if it does.)
*
* @newin{2,22}
*
* @return @a target's hostname.
*/
Glib::ustring get_hostname() const;
/** Gets @a target's port
*
* @newin{2,22}
*
* @return @a target's port.
*/
guint16 get_port() const;
/** Gets @a target's priority. You should not need to look at this;
* Resolver already sorts the targets according to the algorithm in
* RFC 2782.
*
* @newin{2,22}
*
* @return @a target's priority.
*/
guint16 get_priority() const;
/** Gets @a target's weight. You should not need to look at this;
* Resolver already sorts the targets according to the algorithm in
* RFC 2782.
*
* @newin{2,22}
*
* @return @a target's weight.
*/
guint16 get_weight() const;
};
#ifndef DOXYGEN_SHOULD_SKIP_THIS
struct SrvTargetListTraits
{
typedef Gio::SrvTarget CppType;
typedef const GSrvTarget* CType;
typedef GSrvTarget* CTypeNonConst;
static CType to_c_type(const CppType& item) { return item.gobj(); }
static CType to_c_type(CType ptr) { return ptr; }
static CppType to_cpp_type(CType item) { return CppType(const_cast<CTypeNonConst>(item), true /* take_copy */); }
static void release_c_type(CType item) { g_srv_target_free(const_cast<CTypeNonConst>(item)); }
};
#endif // DOXYGEN_SHOULD_SKIP_THIS
typedef Glib::ListHandle<Gio::SrvTarget, SrvTargetListTraits> ListHandle_SrvTarget;
} // namespace Gio
namespace Gio
{
/** @relates Gio::SrvTarget
* @param lhs The left-hand side
* @param rhs The right-hand side
*/
inline void swap(SrvTarget& lhs, SrvTarget& rhs)
{ lhs.swap(rhs); }
} // 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::SrvTarget
*/
Gio::SrvTarget wrap(GSrvTarget* object, bool take_copy = false);
#ifndef DOXYGEN_SHOULD_SKIP_THIS
template <>
class Value<Gio::SrvTarget> : public Glib::Value_Boxed<Gio::SrvTarget>
{};
#endif /* DOXYGEN_SHOULD_SKIP_THIS */
} // namespace Glib
#endif /* _GIOMM_SRVTARGET_H */
|