LXR qemu/include/qemu/sockets.h

   1/* headers to use the BSD sockets */
   2#ifndef QEMU_SOCKET_H
   3#define QEMU_SOCKET_H
   4
   5#ifdef _WIN32
   6
   7int inet_aton(const char *cp, struct in_addr *ia);
   8
   9#endif /* !_WIN32 */
  10
  11#include "qapi-types.h"
  12
  13/* misc helpers */
  14int qemu_socket(int domain, int type, int protocol);
  15int qemu_accept(int s, struct sockaddr *addr, socklen_t *addrlen);
  16int socket_set_cork(int fd, int v);
  17int socket_set_nodelay(int fd);
  18void qemu_set_block(int fd);
  19void qemu_set_nonblock(int fd);
  20int socket_set_fast_reuse(int fd);
  21
  22#ifdef WIN32
  23/* Windows has different names for the same constants with the same values */
  24#define SHUT_RD   0
  25#define SHUT_WR   1
  26#define SHUT_RDWR 2
  27#endif
  28
  29/* callback function for nonblocking connect
  30 * valid fd on success, negative error code on failure
  31 */
  32typedef void NonBlockingConnectHandler(int fd, Error *err, void *opaque);
  33
  34InetSocketAddress *inet_parse(const char *str, Error **errp);
  35int inet_listen(const char *str, char *ostr, int olen,
  36                int socktype, int port_offset, Error **errp);
  37int inet_connect(const char *str, Error **errp);
  38int inet_nonblocking_connect(const char *str,
  39                             NonBlockingConnectHandler *callback,
  40                             void *opaque, Error **errp);
  41
  42NetworkAddressFamily inet_netfamily(int family);
  43
  44int unix_listen(const char *path, char *ostr, int olen, Error **errp);
  45int unix_connect(const char *path, Error **errp);
  46int unix_nonblocking_connect(const char *str,
  47                             NonBlockingConnectHandler *callback,
  48                             void *opaque, Error **errp);
  49
  50SocketAddress *socket_parse(const char *str, Error **errp);
  51int socket_connect(SocketAddress *addr, Error **errp,
  52                   NonBlockingConnectHandler *callback, void *opaque);
  53int socket_listen(SocketAddress *addr, Error **errp);
  54int socket_dgram(SocketAddress *remote, SocketAddress *local, Error **errp);
  55
  56/* Old, ipv4 only bits.  Don't use for new code. */
  57int parse_host_port(struct sockaddr_in *saddr, const char *str);
  58int socket_init(void);
  59
  60/**
  61 * socket_sockaddr_to_address:
  62 * @sa: socket address struct
  63 * @salen: size of @sa struct
  64 * @errp: pointer to uninitialized error object
  65 *
  66 * Get the string representation of the socket
  67 * address. A pointer to the allocated address information
  68 * struct will be returned, which the caller is required to
  69 * release with a call qapi_free_SocketAddress when no
  70 * longer required.
  71 *
  72 * Returns: the socket address struct, or NULL on error
  73 */
  74SocketAddress *
  75socket_sockaddr_to_address(struct sockaddr_storage *sa,
  76                           socklen_t salen,
  77                           Error **errp);
  78
  79/**
  80 * socket_local_address:
  81 * @fd: the socket file handle
  82 * @errp: pointer to uninitialized error object
  83 *
  84 * Get the string representation of the local socket
  85 * address. A pointer to the allocated address information
  86 * struct will be returned, which the caller is required to
  87 * release with a call qapi_free_SocketAddress when no
  88 * longer required.
  89 *
  90 * Returns: the socket address struct, or NULL on error
  91 */
  92SocketAddress *socket_local_address(int fd, Error **errp);
  93
  94/**
  95 * socket_remote_address:
  96 * @fd: the socket file handle
  97 * @errp: pointer to uninitialized error object
  98 *
  99 * Get the string representation of the remote socket
 100 * address. A pointer to the allocated address information
 101 * struct will be returned, which the caller is required to
 102 * release with a call qapi_free_SocketAddress when no
 103 * longer required.
 104 *
 105 * Returns: the socket address struct, or NULL on error
 106 */
 107SocketAddress *socket_remote_address(int fd, Error **errp);
 108
 109
 110void qapi_copy_SocketAddress(SocketAddress **p_dest,
 111                             SocketAddress *src);
 112
 113#endif /* QEMU_SOCKET_H */
 114