libufs(3)

NAME

libufs - operate on UFS file systems from userland

LIBRARY

library ``libufs''

SYNOPSIS

#include <sys/param.h>
#include <sys/mount.h>
#include <ufs/ufs/ufsmount.h>
#include <ufs/ufs/dinode.h>
#include <ufs/ffs/fs.h>
#include <libufs.h>

DESCRIPTION

The libufs library and the functions it provides are used

for implementing utilities which need to access a UFS file system at a

low level from
userland. Facilities provided are used to implement utili

ties such as
newfs(8) and dumpfs(8). The libufs library is designed to

be simple, and
to provide functions that are traditionally useful to have.

A disk is represented as the type struct uufsd as defined in

The structure is filled out, operations are performed, and the disk

is closed.

ERRORS

Functions provided by libufs return -1 in every functional

error situation. They also set the d_error field of struct uufsd to a

string
describing the error.

SEE ALSO

bread(3), bwrite(3), cgread(3), cgread1(3), sbread(3), sb

write(3),
ufs_disk_close(3), ufs_disk_fillout(3), ufs_disk_fill

out_blank(3),
ufs_disk_write(3), ffs(7)

HISTORY

The libufs(3) library first appeared in FreeBSD 5.0.

AUTHORS

Juli Mallett <jmallett@FreeBSD.org>

Additional design, feedback, and ideas were provided by

Poul-Henning Kamp
<phk@FreeBSD.org>.

BSD June 4, 2003

BSD