]>
git.ipfire.org Git - thirdparty/systemd.git/blob - src/basic/io-util.c
1 /* SPDX-License-Identifier: LGPL-2.1-or-later */
9 #include "string-util.h"
10 #include "time-util.h"
12 int flush_fd(int fd
) {
15 /* Read from the specified file descriptor, until POLLIN is not set anymore, throwing away everything
16 * read. Note that some file descriptors (notable IP sockets) will trigger POLLIN even when no data can be read
17 * (due to IP packet checksum mismatches), hence this function is only safe to be non-blocking if the fd used
18 * was set to non-blocking too. */
25 r
= fd_wait_for_event(fd
, POLLIN
, 0);
35 l
= read(fd
, buf
, sizeof(buf
));
51 ssize_t
loop_read(int fd
, void *buf
, size_t nbytes
, bool do_poll
) {
52 uint8_t *p
= ASSERT_PTR(buf
);
57 /* If called with nbytes == 0, let's call read() at least once, to validate the operation */
59 if (nbytes
> (size_t) SSIZE_MAX
)
65 k
= read(fd
, p
, nbytes
);
70 if (errno
== EAGAIN
&& do_poll
) {
72 /* We knowingly ignore any return value here,
73 * and expect that any error/EOF is reported
76 (void) fd_wait_for_event(fd
, POLLIN
, USEC_INFINITY
);
80 return n
> 0 ? n
: -errno
;
86 assert((size_t) k
<= nbytes
);
96 int loop_read_exact(int fd
, void *buf
, size_t nbytes
, bool do_poll
) {
99 n
= loop_read(fd
, buf
, nbytes
, do_poll
);
102 if ((size_t) n
!= nbytes
)
108 int loop_write(int fd
, const void *buf
, size_t nbytes
, bool do_poll
) {
109 const uint8_t *p
= ASSERT_PTR(buf
);
113 if (_unlikely_(nbytes
> (size_t) SSIZE_MAX
))
119 k
= write(fd
, p
, nbytes
);
124 if (errno
== EAGAIN
&& do_poll
) {
125 /* We knowingly ignore any return value here,
126 * and expect that any error/EOF is reported
129 (void) fd_wait_for_event(fd
, POLLOUT
, USEC_INFINITY
);
136 if (_unlikely_(nbytes
> 0 && k
== 0)) /* Can't really happen */
139 assert((size_t) k
<= nbytes
);
143 } while (nbytes
> 0);
148 int pipe_eof(int fd
) {
151 r
= fd_wait_for_event(fd
, POLLIN
, 0);
155 return !!(r
& POLLHUP
);
158 int ppoll_usec(struct pollfd
*fds
, size_t nfds
, usec_t timeout
) {
161 assert(fds
|| nfds
== 0);
163 /* This is a wrapper around ppoll() that does primarily two things:
165 * ✅ Takes a usec_t instead of a struct timespec
167 * ✅ Guarantees that if an invalid fd is specified we return EBADF (i.e. converts POLLNVAL to
168 * EBADF). This is done because EBADF is a programming error usually, and hence should bubble up
169 * as error, and not be eaten up as non-error POLLNVAL event.
171 * ⚠️ ⚠️ ⚠️ Note that this function does not add any special handling for EINTR. Don't forget
172 * poll()/ppoll() will return with EINTR on any received signal always, there is no automatic
173 * restarting via SA_RESTART available. Thus, typically you want to handle EINTR not as an error,
174 * but just as reason to restart things, under the assumption you use a more appropriate mechanism
175 * to handle signals, such as signalfd() or signal handlers. ⚠️ ⚠️ ⚠️
181 r
= ppoll(fds
, nfds
, timeout
== USEC_INFINITY
? NULL
: TIMESPEC_STORE(timeout
), NULL
);
187 for (size_t i
= 0, n
= r
; i
< nfds
&& n
> 0; i
++) {
188 if (fds
[i
].revents
== 0)
190 if (fds
[i
].revents
& POLLNVAL
)
198 int fd_wait_for_event(int fd
, int event
, usec_t timeout
) {
199 struct pollfd pollfd
= {
205 /* ⚠️ ⚠️ ⚠️ Keep in mind you almost certainly want to handle -EINTR gracefully in the caller, see
206 * ppoll_usec() above! ⚠️ ⚠️ ⚠️ */
208 r
= ppoll_usec(&pollfd
, 1, timeout
);
212 return pollfd
.revents
;
215 static size_t nul_length(const uint8_t *p
, size_t sz
) {
230 ssize_t
sparse_write(int fd
, const void *p
, size_t sz
, size_t run_length
) {
231 const uint8_t *q
, *w
, *e
;
239 n
= nul_length(q
, e
- q
);
241 /* If there are more than the specified run length of
242 * NUL bytes, or if this is the beginning or the end
243 * of the buffer, then seek instead of write */
244 if ((n
> run_length
) ||
246 (n
> 0 && q
+ n
>= e
)) {
248 l
= write(fd
, w
, q
- w
);
255 if (lseek(fd
, n
, SEEK_CUR
) == (off_t
) -1)
267 l
= write(fd
, w
, q
- w
);
274 return q
- (const uint8_t*) p
;
277 char* set_iovec_string_field(struct iovec
*iovec
, size_t *n_iovec
, const char *field
, const char *value
) {
280 x
= strjoin(field
, value
);
282 iovec
[(*n_iovec
)++] = IOVEC_MAKE_STRING(x
);
286 char* set_iovec_string_field_free(struct iovec
*iovec
, size_t *n_iovec
, const char *field
, char *value
) {
289 x
= set_iovec_string_field(iovec
, n_iovec
, field
, value
);
294 struct iovec_wrapper
*iovw_new(void) {
295 return malloc0(sizeof(struct iovec_wrapper
));
298 void iovw_free_contents(struct iovec_wrapper
*iovw
, bool free_vectors
) {
300 for (size_t i
= 0; i
< iovw
->count
; i
++)
301 free(iovw
->iovec
[i
].iov_base
);
303 iovw
->iovec
= mfree(iovw
->iovec
);
307 struct iovec_wrapper
*iovw_free_free(struct iovec_wrapper
*iovw
) {
308 iovw_free_contents(iovw
, true);
313 struct iovec_wrapper
*iovw_free(struct iovec_wrapper
*iovw
) {
314 iovw_free_contents(iovw
, false);
319 int iovw_put(struct iovec_wrapper
*iovw
, void *data
, size_t len
) {
320 if (iovw
->count
>= IOV_MAX
)
323 if (!GREEDY_REALLOC(iovw
->iovec
, iovw
->count
+ 1))
326 iovw
->iovec
[iovw
->count
++] = IOVEC_MAKE(data
, len
);
330 int iovw_put_string_field(struct iovec_wrapper
*iovw
, const char *field
, const char *value
) {
331 _cleanup_free_
char *x
= NULL
;
334 x
= strjoin(field
, value
);
338 r
= iovw_put(iovw
, x
, strlen(x
));
345 int iovw_put_string_field_free(struct iovec_wrapper
*iovw
, const char *field
, char *value
) {
346 _cleanup_free_ _unused_
char *free_ptr
= value
;
348 return iovw_put_string_field(iovw
, field
, value
);
351 void iovw_rebase(struct iovec_wrapper
*iovw
, char *old
, char *new) {
352 for (size_t i
= 0; i
< iovw
->count
; i
++)
353 iovw
->iovec
[i
].iov_base
= (char *)iovw
->iovec
[i
].iov_base
- old
+ new;
356 size_t iovw_size(struct iovec_wrapper
*iovw
) {
359 for (size_t i
= 0; i
< iovw
->count
; i
++)
360 n
+= iovw
->iovec
[i
].iov_len
;
365 void iovec_array_free(struct iovec
*iov
, size_t n
) {
369 for (size_t i
= 0; i
< n
; i
++)
370 free(iov
[i
].iov_base
);