Differential D24596 Diff 72672 head/lib/libc/sys/read.2

Changeset View

Standalone View

head/lib/libc/sys/read.2

	Show All 22 Lines
	.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT			.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
	.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY			.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
	.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF			.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
	.\" SUCH DAMAGE.			.\" SUCH DAMAGE.
	.\"			.\"
	.\" @(#)read.2 8.4 (Berkeley) 2/26/94			.\" @(#)read.2 8.4 (Berkeley) 2/26/94
	.\" $FreeBSD$			.\" $FreeBSD$
	.\"			.\"
	.Dd March 30, 2020			.Dd June 4, 2020
	.Dt READ 2			.Dt READ 2
	.Os			.Os
	.Sh NAME			.Sh NAME
	.Nm read ,			.Nm read ,
	.Nm readv ,			.Nm readv ,
	.Nm pread ,			.Nm pread ,
	.Nm preadv			.Nm preadv
	.Nd read input			.Nd read input
	▲ Show 20 Lines • Show All 154 Lines • ▼ Show 20 Lines
	.It Bq Er EINVAL			.It Bq Er EINVAL
	The pointer associated with			The pointer associated with
	.Fa fd			.Fa fd
	was negative.			was negative.
	.It Bq Er EAGAIN			.It Bq Er EAGAIN
	The file was marked for non-blocking I/O,			The file was marked for non-blocking I/O,
	and no data were ready to be read.			and no data were ready to be read.
	.It Bq Er EISDIR			.It Bq Er EISDIR
	The file descriptor is associated with a directory residing			The file descriptor is associated with a directory.
	on a file system that does not allow regular read operations on			Directories may only be read directly if the filesystem supports it and
	directories (e.g.\& NFS).			the
				.Dv security.bsd.allow_read_dir
				sysctl MIB is set to a non-zero value.
				For most scenarios, the
				.Xr readdir 3
				function should be used instead.
	.It Bq Er EOPNOTSUPP			.It Bq Er EOPNOTSUPP
	The file descriptor is associated with a file system and file type that			The file descriptor is associated with a file system and file type that
	do not allow regular read operations on it.			do not allow regular read operations on it.
	.It Bq Er EOVERFLOW			.It Bq Er EOVERFLOW
	The file descriptor is associated with a regular file,			The file descriptor is associated with a regular file,
	.Fa nbytes			.Fa nbytes
	is greater than 0,			is greater than 0,
	.Fa offset			.Fa offset
	▲ Show 20 Lines • Show All 93 Lines • Show Last 20 Lines