xref: /titanic_44/usr/src/cmd/modload/addrem.h (revision 4a16f9a6c1cc74aeed5ff36b4723c3e43bc67666)
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  * Copyright (c) 1993, 2010, Oracle and/or its affiliates. All rights reserved.
23  */
24 
25 #ifndef _CMD_MODLOAD_ADDREM_H
26 #define	_CMD_MODLOAD_ADDREM_H
27 
28 #include <sys/modctl.h>
29 #include <device_info.h>
30 
31 #ifdef	__cplusplus
32 extern "C" {
33 #endif
34 
35 /* defines for add_drv.c, update_drv.c, and rem_drv.c */
36 
37 #define	SUCCESS	0
38 #define	FAILURE -1
39 #define	NOERR	0
40 #define	ERROR	-1
41 #define	UNIQUE	-2
42 #define	NOT_UNIQUE -3
43 #define	NONE_FOUND -4
44 
45 #define	MAX_CMD_LINE	256
46 #define	MAX_N2M_ALIAS_LINE	FILENAME_MAX + FILENAME_MAX + 1
47 #define	MAXLEN_NAM_TO_MAJ_ENT 	FILENAME_MAX + MAX_STR_MAJOR + 1
48 #define	OPT_LEN		128
49 #define	CADDR_HEX_STR	16
50 #define	UINT_STR	10
51 #define	MODLINE_ENT_MAX	(4 * UINT_STR) + CADDR_HEX_STR + MODMAXNAMELEN
52 #define	MAX_STR_MAJOR	UINT_STR
53 #define	STR_LONG	10
54 #define	PERM_STR	4
55 #define	MAX_PERM_ENTRY	(2 * STR_LONG) + PERM_STR + (2 * FILENAME_MAX) + 1
56 #define	MAX_DBFILE_ENTRY	MAX_PERM_ENTRY
57 
58 #define	CLEAN_MINOR_PERM	0x00000001
59 #define	CLEAN_DRV_ALIAS		0x00000002
60 #define	CLEAN_NAM_MAJ		0x00000004
61 #define	CLEAN_DRV_CLASSES	0x00000010
62 #define	CLEAN_DEV_POLICY	0x00000020
63 #define	CLEAN_DRV_PRIV		0x00000040
64 #define	CLEAN_ALL		(CLEAN_MINOR_PERM | CLEAN_DRV_ALIAS | \
65 				CLEAN_NAM_MAJ | CLEAN_DRV_CLASSES | \
66 				CLEAN_DEV_POLICY | CLEAN_DRV_PRIV)
67 
68 /* add_drv/rem_drv database files */
69 #define	DRIVER_ALIAS	"/etc/driver_aliases"
70 #define	DRIVER_CLASSES	"/etc/driver_classes"
71 #define	MINOR_PERM	"/etc/minor_perm"
72 #define	NAM_TO_MAJ	"/etc/name_to_major"
73 #define	REM_NAM_TO_MAJ	"/etc/rem_name_to_major"
74 
75 #define	ADD_REM_LOCK	"/var/run/AdDrEm.lck"
76 #define	TMPHOLD		"/etc/TmPhOlD"
77 
78 #if defined(__x86)
79 #define	DRVDIR64	"amd64"
80 #elif defined(__sparc)
81 #define	DRVDIR64	"sparcv9"
82 #endif
83 
84 /* pointers to add_drv/rem_drv database files */
85 char *driver_aliases;
86 char *driver_classes;
87 char *minor_perm;
88 char *name_to_major;
89 char *rem_name_to_major;
90 char *device_policy;
91 char *extra_privs;
92 
93 /* devfs root string */
94 char *devfs_root;
95 
96 /* module path searching structure */
97 struct drvmod_dir {
98 	char direc[FILENAME_MAX + 1];
99 	struct drvmod_dir *next;
100 };
101 
102 struct drvmod_dir *moddir;
103 
104 /* names of things: directories, commands, files */
105 #define	KERNEL_DRV	"/kernel/drv"
106 #define	USR_KERNEL_DRV	"/usr/kernel/drv"
107 #define	DRVCONFIG_PATH	"/usr/sbin/drvconfig"
108 #define	DRVCONFIG	"drvconfig"
109 #define	DEVFSADM_PATH	"/usr/sbin/devfsadm"
110 #define	DEVFSADM	"devfsadm"
111 #define	DEVFS_ROOT	"/devices"
112 #define	RECONFIGURE	"/reconfigure"
113 #define	MODUNLOAD_PATH	"/usr/sbin/modunload"
114 
115 extern void log_minorperm_error(minorperm_err_t, int);
116 extern void remove_entry(int, char *);
117 extern char *get_next_entry(char *, char *);
118 extern char *get_perm_entry(char *, char *);
119 extern int check_perms_aliases(int, int);
120 extern int check_name_to_major(int);
121 extern void enter_lock(void);
122 extern void err_exit(void);
123 extern void exit_unlock(void);
124 extern char *get_entry(char *, char *, char, int);
125 extern int build_filenames(char *);
126 extern int append_to_file(char *, char *, char *, char, char *, int);
127 extern int append_to_minor_perm(char *, char *, char *);
128 extern int get_major_no(char *, char *);
129 extern int get_driver_name(int, char *, char *);
130 extern int delete_entry(char *, char *, char *, char *);
131 extern int check_space_within_quote(char *);
132 extern void list_entry(char *, char *, char *);
133 extern int update_minor_entry(char *, char *);
134 extern int check_perm_opts(char *);
135 extern int update_name_to_major(char *, major_t *, int);
136 extern int do_the_update(char *, char *);
137 extern int fill_n2m_array(char *, char **, int *);
138 extern int aliases_unique(char *);
139 extern int aliases_exist(char *);
140 extern int aliases_paths_exist(char *);
141 extern int update_driver_aliases(char *, char *);
142 extern int unique_driver_name(char *, char *, int *);
143 extern int unique_drv_alias(char *);
144 extern int check_duplicate_driver_alias(char *, char *);
145 extern int trim_duplicate_aliases(char *, char *, char **);
146 extern int get_max_major(char *);
147 extern void get_modid(char *, int *);
148 extern int config_driver(char *, major_t, char *, char *, int, int);
149 extern int unconfig_driver(char *, major_t, char *, int);
150 extern void load_driver(char *, int);
151 extern int create_reconfig(char *);
152 extern void cleanup_moddir(void);
153 
154 /* drvsubr.c */
155 #define	XEND	".XXXXXX"
156 #define	MAXMODPATHS	1024
157 
158 /* module path list separators */
159 #define	MOD_SEP	" :"
160 #define	DIR_SEP "/"
161 
162 /* [un]config_driver flags */
163 #define	CONFIG_DRV_VERBOSE	0x01		/* verbose */
164 #define	CONFIG_DRV_FORCE	0x02		/* unconfig even if in use */
165 #define	CONFIG_DRV_UPDATE_ONLY	0x04		/* -u update only */
166 
167 #ifdef	__cplusplus
168 }
169 #endif
170 
171 #endif /* _CMD_MODLOAD_ADDREM_H */
172