HAMMER 8/many - A-list, B-Tree fixes. As-of queries
[dragonfly.git] / sys / vfs / hammer / hammer_inode.c
1 /*
2  * Copyright (c) 2007 The DragonFly Project.  All rights reserved.
3  * 
4  * This code is derived from software contributed to The DragonFly Project
5  * by Matthew Dillon <dillon@backplane.com>
6  * 
7  * Redistribution and use in source and binary forms, with or without
8  * modification, are permitted provided that the following conditions
9  * are met:
10  * 
11  * 1. Redistributions of source code must retain the above copyright
12  *    notice, this list of conditions and the following disclaimer.
13  * 2. Redistributions in binary form must reproduce the above copyright
14  *    notice, this list of conditions and the following disclaimer in
15  *    the documentation and/or other materials provided with the
16  *    distribution.
17  * 3. Neither the name of The DragonFly Project nor the names of its
18  *    contributors may be used to endorse or promote products derived
19  *    from this software without specific, prior written permission.
20  * 
21  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
22  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
23  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
24  * FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE
25  * COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
26  * INCIDENTAL, SPECIAL, EXEMPLARY OR CONSEQUENTIAL DAMAGES (INCLUDING,
27  * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
28  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
29  * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
30  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
31  * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
32  * SUCH DAMAGE.
33  * 
34  * $DragonFly: src/sys/vfs/hammer/hammer_inode.c,v 1.9 2007/11/27 07:48:52 dillon Exp $
35  */
36
37 #include "hammer.h"
38 #include <sys/buf.h>
39 #include <sys/buf2.h>
40
41 int
42 hammer_vop_inactive(struct vop_inactive_args *ap)
43 {
44         struct hammer_inode *ip = VTOI(ap->a_vp);
45
46         /*
47          * Degenerate case
48          */
49         if (ip == NULL) {
50                 vrecycle(ap->a_vp);
51                 return(0);
52         }
53
54         /*
55          * If the inode no longer has any references we recover its
56          * in-memory resources immediately.
57          */
58         if (ip->ino_rec.ino_nlinks == 0 &&
59             (ip->hmp->mp->mnt_flag & MNT_RDONLY) == 0) {
60                 hammer_sync_inode(ip, MNT_NOWAIT, 1);
61         }
62         return(0);
63 }
64
65 int
66 hammer_vop_reclaim(struct vop_reclaim_args *ap)
67 {
68         struct hammer_inode *ip;
69         struct vnode *vp;
70
71         vp = ap->a_vp;
72
73         /*
74          * Release the vnode association and ask that the inode be flushed.
75          */
76         if ((ip = vp->v_data) != NULL) {
77                 vp->v_data = NULL;
78                 ip->vp = NULL;
79                 hammer_rel_inode(ip, 1);
80         }
81         return(0);
82 }
83
84 /*
85  * Obtain a vnode for the specified inode number.  An exclusively locked
86  * vnode is returned.
87  */
88 int
89 hammer_vfs_vget(struct mount *mp, ino_t ino, struct vnode **vpp)
90 {
91         struct hammer_mount *hmp = (void *)mp->mnt_data;
92         struct hammer_inode *ip;
93         int error;
94
95         /*
96          * Get/allocate the hammer_inode structure.  The structure must be
97          * unlocked while we manipulate the related vnode to avoid a
98          * deadlock.
99          */
100         ip = hammer_get_inode(hmp, ino, hmp->asof, &error);
101         if (ip == NULL) {
102                 *vpp = NULL;
103                 return(error);
104         }
105         error = hammer_get_vnode(ip, LK_EXCLUSIVE, vpp);
106         hammer_rel_inode(ip, 0);
107         return (error);
108 }
109
110 /*
111  * Return a locked vnode for the specified inode.  The inode must be
112  * referenced but NOT LOCKED on entry and will remain referenced on
113  * return.
114  */
115 int
116 hammer_get_vnode(struct hammer_inode *ip, int lktype, struct vnode **vpp)
117 {
118         struct vnode *vp;
119         int error = 0;
120
121         for (;;) {
122                 if ((vp = ip->vp) == NULL) {
123                         error = getnewvnode(VT_HAMMER, ip->hmp->mp, vpp, 0, 0);
124                         if (error)
125                                 break;
126                         hammer_lock_ex(&ip->lock);
127                         if (ip->vp != NULL) {
128                                 hammer_unlock(&ip->lock);
129                                 vp->v_type = VBAD;
130                                 vx_put(vp);
131                                 continue;
132                         }
133                         hammer_ref(&ip->lock);
134                         vp = *vpp;
135                         ip->vp = vp;
136                         vp->v_type = hammer_get_vnode_type(
137                                             ip->ino_rec.base.base.obj_type);
138                         vp->v_data = (void *)ip;
139                         /* vnode locked by getnewvnode() */
140                         /* make related vnode dirty if inode dirty? */
141                         hammer_unlock(&ip->lock);
142                         if (vp->v_type == VREG)
143                                 vinitvmio(vp, ip->ino_rec.ino_size);
144                         break;
145                 }
146
147                 /*
148                  * loop if the vget fails (aka races), or if the vp
149                  * no longer matches ip->vp.
150                  */
151                 if (vget(vp, LK_EXCLUSIVE) == 0) {
152                         if (vp == ip->vp)
153                                 break;
154                         vput(vp);
155                 }
156         }
157         *vpp = vp;
158         return(error);
159 }
160
161 /*
162  * Acquire a HAMMER inode.  The returned inode is not locked.  These functions
163  * do not attach or detach the related vnode (use hammer_get_vnode() for
164  * that).
165  */
166 struct hammer_inode *
167 hammer_get_inode(struct hammer_mount *hmp, u_int64_t obj_id, hammer_tid_t asof,
168                  int *errorp)
169 {
170         struct hammer_inode_info iinfo;
171         struct hammer_cursor cursor;
172         struct hammer_inode *ip;
173
174         /*
175          * Determine if we already have an inode cached.  If we do then
176          * we are golden.
177          */
178         iinfo.obj_id = obj_id;
179         iinfo.obj_asof = asof;
180 loop:
181         ip = hammer_ino_rb_tree_RB_LOOKUP_INFO(&hmp->rb_inos_root, &iinfo);
182         if (ip) {
183                 hammer_ref(&ip->lock);
184                 *errorp = 0;
185                 return(ip);
186         }
187
188         ip = kmalloc(sizeof(*ip), M_HAMMER, M_WAITOK|M_ZERO);
189         ip->obj_id = obj_id;
190         ip->obj_asof = iinfo.obj_asof;
191         ip->hmp = hmp;
192         RB_INIT(&ip->rec_tree);
193
194         /*
195          * Locate the on-disk inode.
196          * If we do not have an inode cached search the HAMMER on-disk B-Tree
197          * for it.
198          */
199
200         hammer_init_cursor_hmp(&cursor, hmp);
201         cursor.key_beg.obj_id = ip->obj_id;
202         cursor.key_beg.key = 0;
203         cursor.key_beg.create_tid = iinfo.obj_asof;
204         cursor.key_beg.delete_tid = 0;
205         cursor.key_beg.rec_type = HAMMER_RECTYPE_INODE;
206         cursor.key_beg.obj_type = 0;
207         cursor.flags = HAMMER_CURSOR_GET_RECORD | HAMMER_CURSOR_GET_DATA;
208
209         *errorp = hammer_btree_lookup(&cursor);
210
211         /*
212          * On success the B-Tree lookup will hold the appropriate
213          * buffer cache buffers and provide a pointer to the requested
214          * information.  Copy the information to the in-memory inode.
215          */
216         if (*errorp == 0) {
217                 ip->ino_rec = cursor.record->inode;
218                 ip->ino_data = cursor.data->inode;
219         }
220         hammer_cache_node(cursor.node, &ip->cache);
221         hammer_done_cursor(&cursor);
222
223         /*
224          * On success load the inode's record and data and insert the
225          * inode into the B-Tree.  It is possible to race another lookup
226          * insertion of the same inode so deal with that condition too.
227          */
228         if (*errorp == 0) {
229                 hammer_ref(&ip->lock);
230                 if (RB_INSERT(hammer_ino_rb_tree, &hmp->rb_inos_root, ip)) {
231                         hammer_uncache_node(&ip->cache);
232                         hammer_unref(&ip->lock);
233                         kfree(ip, M_HAMMER);
234                         goto loop;
235                 }
236                 ip->flags |= HAMMER_INODE_ONDISK;
237         } else {
238                 kfree(ip, M_HAMMER);
239                 ip = NULL;
240         }
241         return (ip);
242 }
243
244 /*
245  * Create a new filesystem object, returning the inode in *ipp.  The
246  * returned inode will be referenced but not locked.
247  *
248  * The inode is created in-memory and will be delay-synchronized to the
249  * disk.
250  */
251 int
252 hammer_create_inode(hammer_transaction_t trans, struct vattr *vap,
253                     struct ucred *cred, hammer_inode_t dip,
254                     struct hammer_inode **ipp)
255 {
256         hammer_mount_t hmp;
257         hammer_inode_t ip;
258         uid_t xuid;
259
260         hmp = trans->hmp;
261         ip = kmalloc(sizeof(*ip), M_HAMMER, M_WAITOK|M_ZERO);
262         ip->obj_id = hammer_alloc_tid(trans);
263         KKASSERT(ip->obj_id != 0);
264         ip->obj_asof = hmp->asof;
265         ip->hmp = hmp;
266         ip->flags = HAMMER_INODE_DDIRTY | HAMMER_INODE_RDIRTY |
267                     HAMMER_INODE_ITIMES;
268         ip->last_tid = trans->tid;
269
270         RB_INIT(&ip->rec_tree);
271
272         ip->ino_rec.ino_atime = trans->tid;
273         ip->ino_rec.ino_mtime = trans->tid;
274         ip->ino_rec.ino_size = 0;
275         ip->ino_rec.ino_nlinks = 0;
276         /* XXX */
277         kprintf("rootvol %p ondisk %p\n", hmp->rootvol, hmp->rootvol->ondisk);
278         ip->ino_rec.base.rec_id = hammer_alloc_recid(trans);
279         KKASSERT(ip->ino_rec.base.rec_id != 0);
280         ip->ino_rec.base.base.obj_id = ip->obj_id;
281         ip->ino_rec.base.base.key = 0;
282         ip->ino_rec.base.base.create_tid = trans->tid;
283         ip->ino_rec.base.base.delete_tid = 0;
284         ip->ino_rec.base.base.rec_type = HAMMER_RECTYPE_INODE;
285         ip->ino_rec.base.base.obj_type = hammer_get_obj_type(vap->va_type);
286
287         ip->ino_data.version = HAMMER_INODE_DATA_VERSION;
288         ip->ino_data.mode = vap->va_mode;
289         ip->ino_data.ctime = trans->tid;
290         ip->ino_data.parent_obj_id = (dip) ? dip->ino_rec.base.base.obj_id : 0;
291
292         /*
293          * Calculate default uid/gid and overwrite with information from
294          * the vap.
295          */
296         xuid = hammer_to_unix_xid(&dip->ino_data.uid);
297         ip->ino_data.gid = dip->ino_data.gid;
298         xuid = vop_helper_create_uid(hmp->mp, dip->ino_data.mode, xuid, cred,
299                                      &vap->va_mode);
300         ip->ino_data.mode = vap->va_mode;
301
302         if (vap->va_vaflags & VA_UID_UUID_VALID)
303                 ip->ino_data.uid = vap->va_uid_uuid;
304         else if (vap->va_uid != (uid_t)VNOVAL)
305                 hammer_guid_to_uuid(&ip->ino_data.uid, xuid);
306         if (vap->va_vaflags & VA_GID_UUID_VALID)
307                 ip->ino_data.gid = vap->va_gid_uuid;
308         else if (vap->va_gid != (gid_t)VNOVAL)
309                 hammer_guid_to_uuid(&ip->ino_data.gid, vap->va_gid);
310
311         hammer_ref(&ip->lock);
312         if (RB_INSERT(hammer_ino_rb_tree, &hmp->rb_inos_root, ip)) {
313                 hammer_unref(&ip->lock);
314                 panic("hammer_create_inode: duplicate obj_id %llx", ip->obj_id);
315         }
316         *ipp = ip;
317         return(0);
318 }
319
320 int
321 hammer_update_inode(hammer_inode_t ip)
322 {
323         struct hammer_cursor cursor;
324         hammer_record_t record;
325         int error;
326
327         /*
328          * Locate the record on-disk and mark it as deleted.  Both the B-Tree
329          * node and the record must be marked deleted.  Adjusting delete_tid
330          * does not effect the element position in the B-Tree.
331          *
332          * If the inode is already deleted on-disk we have nothing to do.
333          *
334          * XXX Update the inode record and data in-place if the retention
335          * policy allows it.
336          */
337         error = 0;
338
339         if ((ip->flags & (HAMMER_INODE_ONDISK|HAMMER_INODE_DELONDISK)) ==
340             HAMMER_INODE_ONDISK) {
341                 hammer_init_cursor_ip(&cursor, ip);
342                 cursor.key_beg.obj_id = ip->obj_id;
343                 cursor.key_beg.key = 0;
344                 cursor.key_beg.create_tid = ip->obj_asof;
345                 cursor.key_beg.delete_tid = 0;
346                 cursor.key_beg.rec_type = HAMMER_RECTYPE_INODE;
347                 cursor.key_beg.obj_type = 0;
348                 cursor.flags = HAMMER_CURSOR_GET_RECORD;
349
350                 error = hammer_btree_lookup(&cursor);
351
352                 if (error == 0) {
353                         cursor.record->base.base.delete_tid = ip->last_tid;
354                         cursor.node->ondisk->elms[cursor.index].leaf.base.delete_tid = ip->last_tid;
355                         hammer_modify_buffer(cursor.record_buffer);
356                         hammer_modify_node(cursor.node);
357                         ip->flags |= HAMMER_INODE_DELONDISK;
358                 }
359                 hammer_cache_node(cursor.node, &ip->cache);
360                 hammer_done_cursor(&cursor);
361         }
362
363         /*
364          * Write out a new record if the in-memory inode is not marked
365          * as having been deleted.
366          *
367          * If the inode has been deleted permanently, HAMMER_INODE_DELONDISK
368          * will remain set and prevent further updates.
369          */
370         if (error == 0 && (ip->flags & HAMMER_INODE_DELETED) == 0) { 
371                 record = hammer_alloc_mem_record(ip);
372                 record->rec.inode = ip->ino_rec;
373                 record->rec.inode.base.base.create_tid = ip->last_tid;
374                 record->rec.inode.base.data_len = sizeof(ip->ino_data);
375                 record->data = (void *)&ip->ino_data;
376                 error = hammer_ip_sync_record(record);
377                 hammer_free_mem_record(record);
378                 ip->flags &= ~(HAMMER_INODE_RDIRTY|HAMMER_INODE_DDIRTY|
379                                HAMMER_INODE_DELONDISK);
380                 ip->flags |= HAMMER_INODE_ONDISK;
381         }
382         ip->flags &= ~HAMMER_INODE_TID;
383         return(error);
384 }
385
386 /*
387  * Release a reference on an inode and unload it if told to flush.
388  */
389 void
390 hammer_rel_inode(struct hammer_inode *ip, int flush)
391 {
392         hammer_unref(&ip->lock);
393         if (flush || ip->ino_rec.ino_nlinks == 0)
394                 ip->flags |= HAMMER_INODE_FLUSH;
395         if (ip->lock.refs == 0 && (ip->flags & HAMMER_INODE_FLUSH))
396                 hammer_unload_inode(ip, NULL);
397 }
398
399 /*
400  * Unload and destroy the specified inode.
401  *
402  * (called via RB_SCAN)
403  */
404 int
405 hammer_unload_inode(struct hammer_inode *ip, void *data __unused)
406 {
407         int error;
408
409         KASSERT(ip->lock.refs == 0,
410                 ("hammer_unload_inode: %d refs\n", ip->lock.refs));
411         KKASSERT(ip->vp == NULL);
412         hammer_ref(&ip->lock);
413
414         error = hammer_sync_inode(ip, MNT_WAIT, 1);
415         if (error)
416                 kprintf("hammer_sync_inode failed error %d\n", error);
417
418         RB_REMOVE(hammer_ino_rb_tree, &ip->hmp->rb_inos_root, ip);
419
420         hammer_uncache_node(&ip->cache);
421         kfree(ip, M_HAMMER);
422         return(0);
423 }
424
425 /*
426  * A transaction has modified an inode, requiring a new record and possibly
427  * also data to be written out.
428  *
429  * last_tid is the TID to use for the disk sync.
430  */
431 void
432 hammer_modify_inode(struct hammer_transaction *trans,
433                     struct hammer_inode *ip, int flags)
434 {
435         if ((flags & HAMMER_INODE_TID) && (ip->flags & HAMMER_INODE_TID) == 0) {
436                 ip->last_tid = trans->tid;
437         }
438         ip->flags |= flags;
439 }
440
441 /*
442  * Sync any dirty buffers and records associated with an inode.  The
443  * inode's last_tid field is used as the transaction id for the sync,
444  * overriding any intermediate TIDs that were used for records.  Note
445  * that the dirty buffer cache buffers do not have any knowledge of
446  * the transaction id they were modified under.
447  */
448 static int
449 hammer_sync_inode_callback(hammer_record_t rec, void *data __unused)
450 {
451         int error;
452
453         error = 0;
454         if ((rec->flags & HAMMER_RECF_DELETED) == 0)
455                 error = hammer_ip_sync_record(rec);
456
457         if (error) {
458                 kprintf("hammer_sync_inode_callback: sync failed rec %p\n",
459                         rec);
460                 return(-1);
461         }
462         hammer_free_mem_record(rec);
463         return(0);
464 }
465
466 /*
467  * XXX error handling
468  */
469 int
470 hammer_sync_inode(hammer_inode_t ip, int waitfor, int handle_delete)
471 {
472         struct hammer_transaction trans;
473         int error;
474         int r;
475
476         hammer_lock_ex(&ip->lock);
477         hammer_start_transaction(&trans, ip->hmp);
478
479         /*
480          * If the inode has been deleted (nlinks == 0), and the OS no longer
481          * has any references to it (handle_delete != 0), clean up in-memory
482          * data.
483          *
484          * NOTE: We do not set the RDIRTY flag when updating the delete_tid,
485          * setting HAMMER_INODE_DELETED takes care of it.
486          *
487          * NOTE: Because we may sync records within this new transaction,
488          * force the inode update later on to use our transaction id or
489          * the delete_tid of the inode may be less then the create_tid of
490          * the inode update.  XXX shouldn't happen but don't take the chance.
491          */
492         if (ip->ino_rec.ino_nlinks == 0 && handle_delete) {
493                 if (ip->vp)
494                         vtruncbuf(ip->vp, 0, HAMMER_BUFSIZE);
495                 error = hammer_ip_delete_range(&trans, ip,
496                                                HAMMER_MIN_KEY, HAMMER_MAX_KEY);
497                 KKASSERT(RB_EMPTY(&ip->rec_tree));
498                 ip->flags &= ~HAMMER_INODE_TID;
499                 ip->ino_rec.base.base.delete_tid = trans.tid;
500                 hammer_modify_inode(&trans, ip,
501                                     HAMMER_INODE_DELETED | HAMMER_INODE_TID);
502         }
503
504         /*
505          * Sync the buffer cache
506          */
507         if (ip->vp != NULL)
508                 error = vfsync(ip->vp, waitfor, 1, NULL, NULL);
509         else
510                 error = 0;
511
512         /*
513          * Now sync related records
514          */
515         if (error == 0) {
516                 r = RB_SCAN(hammer_rec_rb_tree, &ip->rec_tree, NULL,
517                             hammer_sync_inode_callback, NULL);
518                 if (r < 0)
519                         error = EIO;
520         }
521
522         /*
523          * Now update the inode's on-disk inode-data and/or on-disk record.
524          */
525         switch(ip->flags & (HAMMER_INODE_DELETED|HAMMER_INODE_ONDISK)) {
526         case HAMMER_INODE_DELETED|HAMMER_INODE_ONDISK:
527                 /*
528                  * If deleted and on-disk, don't set any additional flags.
529                  * the delete flag takes care of things.
530                  */
531                 break;
532         case HAMMER_INODE_DELETED:
533                 /*
534                  * Take care of the case where a deleted inode was never
535                  * flushed to the disk in the first place.
536                  */
537                 ip->flags &= ~(HAMMER_INODE_RDIRTY|HAMMER_INODE_DDIRTY);
538                 while (RB_ROOT(&ip->rec_tree))
539                         hammer_free_mem_record(RB_ROOT(&ip->rec_tree));
540                 break;
541         case HAMMER_INODE_ONDISK:
542                 /*
543                  * If already on-disk, do not set any additional flags.
544                  */
545                 break;
546         default:
547                 /*
548                  * If not on-disk and not deleted, set both dirty flags
549                  * to force an initial record to be written.
550                  */
551                 ip->flags |= HAMMER_INODE_RDIRTY | HAMMER_INODE_DDIRTY;
552                 break;
553         }
554
555         /*
556          * If RDIRTY or DDIRTY is set, write out a new record.  If the
557          * inode is already on-disk, the old record is marked as deleted.
558          */
559         if (ip->flags & (HAMMER_INODE_RDIRTY | HAMMER_INODE_DDIRTY |
560                          HAMMER_INODE_DELETED)) {
561                 error = hammer_update_inode(ip);
562         }
563         hammer_commit_transaction(&trans);
564         hammer_unlock(&ip->lock);
565         return(error);
566 }
567
568 /*
569  * Access the filesystem buffer containing the cluster-relative byte
570  * offset, validate the buffer type, load *bufferp and return a
571  * pointer to the requested data.  The buffer is reference and locked on
572  * return.
573  *
574  * If buf_type is 0 the buffer is assumed to be a pure-data buffer and
575  * no type or crc check is performed.
576  *
577  * If *bufferp is not NULL on entry it is assumed to contain a locked
578  * and referenced buffer which will then be replaced.
579  *
580  * If the caller is holding another unrelated buffer locked it must be
581  * passed in reorderbuf so we can properly order buffer locks.
582  *
583  * XXX add a flag for the buffer type and check the CRC here XXX
584  */
585 void *
586 hammer_bread(hammer_cluster_t cluster, int32_t cloff,
587              u_int64_t buf_type, int *errorp,
588              struct hammer_buffer **bufferp)
589 {
590         hammer_buffer_t buffer;
591         int32_t buf_no;
592         int32_t buf_off;
593
594         /*
595          * Load the correct filesystem buffer, replacing *bufferp.
596          */
597         buf_no = cloff / HAMMER_BUFSIZE;
598         buffer = *bufferp;
599         if (buffer == NULL || buffer->cluster != cluster ||
600             buffer->buf_no != buf_no) {
601                 if (buffer) {
602                         /*hammer_unlock(&buffer->io.lock);*/
603                         hammer_rel_buffer(buffer, 0);
604                 }
605                 buffer = hammer_get_buffer(cluster, buf_no, 0, errorp);
606                 *bufferp = buffer;
607                 if (buffer == NULL)
608                         return(NULL);
609                 /*hammer_lock_ex(&buffer->io.lock);*/
610         }
611
612         /*
613          * Validate the buffer type
614          */
615         buf_off = cloff & HAMMER_BUFMASK;
616         if (buf_type) {
617                 if (buf_type != buffer->ondisk->head.buf_type) {
618                         kprintf("BUFFER HEAD TYPE MISMATCH %llx %llx\n",
619                                 buf_type, buffer->ondisk->head.buf_type);
620                         *errorp = EIO;
621                         return(NULL);
622                 }
623                 if (buf_off < sizeof(buffer->ondisk->head)) {
624                         kprintf("BUFFER OFFSET TOO LOW %d\n", buf_off);
625                         *errorp = EIO;
626                         return(NULL);
627                 }
628         }
629
630         /*
631          * Return a pointer to the buffer data.
632          */
633         *errorp = 0;
634         return((char *)buffer->ondisk + buf_off);
635 }
636