1/*
2 * CDDL HEADER START
3 *
4 * The contents of this file are subject to the terms of the
5 * Common Development and Distribution License (the "License").
6 * You may not use this file except in compliance with the License.
7 *
8 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9 * or http://www.opensolaris.org/os/licensing.
10 * See the License for the specific language governing permissions
11 * and limitations under the License.
12 *
13 * When distributing Covered Code, include this CDDL HEADER in each
14 * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15 * If applicable, add the following below this CDDL HEADER, with the
16 * fields enclosed by brackets "[]" replaced with your own identifying
17 * information: Portions Copyright [yyyy] [name of copyright owner]
18 *
19 * CDDL HEADER END
20 */
21
22/*
23 * Copyright (c) 1989, 2010, Oracle and/or its affiliates. All rights reserved.
24 */
25
26/*	Copyright (c) 1984, 1986, 1987, 1988, 1989 AT&T	*/
27/*	  All Rights Reserved	*/
28
29/* Copyright (c) 2013, OmniTI Computer Consulting, Inc. All rights reserved. */
30/* Copyright 2015 Joyent, Inc. */
31
32#ifndef _SYS_FILE_H
33#define	_SYS_FILE_H
34
35#include <sys/t_lock.h>
36#if defined(_KERNEL) || defined(_FAKE_KERNEL)
37#include <sys/model.h>
38#include <sys/user.h>
39#endif
40
41#ifdef	__cplusplus
42extern "C" {
43#endif
44
45/*
46 * fio locking:
47 *   f_rwlock	protects f_vnode and f_cred
48 *   f_tlock	protects the rest
49 *
50 *   The purpose of locking in this layer is to keep the kernel
51 *   from panicing if, for example, a thread calls close() while
52 *   another thread is doing a read().  It is up to higher levels
53 *   to make sure 2 threads doing I/O to the same file don't
54 *   screw each other up.
55 */
56/*
57 * One file structure is allocated for each open/creat/pipe call.
58 * Main use is to hold the read/write pointer (and OFD locks) associated with
59 * each open file.
60 */
61typedef struct file {
62	kmutex_t	f_tlock;	/* short term lock */
63	ushort_t	f_flag;
64	ushort_t	f_flag2;	/* extra flags (FSEARCH, FEXEC) */
65	struct vnode	*f_vnode;	/* pointer to vnode structure */
66	offset_t	f_offset;	/* read/write character pointer */
67	struct cred	*f_cred;	/* credentials of user who opened it */
68	struct f_audit_data	*f_audit_data;	/* file audit data */
69	int		f_count;	/* reference count */
70	struct filock *f_filock;	/* ptr to single lock_descriptor_t */
71} file_t;
72
73/*
74 * fpollinfo struct - used by poll caching to track who has polled the fd
75 */
76typedef struct fpollinfo {
77	struct _kthread		*fp_thread;	/* thread caching poll info */
78	struct fpollinfo	*fp_next;
79} fpollinfo_t;
80
81/* f_flag */
82
83#define	FOPEN		0xffffffff
84#define	FREAD		0x01	/* <sys/aiocb.h> LIO_READ must be identical */
85#define	FWRITE		0x02	/* <sys/aiocb.h> LIO_WRITE must be identical */
86#define	FNDELAY		0x04
87#define	FAPPEND		0x08
88#define	FSYNC		0x10	/* file (data+inode) integrity while writing */
89#define	FREVOKED	0x20	/* Object reuse Revoked file */
90#define	FDSYNC		0x40	/* file data only integrity while writing */
91#define	FNONBLOCK	0x80
92
93#define	FMASK		0xa0ff	/* all flags that can be changed by F_SETFL */
94
95/* open-only modes */
96
97#define	FCREAT		0x0100
98#define	FTRUNC		0x0200
99#define	FEXCL		0x0400
100#define	FASYNC		0x1000	/* asyncio in progress pseudo flag */
101#define	FOFFMAX		0x2000	/* large file */
102#define	FXATTR		0x4000	/* open as extended attribute */
103#define	FNOCTTY		0x0800
104#define	FRSYNC		0x8000	/* sync read operations at same level of */
105				/* integrity as specified for writes by */
106				/* FSYNC and FDSYNC flags */
107
108#define	FNODSYNC	0x10000 /* fsync pseudo flag */
109
110#define	FNOFOLLOW	0x20000	/* don't follow symlinks */
111#define	FNOLINKS	0x40000	/* don't allow multiple hard links */
112#define	FIGNORECASE	0x80000 /* request case-insensitive lookups */
113#define	FXATTRDIROPEN	0x100000  /* only opening hidden attribute directory */
114
115/* f_flag2 (open-only) */
116
117#define	FSEARCH		0x200000	/* O_SEARCH = 0x200000 */
118#define	FEXEC		0x400000	/* O_EXEC = 0x400000 */
119
120#define	FCLOEXEC	0x800000	/* O_CLOEXEC = 0x800000 */
121#define	FDIRECTORY	0x1000000	/* O_DIRECTORY = 0x1000000 */
122
123#if defined(_KERNEL) || defined(_FAKE_KERNEL)
124
125/*
126 * Fake flags for driver ioctl calls to inform them of the originating
127 * process' model.  See <sys/model.h>
128 *
129 * Part of the Solaris 2.6+ DDI/DKI
130 */
131#define	FMODELS	DATAMODEL_MASK	/* Note: 0x0ff00000 */
132#define	FILP32	DATAMODEL_ILP32
133#define	FLP64	DATAMODEL_LP64
134#define	FNATIVE	DATAMODEL_NATIVE
135
136/*
137 * Large Files: The macro gets the offset maximum (refer to LFS API doc)
138 * corresponding to a file descriptor. We had the choice of storing
139 * this value in file descriptor. Right now we only have two
140 * offset maximums one if MAXOFF_T and other is MAXOFFSET_T. It is
141 * inefficient to store these two values in a separate member in
142 * file descriptor. To avoid wasting spaces we define this macro.
143 * The day there are more than two offset maximum we may want to
144 * rewrite this macro.
145 */
146
147#define	OFFSET_MAX(fd)	((fd->f_flag & FOFFMAX) ? MAXOFFSET_T : MAXOFF32_T)
148
149/*
150 * Fake flag => internal ioctl call for layered drivers.
151 * Note that this flag deliberately *won't* fit into
152 * the f_flag field of a file_t.
153 *
154 * Part of the Solaris 2.x DDI/DKI.
155 */
156#define	FKIOCTL		0x80000000	/* ioctl addresses are from kernel */
157
158/*
159 * Fake flag => this time to specify that the open(9E)
160 * comes from another part of the kernel, not userland.
161 *
162 * Part of the Solaris 2.x DDI/DKI.
163 */
164#define	FKLYR		0x40000000	/* layered driver call */
165
166#endif	/* _KERNEL */
167
168/* miscellaneous defines */
169
170#ifndef L_SET
171#define	L_SET	0	/* for lseek */
172#endif /* L_SET */
173
174/*
175 * For flock(3C).  These really don't belong here but for historical reasons
176 * the interface defines them to be here.
177 */
178#define	LOCK_SH	1
179#define	LOCK_EX	2
180#define	LOCK_NB	4
181#define	LOCK_UN	8
182
183#if !defined(_STRICT_SYMBOLS)
184extern int flock(int, int);
185#endif
186
187#if defined(_KERNEL) || defined(_FAKE_KERNEL)
188
189/*
190 * Routines dealing with user per-open file flags and
191 * user open files.
192 */
193struct proc;	/* forward reference for function prototype */
194struct vnodeops;
195struct vattr;
196struct uf_info;
197
198extern file_t *getf(int);
199extern file_t *getf_gen(int, uf_entry_gen_t *);
200extern void releasef(int);
201extern void areleasef(int, struct uf_info *);
202#ifndef	_BOOT
203extern void closeall(struct uf_info *);
204#endif
205extern void flist_fork(struct uf_info *, struct uf_info *);
206extern int closef(file_t *);
207extern int closeandsetf(int, file_t *);
208extern int ufalloc_file(int, file_t *);
209extern int ufalloc(int);
210extern int ufcanalloc(struct proc *, uint_t);
211extern int falloc(struct vnode *, int, file_t **, int *);
212extern void finit(void);
213extern void unfalloc(file_t *);
214extern void setf(int, file_t *);
215extern int f_getfd_error(int, int *);
216extern char f_getfd(int);
217extern int f_setfd_error(int, int);
218extern void f_setfd(int, char);
219extern int f_getfl(int, int *);
220extern int f_badfd(int, int *, int);
221extern int fassign(struct vnode **, int, int *);
222extern void fcnt_add(struct uf_info *, int);
223extern void close_exec(struct uf_info *);
224extern void clear_stale_fd(void);
225extern void clear_active_fd(int);
226extern void free_afd(afd_t *afd);
227extern int fgetstartvp(int, char *, struct vnode **);
228extern int fsetattrat(int, char *, int, struct vattr *);
229extern int fisopen(struct vnode *);
230extern void delfpollinfo(int);
231extern void addfpollinfo(int);
232extern int sock_getfasync(struct vnode *);
233extern int files_can_change_zones(void);
234#ifdef DEBUG
235/* The following functions are only used in ASSERT()s */
236extern void checkwfdlist(struct vnode *, fpollinfo_t *);
237extern void checkfpollinfo(void);
238extern int infpollinfo(int);
239#endif	/* DEBUG */
240
241#endif	/* defined(_KERNEL) */
242
243#ifdef	__cplusplus
244}
245#endif
246
247#endif	/* _SYS_FILE_H */
248