[unix-history] / .ref-BSD-3 / usr / man / man2 / write.2

.TH WRITE 2 
.SH NAME
write \- write on a file
.SH SYNOPSIS
.B write(fildes, buffer, nbytes)
.br
.B char *buffer;
.SH DESCRIPTION
A file descriptor is a word returned from a
successful
.I open,
.I creat,
.I dup,
or
.IR pipe (2)
call.
.PP
.I Buffer
is the address of
.I nbytes
contiguous
bytes which are written on the output file.
The number of characters actually written is returned.
It should be regarded as an error
if this is not the same as requested.
.PP
Writes which are multiples
of 1024 characters long and begin on a 1024-byte boundary
in the file
are more efficient than any others.
.SH "SEE ALSO"
creat(2), open(2), pipe(2)
.SH DIAGNOSTICS
Returns
\-1 on error: bad descriptor, buffer address, or
count; physical I/O errors.
.SH "ASSEMBLER (PDP-11)"
(write = 4.)
.br
(file descriptor in r0)
.br
.B sys  write; buffer; nbytes
.br
(byte count in r0)
Commit	Line	Data
9e838ae2 BJ	1	.TH WRITE 2
	2	.SH NAME
	3	write \- write on a file
	4	.SH SYNOPSIS
	5	.B write(fildes, buffer, nbytes)
	6	.br
	7	.B char *buffer;
	8	.SH DESCRIPTION
	9	A file descriptor is a word returned from a
	10	successful
	11	.I open,
	12	.I creat,
	13	.I dup,
	14	or
	15	.IR pipe (2)
	16	call.
	17	.PP
	18	.I Buffer
	19	is the address of
	20	.I nbytes
	21	contiguous
	22	bytes which are written on the output file.
	23	The number of characters actually written is returned.
	24	It should be regarded as an error
	25	if this is not the same as requested.
	26	.PP
	27	Writes which are multiples
	28	of 1024 characters long and begin on a 1024-byte boundary
	29	in the file
	30	are more efficient than any others.
	31	.SH "SEE ALSO"
	32	creat(2), open(2), pipe(2)
	33	.SH DIAGNOSTICS
	34	Returns
	35	\-1 on error: bad descriptor, buffer address, or
	36	count; physical I/O errors.
	37	.SH "ASSEMBLER (PDP-11)"
	38	(write = 4.)
	39	.br
	40	(file descriptor in r0)
	41	.br
	42	.B sys write; buffer; nbytes
	43	.br
	44	(byte count in r0)