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