Return to vwrite.2v CVS log

Up to [Research Unix] / researchv10dc / man / manb

Annotation of researchv10dc/man/manb/vwrite.2v, revision 1.1.1.1

1.1       root        1: .TH VWRITE 2V deprecated
                      2: .UC 4
                      3: .SH NAME
                      4: vwrite \- write (virtually) to file
                      5: .SH SYNOPSIS
                      6: .nf
                      7: .B vwrite(filedes, buffer, nbytes)
                      8: .B char *buffer;
                      9: .fi
                     10: .SH DESCRIPTION
                     11: .B N.B.:
                     12: This call is likely to be replaced by more general virtual memory facilities
                     13: in the near future.
                     14: .PP
                     15: The
                     16: .I vwrite
                     17: system call is used in conjunction with
                     18: .I vread
                     19: to perform efficient updating of large files.
                     20: After a call to
                     21: .I vread
                     22: and updating of the data in the buffer which was given to
                     23: .I vread,
                     24: a
                     25: .I vwrite
                     26: of the same buffer to the same
                     27: .I filedes
                     28: at the same offset in the file
                     29: will cause data which has been modified since it was
                     30: .I vread
                     31: from (or
                     32: .I vwritten
                     33: to) the file to be returned to the file.
                     34: .SH SEE ALSO
                     35: vread(2)
                     36: .SH DIAGNOSTICS
                     37: Returns \-1 on error: bad descriptor, buffer address, count or alignment
                     38: as well as on physical I/O errors.
                     39: .SH BUGS
                     40: The result of
                     41: .I vwrite
                     42: is defined only when no other
                     43: .I vread's
                     44: have occurred on
                     45: .I buffer
                     46: since the one matching the
                     47: .I vwrite.
                     48: .PP
                     49: This call is peculiar to this version of UNIX.
                     50: It will be superseded by more general
                     51: virtual memory facilities in future versions of the system.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.