[apple/xnu.git] / bsd / sys / ubc.h

/*
 * Copyright (c) 1999, 2000 Apple Computer, Inc. All rights reserved.
 *
 * @APPLE_LICENSE_HEADER_START@
 * 
 * The contents of this file constitute Original Code as defined in and
 * are subject to the Apple Public Source License Version 1.1 (the
 * "License").  You may not use this file except in compliance with the
 * License.  Please obtain a copy of the License at
 * http://www.apple.com/publicsource and read it before using this file.
 * 
 * This 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,
 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE 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.
 *
 *	Header file for Unified Buffer Cache.
 *
 */ 

#ifndef	_SYS_UBC_H_
#define	_SYS_UBC_H_

#include <sys/types.h>
#include <sys/ucred.h>
#include <sys/vnode.h>

#include <sys/cdefs.h>

#include <mach/memory_object_types.h>

#define UBC_INFO_NULL	((struct ubc_info *) 0)
#define UBC_NOINFO		((struct ubc_info *)0xDEADD1ED)

extern struct zone	*ubc_info_zone;

/*
 *	The following data structure keeps the information to associate
 *	a vnode to the correspondig VM objects.
 */

struct ubc_info {
	void 			* ui_pager;	/* pager */
	void			*ui_object;	/* VM object corresponding to the pager */
	long			ui_flags;	/* flags */
	struct vnode 	*ui_vnode;	/* The vnode associated with this ubc_info */
	struct ucred 	*ui_ucred;	/* holds credentials for NFS paging */
	int				ui_holdcnt; /* hold the memory object */
	off_t			ui_size;	/* file size for the vnode */
	long			ui_mapped;	/* is it currently mapped */
};

/* 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 */

/*
 * exported primitives for loadable file systems.
 */

__BEGIN_DECLS
int	ubc_info_init __P((struct vnode *));
void	ubc_info_free  __P((struct vnode *));
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 *));
void *ubc_getpager __P((struct vnode *));
void *ubc_getobject __P((struct vnode *, int));
int ubc_setpager __P((struct vnode *, void *));
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_hold __P((struct vnode *));
void ubc_rele __P((struct vnode *));
void ubc_map __P((struct vnode *));
int	ubc_release __P((struct vnode *));
int	ubc_invalidate __P((struct vnode *, off_t, size_t));
int	ubc_isinuse __P((struct vnode *, int));

/* 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 *));
__END_DECLS

#define UBCINFOMISSING(vp) \
	((vp) && ((vp)->v_type == VREG) && ((vp)->v_ubcinfo == UBC_INFO_NULL))

#define UBCINFORECLAIMED(vp) \
	((vp) && ((vp)->v_type == VREG) && ((vp)->v_ubcinfo == UBC_NOINFO))

#define UBCINFOEXISTS(vp) \
	((vp) && ((vp)->v_type == VREG) && \
		((vp)->v_ubcinfo) && ((vp)->v_ubcinfo != UBC_NOINFO))

#define UBCISVALID(vp) \
	((vp) && ((vp)->v_type == VREG) && !((vp)->v_flag & VSYSTEM))

#define UBCINVALID(vp) \
	(((vp) == NULL) || ((vp) && ((vp)->v_type != VREG))     \
		|| ((vp) && ((vp)->v_flag & VSYSTEM)))

#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));

/* Flags for ubc_getobject() */
#define UBC_HOLDOBJECT		0x0001
#define UBC_NOREACTIVATE	0x0002
#define	UBC_PAGINGOP		0x0004


#endif	/* _SYS_UBC_H_ */
Commit	Line	Data
1c79356b A	1	/*
	2	* Copyright (c) 1999, 2000 Apple Computer, Inc. All rights reserved.
	3	*
	4	* @APPLE_LICENSE_HEADER_START@
	5	*
	6	* The contents of this file constitute Original Code as defined in and
	7	* are subject to the Apple Public Source License Version 1.1 (the
	8	* "License"). You may not use this file except in compliance with the
	9	* License. Please obtain a copy of the License at
	10	* http://www.apple.com/publicsource and read it before using this file.
	11	*
	12	* This Original Code and all software distributed under the License are
	13	* distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, EITHER
	14	* EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
	15	* INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
	16	* FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT. Please see the
	17	* License for the specific language governing rights and limitations
	18	* under the License.
	19	*
	20	* @APPLE_LICENSE_HEADER_END@
	21	*/
	22	/*
	23	* File: ubc.h
	24	* Author: Umesh Vaishampayan [umeshv@apple.com]
	25	* 05-Aug-1999 umeshv Created.
	26	*
	27	* Header file for Unified Buffer Cache.
	28	*
	29	*/
	30
	31	#ifndef _SYS_UBC_H_
	32	#define _SYS_UBC_H_
	33
	34	#include <sys/types.h>
	35	#include <sys/ucred.h>
	36	#include <sys/vnode.h>
	37
	38	#include <sys/cdefs.h>
	39
	40	#include <mach/memory_object_types.h>
	41
	42	#define UBC_INFO_NULL ((struct ubc_info *) 0)
	43	#define UBC_NOINFO ((struct ubc_info *)0xDEADD1ED)
	44
	45	extern struct zone *ubc_info_zone;
	46
	47	/*
	48	* The following data structure keeps the information to associate
	49	* a vnode to the correspondig VM objects.
	50	*/
	51
	52	struct ubc_info {
	53	void * ui_pager; /* pager */
	54	void ui_object; / VM object corresponding to the pager */
	55	long ui_flags; /* flags */
	56	struct vnode ui_vnode; / The vnode associated with this ubc_info */
	57	struct ucred ui_ucred; / holds credentials for NFS paging */
	58	int ui_holdcnt; /* hold the memory object */
	59	off_t ui_size; /* file size for the vnode */
	60	long ui_mapped; /* is it currently mapped */
	61	};
	62
	63	/* Defines for ui_flags */
	64	#define UI_NONE 0x00000000 /* none */
65	#define UI_HASPAGER 0x00000001 /* has a pager associated */
66	#define UI_INITED 0x00000002 /* newly initialized vnode */
67	#define UI_HASOBJREF 0x00000004 /* hold a reference on object */
68	#define UI_WASMAPPED 0x00000008 /* vnode was mapped */
69	#define UI_DONTCACHE 0x00000010 /* do not cache object */
70
71	/*
72	* exported primitives for loadable file systems.
73	*/
74
75	__BEGIN_DECLS
76	int ubc_info_init __P((struct vnode *));
77	void ubc_info_free __P((struct vnode *));
78	int ubc_setsize __P((struct vnode *, off_t));
79	off_t ubc_getsize __P((struct vnode *));
80	int ubc_uncache __P((struct vnode *));
81	int ubc_umount __P((struct mount *));
82	void ubc_unmountall __P(());
83	int ubc_setcred __P((struct vnode , struct proc ));
84	struct ucred ubc_getcred __P((struct vnode ));
85	void ubc_getpager __P((struct vnode ));
86	void ubc_getobject __P((struct vnode , int));
87	int ubc_setpager __P((struct vnode , void ));
88	int ubc_setflags __P((struct vnode *, int));
89	int ubc_clearflags __P((struct vnode *, int));
90	int ubc_issetflags __P((struct vnode *, int));
91	off_t ubc_blktooff __P((struct vnode *, daddr_t));
92	daddr_t ubc_offtoblk __P((struct vnode *, off_t));
93	int ubc_clean __P((struct vnode *, int));
94	int ubc_pushdirty __P((struct vnode *));
95	int ubc_hold __P((struct vnode *));
96	void ubc_rele __P((struct vnode *));
97	void ubc_map __P((struct vnode *));
98	int ubc_release __P((struct vnode *));
99	int ubc_invalidate __P((struct vnode *, off_t, size_t));
100	int ubc_isinuse __P((struct vnode *, int));
101
102	/* cluster IO routines */
103	int cluster_read __P((struct vnode , struct uio , off_t, int, int));
104	int advisory_read __P((struct vnode *, off_t, off_t, int, int));
105	int cluster_write __P((struct vnode , struct uio, off_t, off_t,
106	off_t, off_t, int, int));
107	int cluster_push __P((struct vnode *));
108	int cluster_pageout __P((struct vnode *, upl_t, vm_offset_t, off_t, int,
109	off_t, int, int));
110	int cluster_pagein __P((struct vnode *, upl_t, vm_offset_t, off_t, int,
111	off_t, int, int));
112	int cluster_bp __P((struct buf *));
113	__END_DECLS
114
115	#define UBCINFOMISSING(vp) \
116	((vp) && ((vp)->v_type == VREG) && ((vp)->v_ubcinfo == UBC_INFO_NULL))
117
118	#define UBCINFORECLAIMED(vp) \
119	((vp) && ((vp)->v_type == VREG) && ((vp)->v_ubcinfo == UBC_NOINFO))
120
121	#define UBCINFOEXISTS(vp) \
122	((vp) && ((vp)->v_type == VREG) && \
123	((vp)->v_ubcinfo) && ((vp)->v_ubcinfo != UBC_NOINFO))
124
125	#define UBCISVALID(vp) \
126	((vp) && ((vp)->v_type == VREG) && !((vp)->v_flag & VSYSTEM))
127
128	#define UBCINVALID(vp) \
129	(((vp) == NULL) \|\| ((vp) && ((vp)->v_type != VREG)) \
130	\|\| ((vp) && ((vp)->v_flag & VSYSTEM)))
131
132	#define UBCINFOCHECK(fun, vp) \
133	if ((vp) && ((vp)->v_type == VREG) && \
134	(((vp)->v_ubcinfo == UBC_INFO_NULL) \
135	\|\| ((vp)->v_ubcinfo == UBC_NOINFO))) \
136	panic("%s: lost ubc_info", (fun));
137
138	/* Flags for ubc_getobject() */
139	#define UBC_HOLDOBJECT 0x0001
140	#define UBC_NOREACTIVATE 0x0002
141	#define UBC_PAGINGOP 0x0004
142
143
144	#endif /* _SYS_UBC_H_ */
145