xref: /titanic_52/usr/src/uts/common/sys/open.h (revision 10db1377dafab8ba3feedef26db9c5d8539a5cd1)
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, Version 1.0 only
6  * (the "License").  You may not use this file except in compliance
7  * with the License.
8  *
9  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
10  * or http://www.opensolaris.org/os/licensing.
11  * See the License for the specific language governing permissions
12  * and limitations under the License.
13  *
14  * When distributing Covered Code, include this CDDL HEADER in each
15  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
16  * If applicable, add the following below this CDDL HEADER, with the
17  * fields enclosed by brackets "[]" replaced with your own identifying
18  * information: Portions Copyright [yyyy] [name of copyright owner]
19  *
20  * CDDL HEADER END
21  */
22 /*	Copyright (c) 1984, 1986, 1987, 1988, 1989 AT&T	*/
23 /*	  All Rights Reserved  	*/
24 
25 
26 #ifndef _SYS_OPEN_H
27 #define	_SYS_OPEN_H
28 
29 #pragma ident	"%Z%%M%	%I%	%E% SMI"	/* from SVR4 11.4 */
30 
31 #ifdef	__cplusplus
32 extern "C" {
33 #endif
34 
35 /*
36  * Some drivers need to be able to keep accurate records of open/close
37  * calls to determine whether a device is still in use.  To allow this
38  * open/close calls have been typed and the type is passed as a third
39  * argument in open/close calls, as in:
40  *	(*cdevsw[getmajor(dev)].d_open)(getminor(dev), flag, OTYP_CHR);
41  * or
42  *	(*cdevsw[getmajor(dev)].d_close)(getminor(dev), flag, OTYP_CHR);
43  * Five types of open/close calls have been defined:
44  * OTYP_BLK:	open/close of a block special file
45  * OTYP_MNT:	open/close for mounting/unmounting a file system
46  * OTYP_CHR:	open/close of a character special file
47  * OTYP_SWP:	open/close of a swapping device.
48  * OTYP_LYR:	open/close calls from a driver to another driver,
49  *		without a file being open for the dev of the lower driver.
50  *
51  * The first four types of open/close calls obey the protocol rule
52  * that many more opens may occur for a given minor(dev) for that type of open,
53  * but a close call happens only on the last close of that dev.
54  * This protocol allows a flag to be used (set by opens, cleared by closes)
55  * to keep track of the state for a given minor device value.
56  *
57  * Calls of the fifth type (OTYP_LYR) must obey the protocol rule
58  * that open and close call calls are always paired.  This protocol
59  * permits several drivers to be layers above the same device driver.
60  * A counter can be used for this protocol.
61  *
62  * The value OTYPCNT is defined for the purpose of declaring arrays
63  * in drivers and for performing range checks (0 <= otyp < OTYPCNT)
64  * on values passed.
65  */
66 
67 #define	OTYPCNT		5
68 #define	OTYP_BLK	0
69 #define	OTYP_MNT	1
70 #define	OTYP_CHR	2
71 #define	OTYP_SWP	3
72 #define	OTYP_LYR	4
73 
74 #ifdef	__cplusplus
75 }
76 #endif
77 
78 #endif	/* _SYS_OPEN_H */
79