summaryrefslogtreecommitdiff
path: root/libhw_generic/include/libhw/generic/io.h
blob: 9128bd3508552dddf6bf9ae308483cc50c549c83 (plain)
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
/* libhw/generic/io.h - Device-independent I/O definitions
 *
 * Copyright (C) 2024-2025  Luke T. Shumaker <lukeshu@lukeshu.com>
 * SPDX-License-Identifier: AGPL-3.0-or-later
 */

#ifndef _LIBHW_GENERIC_IO_H_
#define _LIBHW_GENERIC_IO_H_

#include <stddef.h>    /* for size_t */

#include <libobj/obj.h>

/* structs ********************************************************************/

#if __unix__
#include <sys/uio.h>
#else
struct iovec {
	void    *iov_base;
	size_t   iov_len;
};
#endif

struct duplex_iovec {
	void    *iov_read_dst;
	void    *iov_write_src;
	size_t   iov_len;
};

/* basic interfaces ***********************************************************/

/**
 * Return 0 on success, -errno on error.
 */
#define io_closer_LO_IFACE \
	LO_FUNC(int, close)
LO_INTERFACE(io_closer)
#define io_close(c) LO_CALL(c, close)

/**
 * All methods return 0 on success, -errno on error.
 */
#define io_bidi_closer_LO_IFACE \
	LO_NEST(io_closer) \
	LO_FUNC(int, close_read) \
	LO_FUNC(int, close_write)
LO_INTERFACE(io_bidi_closer)
#define io_close_read(c) LO_CALL(c, close_read)
#define io_close_write(c) LO_CALL(c, close_write)

#endif /* _LIBHW_GENERIC_IO_H_ */