package poll

Import Path
	internal/poll (on golang.org and go.dev)

Dependency Relation
	imports 8 packages, and imported by 2 packages

Involved Source Files
	    copy_file_range_linux.go
	    errno_unix.go
	    fcntl_syscall.go
	d-> fd.go
	    fd_fsync_posix.go
	    fd_mutex.go
	    fd_poll_runtime.go
	    fd_posix.go
	    fd_unix.go
	    fd_writev_unix.go
	    hook_cloexec.go
	    hook_unix.go
	    sendfile_linux.go
	    sock_cloexec.go
	    sockopt.go
	    sockopt_linux.go
	    sockopt_unix.go
	    sockoptip.go
	    splice_linux.go
	    writev.go

Exported Type Names

	type DeadlineExceededError (struct)
		DeadlineExceededError is returned for an expired deadline.

		Exported Methods (3)
			(*T) Error() string
				Implement the net.Error interface.
				The string is "i/o timeout" because that is what was returned
				by earlier Go versions. Changing it may break programs that
				match on error strings.

			(*T) Temporary() bool
			(*T) Timeout() bool
		Implements (2+)
			*T : error
			*T : net.Error
	type FD (struct)
		FD is a file descriptor. The net and os packages use this type as a
		field of a larger type representing a network connection or OS file.

		Exported Fields (3)
			IsStream bool
				Whether this is a streaming descriptor, as opposed to a
				packet-based descriptor like a UDP socket. Immutable.

			Sysfd int
				System file descriptor. Immutable until Close.

			ZeroReadIsEOF bool
				Whether a zero byte read indicates EOF. This is false for a
				message based socket connection.

		Exported Methods (38)
			(*T) Accept() (int, syscall.Sockaddr, string, error)
				Accept wraps the accept network call.

			(*T) Close() error
				Close closes the FD. The underlying file descriptor is closed by the
				destroy method when there are no remaining references.

			(*T) Dup() (int, string, error)
				Dup duplicates the file descriptor.

			(*T) Fchdir() error
				Fchdir wraps syscall.Fchdir.

			(*T) Fchmod(mode uint32) error
				Fchmod wraps syscall.Fchmod.

			(*T) Fchown(uid, gid int) error
				Fchown wraps syscall.Fchown.

			(*T) Fstat(s *syscall.Stat_t) error
				Fstat wraps syscall.Fstat

			(*T) Fsync() error
				Fsync wraps syscall.Fsync.

			(*T) Ftruncate(size int64) error
				Ftruncate wraps syscall.Ftruncate.

			(*T) Init(net string, pollable bool) error
				Init initializes the FD. The Sysfd field should already be set.
				This can be called multiple times on a single FD.
				The net argument is a network name from the net package (e.g., "tcp"),
				or "file".
				Set pollable to true if fd should be managed by runtime netpoll.

			(*T) Pread(p []byte, off int64) (int, error)
				Pread wraps the pread system call.

			(*T) Pwrite(p []byte, off int64) (int, error)
				Pwrite wraps the pwrite system call.

			(*T) RawControl(f func(uintptr)) error
				RawControl invokes the user-defined function f for a non-IO
				operation.

			(*T) RawRead(f func(uintptr) bool) error
				RawRead invokes the user-defined function f for a read operation.

			(*T) RawWrite(f func(uintptr) bool) error
				RawWrite invokes the user-defined function f for a write operation.

			(*T) Read(p []byte) (int, error)
				Read implements io.Reader.

			(*T) ReadDirent(buf []byte) (int, error)
				ReadDirent wraps syscall.ReadDirent.
				We treat this like an ordinary system call rather than a call
				that tries to fill the buffer.

			(*T) ReadFrom(p []byte) (int, syscall.Sockaddr, error)
				ReadFrom wraps the recvfrom network call.

			(*T) ReadMsg(p []byte, oob []byte) (int, int, int, syscall.Sockaddr, error)
				ReadMsg wraps the recvmsg network call.

			(*T) Seek(offset int64, whence int) (int64, error)
				Seek wraps syscall.Seek.

			(*T) SetBlocking() error
				SetBlocking puts the file into blocking mode.

			(*T) SetDeadline(t time.Time) error
				SetDeadline sets the read and write deadlines associated with fd.

			(*T) SetReadDeadline(t time.Time) error
				SetReadDeadline sets the read deadline associated with fd.

			(*T) SetWriteDeadline(t time.Time) error
				SetWriteDeadline sets the write deadline associated with fd.

			(*T) SetsockoptByte(level, name int, arg byte) error
				SetsockoptByte wraps the setsockopt network call with a byte argument.

			(*T) SetsockoptIPMreq(level, name int, mreq *syscall.IPMreq) error
				SetsockoptIPMreq wraps the setsockopt network call with an IPMreq argument.

			(*T) SetsockoptIPMreqn(level, name int, mreq *syscall.IPMreqn) error
				SetsockoptIPMreqn wraps the setsockopt network call with an IPMreqn argument.

			(*T) SetsockoptIPv6Mreq(level, name int, mreq *syscall.IPv6Mreq) error
				SetsockoptIPv6Mreq wraps the setsockopt network call with an IPv6Mreq argument.

			(*T) SetsockoptInet4Addr(level, name int, arg [4]byte) error
				SetsockoptInet4Addr wraps the setsockopt network call with an IPv4 address.

			(*T) SetsockoptInt(level, name, arg int) error
				SetsockoptInt wraps the setsockopt network call with an int argument.

			(*T) SetsockoptLinger(level, name int, l *syscall.Linger) error
				SetsockoptLinger wraps the setsockopt network call with a Linger argument.

			(*T) Shutdown(how int) error
				Shutdown wraps syscall.Shutdown.

			(*T) WaitWrite() error
				WaitWrite waits until data can be read from fd.

			(*T) Write(p []byte) (int, error)
				Write implements io.Writer.

			(*T) WriteMsg(p []byte, oob []byte, sa syscall.Sockaddr) (int, int, error)
				WriteMsg wraps the sendmsg network call.

			(*T) WriteOnce(p []byte) (int, error)
				WriteOnce is for testing only. It makes a single write call.

			(*T) WriteTo(p []byte, sa syscall.Sockaddr) (int, error)
				WriteTo wraps the sendto network call.

			(*T) Writev(v *[][]byte) (int64, error)
				Writev wraps the writev system call.

		Implements (11+)
			*T : io.Closer
			*T : io.ReadCloser
			*T : io.Reader
			*T : io.ReadSeeker
			*T : io.ReadWriteCloser
			*T : io.ReadWriter
			*T : io.ReadWriteSeeker
			*T : io.Seeker
			*T : io.WriteCloser
			*T : io.Writer
			*T : io.WriteSeeker
		As Inputs Of (3+)
			func CopyFileRange(dst, src *FD, remain int64) (written int64, handled bool, err error)
			func SendFile(dstFD *FD, src int, remain int64) (int64, error)
			func Splice(dst, src *FD, remain int64) (written int64, handled bool, sc string, err error)
Exported Values

	  var Accept4Func (int, int) (int, syscall.Sockaddr, error)
		Accept4Func is used to hook the accept4 call.
	  var AcceptFunc (int) (int, syscall.Sockaddr, error)
		AcceptFunc is used to hook the accept call.
	  var CloseFunc (int) error
		CloseFunc is used to hook the close call.
	 func CopyFileRange(dst, src *FD, remain int64) (written int64, handled bool, err error)
		CopyFileRange copies at most remain bytes of data from src to dst, using
		the copy_file_range system call. dst and src must refer to regular files.
	 func DupCloseOnExec(fd int) (int, string, error)
		DupCloseOnExec dups fd and marks it close-on-exec.
	  var ErrDeadlineExceeded error
		ErrDeadlineExceeded is returned for an expired deadline.
		This is exported by the os package as os.ErrDeadlineExceeded.
	  var ErrFileClosing error
		ErrFileClosing is returned when a file descriptor is used after it
		has been closed.
	  var ErrNetClosing error
		ErrNetClosing is returned when a network descriptor is used after
		it has been closed. Keep this string consistent because of issue
		#4373: since historically programs have not been able to detect
		this error, they look for the string.
	  var ErrNoDeadline error
		ErrNoDeadline is returned when a request is made to set a deadline
		on a file type that does not use the poller.
	  var ErrNotPollable error
		ErrNotPollable is returned when the file or socket is not suitable
		for event notification.
	 func IsPollDescriptor(fd uintptr) bool
		IsPollDescriptor reports whether fd is the descriptor being used by the poller.
		This is only used for testing.
	 func SendFile(dstFD *FD, src int, remain int64) (int64, error)
		SendFile wraps the sendfile system call.
	 func Splice(dst, src *FD, remain int64) (written int64, handled bool, sc string, err error)
		Splice transfers at most remain bytes of data from src to dst, using the
		splice system call to minimize copies of data from and to userspace.

		Splice creates a temporary pipe, to serve as a buffer for the data transfer.
		src and dst must both be stream-oriented sockets.

		If err != nil, sc is the system call which caused the error.
	  var TestHookDidWritev func(wrote int)
		TestHookDidWritev is a hook for testing writev.

The pages are generated with Golds v0.1.7. (GOOS=linux GOARCH=amd64)
Golds is a Go 101 project and developed by Tapir Liu.
PR and bug reports are welcome and can be submitted to the issue list.
Please follow @Go100and1 (reachable from the left QR code) to get the latest news of Golds.