|
|
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.