diff options
-rw-r--r-- | lib/libufs/getino.3 | 116 |
1 files changed, 0 insertions, 116 deletions
diff --git a/lib/libufs/getino.3 b/lib/libufs/getino.3 deleted file mode 100644 index 881d9e7..0000000 --- a/lib/libufs/getino.3 +++ /dev/null @@ -1,116 +0,0 @@ -.\" Author: Juli Mallett <jmallett@FreeBSD.org> -.\" Date: June 04, 2003 -.\" Description: -.\" Manual page for libufs functions: -.\" getino(3) -.\" putino(3) -.\" -.\" This file is in the public domain. -.\" -.\" $FreeBSD$ -.\" -.Dd June 4, 2003 -.Dt GETINO 3 -.Os -.Sh NAME -.Nm getino , putino -.Nd get and put inodes to and from UFS disks -.Sh LIBRARY -.Lb libufs -.Sh SYNOPSIS -.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 getino "struct uufsd *disk" "void *dino" "ino_t inode" -.Ft int -.Fn putino "struct uufsd *disk" "void *dino" "ino_t inode" -.Sh DESCRIPTION -The -.Fn getino -and -.Fn putino -functions provide the ability to put an inode to disk or read an -inode from disk for -.Xr libufs 3 -consumers. -The -.Fn getino -function reads the inode specified by -.Fa inode , -and puts a pointer to an inode with the correct type into the memory -pointed to by -.Fa dino . -It maintains a cache of nearby inodes, and may simply return pointers -into memory that are in said cache. -The pointer it returns may be modified as if it were of the type -.Vt "struct ufs1_dinode" -or -.Vt "struct ufs2_dinode" -depending on whether the disk being operated on is UFS1 or UFS2, -respectively. -.Pp -The -.Fn putino -function puts an inode specified to be -.Fa inode -to disk, given memory passed in the -.Fa dino -pointer, in exactly the same manner as an inode is retrieved into -.Fa dino -by -.Fn getino . -Calls to -.Fn putino -immediately invalidate the inode cache. -.Sh RETURN VALUES -.Rv -std -.Sh ERRORS -The function -.Fn getino -may fail and set -.Va errno -for any of the errors specified for the library functions -.Xr bread 3 -and -.Xr malloc 3 . -Additionally, error may be returned if the inode format cannot be -determined. -Error reporting conventions for -.Xr libufs 3 -functions are followed. -.Pp -The function -.Fn putino -may fail and set -.Va errno -for any of the errors specified for the library functions -.Xr bwrite 3 . -Additionally, error may be returned if the inode format cannot be -determined, or if the -.Fa dino -parameter is -.Dv NULL . -In the latter case, where -.Fa dino -is unusable, -.Va errno -is set to -.Er EDOOFUS . -Error reporting conventions for -.Xr libufs 3 -functions are followed. -.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.1 . -.Sh AUTHORS -.An Juli Mallett Aq jmallett@FreeBSD.org |