kernel - remove FSMID support
[dragonfly.git] / sys / kern / vfs_vopops.c
blob498c8902c80c667a5c8e9db677c7ae2d5f3caec7
1 /*
2 *
3 * Copyright (c) 2004 The DragonFly Project. All rights reserved.
4 *
5 * This code is derived from software contributed to The DragonFly Project
6 * by Matthew Dillon <dillon@backplane.com>
7 *
8 * Redistribution and use in source and binary forms, with or without
9 * modification, are permitted provided that the following conditions
10 * are met:
12 * 1. Redistributions of source code must retain the above copyright
13 * notice, this list of conditions and the following disclaimer.
14 * 2. Redistributions in binary form must reproduce the above copyright
15 * notice, this list of conditions and the following disclaimer in
16 * the documentation and/or other materials provided with the
17 * distribution.
18 * 3. Neither the name of The DragonFly Project nor the names of its
19 * contributors may be used to endorse or promote products derived
20 * from this software without specific, prior written permission.
22 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
23 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
24 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
25 * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
26 * COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
27 * INCIDENTAL, SPECIAL, EXEMPLARY OR CONSEQUENTIAL DAMAGES (INCLUDING,
28 * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
29 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
30 * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
31 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
32 * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
33 * SUCH DAMAGE.
35 * $DragonFly: src/sys/kern/vfs_vopops.c,v 1.39 2008/06/19 23:27:35 dillon Exp $
38 #include <sys/param.h>
39 #include <sys/systm.h>
40 #include <sys/buf.h>
41 #include <sys/conf.h>
42 #include <sys/dirent.h>
43 #include <sys/domain.h>
44 #include <sys/eventhandler.h>
45 #include <sys/fcntl.h>
46 #include <sys/kernel.h>
47 #include <sys/kthread.h>
48 #include <sys/malloc.h>
49 #include <sys/mbuf.h>
50 #include <sys/mount.h>
51 #include <sys/proc.h>
52 #include <sys/namei.h>
53 #include <sys/reboot.h>
54 #include <sys/socket.h>
55 #include <sys/stat.h>
56 #include <sys/sysctl.h>
57 #include <sys/syslog.h>
58 #include <sys/vmmeter.h>
59 #include <sys/vnode.h>
60 #include <sys/vfsops.h>
61 #include <sys/sysmsg.h>
63 #include <machine/limits.h>
65 #include <vm/vm.h>
66 #include <vm/vm_object.h>
67 #include <vm/vm_extern.h>
68 #include <vm/vm_kern.h>
69 #include <vm/pmap.h>
70 #include <vm/vm_map.h>
71 #include <vm/vm_page.h>
72 #include <vm/vm_pager.h>
73 #include <vm/vnode_pager.h>
74 #include <vm/vm_zone.h>
76 #include <sys/buf2.h>
77 #include <sys/thread2.h>
79 #define VDESCNAME(name) __CONCAT(__CONCAT(vop_,name),_desc)
81 #define VNODEOP_DESC_INIT(name) \
82 struct syslink_desc VDESCNAME(name) = { \
83 __offsetof(struct vop_ops, __CONCAT(vop_, name)), \
84 #name }
86 VNODEOP_DESC_INIT(default);
87 VNODEOP_DESC_INIT(old_lookup);
88 VNODEOP_DESC_INIT(old_create);
89 VNODEOP_DESC_INIT(old_whiteout);
90 VNODEOP_DESC_INIT(old_mknod);
91 VNODEOP_DESC_INIT(open);
92 VNODEOP_DESC_INIT(close);
93 VNODEOP_DESC_INIT(access);
94 VNODEOP_DESC_INIT(getattr);
95 VNODEOP_DESC_INIT(setattr);
96 VNODEOP_DESC_INIT(read);
97 VNODEOP_DESC_INIT(write);
98 VNODEOP_DESC_INIT(ioctl);
99 VNODEOP_DESC_INIT(poll);
100 VNODEOP_DESC_INIT(kqfilter);
101 VNODEOP_DESC_INIT(mmap);
102 VNODEOP_DESC_INIT(fsync);
103 VNODEOP_DESC_INIT(old_remove);
104 VNODEOP_DESC_INIT(old_link);
105 VNODEOP_DESC_INIT(old_rename);
107 VNODEOP_DESC_INIT(old_mkdir);
108 VNODEOP_DESC_INIT(old_rmdir);
109 VNODEOP_DESC_INIT(old_symlink);
110 VNODEOP_DESC_INIT(readdir);
111 VNODEOP_DESC_INIT(readlink);
112 VNODEOP_DESC_INIT(inactive);
113 VNODEOP_DESC_INIT(reclaim);
114 VNODEOP_DESC_INIT(bmap);
115 VNODEOP_DESC_INIT(strategy);
116 VNODEOP_DESC_INIT(print);
117 VNODEOP_DESC_INIT(pathconf);
118 VNODEOP_DESC_INIT(advlock);
119 VNODEOP_DESC_INIT(balloc);
120 VNODEOP_DESC_INIT(reallocblks);
121 VNODEOP_DESC_INIT(getpages);
122 VNODEOP_DESC_INIT(putpages);
123 VNODEOP_DESC_INIT(freeblks);
124 VNODEOP_DESC_INIT(getacl);
125 VNODEOP_DESC_INIT(setacl);
126 VNODEOP_DESC_INIT(aclcheck);
127 VNODEOP_DESC_INIT(getextattr);
128 VNODEOP_DESC_INIT(setextattr);
129 VNODEOP_DESC_INIT(mountctl);
130 VNODEOP_DESC_INIT(markatime);
132 VNODEOP_DESC_INIT(nresolve);
133 VNODEOP_DESC_INIT(nlookupdotdot);
134 VNODEOP_DESC_INIT(ncreate);
135 VNODEOP_DESC_INIT(nmkdir);
136 VNODEOP_DESC_INIT(nmknod);
137 VNODEOP_DESC_INIT(nlink);
138 VNODEOP_DESC_INIT(nsymlink);
139 VNODEOP_DESC_INIT(nwhiteout);
140 VNODEOP_DESC_INIT(nremove);
141 VNODEOP_DESC_INIT(nrmdir);
142 VNODEOP_DESC_INIT(nrename);
144 #define DO_OPS(ops, error, ap, vop_field) \
145 error = ops->vop_field(ap);
147 /************************************************************************
148 * PRIMARY HIGH LEVEL VNODE OPERATIONS CALLS *
149 ************************************************************************
151 * These procedures are called directly from the kernel and/or fileops
152 * code to perform file/device operations on the system.
154 * NOTE: The old namespace api functions such as vop_rename() are no longer
155 * available for general use and have been renamed to vop_old_*(). Only
156 * the code in vfs_default.c is allowed to call those ops.
160 vop_old_lookup(struct vop_ops *ops, struct vnode *dvp,
161 struct vnode **vpp, struct componentname *cnp)
163 struct vop_old_lookup_args ap;
164 int error;
166 ap.a_head.a_desc = &vop_old_lookup_desc;
167 ap.a_head.a_ops = ops;
168 ap.a_dvp = dvp;
169 ap.a_vpp = vpp;
170 ap.a_cnp = cnp;
172 DO_OPS(ops, error, &ap, vop_old_lookup);
173 return(error);
177 vop_old_create(struct vop_ops *ops, struct vnode *dvp,
178 struct vnode **vpp, struct componentname *cnp, struct vattr *vap)
180 struct vop_old_create_args ap;
181 int error;
183 ap.a_head.a_desc = &vop_old_create_desc;
184 ap.a_head.a_ops = ops;
185 ap.a_dvp = dvp;
186 ap.a_vpp = vpp;
187 ap.a_cnp = cnp;
188 ap.a_vap = vap;
190 DO_OPS(ops, error, &ap, vop_old_create);
191 return(error);
195 vop_old_whiteout(struct vop_ops *ops, struct vnode *dvp,
196 struct componentname *cnp, int flags)
198 struct vop_old_whiteout_args ap;
199 int error;
201 ap.a_head.a_desc = &vop_old_whiteout_desc;
202 ap.a_head.a_ops = ops;
203 ap.a_dvp = dvp;
204 ap.a_cnp = cnp;
205 ap.a_flags = flags;
207 DO_OPS(ops, error, &ap, vop_old_whiteout);
208 return(error);
212 vop_old_mknod(struct vop_ops *ops, struct vnode *dvp,
213 struct vnode **vpp, struct componentname *cnp, struct vattr *vap)
215 struct vop_old_mknod_args ap;
216 int error;
218 ap.a_head.a_desc = &vop_old_mknod_desc;
219 ap.a_head.a_ops = ops;
220 ap.a_dvp = dvp;
221 ap.a_vpp = vpp;
222 ap.a_cnp = cnp;
223 ap.a_vap = vap;
225 DO_OPS(ops, error, &ap, vop_old_mknod);
226 return(error);
230 * NOTE: VAGE is always cleared when calling VOP_OPEN().
233 vop_open(struct vop_ops *ops, struct vnode *vp, int mode, struct ucred *cred,
234 struct file *fp)
236 struct vop_open_args ap;
237 int error;
240 * Decrement 3-2-1-0. Does not decrement beyond 0
242 if (vp->v_flag & VAGE0) {
243 vp->v_flag &= ~VAGE0;
244 } else if (vp->v_flag & VAGE1) {
245 vp->v_flag &= ~VAGE1;
246 vp->v_flag |= VAGE0;
249 ap.a_head.a_desc = &vop_open_desc;
250 ap.a_head.a_ops = ops;
251 ap.a_vp = vp;
252 ap.a_fp = fp;
253 ap.a_mode = mode;
254 ap.a_cred = cred;
256 DO_OPS(ops, error, &ap, vop_open);
257 return(error);
261 vop_close(struct vop_ops *ops, struct vnode *vp, int fflag)
263 struct vop_close_args ap;
264 int error;
266 ap.a_head.a_desc = &vop_close_desc;
267 ap.a_head.a_ops = ops;
268 ap.a_vp = vp;
269 ap.a_fflag = fflag;
271 DO_OPS(ops, error, &ap, vop_close);
272 return(error);
276 vop_access(struct vop_ops *ops, struct vnode *vp, int mode, int flags,
277 struct ucred *cred)
279 struct vop_access_args ap;
280 int error;
282 ap.a_head.a_desc = &vop_access_desc;
283 ap.a_head.a_ops = ops;
284 ap.a_vp = vp;
285 ap.a_mode = mode;
286 ap.a_flags = flags;
287 ap.a_cred = cred;
289 DO_OPS(ops, error, &ap, vop_access);
290 return(error);
294 vop_getattr(struct vop_ops *ops, struct vnode *vp, struct vattr *vap)
296 struct vop_getattr_args ap;
297 int error;
299 ap.a_head.a_desc = &vop_getattr_desc;
300 ap.a_head.a_ops = ops;
301 ap.a_vp = vp;
302 ap.a_vap = vap;
304 DO_OPS(ops, error, &ap, vop_getattr);
306 return(error);
310 vop_setattr(struct vop_ops *ops, struct vnode *vp, struct vattr *vap,
311 struct ucred *cred)
313 struct vop_setattr_args ap;
314 int error;
316 ap.a_head.a_desc = &vop_setattr_desc;
317 ap.a_head.a_ops = ops;
318 ap.a_vp = vp;
319 ap.a_vap = vap;
320 ap.a_cred = cred;
322 DO_OPS(ops, error, &ap, vop_setattr);
323 return(error);
327 vop_read(struct vop_ops *ops, struct vnode *vp, struct uio *uio, int ioflag,
328 struct ucred *cred)
330 struct vop_read_args ap;
331 int error;
333 ap.a_head.a_desc = &vop_read_desc;
334 ap.a_head.a_ops = ops;
335 ap.a_vp = vp;
336 ap.a_uio = uio;
337 ap.a_ioflag = ioflag;
338 ap.a_cred = cred;
340 DO_OPS(ops, error, &ap, vop_read);
341 return(error);
345 vop_write(struct vop_ops *ops, struct vnode *vp, struct uio *uio, int ioflag,
346 struct ucred *cred)
348 struct vop_write_args ap;
349 int error;
351 ap.a_head.a_desc = &vop_write_desc;
352 ap.a_head.a_ops = ops;
353 ap.a_vp = vp;
354 ap.a_uio = uio;
355 ap.a_ioflag = ioflag;
356 ap.a_cred = cred;
358 DO_OPS(ops, error, &ap, vop_write);
359 return(error);
363 vop_ioctl(struct vop_ops *ops, struct vnode *vp, u_long command, caddr_t data,
364 int fflag, struct ucred *cred, struct sysmsg *msg)
366 struct vop_ioctl_args ap;
367 int error;
369 ap.a_head.a_desc = &vop_ioctl_desc;
370 ap.a_head.a_ops = ops;
371 ap.a_vp = vp;
372 ap.a_command = command;
373 ap.a_data = data;
374 ap.a_fflag = fflag;
375 ap.a_cred = cred;
376 ap.a_sysmsg = msg;
378 DO_OPS(ops, error, &ap, vop_ioctl);
379 return(error);
383 vop_poll(struct vop_ops *ops, struct vnode *vp, int events, struct ucred *cred)
385 struct vop_poll_args ap;
386 int error;
388 ap.a_head.a_desc = &vop_poll_desc;
389 ap.a_head.a_ops = ops;
390 ap.a_vp = vp;
391 ap.a_events = events;
392 ap.a_cred = cred;
394 DO_OPS(ops, error, &ap, vop_poll);
395 return(error);
399 vop_kqfilter(struct vop_ops *ops, struct vnode *vp, struct knote *kn)
401 struct vop_kqfilter_args ap;
402 int error;
404 ap.a_head.a_desc = &vop_kqfilter_desc;
405 ap.a_head.a_ops = ops;
406 ap.a_vp = vp;
407 ap.a_kn = kn;
409 DO_OPS(ops, error, &ap, vop_kqfilter);
410 return(error);
414 vop_mmap(struct vop_ops *ops, struct vnode *vp, int fflags, struct ucred *cred)
416 struct vop_mmap_args ap;
417 int error;
419 ap.a_head.a_desc = &vop_mmap_desc;
420 ap.a_head.a_ops = ops;
421 ap.a_vp = vp;
422 ap.a_fflags = fflags;
423 ap.a_cred = cred;
425 DO_OPS(ops, error, &ap, vop_mmap);
426 return(error);
430 vop_fsync(struct vop_ops *ops, struct vnode *vp, int waitfor, int flags)
432 struct vop_fsync_args ap;
433 int error;
435 ap.a_head.a_desc = &vop_fsync_desc;
436 ap.a_head.a_ops = ops;
437 ap.a_vp = vp;
438 ap.a_waitfor = waitfor;
439 ap.a_flags = flags;
441 DO_OPS(ops, error, &ap, vop_fsync);
442 return(error);
446 vop_old_remove(struct vop_ops *ops, struct vnode *dvp,
447 struct vnode *vp, struct componentname *cnp)
449 struct vop_old_remove_args ap;
450 int error;
452 ap.a_head.a_desc = &vop_old_remove_desc;
453 ap.a_head.a_ops = ops;
454 ap.a_dvp = dvp;
455 ap.a_vp = vp;
456 ap.a_cnp = cnp;
458 DO_OPS(ops, error, &ap, vop_old_remove);
459 return(error);
463 vop_old_link(struct vop_ops *ops, struct vnode *tdvp,
464 struct vnode *vp, struct componentname *cnp)
466 struct vop_old_link_args ap;
467 int error;
469 ap.a_head.a_desc = &vop_old_link_desc;
470 ap.a_head.a_ops = ops;
471 ap.a_tdvp = tdvp;
472 ap.a_vp = vp;
473 ap.a_cnp = cnp;
475 DO_OPS(ops, error, &ap, vop_old_link);
476 return(error);
480 vop_old_rename(struct vop_ops *ops,
481 struct vnode *fdvp, struct vnode *fvp, struct componentname *fcnp,
482 struct vnode *tdvp, struct vnode *tvp, struct componentname *tcnp)
484 struct vop_old_rename_args ap;
485 int error;
487 ap.a_head.a_desc = &vop_old_rename_desc;
488 ap.a_head.a_ops = ops;
489 ap.a_fdvp = fdvp;
490 ap.a_fvp = fvp;
491 ap.a_fcnp = fcnp;
492 ap.a_tdvp = tdvp;
493 ap.a_tvp = tvp;
494 ap.a_tcnp = tcnp;
496 DO_OPS(ops, error, &ap, vop_old_rename);
497 return(error);
501 vop_old_mkdir(struct vop_ops *ops, struct vnode *dvp,
502 struct vnode **vpp, struct componentname *cnp, struct vattr *vap)
504 struct vop_old_mkdir_args ap;
505 int error;
507 ap.a_head.a_desc = &vop_old_mkdir_desc;
508 ap.a_head.a_ops = ops;
509 ap.a_dvp = dvp;
510 ap.a_vpp = vpp;
511 ap.a_cnp = cnp;
512 ap.a_vap = vap;
514 DO_OPS(ops, error, &ap, vop_old_mkdir);
515 return(error);
519 vop_old_rmdir(struct vop_ops *ops, struct vnode *dvp,
520 struct vnode *vp, struct componentname *cnp)
522 struct vop_old_rmdir_args ap;
523 int error;
525 ap.a_head.a_desc = &vop_old_rmdir_desc;
526 ap.a_head.a_ops = ops;
527 ap.a_dvp = dvp;
528 ap.a_vp = vp;
529 ap.a_cnp = cnp;
531 DO_OPS(ops, error, &ap, vop_old_rmdir);
532 return(error);
536 vop_old_symlink(struct vop_ops *ops, struct vnode *dvp,
537 struct vnode **vpp, struct componentname *cnp,
538 struct vattr *vap, char *target)
540 struct vop_old_symlink_args ap;
541 int error;
543 ap.a_head.a_desc = &vop_old_symlink_desc;
544 ap.a_head.a_ops = ops;
545 ap.a_dvp = dvp;
546 ap.a_vpp = vpp;
547 ap.a_cnp = cnp;
548 ap.a_vap = vap;
549 ap.a_target = target;
551 DO_OPS(ops, error, &ap, vop_old_symlink);
552 return(error);
556 vop_readdir(struct vop_ops *ops, struct vnode *vp, struct uio *uio,
557 struct ucred *cred, int *eofflag, int *ncookies, off_t **cookies)
559 struct vop_readdir_args ap;
560 int error;
562 ap.a_head.a_desc = &vop_readdir_desc;
563 ap.a_head.a_ops = ops;
564 ap.a_vp = vp;
565 ap.a_uio = uio;
566 ap.a_cred = cred;
567 ap.a_eofflag = eofflag;
568 ap.a_ncookies = ncookies;
569 ap.a_cookies = cookies;
571 DO_OPS(ops, error, &ap, vop_readdir);
572 return(error);
576 vop_readlink(struct vop_ops *ops, struct vnode *vp, struct uio *uio,
577 struct ucred *cred)
579 struct vop_readlink_args ap;
580 int error;
582 ap.a_head.a_desc = &vop_readlink_desc;
583 ap.a_head.a_ops = ops;
584 ap.a_vp = vp;
585 ap.a_uio = uio;
586 ap.a_cred = cred;
588 DO_OPS(ops, error, &ap, vop_readlink);
589 return(error);
593 vop_inactive(struct vop_ops *ops, struct vnode *vp)
595 struct vop_inactive_args ap;
596 int error;
598 ap.a_head.a_desc = &vop_inactive_desc;
599 ap.a_head.a_ops = ops;
600 ap.a_vp = vp;
602 DO_OPS(ops, error, &ap, vop_inactive);
603 return(error);
607 vop_reclaim(struct vop_ops *ops, struct vnode *vp)
609 struct vop_reclaim_args ap;
610 int error;
612 ap.a_head.a_desc = &vop_reclaim_desc;
613 ap.a_head.a_ops = ops;
614 ap.a_vp = vp;
616 DO_OPS(ops, error, &ap, vop_reclaim);
617 return(error);
621 vop_bmap(struct vop_ops *ops, struct vnode *vp, off_t loffset,
622 off_t *doffsetp, int *runp, int *runb, buf_cmd_t cmd)
624 struct vop_bmap_args ap;
625 int error;
627 ap.a_head.a_desc = &vop_bmap_desc;
628 ap.a_head.a_ops = ops;
629 ap.a_vp = vp;
630 ap.a_loffset = loffset;
631 ap.a_doffsetp = doffsetp;
632 ap.a_runp = runp;
633 ap.a_runb = runb;
634 ap.a_cmd = cmd;
636 DO_OPS(ops, error, &ap, vop_bmap);
637 return(error);
641 vop_strategy(struct vop_ops *ops, struct vnode *vp, struct bio *bio)
643 struct vop_strategy_args ap;
644 int error;
646 ap.a_head.a_desc = &vop_strategy_desc;
647 ap.a_head.a_ops = ops;
648 ap.a_vp = vp;
649 ap.a_bio = bio;
651 DO_OPS(ops, error, &ap, vop_strategy);
652 return(error);
656 vop_print(struct vop_ops *ops, struct vnode *vp)
658 struct vop_print_args ap;
659 int error;
661 ap.a_head.a_desc = &vop_print_desc;
662 ap.a_head.a_ops = ops;
663 ap.a_vp = vp;
665 DO_OPS(ops, error, &ap, vop_print);
666 return(error);
670 vop_pathconf(struct vop_ops *ops, struct vnode *vp, int name,
671 register_t *retval)
673 struct vop_pathconf_args ap;
674 int error;
676 ap.a_head.a_desc = &vop_pathconf_desc;
677 ap.a_head.a_ops = ops;
678 ap.a_vp = vp;
679 ap.a_name = name;
680 ap.a_retval = retval;
682 DO_OPS(ops, error, &ap, vop_pathconf);
683 return(error);
687 vop_advlock(struct vop_ops *ops, struct vnode *vp, caddr_t id, int op,
688 struct flock *fl, int flags)
690 struct vop_advlock_args ap;
691 int error;
693 ap.a_head.a_desc = &vop_advlock_desc;
694 ap.a_head.a_ops = ops;
695 ap.a_vp = vp;
696 ap.a_id = id;
697 ap.a_op = op;
698 ap.a_fl = fl;
699 ap.a_flags = flags;
701 DO_OPS(ops, error, &ap, vop_advlock);
702 return(error);
706 vop_balloc(struct vop_ops *ops, struct vnode *vp, off_t startoffset,
707 int size, struct ucred *cred, int flags,
708 struct buf **bpp)
710 struct vop_balloc_args ap;
711 int error;
713 ap.a_head.a_desc = &vop_balloc_desc;
714 ap.a_head.a_ops = ops;
715 ap.a_vp = vp;
716 ap.a_startoffset = startoffset;
717 ap.a_size = size;
718 ap.a_cred = cred;
719 ap.a_flags = flags;
720 ap.a_bpp = bpp;
722 DO_OPS(ops, error, &ap, vop_balloc);
723 return(error);
727 vop_reallocblks(struct vop_ops *ops, struct vnode *vp,
728 struct cluster_save *buflist)
730 struct vop_reallocblks_args ap;
731 int error;
733 ap.a_head.a_desc = &vop_reallocblks_desc;
734 ap.a_head.a_ops = ops;
735 ap.a_vp = vp;
736 ap.a_buflist = buflist;
738 DO_OPS(ops, error, &ap, vop_reallocblks);
739 return(error);
743 vop_getpages(struct vop_ops *ops, struct vnode *vp, vm_page_t *m, int count,
744 int reqpage, vm_ooffset_t offset)
746 struct vop_getpages_args ap;
747 int error;
749 ap.a_head.a_desc = &vop_getpages_desc;
750 ap.a_head.a_ops = ops;
751 ap.a_vp = vp;
752 ap.a_m = m;
753 ap.a_count = count;
754 ap.a_reqpage = reqpage;
755 ap.a_offset = offset;
757 DO_OPS(ops, error, &ap, vop_getpages);
758 return(error);
762 vop_putpages(struct vop_ops *ops, struct vnode *vp, vm_page_t *m, int count,
763 int sync, int *rtvals, vm_ooffset_t offset)
765 struct vop_putpages_args ap;
766 int error;
768 ap.a_head.a_desc = &vop_putpages_desc;
769 ap.a_head.a_ops = ops;
770 ap.a_vp = vp;
771 ap.a_m = m;
772 ap.a_count = count;
773 ap.a_sync = sync;
774 ap.a_rtvals = rtvals;
775 ap.a_offset = offset;
777 DO_OPS(ops, error, &ap, vop_putpages);
778 return(error);
782 vop_freeblks(struct vop_ops *ops, struct vnode *vp, off_t offset, int length)
784 struct vop_freeblks_args ap;
785 int error;
787 ap.a_head.a_desc = &vop_freeblks_desc;
788 ap.a_head.a_ops = ops;
789 ap.a_vp = vp;
790 ap.a_offset = offset;
791 ap.a_length = length;
793 DO_OPS(ops, error, &ap, vop_freeblks);
794 return(error);
798 vop_getacl(struct vop_ops *ops, struct vnode *vp, acl_type_t type,
799 struct acl *aclp, struct ucred *cred)
801 struct vop_getacl_args ap;
802 int error;
804 ap.a_head.a_desc = &vop_getacl_desc;
805 ap.a_head.a_ops = ops;
806 ap.a_vp = vp;
807 ap.a_type = type;
808 ap.a_aclp = aclp;
809 ap.a_cred = cred;
811 DO_OPS(ops, error, &ap, vop_getacl);
812 return(error);
816 vop_setacl(struct vop_ops *ops, struct vnode *vp, acl_type_t type,
817 struct acl *aclp, struct ucred *cred)
819 struct vop_setacl_args ap;
820 int error;
822 ap.a_head.a_desc = &vop_setacl_desc;
823 ap.a_head.a_ops = ops;
824 ap.a_vp = vp;
825 ap.a_type = type;
826 ap.a_aclp = aclp;
827 ap.a_cred = cred;
829 DO_OPS(ops, error, &ap, vop_setacl);
830 return(error);
834 vop_aclcheck(struct vop_ops *ops, struct vnode *vp, acl_type_t type,
835 struct acl *aclp, struct ucred *cred)
837 struct vop_aclcheck_args ap;
838 int error;
840 ap.a_head.a_desc = &vop_aclcheck_desc;
841 ap.a_head.a_ops = ops;
842 ap.a_vp = vp;
843 ap.a_type = type;
844 ap.a_aclp = aclp;
845 ap.a_cred = cred;
847 DO_OPS(ops, error, &ap, vop_aclcheck);
848 return(error);
852 vop_getextattr(struct vop_ops *ops, struct vnode *vp, char *name,
853 struct uio *uio, struct ucred *cred)
855 struct vop_getextattr_args ap;
856 int error;
858 ap.a_head.a_desc = &vop_getextattr_desc;
859 ap.a_head.a_ops = ops;
860 ap.a_vp = vp;
861 ap.a_name = name;
862 ap.a_uio = uio;
863 ap.a_cred = cred;
865 DO_OPS(ops, error, &ap, vop_getextattr);
866 return(error);
870 vop_setextattr(struct vop_ops *ops, struct vnode *vp, char *name,
871 struct uio *uio, struct ucred *cred)
873 struct vop_setextattr_args ap;
874 int error;
876 ap.a_head.a_desc = &vop_setextattr_desc;
877 ap.a_head.a_ops = ops;
878 ap.a_vp = vp;
879 ap.a_name = name;
880 ap.a_uio = uio;
881 ap.a_cred = cred;
883 DO_OPS(ops, error, &ap, vop_setextattr);
884 return(error);
888 vop_mountctl(struct vop_ops *ops, int op, struct file *fp,
889 const void *ctl, int ctllen, void *buf, int buflen, int *res)
891 struct vop_mountctl_args ap;
892 int error;
894 ap.a_head.a_desc = &vop_mountctl_desc;
895 ap.a_head.a_ops = ops;
896 ap.a_op = op;
897 ap.a_ctl = ctl;
898 ap.a_fp = fp;
899 ap.a_ctllen = ctllen;
900 ap.a_buf = buf;
901 ap.a_buflen = buflen;
902 ap.a_res = res;
904 DO_OPS(ops, error, &ap, vop_mountctl);
905 return(error);
909 vop_markatime(struct vop_ops *ops, struct vnode *vp, struct ucred *cred)
911 struct vop_markatime_args ap;
912 int error;
914 ap.a_head.a_desc = &vop_markatime_desc;
915 ap.a_head.a_ops = ops;
916 ap.a_vp = vp;
917 ap.a_cred = cred;
919 DO_OPS(ops, error, &ap, vop_markatime);
920 return(error);
924 * NEW API FUNCTIONS
926 * nresolve takes a locked ncp, a referenced but unlocked dvp, and a cred,
927 * and resolves the ncp into a positive or negative hit.
929 * The namecache is automatically adjusted by this function. The ncp
930 * is left locked on return.
933 vop_nresolve(struct vop_ops *ops, struct nchandle *nch,
934 struct vnode *dvp, struct ucred *cred)
936 struct vop_nresolve_args ap;
937 int error;
939 ap.a_head.a_desc = &vop_nresolve_desc;
940 ap.a_head.a_ops = ops;
941 ap.a_nch = nch;
942 ap.a_dvp = dvp;
943 ap.a_cred = cred;
945 DO_OPS(ops, error, &ap, vop_nresolve);
946 return(error);
950 * nlookupdotdot takes an unlocked directory, referenced dvp, and looks
951 * up "..", returning a locked parent directory in *vpp. If an error
952 * occurs *vpp will be NULL.
955 vop_nlookupdotdot(struct vop_ops *ops, struct vnode *dvp,
956 struct vnode **vpp, struct ucred *cred, char **fakename)
958 struct vop_nlookupdotdot_args ap;
959 int error;
961 ap.a_head.a_desc = &vop_nlookupdotdot_desc;
962 ap.a_head.a_ops = ops;
963 ap.a_dvp = dvp;
964 ap.a_vpp = vpp;
965 ap.a_cred = cred;
966 ap.a_fakename = fakename;
968 DO_OPS(ops, error, &ap, vop_nlookupdotdot);
969 return(error);
973 * ncreate takes a locked, resolved ncp that typically represents a negative
974 * cache hit and creates the file or node specified by the ncp, cred, and
975 * vattr. If no error occurs a locked vnode is returned in *vpp.
977 * The dvp passed in is referenced but unlocked.
979 * The namecache is automatically adjusted by this function. The ncp
980 * is left locked on return.
983 vop_ncreate(struct vop_ops *ops, struct nchandle *nch, struct vnode *dvp,
984 struct vnode **vpp, struct ucred *cred, struct vattr *vap)
986 struct vop_ncreate_args ap;
987 int error;
989 ap.a_head.a_desc = &vop_ncreate_desc;
990 ap.a_head.a_ops = ops;
991 ap.a_nch = nch;
992 ap.a_dvp = dvp;
993 ap.a_vpp = vpp;
994 ap.a_cred = cred;
995 ap.a_vap = vap;
997 DO_OPS(ops, error, &ap, vop_ncreate);
998 return(error);
1002 * nmkdir takes a locked, resolved ncp that typically represents a negative
1003 * cache hit and creates the directory specified by the ncp, cred, and
1004 * vattr. If no error occurs a locked vnode is returned in *vpp.
1006 * The dvp passed in is referenced but unlocked.
1008 * The namecache is automatically adjusted by this function. The ncp
1009 * is left locked on return.
1012 vop_nmkdir(struct vop_ops *ops, struct nchandle *nch, struct vnode *dvp,
1013 struct vnode **vpp, struct ucred *cred, struct vattr *vap)
1015 struct vop_nmkdir_args ap;
1016 int error;
1018 ap.a_head.a_desc = &vop_nmkdir_desc;
1019 ap.a_head.a_ops = ops;
1020 ap.a_nch = nch;
1021 ap.a_dvp = dvp;
1022 ap.a_vpp = vpp;
1023 ap.a_cred = cred;
1024 ap.a_vap = vap;
1026 DO_OPS(ops, error, &ap, vop_nmkdir);
1027 return(error);
1031 * nmknod takes a locked, resolved ncp that typically represents a negative
1032 * cache hit and creates the node specified by the ncp, cred, and
1033 * vattr. If no error occurs a locked vnode is returned in *vpp.
1035 * The dvp passed in is referenced but unlocked.
1037 * The namecache is automatically adjusted by this function. The ncp
1038 * is left locked on return.
1041 vop_nmknod(struct vop_ops *ops, struct nchandle *nch, struct vnode *dvp,
1042 struct vnode **vpp, struct ucred *cred, struct vattr *vap)
1044 struct vop_nmknod_args ap;
1045 int error;
1047 ap.a_head.a_desc = &vop_nmknod_desc;
1048 ap.a_head.a_ops = ops;
1049 ap.a_nch = nch;
1050 ap.a_dvp = dvp;
1051 ap.a_vpp = vpp;
1052 ap.a_cred = cred;
1053 ap.a_vap = vap;
1055 DO_OPS(ops, error, &ap, vop_nmknod);
1056 return(error);
1060 * nlink takes a locked, resolved ncp that typically represents a negative
1061 * cache hit and creates the node specified by the ncp, cred, and
1062 * existing vnode. The passed vp must be locked and will remain locked
1063 * on return, as does the ncp, whether an error occurs or not.
1065 * The dvp passed in is referenced but unlocked.
1067 * The namecache is automatically adjusted by this function. The ncp
1068 * is left locked on return.
1071 vop_nlink(struct vop_ops *ops, struct nchandle *nch, struct vnode *dvp,
1072 struct vnode *vp, struct ucred *cred)
1074 struct vop_nlink_args ap;
1075 int error;
1077 ap.a_head.a_desc = &vop_nlink_desc;
1078 ap.a_head.a_ops = ops;
1079 ap.a_nch = nch;
1080 ap.a_dvp = dvp;
1081 ap.a_vp = vp;
1082 ap.a_cred = cred;
1084 DO_OPS(ops, error, &ap, vop_nlink);
1085 return(error);
1089 * nsymlink takes a locked, resolved ncp that typically represents a negative
1090 * cache hit and creates a symbolic link based on cred, vap, and target (the
1091 * contents of the link). If no error occurs a locked vnode is returned in
1092 * *vpp.
1094 * The dvp passed in is referenced but unlocked.
1096 * The namecache is automatically adjusted by this function. The ncp
1097 * is left locked on return.
1100 vop_nsymlink(struct vop_ops *ops, struct nchandle *nch, struct vnode *dvp,
1101 struct vnode **vpp, struct ucred *cred,
1102 struct vattr *vap, char *target)
1104 struct vop_nsymlink_args ap;
1105 int error;
1107 ap.a_head.a_desc = &vop_nsymlink_desc;
1108 ap.a_head.a_ops = ops;
1109 ap.a_nch = nch;
1110 ap.a_dvp = dvp;
1111 ap.a_vpp = vpp;
1112 ap.a_cred = cred;
1113 ap.a_vap = vap;
1114 ap.a_target = target;
1116 DO_OPS(ops, error, &ap, vop_nsymlink);
1117 return(error);
1121 * nwhiteout takes a locked, resolved ncp that can represent a positive or
1122 * negative hit and executes the whiteout function specified in flags.
1124 * The dvp passed in is referenced but unlocked.
1126 * The namecache is automatically adjusted by this function. The ncp
1127 * is left locked on return.
1130 vop_nwhiteout(struct vop_ops *ops, struct nchandle *nch, struct vnode *dvp,
1131 struct ucred *cred, int flags)
1133 struct vop_nwhiteout_args ap;
1134 int error;
1136 ap.a_head.a_desc = &vop_nwhiteout_desc;
1137 ap.a_head.a_ops = ops;
1138 ap.a_nch = nch;
1139 ap.a_dvp = dvp;
1140 ap.a_cred = cred;
1141 ap.a_flags = flags;
1143 DO_OPS(ops, error, &ap, vop_nwhiteout);
1144 return(error);
1148 * nremove takes a locked, resolved ncp that generally represents a
1149 * positive hit and removes the file.
1151 * The dvp passed in is referenced but unlocked.
1153 * The namecache is automatically adjusted by this function. The ncp
1154 * is left locked on return.
1157 vop_nremove(struct vop_ops *ops, struct nchandle *nch, struct vnode *dvp,
1158 struct ucred *cred)
1160 struct vop_nremove_args ap;
1161 int error;
1163 ap.a_head.a_desc = &vop_nremove_desc;
1164 ap.a_head.a_ops = ops;
1165 ap.a_nch = nch;
1166 ap.a_dvp = dvp;
1167 ap.a_cred = cred;
1169 DO_OPS(ops, error, &ap, vop_nremove);
1170 return(error);
1174 * nrmdir takes a locked, resolved ncp that generally represents a
1175 * directory and removes the directory.
1177 * The dvp passed in is referenced but unlocked.
1179 * The namecache is automatically adjusted by this function. The ncp
1180 * is left locked on return.
1183 vop_nrmdir(struct vop_ops *ops, struct nchandle *nch, struct vnode *dvp,
1184 struct ucred *cred)
1186 struct vop_nrmdir_args ap;
1187 int error;
1189 ap.a_head.a_desc = &vop_nrmdir_desc;
1190 ap.a_head.a_ops = ops;
1191 ap.a_nch = nch;
1192 ap.a_dvp = dvp;
1193 ap.a_cred = cred;
1195 DO_OPS(ops, error, &ap, vop_nrmdir);
1196 return(error);
1200 * nrename takes TWO locked, resolved ncp's and the cred of the caller
1201 * and renames the source ncp to the target ncp. The target ncp may
1202 * represent a positive or negative hit.
1204 * The fdvp and tdvp passed in are referenced but unlocked.
1206 * The namecache is automatically adjusted by this function. The ncp
1207 * is left locked on return. The source ncp is typically changed to
1208 * a negative cache hit and the target ncp typically takes on the
1209 * source ncp's underlying file.
1212 vop_nrename(struct vop_ops *ops,
1213 struct nchandle *fnch, struct nchandle *tnch,
1214 struct vnode *fdvp, struct vnode *tdvp,
1215 struct ucred *cred)
1217 struct vop_nrename_args ap;
1218 int error;
1220 ap.a_head.a_desc = &vop_nrename_desc;
1221 ap.a_head.a_ops = ops;
1222 ap.a_fnch = fnch;
1223 ap.a_tnch = tnch;
1224 ap.a_fdvp = fdvp;
1225 ap.a_tdvp = tdvp;
1226 ap.a_cred = cred;
1228 DO_OPS(ops, error, &ap, vop_nrename);
1229 return(error);
1232 /************************************************************************
1233 * PRIMARY VNODE OPERATIONS FORWARDING CALLS *
1234 ************************************************************************
1236 * These procedures are called from VFSs such as unionfs and nullfs
1237 * when they wish to forward an operation on one VFS to another. The
1238 * argument structure/message is modified and then directly passed to the
1239 * appropriate routine. This routines may also be called by initiators
1240 * who have an argument structure in hand rather then discreet arguments.
1243 vop_vnoperate_ap(struct vop_generic_args *ap)
1245 struct vop_ops *ops;
1246 int error;
1248 ops = ap->a_ops;
1249 error = VOCALL(ops, ap);
1251 return (error);
1255 * This routine is called by the cache coherency layer to execute the actual
1256 * VFS operation. If a journaling layer is present we call though it, else
1257 * we call the native VOP functions.
1260 vop_cache_operate_ap(struct vop_generic_args *ap)
1262 struct vop_ops *ops;
1263 int error;
1265 ops = ap->a_ops;
1266 if (ops->head.vv_mount->mnt_vn_journal_ops)
1267 error = VOCALL(ops->head.vv_mount->mnt_vn_journal_ops, ap);
1268 else
1269 error = VOCALL(ops->head.vv_mount->mnt_vn_norm_ops, ap);
1270 return (error);
1275 * This routine is called by the journaling layer to execute the actual
1276 * VFS operation.
1279 vop_journal_operate_ap(struct vop_generic_args *ap)
1281 struct vop_ops *ops;
1282 int error;
1284 ops = ap->a_ops;
1285 error = VOCALL(ops->head.vv_mount->mnt_vn_norm_ops, ap);
1287 return (error);
1291 vop_open_ap(struct vop_open_args *ap)
1293 int error;
1295 DO_OPS(ap->a_head.a_ops, error, ap, vop_open);
1296 return(error);
1300 vop_close_ap(struct vop_close_args *ap)
1302 int error;
1304 DO_OPS(ap->a_head.a_ops, error, ap, vop_close);
1305 return(error);
1309 vop_access_ap(struct vop_access_args *ap)
1311 int error;
1313 DO_OPS(ap->a_head.a_ops, error, ap, vop_access);
1314 return(error);
1318 vop_getattr_ap(struct vop_getattr_args *ap)
1320 int error;
1322 DO_OPS(ap->a_head.a_ops, error, ap, vop_getattr);
1323 return(error);
1327 vop_setattr_ap(struct vop_setattr_args *ap)
1329 int error;
1331 DO_OPS(ap->a_head.a_ops, error, ap, vop_setattr);
1332 return(error);
1336 vop_read_ap(struct vop_read_args *ap)
1338 int error;
1340 DO_OPS(ap->a_head.a_ops, error, ap, vop_read);
1341 return(error);
1345 vop_write_ap(struct vop_write_args *ap)
1347 int error;
1349 DO_OPS(ap->a_head.a_ops, error, ap, vop_write);
1350 return(error);
1354 vop_ioctl_ap(struct vop_ioctl_args *ap)
1356 int error;
1358 DO_OPS(ap->a_head.a_ops, error, ap, vop_ioctl);
1359 return(error);
1363 vop_poll_ap(struct vop_poll_args *ap)
1365 int error;
1367 DO_OPS(ap->a_head.a_ops, error, ap, vop_poll);
1368 return(error);
1372 vop_kqfilter_ap(struct vop_kqfilter_args *ap)
1374 int error;
1376 DO_OPS(ap->a_head.a_ops, error, ap, vop_kqfilter);
1377 return(error);
1381 vop_mmap_ap(struct vop_mmap_args *ap)
1383 int error;
1385 DO_OPS(ap->a_head.a_ops, error, ap, vop_mmap);
1386 return(error);
1390 vop_fsync_ap(struct vop_fsync_args *ap)
1392 int error;
1394 DO_OPS(ap->a_head.a_ops, error, ap, vop_fsync);
1395 return(error);
1399 vop_readdir_ap(struct vop_readdir_args *ap)
1401 int error;
1403 DO_OPS(ap->a_head.a_ops, error, ap, vop_readdir);
1404 return(error);
1408 vop_readlink_ap(struct vop_readlink_args *ap)
1410 int error;
1412 DO_OPS(ap->a_head.a_ops, error, ap, vop_readlink);
1413 return(error);
1417 vop_inactive_ap(struct vop_inactive_args *ap)
1419 int error;
1421 DO_OPS(ap->a_head.a_ops, error, ap, vop_inactive);
1422 return(error);
1426 vop_reclaim_ap(struct vop_reclaim_args *ap)
1428 int error;
1430 DO_OPS(ap->a_head.a_ops, error, ap, vop_reclaim);
1431 return(error);
1435 vop_bmap_ap(struct vop_bmap_args *ap)
1437 int error;
1439 DO_OPS(ap->a_head.a_ops, error, ap, vop_bmap);
1440 return(error);
1444 vop_strategy_ap(struct vop_strategy_args *ap)
1446 int error;
1448 DO_OPS(ap->a_head.a_ops, error, ap, vop_strategy);
1449 return(error);
1453 vop_print_ap(struct vop_print_args *ap)
1455 int error;
1457 DO_OPS(ap->a_head.a_ops, error, ap, vop_print);
1458 return(error);
1462 vop_pathconf_ap(struct vop_pathconf_args *ap)
1464 int error;
1466 DO_OPS(ap->a_head.a_ops, error, ap, vop_pathconf);
1467 return(error);
1471 vop_advlock_ap(struct vop_advlock_args *ap)
1473 int error;
1475 DO_OPS(ap->a_head.a_ops, error, ap, vop_advlock);
1476 return(error);
1480 vop_balloc_ap(struct vop_balloc_args *ap)
1482 int error;
1484 DO_OPS(ap->a_head.a_ops, error, ap, vop_balloc);
1485 return(error);
1489 vop_reallocblks_ap(struct vop_reallocblks_args *ap)
1491 int error;
1493 DO_OPS(ap->a_head.a_ops, error, ap, vop_reallocblks);
1494 return(error);
1498 vop_getpages_ap(struct vop_getpages_args *ap)
1500 int error;
1502 DO_OPS(ap->a_head.a_ops, error, ap, vop_getpages);
1503 return(error);
1507 vop_putpages_ap(struct vop_putpages_args *ap)
1509 int error;
1511 DO_OPS(ap->a_head.a_ops, error, ap, vop_putpages);
1512 return(error);
1516 vop_freeblks_ap(struct vop_freeblks_args *ap)
1518 int error;
1520 DO_OPS(ap->a_head.a_ops, error, ap, vop_freeblks);
1521 return(error);
1525 vop_getacl_ap(struct vop_getacl_args *ap)
1527 int error;
1529 DO_OPS(ap->a_head.a_ops, error, ap, vop_getacl);
1530 return(error);
1534 vop_setacl_ap(struct vop_setacl_args *ap)
1536 int error;
1538 DO_OPS(ap->a_head.a_ops, error, ap, vop_setacl);
1539 return(error);
1543 vop_aclcheck_ap(struct vop_aclcheck_args *ap)
1545 int error;
1547 DO_OPS(ap->a_head.a_ops, error, ap, vop_aclcheck);
1548 return(error);
1552 vop_getextattr_ap(struct vop_getextattr_args *ap)
1554 int error;
1556 DO_OPS(ap->a_head.a_ops, error, ap, vop_getextattr);
1557 return(error);
1561 vop_setextattr_ap(struct vop_setextattr_args *ap)
1563 int error;
1565 DO_OPS(ap->a_head.a_ops, error, ap, vop_setextattr);
1566 return(error);
1570 vop_mountctl_ap(struct vop_mountctl_args *ap)
1572 int error;
1574 DO_OPS(ap->a_head.a_ops, error, ap, vop_mountctl);
1575 return(error);
1579 vop_markatime_ap(struct vop_markatime_args *ap)
1581 int error;
1583 DO_OPS(ap->a_head.a_ops, error, ap, vop_markatime);
1584 return(error);
1588 vop_nresolve_ap(struct vop_nresolve_args *ap)
1590 int error;
1592 DO_OPS(ap->a_head.a_ops, error, ap, vop_nresolve);
1593 return(error);
1597 vop_nlookupdotdot_ap(struct vop_nlookupdotdot_args *ap)
1599 int error;
1601 DO_OPS(ap->a_head.a_ops, error, ap, vop_nlookupdotdot);
1602 return(error);
1606 vop_ncreate_ap(struct vop_ncreate_args *ap)
1608 int error;
1610 DO_OPS(ap->a_head.a_ops, error, ap, vop_ncreate);
1611 return(error);
1615 vop_nmkdir_ap(struct vop_nmkdir_args *ap)
1617 int error;
1619 DO_OPS(ap->a_head.a_ops, error, ap, vop_nmkdir);
1620 return(error);
1624 vop_nmknod_ap(struct vop_nmknod_args *ap)
1626 int error;
1628 DO_OPS(ap->a_head.a_ops, error, ap, vop_nmknod);
1629 return(error);
1633 vop_nlink_ap(struct vop_nlink_args *ap)
1635 int error;
1637 DO_OPS(ap->a_head.a_ops, error, ap, vop_nlink);
1638 return(error);
1642 vop_nsymlink_ap(struct vop_nsymlink_args *ap)
1644 int error;
1646 DO_OPS(ap->a_head.a_ops, error, ap, vop_nsymlink);
1647 return(error);
1651 vop_nwhiteout_ap(struct vop_nwhiteout_args *ap)
1653 int error;
1655 DO_OPS(ap->a_head.a_ops, error, ap, vop_nwhiteout);
1656 return(error);
1660 vop_nremove_ap(struct vop_nremove_args *ap)
1662 int error;
1664 DO_OPS(ap->a_head.a_ops, error, ap, vop_nremove);
1665 return(error);
1669 vop_nrmdir_ap(struct vop_nrmdir_args *ap)
1671 int error;
1673 DO_OPS(ap->a_head.a_ops, error, ap, vop_nrmdir);
1674 return(error);
1678 vop_nrename_ap(struct vop_nrename_args *ap)
1680 int error;
1682 DO_OPS(ap->a_head.a_ops, error, ap, vop_nrename);
1683 return(error);