@@ -38,7 +38,7 @@ pub use backend::io::types::ReadWriteFlags;
3838/// [OpenBSD]: https://man.openbsd.org/read.2
3939/// [DragonFly BSD]: https://man.dragonflybsd.org/?command=read§ion=2
4040/// [illumos]: https://illumos.org/man/2/read
41- /// [glibc]: https://www.gnu. org/software/libc/ manual/html_node/I_002fO-Primitives.html#index-reading-from-a-file-descriptor
41+ /// [glibc]: https://sourceware. org/glibc/ manual/latest /html_node/I_002fO-Primitives.html#index-reading-from-a-file-descriptor
4242#[ inline]
4343pub fn read < Fd : AsFd > ( fd : Fd , buf : & mut [ u8 ] ) -> io:: Result < usize > {
4444 unsafe { backend:: io:: syscalls:: read ( fd. as_fd ( ) , buf. as_mut_ptr ( ) , buf. len ( ) ) }
@@ -84,7 +84,7 @@ pub fn read_uninit<Fd: AsFd>(
8484/// [OpenBSD]: https://man.openbsd.org/write.2
8585/// [DragonFly BSD]: https://man.dragonflybsd.org/?command=write§ion=2
8686/// [illumos]: https://illumos.org/man/2/write
87- /// [glibc]: https://www.gnu. org/software/libc/ manual/html_node/I_002fO-Primitives.html#index-writing-to-a-file-descriptor
87+ /// [glibc]: https://sourceware. org/glibc/ manual/latest /html_node/I_002fO-Primitives.html#index-writing-to-a-file-descriptor
8888#[ inline]
8989pub fn write < Fd : AsFd > ( fd : Fd , buf : & [ u8 ] ) -> io:: Result < usize > {
9090 backend:: io:: syscalls:: write ( fd. as_fd ( ) , buf)
@@ -104,6 +104,7 @@ pub fn write<Fd: AsFd>(fd: Fd, buf: &[u8]) -> io::Result<usize> {
104104/// - [OpenBSD]
105105/// - [DragonFly BSD]
106106/// - [illumos]
107+ /// - [glibc]
107108///
108109/// [POSIX]: https://pubs.opengroup.org/onlinepubs/9799919799/functions/pread.html
109110/// [Linux]: https://man7.org/linux/man-pages/man2/pread.2.html
@@ -113,6 +114,7 @@ pub fn write<Fd: AsFd>(fd: Fd, buf: &[u8]) -> io::Result<usize> {
113114/// [OpenBSD]: https://man.openbsd.org/pread.2
114115/// [DragonFly BSD]: https://man.dragonflybsd.org/?command=pread§ion=2
115116/// [illumos]: https://illumos.org/man/2/pread
117+ /// [glibc]: https://sourceware.org/glibc/manual/latest/html_node/I_002fO-Primitives.html#index-pread64
116118#[ inline]
117119pub fn pread < Fd : AsFd > ( fd : Fd , buf : & mut [ u8 ] , offset : u64 ) -> io:: Result < usize > {
118120 unsafe { backend:: io:: syscalls:: pread ( fd. as_fd ( ) , buf. as_mut_ptr ( ) , buf. len ( ) , offset) }
@@ -150,6 +152,7 @@ pub fn pread_uninit<Fd: AsFd>(
150152/// - [OpenBSD]
151153/// - [DragonFly BSD]
152154/// - [illumos]
155+ /// - [glibc]
153156///
154157/// [POSIX]: https://pubs.opengroup.org/onlinepubs/9799919799/functions/pwrite.html
155158/// [Linux]: https://man7.org/linux/man-pages/man2/pwrite.2.html
@@ -159,6 +162,7 @@ pub fn pread_uninit<Fd: AsFd>(
159162/// [OpenBSD]: https://man.openbsd.org/pwrite.2
160163/// [DragonFly BSD]: https://man.dragonflybsd.org/?command=pwrite§ion=2
161164/// [illumos]: https://illumos.org/man/2/pwrite
165+ /// [glibc]: https://sourceware.org/glibc/manual/latest/html_node/I_002fO-Primitives.html#index-pwrite64
162166#[ inline]
163167pub fn pwrite < Fd : AsFd > ( fd : Fd , buf : & [ u8 ] , offset : u64 ) -> io:: Result < usize > {
164168 backend:: io:: syscalls:: pwrite ( fd. as_fd ( ) , buf, offset)
@@ -175,6 +179,7 @@ pub fn pwrite<Fd: AsFd>(fd: Fd, buf: &[u8], offset: u64) -> io::Result<usize> {
175179/// - [OpenBSD]
176180/// - [DragonFly BSD]
177181/// - [illumos]
182+ /// - [glibc]
178183///
179184/// [POSIX]: https://pubs.opengroup.org/onlinepubs/9799919799/functions/readv.html
180185/// [Linux]: https://man7.org/linux/man-pages/man2/readv.2.html
@@ -184,6 +189,7 @@ pub fn pwrite<Fd: AsFd>(fd: Fd, buf: &[u8], offset: u64) -> io::Result<usize> {
184189/// [OpenBSD]: https://man.openbsd.org/readv.2
185190/// [DragonFly BSD]: https://man.dragonflybsd.org/?command=readv§ion=2
186191/// [illumos]: https://illumos.org/man/2/readv
192+ /// [glibc]: https://sourceware.org/glibc/manual/latest/html_node/Scatter_002dGather.html#index-readv
187193#[ cfg( not( any( target_os = "espidf" , target_os = "horizon" ) ) ) ]
188194#[ inline]
189195pub fn readv < Fd : AsFd > ( fd : Fd , bufs : & mut [ IoSliceMut < ' _ > ] ) -> io:: Result < usize > {
@@ -201,6 +207,7 @@ pub fn readv<Fd: AsFd>(fd: Fd, bufs: &mut [IoSliceMut<'_>]) -> io::Result<usize>
201207/// - [OpenBSD]
202208/// - [DragonFly BSD]
203209/// - [illumos]
210+ /// - [glibc]
204211///
205212/// [POSIX]: https://pubs.opengroup.org/onlinepubs/9799919799/functions/writev.html
206213/// [Linux]: https://man7.org/linux/man-pages/man2/writev.2.html
@@ -210,6 +217,7 @@ pub fn readv<Fd: AsFd>(fd: Fd, bufs: &mut [IoSliceMut<'_>]) -> io::Result<usize>
210217/// [OpenBSD]: https://man.openbsd.org/writev.2
211218/// [DragonFly BSD]: https://man.dragonflybsd.org/?command=writev§ion=2
212219/// [illumos]: https://illumos.org/man/2/writev
220+ /// [glibc]: https://sourceware.org/glibc/manual/latest/html_node/Scatter_002dGather.html#index-writev
213221#[ cfg( not( any( target_os = "espidf" , target_os = "horizon" ) ) ) ]
214222#[ inline]
215223pub fn writev < Fd : AsFd > ( fd : Fd , bufs : & [ IoSlice < ' _ > ] ) -> io:: Result < usize > {
@@ -226,13 +234,15 @@ pub fn writev<Fd: AsFd>(fd: Fd, bufs: &[IoSlice<'_>]) -> io::Result<usize> {
226234/// - [OpenBSD]
227235/// - [DragonFly BSD]
228236/// - [illumos]
237+ /// - [glibc]
229238///
230239/// [Linux]: https://man7.org/linux/man-pages/man2/preadv.2.html
231240/// [FreeBSD]: https://man.freebsd.org/cgi/man.cgi?query=preadv&sektion=2
232241/// [NetBSD]: https://man.netbsd.org/preadv.2
233242/// [OpenBSD]: https://man.openbsd.org/preadv.2
234243/// [DragonFly BSD]: https://man.dragonflybsd.org/?command=preadv§ion=2
235244/// [illumos]: https://illumos.org/man/2/preadv
245+ /// [glibc]: https://sourceware.org/glibc/manual/latest/html_node/Scatter_002dGather.html#index-preadv64
236246#[ cfg( not( any(
237247 target_os = "espidf" ,
238248 target_os = "haiku" ,
@@ -261,13 +271,15 @@ pub fn preadv<Fd: AsFd>(fd: Fd, bufs: &mut [IoSliceMut<'_>], offset: u64) -> io:
261271/// - [OpenBSD]
262272/// - [DragonFly BSD]
263273/// - [illumos]
274+ /// - [glibc]
264275///
265276/// [Linux]: https://man7.org/linux/man-pages/man2/pwritev.2.html
266277/// [FreeBSD]: https://man.freebsd.org/cgi/man.cgi?query=pwritev&sektion=2
267278/// [NetBSD]: https://man.netbsd.org/pwritev.2
268279/// [OpenBSD]: https://man.openbsd.org/pwritev.2
269280/// [DragonFly BSD]: https://man.dragonflybsd.org/?command=pwritev§ion=2
270281/// [illumos]: https://illumos.org/man/2/pwritev
282+ /// [glibc]: https://sourceware.org/glibc/manual/latest/html_node/I_002fO-Primitives.html#index-pwrite64
271283#[ cfg( not( any(
272284 target_os = "espidf" ,
273285 target_os = "haiku" ,
@@ -288,8 +300,10 @@ pub fn pwritev<Fd: AsFd>(fd: Fd, bufs: &[IoSlice<'_>], offset: u64) -> io::Resul
288300///
289301/// # References
290302/// - [Linux]
303+ /// - [glibc]
291304///
292305/// [Linux]: https://man7.org/linux/man-pages/man2/preadv2.2.html
306+ /// [glibc]: https://sourceware.org/glibc/manual/latest/html_node/Scatter_002dGather.html#index-preadv64v2
293307#[ cfg( linux_kernel) ]
294308#[ inline]
295309pub fn preadv2 < Fd : AsFd > (
@@ -307,8 +321,10 @@ pub fn preadv2<Fd: AsFd>(
307321///
308322/// # References
309323/// - [Linux]
324+ /// - [glibc]
310325///
311326/// [Linux]: https://man7.org/linux/man-pages/man2/pwritev2.2.html
327+ /// [glibc]: https://sourceware.org/glibc/manual/latest/html_node/Scatter_002dGather.html#index-pwritev64v2
312328#[ cfg( linux_kernel) ]
313329#[ inline]
314330pub fn pwritev2 < Fd : AsFd > (
0 commit comments