3 //! On Unix, "everything is a file descriptor". On Windows, file/pipe/process
4 //! handles are distinct from socket descriptors. This file provides a minimal
15 /// This is a portability abstraction over Unix-like [`BorrowedFd`] and
22 /// This is a portability abstraction over Unix-like `BorrowedFd` and
29 /// This is a portability abstraction over Unix-like [`BorrowedFd`] and
36 /// This is a portability abstraction over Unix-like `BorrowedFd` and
43 /// This is a portability abstraction over Unix-like [`OwnedFd`] and
50 /// This is a portability abstraction over Unix-like `OwnedFd` and
57 /// This is a portability abstraction over Unix-like [`OwnedFd`] and
64 /// This is a portability abstraction over Unix-like `OwnedFd` and
71 /// This is a portability abstraction over Unix-like [`AsFd`] and Windows'
81     /// use std::fs::File;
85     /// let mut f = File::open("foo.txt")?;
89     fn as_filelike(&self) -> BorrowedFilelike<'_>;  in as_filelike()
91     /// Return a borrowing view of a resource which dereferences to a `&Target`.
93     /// Note that [`Read`] or [`Write`] require `&mut Target`, but in some cases,
94     /// such as [`File`], `Read` and `Write` are implemented for `&Target` in
95     /// addition to `Target`, and you can get a `&mut &Target` by doing `&*` on
99     /// let v = f.as_filelike_view::<std::fs::File>();
103     /// [`File`]: std::fs::File
106     fn as_filelike_view<Target: FilelikeViewType>(&self) -> FilelikeView<'_, Target>;  in as_filelike_view()  argument
112     fn as_filelike(&self) -> BorrowedFilelike<'_> {  in as_filelike()
117     fn as_filelike_view<Target: FilelikeViewType>(&self) -> FilelikeView<'_, Target> {  in as_filelike_view()  argument
124 /// This is a portability abstraction over Unix-like `AsFd` and Windows'
134     /// use std::fs::File;
138     /// let mut f = File::open("foo.txt")?;
142     fn as_filelike(&self) -> BorrowedFilelike<'_>;  in as_filelike()
144     /// Return a borrowing view of a resource which dereferences to a `&Target`.
146     /// Note that [`Read`] or [`Write`] require `&mut Target`, but in some cases,
147     /// such as [`File`], `Read` and `Write` are implemented for `&Target` in
148     /// addition to `Target`, and you can get a `&mut &Target` by doing `&*` on
152     /// let v = f.as_filelike_view::<std::fs::File>();
156     /// [`File`]: std::fs::File
159     fn as_filelike_view<Target: FilelikeViewType>(&self) -> FilelikeView<'_, Target>;  in as_filelike_view()  argument
165     fn as_filelike(&self) -> BorrowedFilelike<'_> {  in as_filelike()
170     fn as_filelike_view<Target: FilelikeViewType>(&self) -> FilelikeView<'_, Target> {  in as_filelike_view()  argument
178 /// This is a portability abstraction over Unix-like [`AsFd`] and Windows'
184     fn as_socketlike(&self) -> BorrowedSocketlike<'_>;  in as_socketlike()
186     /// Return a borrowing view of a resource which dereferences to a `&Target`.
188     /// Note that [`Read`] or [`Write`] require `&mut Target`, but in some cases,
189     /// such as [`TcpStream`], `Read` and `Write` are implemented for `&Target` in
190     /// addition to `Target`, and you can get a `&mut &Target` by doing `&*` on
201     fn as_socketlike_view<Target: SocketlikeViewType>(&self) -> SocketlikeView<'_, Target>;  in as_socketlike_view()  argument
207     fn as_socketlike(&self) -> BorrowedSocketlike<'_> {  in as_socketlike()
212     fn as_socketlike_view<Target: SocketlikeViewType>(&self) -> SocketlikeView<'_, Target> {  in as_socketlike_view()  argument
220 /// This is a portability abstraction over Unix-like `AsFd` and Windows'
226     fn as_socketlike(&self) -> BorrowedSocketlike;  in as_socketlike()
228     /// Return a borrowing view of a resource which dereferences to a `&Target`.
230     /// Note that [`Read`] or [`Write`] require `&mut Target`, but in some cases,
231     /// such as [`TcpStream`], `Read` and `Write` are implemented for `&Target` in
232     /// addition to `Target`, and you can get a `&mut &Target` by doing `&*` on
241     fn as_socketlike_view<Target: SocketlikeViewType>(&self) -> SocketlikeView<'_, Target>;  in as_socketlike_view()  argument
247     fn as_socketlike(&self) -> BorrowedSocketlike<'_> {  in as_socketlike()
252     fn as_socketlike_view<Target: SocketlikeViewType>(&self) -> SocketlikeView<'_, Target> {  in as_socketlike_view()  argument
260 /// This is a portability abstraction over Unix-like [`Into<OwnedFd>`] and Windows'
269     /// use std::fs::File;
273     /// let f = File::open("foo.txt")?;
277     fn into_filelike(self) -> OwnedFilelike;  in into_filelike()
283     fn into_filelike(self) -> OwnedFilelike {  in into_filelike()
291 /// This is a portability abstraction over Unix-like `Into<OwnedFd>` and Windows'
296     fn into_filelike(self) -> OwnedFilelike;  in into_filelike()
302     fn into_filelike(self) -> OwnedFilelike {  in into_filelike()
310 /// This is a portability abstraction over Unix-like [`Into<OwnedFd>`] and Windows'
315     fn into_socketlike(self) -> OwnedSocketlike;  in into_socketlike()
321     fn into_socketlike(self) -> OwnedSocketlike {  in into_socketlike()
329 /// This is a portability abstraction over Unix-like `Into<OwnedFd>` and Windows'
338     /// use std::fs::File;
342     /// let f = File::open("foo.txt")?;
346     fn into_socketlike(self) -> OwnedSocketlike;  in into_socketlike()
352     fn into_socketlike(self) -> OwnedSocketlike {  in into_socketlike()
360 /// This is a portability abstraction over Unix-like [`From<OwnedFd>`] and Windows'
370     /// use std::fs::File;
374     /// let f = File::open("foo.txt")?;
376     /// let f = File::from_filelike(owned_filelike);
379     fn from_filelike(owned: OwnedFilelike) -> Self;  in from_filelike()
387     /// use std::fs::File;
391     /// let f = File::open("foo.txt")?;
392     /// let f = File::from_into_filelike(f);
395     fn from_into_filelike<Owned: IntoFilelike>(owned: Owned) -> Self;  in from_into_filelike()
401     fn from_filelike(owned: OwnedFilelike) -> Self {  in from_filelike()
406     fn from_into_filelike<Owned: IntoFilelike>(owned: Owned) -> Self {  in from_into_filelike()
414 /// This is a portability abstraction over Unix-like `From<OwnedFd>` and Windows'
424     /// use std::fs::File;
428     /// let f = File::open("foo.txt")?;
430     /// let f = File::from_filelike(owned_filelike);
433     fn from_filelike(owned: OwnedFilelike) -> Self;  in from_filelike()
441     /// use std::fs::File;
445     /// let f = File::open("foo.txt")?;
446     /// let f = File::from_into_filelike(f);
449     fn from_into_filelike<Owned: IntoFilelike>(owned: Owned) -> Self;  in from_into_filelike()
455     fn from_filelike(owned: OwnedFilelike) -> Self {  in from_filelike()
460     fn from_into_filelike<Owned: IntoFilelike>(owned: Owned) -> Self {  in from_into_filelike()
468 /// This is a portability abstraction over Unix-like [`From<OwnedFd>`] and Windows'
474     fn from_socketlike(owned: OwnedSocketlike) -> Self;  in from_socketlike()
478     fn from_into_socketlike<Owned: IntoSocketlike>(owned: Owned) -> Self;  in from_into_socketlike()
484     fn from_socketlike(owned: OwnedSocketlike) -> Self {  in from_socketlike()
489     fn from_into_socketlike<Owned: IntoSocketlike>(owned: Owned) -> Self {  in from_into_socketlike()
497 /// This is a portability abstraction over Unix-like `From<OwnedFd>` and Windows'
503     fn from_socketlike(owned: OwnedSocketlike) -> Self;  in from_socketlike()
507     fn from_into_socketlike<Owned: IntoSocketlike>(owned: Owned) -> Self;  in from_into_socketlike()
513     fn from_socketlike(owned: OwnedSocketlike) -> Self {  in from_socketlike()
518     fn from_into_socketlike<Owned: IntoSocketlike>(owned: Owned) -> Self {  in from_into_socketlike()