xref: /dragonfly/sys/sys/file.h (revision d5f516c3)
1 /*
2  * Copyright (c) 1982, 1986, 1989, 1993
3  *	The Regents of the University of California.  All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  * 1. Redistributions of source code must retain the above copyright
9  *    notice, this list of conditions and the following disclaimer.
10  * 2. Redistributions in binary form must reproduce the above copyright
11  *    notice, this list of conditions and the following disclaimer in the
12  *    documentation and/or other materials provided with the distribution.
13  * 3. All advertising materials mentioning features or use of this software
14  *    must display the following acknowledgement:
15  *	This product includes software developed by the University of
16  *	California, Berkeley and its contributors.
17  * 4. Neither the name of the University nor the names of its contributors
18  *    may be used to endorse or promote products derived from this software
19  *    without specific prior written permission.
20  *
21  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
22  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
23  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
24  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
25  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
26  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
27  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
28  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
29  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
30  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
31  * SUCH DAMAGE.
32  *
33  *	@(#)file.h	8.3 (Berkeley) 1/9/95
34  * $FreeBSD: src/sys/sys/file.h,v 1.22.2.7 2002/11/21 23:39:24 sam Exp $
35  * $DragonFly: src/sys/sys/file.h,v 1.12 2004/11/12 00:09:27 dillon Exp $
36  */
37 
38 #ifndef _SYS_FILE_H_
39 #define	_SYS_FILE_H_
40 
41 #ifndef _KERNEL
42 #include <sys/fcntl.h>
43 #include <sys/unistd.h>
44 #endif
45 
46 #if defined(_KERNEL) || defined(_KERNEL_STRUCTURES)
47 
48 #include <sys/queue.h>
49 
50 struct stat;
51 struct proc;
52 struct thread;
53 struct uio;
54 struct knote;
55 struct file;
56 struct ucred;
57 struct vnode;
58 struct lwkt_port;
59 struct namecache;
60 
61 struct	fileops {
62 	struct lwkt_port *fo_port;
63 	int	(*fo_clone)(struct file *);	/* additional work after dup */
64 
65 	int	(*fold_read)	(struct file *fp, struct uio *uio,
66 				    struct ucred *cred, int flags,
67 				    struct thread *td);
68 	int	(*fold_write)	(struct file *fp, struct uio *uio,
69 				    struct ucred *cred, int flags,
70 				    struct thread *td);
71 	int	(*fold_ioctl)	(struct file *fp, u_long com,
72 				    caddr_t data, struct thread *td);
73 	int	(*fold_poll)	(struct file *fp, int events,
74 				    struct ucred *cred, struct thread *td);
75 	int	(*fold_kqfilter)	(struct file *fp,
76 				    struct knote *kn);
77 	int	(*fold_stat)	(struct file *fp, struct stat *sb,
78 				    struct thread *td);
79 	int	(*fold_close)	(struct file *fp, struct thread *td);
80 };
81 
82 #define	FOF_OFFSET	1	/* fo_read(), fo_write() flags */
83 
84 /*
85  * Kernel descriptor table.
86  * One entry for each open kernel vnode and socket.
87  */
88 struct file {
89 	LIST_ENTRY(file) f_list;/* list of active files */
90 	short	f_FILLER3;	/* (old f_flag) */
91 #define	DTYPE_VNODE	1	/* file */
92 #define	DTYPE_SOCKET	2	/* communications endpoint */
93 #define	DTYPE_PIPE	3	/* pipe */
94 #define	DTYPE_FIFO	4	/* fifo (named pipe) */
95 #define	DTYPE_KQUEUE	5	/* event queue */
96 #define DTYPE_CRYPTO	6	/* crypto */
97 	short	f_type;		/* descriptor type */
98 	u_int	f_flag;		/* see fcntl.h */
99 	struct	ucred *f_cred;	/* credentials associated with descriptor */
100 	struct  fileops *f_ops;
101 	int	f_seqcount;	/*
102 				 * count of sequential accesses -- cleared
103 				 * by most seek operations.
104 				 */
105 	off_t	f_nextoff;	/*
106 				 * offset of next expected read or write
107 				 */
108 	off_t	f_offset;
109 	caddr_t	f_data;		/* vnode or socket */
110 	int	f_count;	/* reference count */
111 	int	f_msgcount;	/* reference count from message queue */
112 	struct namecache *f_ncp; /* ncp (required for directories) */
113 };
114 
115 LIST_HEAD(filelist, file);
116 
117 #endif
118 
119 #ifdef _KERNEL
120 
121 #ifdef MALLOC_DECLARE
122 MALLOC_DECLARE(M_FILE);
123 #endif
124 
125 extern int fdrop (struct file *fp, struct thread *td);
126 
127 extern int fp_open(const char *path, int flags, int mode, struct file **fpp);
128 extern int fp_vpopen(struct vnode *vp, int flags, struct file **fpp);
129 extern int fp_pread(struct file *fp, void *buf, size_t nbytes, off_t offset, ssize_t *res);
130 extern int fp_pwrite(struct file *fp, void *buf, size_t nbytes, off_t offset, ssize_t *res);
131 extern int fp_read(struct file *fp, void *buf, size_t nbytes, ssize_t *res);
132 extern int fp_write(struct file *fp, void *buf, size_t nbytes, ssize_t *res);
133 extern int fp_stat(struct file *fp, struct stat *ub);
134 extern int fp_mmap(void *addr, size_t size, int prot, int flags, struct file *fp, off_t pos, void **resp);
135 
136 extern int fp_close(struct file *fp);
137 
138 extern struct filelist filehead; /* head of list of open files */
139 extern struct fileops vnode_fileops;
140 extern struct fileops specvnode_fileops;
141 extern struct fileops badfileops;
142 extern int maxfiles;		/* kernel limit on number of open files */
143 extern int maxfilesrootres;	/* descriptors reserved for root use */
144 extern int maxfilesperproc;	/* per process limit on number of open files */
145 extern int nfiles;		/* actual number of open files */
146 
147 #endif /* _KERNEL */
148 
149 #endif /* !SYS_FILE_H */
150