1 /* headers to use the BSD sockets */
8 int inet_aton(const char *cp
, struct in_addr
*ia
);
12 #include "qapi/qapi-types-sockets.h"
15 bool fd_is_socket(int fd
);
16 int qemu_socket(int domain
, int type
, int protocol
);
20 * @domain: specifies a communication domain, such as PF_UNIX
21 * @type: specifies the socket type.
22 * @protocol: specifies a particular protocol to be used with the socket
23 * @sv: an array to store the pair of socket created
25 * Creates an unnamed pair of connected sockets in the specified domain,
26 * of the specified type, and using the optionally specified protocol.
27 * And automatically set the close-on-exec flags on the returned sockets
29 * Return 0 on success.
31 int qemu_socketpair(int domain
, int type
, int protocol
, int sv
[2]);
33 int qemu_accept(int s
, struct sockaddr
*addr
, socklen_t
*addrlen
);
35 * A variant of send(2) which handles partial send.
37 * Return the number of bytes transferred over the socket.
38 * Set errno if fewer than `count' bytes are sent.
40 * This function don't work with non-blocking socket's.
41 * Any of the possibilities with non-blocking socket's is bad:
42 * - return a short write (then name is wrong)
43 * - busy wait adding (errno == EAGAIN) to the loop
45 ssize_t
qemu_send_full(int s
, const void *buf
, size_t count
)
46 G_GNUC_WARN_UNUSED_RESULT
;
47 int socket_set_cork(int fd
, int v
);
48 int socket_set_nodelay(int fd
);
49 void qemu_socket_set_block(int fd
);
50 int qemu_socket_try_set_nonblock(int fd
);
51 void qemu_socket_set_nonblock(int fd
);
52 int socket_set_fast_reuse(int fd
);
55 /* Windows has different names for the same constants with the same values */
61 int inet_ai_family_from_address(InetSocketAddress
*addr
,
63 int inet_parse(InetSocketAddress
*addr
, const char *str
, Error
**errp
);
64 int inet_connect(const char *str
, Error
**errp
);
65 int inet_connect_saddr(InetSocketAddress
*saddr
, Error
**errp
);
67 NetworkAddressFamily
inet_netfamily(int family
);
69 int unix_listen(const char *path
, Error
**errp
);
70 int unix_connect(const char *path
, Error
**errp
);
72 char *socket_uri(SocketAddress
*addr
);
73 SocketAddress
*socket_parse(const char *str
, Error
**errp
);
74 int socket_connect(SocketAddress
*addr
, Error
**errp
);
75 int socket_listen(SocketAddress
*addr
, int num
, Error
**errp
);
76 void socket_listen_cleanup(int fd
, Error
**errp
);
77 int socket_dgram(SocketAddress
*remote
, SocketAddress
*local
, Error
**errp
);
79 /* Old, ipv4 only bits. Don't use for new code. */
80 int convert_host_port(struct sockaddr_in
*saddr
, const char *host
,
81 const char *port
, Error
**errp
);
82 int parse_host_port(struct sockaddr_in
*saddr
, const char *str
,
84 int socket_init(void);
87 * socket_sockaddr_to_address:
88 * @sa: socket address struct
89 * @salen: size of @sa struct
90 * @errp: pointer to uninitialized error object
92 * Get the string representation of the socket
93 * address. A pointer to the allocated address information
94 * struct will be returned, which the caller is required to
95 * release with a call qapi_free_SocketAddress() when no
98 * Returns: the socket address struct, or NULL on error
101 socket_sockaddr_to_address(struct sockaddr_storage
*sa
,
106 * socket_local_address:
107 * @fd: the socket file handle
108 * @errp: pointer to uninitialized error object
110 * Get the string representation of the local socket
111 * address. A pointer to the allocated address information
112 * struct will be returned, which the caller is required to
113 * release with a call qapi_free_SocketAddress() when no
116 * Returns: the socket address struct, or NULL on error
118 SocketAddress
*socket_local_address(int fd
, Error
**errp
);
121 * socket_remote_address:
122 * @fd: the socket file handle
123 * @errp: pointer to uninitialized error object
125 * Get the string representation of the remote socket
126 * address. A pointer to the allocated address information
127 * struct will be returned, which the caller is required to
128 * release with a call qapi_free_SocketAddress() when no
131 * Returns: the socket address struct, or NULL on error
133 SocketAddress
*socket_remote_address(int fd
, Error
**errp
);
136 * socket_address_flatten:
137 * @addr: the socket address to flatten
139 * Convert SocketAddressLegacy to SocketAddress. Caller is responsible
140 * for freeing with qapi_free_SocketAddress().
142 * Returns: the argument converted to SocketAddress.
144 SocketAddress
*socket_address_flatten(SocketAddressLegacy
*addr
);
147 * socket_address_parse_named_fd:
149 * Modify @addr, replacing a named fd by its corresponding number.
150 * Needed for callers that plan to pass @addr to a context where the
151 * current monitor is not available.
153 * Return 0 on success.
155 int socket_address_parse_named_fd(SocketAddress
*addr
, Error
**errp
);
156 #endif /* QEMU_SOCKETS_H */