]> git.saurik.com Git - apple/xnu.git/blobdiff - bsd/sys/ubc.h
xnu-4903.270.47.tar.gz
[apple/xnu.git] / bsd / sys / ubc.h
index 24058f37afd8bb27f7c2b8905b1b9f4bdd65fb0f..bc91fde31e9d52969bccc1cf6961892d4a5ded67 100644 (file)
@@ -1,17 +1,20 @@
 /*
- * Copyright (c) 1999, 2000-2002 Apple Computer, Inc. All rights reserved.
+ * Copyright (c) 1999-2007 Apple Inc. All rights reserved.
+ *
+ * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
  *
- * @APPLE_LICENSE_HEADER_START@
- * 
- * Copyright (c) 1999-2003 Apple Computer, Inc.  All Rights Reserved.
- * 
  * This file contains Original Code and/or Modifications of Original Code
  * as defined in and that are subject to the Apple Public Source License
  * Version 2.0 (the 'License'). You may not use this file except in
- * compliance with the License. Please obtain a copy of the License at
- * http://www.opensource.apple.com/apsl/ and read it before using this
- * file.
- * 
+ * compliance with the License. The rights granted to you under the License
+ * may not be used to create, or enable the creation or redistribution of,
+ * unlawful or unlicensed copies of an Apple operating system, or to
+ * circumvent, violate, or enable the circumvention or violation of, any
+ * terms of an Apple operating system software license agreement.
+ *
+ * Please obtain a copy of the License at
+ * http://www.opensource.apple.com/apsl/ and read it before using this file.
+ *
  * The Original Code and all software distributed under the License are
  * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
  * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
  * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
  * Please see the License for the specific language governing rights and
  * limitations under the License.
- * 
- * @APPLE_LICENSE_HEADER_END@
- */
-/* 
- *     File:   ubc.h
- *     Author: Umesh Vaishampayan [umeshv@apple.com]
- *             05-Aug-1999     umeshv  Created.
  *
+ * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
+ */
+/*
  *     Header file for Unified Buffer Cache.
  *
- */ 
+ */
 
-#ifndef        _SYS_UBC_H_
-#define        _SYS_UBC_H_
+#ifndef _SYS_UBC_H_
+#define _SYS_UBC_H_
 
 #include <sys/appleapiopts.h>
-#include <sys/types.h>
+#include <sys/cdefs.h>
+#include <sys/kernel_types.h>
+#include <kern/locks.h>
+#include <mach/machine.h>
+#include <mach/memory_object_types.h>
 #include <sys/ucred.h>
-#include <sys/vnode.h>
 
-#include <sys/cdefs.h>
+#ifdef KERNEL_PRIVATE
+#include <sys/imgact.h>
+#endif // KERNEL_PRIVATE
 
-#include <mach/memory_object_types.h>
+/* defns for ubc_msync() and ubc_msync */
 
-#define UBC_INFO_NULL  ((struct ubc_info *) 0)
-#define UBC_NOINFO             ((struct ubc_info *)0xDEADD1ED)
+#define UBC_PUSHDIRTY   0x01    /* clean any dirty pages in the specified range to the backing store */
+#define UBC_PUSHALL     0x02    /* push both dirty and precious pages to the backing store */
+#define UBC_INVALIDATE  0x04    /* invalidate pages in the specified range... may be used with UBC_PUSHDIRTY/ALL */
+#define UBC_SYNC        0x08    /* wait for I/Os generated by UBC_PUSHDIRTY to complete */
 
-#ifdef __APPLE_API_PRIVATE
-extern struct zone     *ubc_info_zone;
+__BEGIN_DECLS
 
-/*
- *     The following data structure keeps the information to associate
- *     a vnode to the correspondig VM objects.
- */
+off_t           ubc_blktooff(struct vnode *, daddr64_t);
+daddr64_t       ubc_offtoblk(struct vnode *, off_t);
+off_t   ubc_getsize(struct vnode *);
+int     ubc_setsize(struct vnode *, off_t);
+
+#ifdef KERNEL_PRIVATE
 
-struct ubc_info {
-       memory_object_t                 ui_pager;       /* pager */
-       memory_object_control_t ui_control;     /* VM control for the pager */
-       long                                    ui_flags;       /* flags */
-       struct vnode                    *ui_vnode;      /* The vnode for this ubc_info */
-       struct ucred                    *ui_ucred;      /* holds credentials for NFS paging */
-       int                                             ui_refcount;/* ref count on the ubc_info */
-       off_t                                   ui_size;        /* file size for the vnode */
-       long                                    ui_mapped;      /* is it currently mapped */
-       void                                    *ui_owner;      /* for recursive ubc_busy */
+enum {
+       UBC_SETSIZE_NO_FS_REENTRY = 1
 };
+typedef uint32_t ubc_setsize_opts_t;
 
-/* Defines for ui_flags */
-#define        UI_NONE                 0x00000000              /* none */
-#define        UI_HASPAGER             0x00000001              /* has a pager associated */
-#define        UI_INITED               0x00000002              /* newly initialized vnode */
-#define UI_HASOBJREF   0x00000004              /* hold a reference on object */
-#define UI_WASMAPPED   0x00000008              /* vnode was mapped */
-#define        UI_DONTCACHE    0x00000010              /* do not cache object */
-#define        UI_BUSY                 0x00000020              /* for VM synchronization */
-#define        UI_WANTED               0x00000040              /* for VM synchronization */
+errno_t ubc_setsize_ex(vnode_t vp, off_t nsize, ubc_setsize_opts_t opts);
 
-#endif /* __APPLE_API_PRIVATE */
+#endif // KERNEL_PRIVATE
 
-#ifdef __APPLE_API_EVOLVING
-/*
- * exported primitives for loadable file systems.
- */
+kauth_cred_t ubc_getcred(struct vnode *);
+struct thread;
+int     ubc_setthreadcred(struct vnode *, struct proc *, struct thread *);
 
-__BEGIN_DECLS
-int    ubc_info_init __P((struct vnode *));
-void   ubc_info_deallocate  __P((struct ubc_info *));
-int    ubc_setsize __P((struct vnode *, off_t));
-off_t  ubc_getsize __P((struct vnode *));
-int    ubc_uncache __P((struct vnode *));
-int    ubc_umount __P((struct mount *));
-void   ubc_unmountall __P(());
-int    ubc_setcred __P((struct vnode *, struct proc *));
-struct ucred *ubc_getcred __P((struct vnode *));
-memory_object_t ubc_getpager __P((struct vnode *));
-memory_object_control_t ubc_getobject __P((struct vnode *, int));
-int ubc_setpager __P((struct vnode *, memory_object_t));
-int ubc_setflags __P((struct vnode *, int));
-int ubc_clearflags __P((struct vnode *, int));
-int ubc_issetflags __P((struct vnode *, int));
-off_t ubc_blktooff __P((struct vnode *, daddr_t));
-daddr_t ubc_offtoblk __P((struct vnode *, off_t));
-int ubc_clean __P((struct vnode *, int));
-int    ubc_pushdirty __P((struct vnode *));
-int    ubc_pushdirty_range __P((struct vnode *, off_t, off_t));
-int ubc_hold __P((struct vnode *));
-void ubc_rele __P((struct vnode *));
-void ubc_map __P((struct vnode *));
-int    ubc_destroy_named __P((struct vnode *));
-int    ubc_release_named __P((struct vnode *));
-int    ubc_invalidate __P((struct vnode *, off_t, size_t));
-int    ubc_isinuse __P((struct vnode *, int));
-
-int    ubc_page_op __P((struct vnode *, off_t, int, ppnum_t *, int *));
+errno_t ubc_msync(vnode_t, off_t, off_t, off_t *, int);
+int     ubc_pages_resident(vnode_t);
+int     ubc_page_op(vnode_t, off_t, int, ppnum_t *, int *);
+int     ubc_range_op(vnode_t, off_t, off_t, int, int *);
+
+#ifdef KERNEL_PRIVATE
+/* This API continues to exist only until <rdar://4714366> is resolved */
+int     ubc_setcred(struct vnode *, struct proc *) __deprecated;
+/* code signing */
+struct cs_blob;
+struct cs_blob *ubc_cs_blob_get(vnode_t, cpu_type_t, off_t);
+
+/* apis to handle generation count for cs blob */
+void cs_blob_reset_cache(void);
+int ubc_cs_blob_revalidate(vnode_t, struct cs_blob *, struct image_params *, int);
+int ubc_cs_generation_check(vnode_t);
+
+int cs_entitlements_blob_get(proc_t, void **, size_t *);
+int cs_blob_get(proc_t, void **, size_t *);
+const char *cs_identity_get(proc_t);
+
+#endif
 
 /* cluster IO routines */
-int    cluster_read __P((struct vnode *, struct uio *, off_t, int, int));
-int    advisory_read __P((struct vnode *, off_t, off_t, int, int));
-int    cluster_write __P((struct vnode *, struct uio*, off_t, off_t,
-               off_t, off_t,  int, int));
-int    cluster_push __P((struct vnode *));
-int    cluster_pageout __P((struct vnode *, upl_t, vm_offset_t, off_t, int,
-               off_t, int, int));
-int    cluster_pagein __P((struct vnode *, upl_t, vm_offset_t, off_t, int,
-               off_t, int, int));
-int    cluster_bp __P((struct buf *));
+void    cluster_update_state(vnode_t, vm_object_offset_t, vm_object_offset_t, boolean_t);
+
+int     advisory_read(vnode_t, off_t, off_t, int);
+int     advisory_read_ext(vnode_t, off_t, off_t, int, int (*)(buf_t, void *), void *, int);
+
+int     cluster_read(vnode_t, struct uio *, off_t, int);
+int     cluster_read_ext(vnode_t, struct uio *, off_t, int, int (*)(buf_t, void *), void *);
+
+int     cluster_write(vnode_t, struct uio *, off_t, off_t, off_t, off_t, int);
+int     cluster_write_ext(vnode_t, struct uio *, off_t, off_t, off_t, off_t, int, int (*)(buf_t, void *), void *);
+
+int     cluster_pageout(vnode_t, upl_t, upl_offset_t, off_t, int, off_t, int);
+int     cluster_pageout_ext(vnode_t, upl_t, upl_offset_t, off_t, int, off_t, int, int (*)(buf_t, void *), void *);
+
+int     cluster_pagein(vnode_t, upl_t, upl_offset_t, off_t, int, off_t, int);
+int     cluster_pagein_ext(vnode_t, upl_t, upl_offset_t, off_t, int, off_t, int, int (*)(buf_t, void *), void *);
+
+int     cluster_push(vnode_t, int);
+int     cluster_push_ext(vnode_t, int, int (*)(buf_t, void *), void *);
+int     cluster_push_err(vnode_t, int, int (*)(buf_t, void *), void *, int *);
+
+int     cluster_bp(buf_t);
+int     cluster_bp_ext(buf_t, int (*)(buf_t, void *), void *);
+
+void    cluster_zero(upl_t, upl_offset_t, int, buf_t);
+
+int     cluster_copy_upl_data(uio_t, upl_t, int, int *);
+int     cluster_copy_ubc_data(vnode_t, uio_t, int *, int);
+
+typedef struct cl_direct_read_lock cl_direct_read_lock_t;
+cl_direct_read_lock_t *cluster_lock_direct_read(vnode_t vp, lck_rw_type_t exclusive);
+void cluster_unlock_direct_read(cl_direct_read_lock_t *lck);
 
 /* UPL routines */
-int    ubc_create_upl __P((struct vnode *, off_t, long, upl_t *,
-               upl_page_info_t **, int));
-int ubc_upl_map __P((upl_t, vm_offset_t *));
-int ubc_upl_unmap __P((upl_t));
-int ubc_upl_commit __P((upl_t));
-int ubc_upl_commit_range __P((upl_t, vm_offset_t, vm_size_t, int));
-int ubc_upl_abort __P((upl_t, int));
-int ubc_upl_abort_range __P((upl_t, vm_offset_t, vm_size_t, int));
-upl_page_info_t *ubc_upl_pageinfo __P((upl_t));
-__END_DECLS
+#ifndef XNU_KERNEL_PRIVATE
+int     ubc_create_upl(vnode_t, off_t, int, upl_t *, upl_page_info_t **, int);
+#endif /* XNU_KERNEL_PRIVATE */
+int     ubc_upl_map(upl_t, vm_offset_t *);
+int     ubc_upl_unmap(upl_t);
+int     ubc_upl_commit(upl_t);
+int     ubc_upl_commit_range(upl_t, upl_offset_t, upl_size_t, int);
+int     ubc_upl_abort(upl_t, int);
+int     ubc_upl_abort_range(upl_t, upl_offset_t, upl_size_t, int);
+void    ubc_upl_range_needed(upl_t, int, int);
 
-#define UBCINFOMISSING(vp) \
-       ((vp) && ((vp)->v_type == VREG) && ((vp)->v_ubcinfo == UBC_INFO_NULL))
+upl_page_info_t *ubc_upl_pageinfo(upl_t);
+upl_size_t ubc_upl_maxbufsize(void);
 
-#define UBCINFORECLAIMED(vp) \
-       ((vp) && ((vp)->v_type == VREG) && ((vp)->v_ubcinfo == UBC_NOINFO))
+int     is_file_clean(vnode_t, off_t);
 
-#define UBCINFOEXISTS(vp) \
-       ((vp) && ((vp)->v_type == VREG) && \
-               ((vp)->v_ubcinfo) && ((vp)->v_ubcinfo != UBC_NOINFO))
+errno_t mach_to_bsd_errno(kern_return_t mach_err);
 
-#define UBCISVALID(vp) \
-       ((vp) && ((vp)->v_type == VREG) && !((vp)->v_flag & VSYSTEM))
+#ifdef KERNEL_PRIVATE
 
-#define UBCINVALID(vp) \
-       (((vp) == NULL) || ((vp) && ((vp)->v_type != VREG))     \
-               || ((vp) && ((vp)->v_flag & VSYSTEM)))
+int     ubc_create_upl_external(vnode_t, off_t, int, upl_t *, upl_page_info_t **, int);
+#ifdef  XNU_KERNEL_PRIVATE
+int     ubc_create_upl_kernel(vnode_t, off_t, int, upl_t *, upl_page_info_t **, int, vm_tag_t);
+#endif  /* XNU_KERNEL_PRIVATE */
 
-#define UBCINFOCHECK(fun, vp)  \
-       if ((vp) && ((vp)->v_type == VREG) &&   \
-                       (((vp)->v_ubcinfo == UBC_INFO_NULL)     \
-                       || ((vp)->v_ubcinfo == UBC_NOINFO))) \
-               panic("%s: lost ubc_info", (fun));
+__attribute__((pure)) boolean_t ubc_is_mapped(const struct vnode *, boolean_t *writable);
+__attribute__((pure)) boolean_t ubc_is_mapped_writable(const struct vnode *);
 
-/* Flags for ubc_getobject() */
-#define UBC_FLAGS_NONE         0x0000
-#define UBC_HOLDOBJECT         0x0001
-#define UBC_FOR_PAGEOUT         0x0002
+uint32_t cluster_max_io_size(mount_t, int);
 
-#endif /* __APPLE_API_EVOLVING */
+#endif
 
-#endif /* _SYS_UBC_H_ */
+__END_DECLS
 
+#endif  /* _SYS_UBC_H_ */