e78ea9f724
getino(3)/putino(3), inode.c has been reworked in Perforce to the point where a manual page may not be accurate. Certainly putino(3) has not even been merged back yet. These will need a lot of improvement for most applications, but they document the API enough to get someone on their feet, most likely. The best documentation still exists in the form of libufs(3) consumers in the base system.
85 lines
1.5 KiB
Groff
85 lines
1.5 KiB
Groff
.\" Author: Juli Mallett <jmallett@FreeBSD.org>
|
|
.\" Date: June 04, 2003
|
|
.\" Description:
|
|
.\" Manual page for libufs functions:
|
|
.\" sbread(3)
|
|
.\" sbwrite(3)
|
|
.\"
|
|
.\" $FreeBSD$
|
|
.\"
|
|
.Dd June 04, 2003
|
|
.Dt SBREAD 3
|
|
.Os
|
|
.Sh NAME
|
|
.Nm sbread , sbwrite
|
|
.Nd read and write superblocks of a UFS filesystem
|
|
.Sh LIBRARY
|
|
.Lb libufs
|
|
.Sh SYNOPSIS
|
|
.In sys/types.h
|
|
.In sys/param.h
|
|
.In sys/mount.h
|
|
.In ufs/ufs/ufsmount.h
|
|
.In ufs/ufs/dinode.h
|
|
.In ufs/ffs/fs.h
|
|
.In libufs.h
|
|
.Ft int
|
|
.Fn sbread "struct uufsd *disk"
|
|
.Ft int
|
|
.Fn sbwrite "struct uufsd *disk" "int all"
|
|
.Sh DESCRIPTION
|
|
The
|
|
.Fn sbread
|
|
and
|
|
.Fn sbwrite
|
|
functions provide superblock reads and writes for
|
|
.Xr libufs 3
|
|
consumers.
|
|
The
|
|
.Fn sbread
|
|
and
|
|
.Fn sbwrite
|
|
functions operate on the superblock field,
|
|
.Fa d_sb ,
|
|
associated with a given userland UFS disk structure.
|
|
Additionally, the
|
|
.Fn sbwrite
|
|
function will write to all superblock locations if the
|
|
.Fa all
|
|
value is non-zero.
|
|
.Pp
|
|
The
|
|
.Fn sbread
|
|
and
|
|
.Fn sbwrite
|
|
functions return 0 on success or -1 on error.
|
|
.Sh ERRORS
|
|
The function
|
|
.Fn sbread
|
|
may fail and set
|
|
.Va errno
|
|
for any of the errors specified for the library function
|
|
.Xr bread 3 .
|
|
Additionally, it may follow the
|
|
.Xr libufs 3
|
|
error methodologies in situations where no usable superblock could be
|
|
found.
|
|
.Pp
|
|
The function
|
|
.Fn sbwrite
|
|
may fail and set
|
|
.Va errno
|
|
for any of the errors specified for the library function
|
|
.Xr bwrite 3 .
|
|
.Sh SEE ALSO
|
|
.Xr bread 3 ,
|
|
.Xr bwrite 3 ,
|
|
.Xr libufs 3
|
|
.Sh HISTORY
|
|
These functions first appeared as part of
|
|
.Xr libufs 3
|
|
in
|
|
.Fx 5.0 .
|
|
.Sh AUTHORS
|
|
.An Juli Mallett Aq jmallett@FreeBSD.org
|