|
HTML rendering created 2026-01-16 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH. |
|
|
NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | ERRORS | SEE ALSO | COLOPHON |
|
|
|
io_uring_prep_getsockname(3) liburing Manual io_uring_prep_getsockname(3)
io_uring_prep_getsockname - prepare a getsockname or getpeername
request
#include <sys/socket.h>
#include <liburing.h>
void io_uring_prep_getsockname(struct io_uring_sqe *sqe,
int sockfd,
struct sockaddr *sockaddr,
socklen_t *sockaddr_len,
int peer);
The io_uring_prep_getsockname(3) function prepares a
getsockname/getpeername request. The submission queue entry sqe
is setup to fetch the locally bound address or peer address of the
socket file descriptor pointed by sockfd. The parameter sockaddr
points to a region of size sockaddr_len where the output is
written. sockaddr_len is modified by the kernel to indicate how
many bytes were written. The output address is the locally bound
address if peer is set to 0 or the peer address if peer is set to
1.
This function prepares an async getsockname(2) or getpeername(2)
request. See those man pages for details.
None
The CQE res field will contain the result of the operation. See
the related man page for details on possible values. Note that
where synchronous system calls will return -1 on failure and set
errno to the actual error value, io_uring never uses errno.
Instead it returns the negated errno directly in the CQE res
field. Differently from the equivalent system calls, if the user
attempts to use this operation on a non-socket file descriptor,
the CQE error result is -ENOTSUP instead of ENOSOCK.
io_uring_get_sqe(3), io_uring_submit(3),
io_uring_prep_getsockname(2) io_uring_prep_getpeername(2)
This page is part of the liburing (A library for io_uring)
project. Information about the project can be found at
⟨https://github.com/axboe/liburing⟩. If you have a bug report for
this manual page, send it to [email protected]. This page
was obtained from the project's upstream Git repository
⟨https://github.com/axboe/liburing⟩ on 2026-01-16. (At that time,
the date of the most recent commit that was found in the
repository was 2026-01-13.) If you discover any rendering
problems in this HTML version of the page, or you believe there is
a better or more up-to-date source for the page, or you have
corrections or improvements to the information in this COLOPHON
(which is not part of the original manual page), send a mail to
[email protected]
liburing-2.13 Dec 3, 2025 io_uring_prep_getsockname(3)
Pages that refer to this page: io_uring_prep_getsockname(3)
|
HTML rendering created 2026-01-16 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH. |
|