Beginnings of improved synchronous API support
[platform/upstream/libsoup.git] / libsoup / soup-address.h
1 /* -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */
2 /*
3  * Copyright (C) 2000-2003, Ximian, Inc.
4  */
5
6 #ifndef SOUP_ADDRESS_H
7 #define SOUP_ADDRESS_H
8
9 #include <sys/types.h>
10 #include <sys/socket.h>
11
12 #include <libsoup/soup-types.h>
13
14 #define SOUP_TYPE_ADDRESS            (soup_address_get_type ())
15 #define SOUP_ADDRESS(obj)            (G_TYPE_CHECK_INSTANCE_CAST ((obj), SOUP_TYPE_ADDRESS, SoupAddress))
16 #define SOUP_ADDRESS_CLASS(klass)    (G_TYPE_CHECK_CLASS_CAST ((klass), SOUP_TYPE_ADDRESS, SoupAddressClass))
17 #define SOUP_IS_ADDRESS(obj)         (G_TYPE_CHECK_INSTANCE_TYPE ((obj), SOUP_TYPE_ADDRESS))
18 #define SOUP_IS_ADDRESS_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((obj), SOUP_TYPE_ADDRESS))
19 #define SOUP_ADDRESS_GET_CLASS(obj)  (G_TYPE_INSTANCE_GET_CLASS ((obj), SOUP_TYPE_ADDRESS, SoupAddressClass))
20
21 typedef struct SoupAddressPrivate SoupAddressPrivate;
22
23 struct SoupAddress {
24         GObject parent;
25
26         SoupAddressPrivate *priv;
27 };
28
29 typedef struct {
30         GObjectClass parent_class;
31
32         /* signals */
33         void (*dns_result) (SoupAddress *addr, guint status);
34 } SoupAddressClass;
35
36 typedef enum {
37         SOUP_ADDRESS_FAMILY_IPV4 = AF_INET,
38 #ifdef AF_INET6
39         SOUP_ADDRESS_FAMILY_IPV6 = AF_INET6
40 #else
41         SOUP_ADDRESS_FAMILY_IPV6 = -1
42 #endif
43 } SoupAddressFamily;
44
45 #define SOUP_ADDRESS_ANY_PORT 0
46
47 GType soup_address_get_type (void);
48
49 SoupAddress     *soup_address_new                (const char          *name,
50                                                   guint                port);
51 SoupAddress     *soup_address_new_from_sockaddr  (struct sockaddr     *sa,
52                                                   int                  len);
53 SoupAddress     *soup_address_new_any            (SoupAddressFamily    family,
54                                                   guint                port);
55
56 typedef void   (*SoupAddressCallback)            (SoupAddress         *addr,
57                                                   guint                status,
58                                                   gpointer             data);
59 void             soup_address_resolve_async      (SoupAddress         *addr,
60                                                   SoupAddressCallback  cb,
61                                                   gpointer             data);
62 guint            soup_address_resolve_sync       (SoupAddress         *addr);
63
64 const char      *soup_address_get_name           (SoupAddress         *addr);
65 struct sockaddr *soup_address_get_sockaddr       (SoupAddress         *addr,
66                                                   int                 *len);
67 const char      *soup_address_get_physical       (SoupAddress         *addr);
68 guint            soup_address_get_port           (SoupAddress         *addr);
69
70 #endif /* SOUP_ADDRESS_H */