1 .\" Author: Juli Mallett <jmallett@FreeBSD.org>
2 .\" Date: June 04, 2003
4 .\" Manual page for libufs functions:
8 .\" This file is in the public domain.
17 .Nd read and write blocks of a UFS file system
23 .In ufs/ufs/ufsmount.h
28 .Fn bread "struct uufsd *disk" "ufs2_daddr_t blockno" "void *data" "size_t size"
31 .Fa "struct uufsd *disk" "ufs2_daddr_t blockno"
32 .Fa "const void *data" "size_t size"
39 functions provide a block read and write API for
42 They operate on a userland UFS disk structure, and perform the read
43 and write at a given block address, which uses the current
45 value of the structure.
51 functions return the amount read or written, or \-1 in case of any error,
58 for any of the errors specified for the library functions
62 Additionally, it may follow the
64 error methodologies in situations where the amount of data read
65 is not equal to the amount requested, or in case of device error.
71 for any of the errors specified for the library function
73 Additionally, it may follow the
75 error methodologies in situations where the amount of data written
76 is not equal to the amount requested, or in case of a device error.
81 These functions first appeared as part of
86 .An Juli Mallett Aq jmallett@FreeBSD.org