write.2

UNIX v6源代码 这几乎是最经典的unix版本 unix操作系统设计和莱昂氏unix源代码分析都是用的该版

.th WRITE II 8/5/73
.sh NAME
write \*- write on a file
.sh SYNOPSIS
(write = 4.)
.br
(file descriptor in r0)
.br
.ft B
sys  write; buffer; nbytes
.s3
write(fildes, buffer, nbytes)
.br
char *buffer;
.ft R
.sh DESCRIPTION
A file descriptor is a word returned from a
successful
.it open,
.it creat,
.it dup,
or
.it pipe
call.
.s3
.it Buffer
is the address of
.it nbytes
contiguous
bytes which are written on the output file.
The number of characters actually written is returned (in r0).
It should be regarded as an error
if this is not the same as requested.
.s3
Writes which are multiples
of 512 characters long and begin on a 512-byte boundary
in the file
are more efficient than any others.
.sh "SEE ALSO"
creat (II), open (II), pipe (II)
.sh DIAGNOSTICS
The error bit
(c-bit) is set on an error: bad descriptor, buffer address, or
count; physical I/O errors.
From C, a returned value of \*-1 indicates an error.