48 lines
1.3 KiB
Groff
48 lines
1.3 KiB
Groff
. \" Manual Seite fuer fileread
|
|
. \" @(#)fileread.3 1.1
|
|
. \"
|
|
.if t .ds a \v'-0.55m'\h'0.00n'\z.\h'0.40n'\z.\v'0.55m'\h'-0.40n'a
|
|
.if t .ds o \v'-0.55m'\h'0.00n'\z.\h'0.45n'\z.\v'0.55m'\h'-0.45n'o
|
|
.if t .ds u \v'-0.55m'\h'0.00n'\z.\h'0.40n'\z.\v'0.55m'\h'-0.40n'u
|
|
.if t .ds A \v'-0.77m'\h'0.25n'\z.\h'0.45n'\z.\v'0.77m'\h'-0.70n'A
|
|
.if t .ds O \v'-0.77m'\h'0.25n'\z.\h'0.45n'\z.\v'0.77m'\h'-0.70n'O
|
|
.if t .ds U \v'-0.77m'\h'0.30n'\z.\h'0.45n'\z.\v'0.77m'\h'-.75n'U
|
|
.if t .ds s \(*b
|
|
.if t .ds S SS
|
|
.if n .ds a ae
|
|
.if n .ds o oe
|
|
.if n .ds u ue
|
|
.if n .ds s sz
|
|
.TH FILEREAD 3 "15. Juli 1988" "J\*org Schilling" "Schily\'s LIBRARY FUNCTIONS"
|
|
.SH NAME
|
|
fileread() \- reads file into buffer
|
|
.SH SYNOPSIS
|
|
.nf
|
|
.B
|
|
int fileread(f,buf,size)
|
|
.B FILE *f;
|
|
.B char *buf;
|
|
.B int size;
|
|
.fi
|
|
.SH DESCRIPTION
|
|
fileread() reads up to size bytes from the file into buf. The
|
|
number actually read may be smaller if end-of-file is reached.
|
|
The file pointer (implied) is left pointing to one past the last
|
|
character read.
|
|
.SH RETURNS
|
|
.TP
|
|
.B > 0
|
|
the number of bytes actually read.
|
|
.TP
|
|
.B = 0
|
|
file was at end-of-file.
|
|
.TP
|
|
.B < 0
|
|
error code.
|
|
.PP
|
|
It returns the number of bytes actually read or an error
|
|
code.
|
|
.SH NOTES
|
|
The buffer must be at least size long. If reading from a "raw"
|
|
device, size must be a multiple of 512.
|