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 get and put inodes to and from UFS disks
23 .In ufs/ufs/ufsmount.h
28 .Fn getino "struct uufsd *disk" "void *dino" "ino_t inode"
30 .Fn putino "struct uufsd *disk" "void *dino" "ino_t inode"
36 functions provide the ability to put an inode to disk or read an
42 function reads the inode specified by
44 and puts a pointer to an inode with the correct type into the memory
47 It maintains a cache of nearby inodes, and may simply return pointers
48 into memory that are in said cache.
49 The pointer it returns may be modified as if it were of the type
50 .Dq struct ufs1_dinode
52 .Dq struct ufs2_dinode
53 depending on whether the disk being operated on is UFS1 or UFS2,
58 function puts an inode specified to be
60 to disk, given memory passed in the
62 pointer, in exactly the same manner as an inode is retrieved into
68 immediately invalidate the inode cache.
70 Both functions return 0 on success and -1 on error.
76 for any of the errors specified for the library functions
80 Additionally, error may be returned if the inode format cannot be
82 Error reporting conventions for
84 functions are followed.
90 for any of the errors specified for the library functions
92 Additionally, error may be returned if the inode format cannot be
97 In the latter case, where
103 Error reporting conventions for
105 functions are followed.
111 These functions first appeared as part of
116 .An Juli Mallett Aq jmallett@FreeBSD.org