xref: /xnu-8792.81.2/libsyscall/mach/mach_error_string.c (revision 19c3b8c28c31cb8130e034cfb5df6bf9ba342d90)
1*19c3b8c2SApple OSS Distributions /*
2*19c3b8c2SApple OSS Distributions  * Copyright (c) 2003 Apple Computer, Inc. All rights reserved.
3*19c3b8c2SApple OSS Distributions  *
4*19c3b8c2SApple OSS Distributions  * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
5*19c3b8c2SApple OSS Distributions  *
6*19c3b8c2SApple OSS Distributions  * This file contains Original Code and/or Modifications of Original Code
7*19c3b8c2SApple OSS Distributions  * as defined in and that are subject to the Apple Public Source License
8*19c3b8c2SApple OSS Distributions  * Version 2.0 (the 'License'). You may not use this file except in
9*19c3b8c2SApple OSS Distributions  * compliance with the License. The rights granted to you under the License
10*19c3b8c2SApple OSS Distributions  * may not be used to create, or enable the creation or redistribution of,
11*19c3b8c2SApple OSS Distributions  * unlawful or unlicensed copies of an Apple operating system, or to
12*19c3b8c2SApple OSS Distributions  * circumvent, violate, or enable the circumvention or violation of, any
13*19c3b8c2SApple OSS Distributions  * terms of an Apple operating system software license agreement.
14*19c3b8c2SApple OSS Distributions  *
15*19c3b8c2SApple OSS Distributions  * Please obtain a copy of the License at
16*19c3b8c2SApple OSS Distributions  * http://www.opensource.apple.com/apsl/ and read it before using this file.
17*19c3b8c2SApple OSS Distributions  *
18*19c3b8c2SApple OSS Distributions  * The Original Code and all software distributed under the License are
19*19c3b8c2SApple OSS Distributions  * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
20*19c3b8c2SApple OSS Distributions  * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
21*19c3b8c2SApple OSS Distributions  * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
22*19c3b8c2SApple OSS Distributions  * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
23*19c3b8c2SApple OSS Distributions  * Please see the License for the specific language governing rights and
24*19c3b8c2SApple OSS Distributions  * limitations under the License.
25*19c3b8c2SApple OSS Distributions  *
26*19c3b8c2SApple OSS Distributions  * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
27*19c3b8c2SApple OSS Distributions  */
28*19c3b8c2SApple OSS Distributions /*
29*19c3b8c2SApple OSS Distributions  * @OSF_COPYRIGHT@
30*19c3b8c2SApple OSS Distributions  */
31*19c3b8c2SApple OSS Distributions /*
32*19c3b8c2SApple OSS Distributions  * Mach Operating System
33*19c3b8c2SApple OSS Distributions  * Copyright (c) 1991,1990,1989 Carnegie Mellon University
34*19c3b8c2SApple OSS Distributions  * All Rights Reserved.
35*19c3b8c2SApple OSS Distributions  *
36*19c3b8c2SApple OSS Distributions  * Permission to use, copy, modify and distribute this software and its
37*19c3b8c2SApple OSS Distributions  * documentation is hereby granted, provided that both the copyright
38*19c3b8c2SApple OSS Distributions  * notice and this permission notice appear in all copies of the
39*19c3b8c2SApple OSS Distributions  * software, derivative works or modified versions, and any portions
40*19c3b8c2SApple OSS Distributions  * thereof, and that both notices appear in supporting documentation.
41*19c3b8c2SApple OSS Distributions  *
42*19c3b8c2SApple OSS Distributions  * CARNEGIE MELLON ALLOWS FREE USE OF THIS SOFTWARE IN ITS "AS IS"
43*19c3b8c2SApple OSS Distributions  * CONDITION.  CARNEGIE MELLON DISCLAIMS ANY LIABILITY OF ANY KIND FOR
44*19c3b8c2SApple OSS Distributions  * ANY DAMAGES WHATSOEVER RESULTING FROM THE USE OF THIS SOFTWARE.
45*19c3b8c2SApple OSS Distributions  *
46*19c3b8c2SApple OSS Distributions  * Carnegie Mellon requests users of this software to return to
47*19c3b8c2SApple OSS Distributions  *
48*19c3b8c2SApple OSS Distributions  *  Software Distribution Coordinator  or  [email protected]
49*19c3b8c2SApple OSS Distributions  *  School of Computer Science
50*19c3b8c2SApple OSS Distributions  *  Carnegie Mellon University
51*19c3b8c2SApple OSS Distributions  *  Pittsburgh PA 15213-3890
52*19c3b8c2SApple OSS Distributions  *
53*19c3b8c2SApple OSS Distributions  * any improvements or extensions that they make and grant Carnegie Mellon
54*19c3b8c2SApple OSS Distributions  * the rights to redistribute these changes.
55*19c3b8c2SApple OSS Distributions  */
56*19c3b8c2SApple OSS Distributions 
57*19c3b8c2SApple OSS Distributions #include <limits.h>
58*19c3b8c2SApple OSS Distributions 
59*19c3b8c2SApple OSS Distributions #include <mach/boolean.h>
60*19c3b8c2SApple OSS Distributions #include <mach/error.h>
61*19c3b8c2SApple OSS Distributions #include <mach/mach_error.h>
62*19c3b8c2SApple OSS Distributions 
63*19c3b8c2SApple OSS Distributions #include "errorlib.h"
64*19c3b8c2SApple OSS Distributions #include "externs.h"
65*19c3b8c2SApple OSS Distributions 
66*19c3b8c2SApple OSS Distributions static void do_compat(mach_error_t *);
67*19c3b8c2SApple OSS Distributions 
68*19c3b8c2SApple OSS Distributions static void
do_compat(mach_error_t * org_err)69*19c3b8c2SApple OSS Distributions do_compat(mach_error_t *org_err)
70*19c3b8c2SApple OSS Distributions {
71*19c3b8c2SApple OSS Distributions 	mach_error_t            err = *org_err;
72*19c3b8c2SApple OSS Distributions 
73*19c3b8c2SApple OSS Distributions 	/*
74*19c3b8c2SApple OSS Distributions 	 * map old error numbers to
75*19c3b8c2SApple OSS Distributions 	 * to new error sys & subsystem
76*19c3b8c2SApple OSS Distributions 	 */
77*19c3b8c2SApple OSS Distributions 
78*19c3b8c2SApple OSS Distributions 	if ((-200 < err) && (err <= -100)) {
79*19c3b8c2SApple OSS Distributions 		err = -(err + 100) | IPC_SEND_MOD;
80*19c3b8c2SApple OSS Distributions 	} else if ((-300 < err) && (err <= -200)) {
81*19c3b8c2SApple OSS Distributions 		err = -(err + 200) | IPC_RCV_MOD;
82*19c3b8c2SApple OSS Distributions 	} else if ((-400 < err) && (err <= -300)) {
83*19c3b8c2SApple OSS Distributions 		err = -(err + 300) | MACH_IPC_MIG_MOD;
84*19c3b8c2SApple OSS Distributions 	} else if ((1000 <= err) && (err < 1100)) {
85*19c3b8c2SApple OSS Distributions 		err = (err - 1000) | SERV_NETNAME_MOD;
86*19c3b8c2SApple OSS Distributions 	} else if ((1600 <= err) && (err < 1700)) {
87*19c3b8c2SApple OSS Distributions 		err = (err - 1600) | SERV_ENV_MOD;
88*19c3b8c2SApple OSS Distributions 	} else if ((27600 <= err) && (err < 27700)) {
89*19c3b8c2SApple OSS Distributions 		err = (err - 27600) | SERV_EXECD_MOD;
90*19c3b8c2SApple OSS Distributions 	}
91*19c3b8c2SApple OSS Distributions 
92*19c3b8c2SApple OSS Distributions 	*org_err = err;
93*19c3b8c2SApple OSS Distributions }
94*19c3b8c2SApple OSS Distributions 
95*19c3b8c2SApple OSS Distributions static int
err_sparse_mapit(int old,const struct error_sparse_map * map_table,int mapcnt)96*19c3b8c2SApple OSS Distributions err_sparse_mapit(int old, const struct error_sparse_map *map_table, int mapcnt)
97*19c3b8c2SApple OSS Distributions {
98*19c3b8c2SApple OSS Distributions 	boolean_t found = FALSE;
99*19c3b8c2SApple OSS Distributions 	int ret = 0, i;
100*19c3b8c2SApple OSS Distributions 
101*19c3b8c2SApple OSS Distributions 	for (i = 0; i < mapcnt; i++) {
102*19c3b8c2SApple OSS Distributions 		struct error_sparse_map entry = map_table[i];
103*19c3b8c2SApple OSS Distributions 
104*19c3b8c2SApple OSS Distributions 		if (entry.start <= old && old <= entry.end) {
105*19c3b8c2SApple OSS Distributions 			ret += old - entry.start;
106*19c3b8c2SApple OSS Distributions 			found = TRUE;
107*19c3b8c2SApple OSS Distributions 			break;
108*19c3b8c2SApple OSS Distributions 		}
109*19c3b8c2SApple OSS Distributions 		ret += entry.end - entry.start + 1;
110*19c3b8c2SApple OSS Distributions 	}
111*19c3b8c2SApple OSS Distributions 
112*19c3b8c2SApple OSS Distributions 	return (found)? ret : INT_MAX;
113*19c3b8c2SApple OSS Distributions }
114*19c3b8c2SApple OSS Distributions 
115*19c3b8c2SApple OSS Distributions char *
mach_error_type(mach_error_t err)116*19c3b8c2SApple OSS Distributions mach_error_type(mach_error_t err)
117*19c3b8c2SApple OSS Distributions {
118*19c3b8c2SApple OSS Distributions 	const struct error_system *sys_p;
119*19c3b8c2SApple OSS Distributions 	int sub, system;
120*19c3b8c2SApple OSS Distributions 
121*19c3b8c2SApple OSS Distributions 	do_compat( &err );
122*19c3b8c2SApple OSS Distributions 
123*19c3b8c2SApple OSS Distributions 	system = err_get_system(err);
124*19c3b8c2SApple OSS Distributions 	sys_p = &_mach_errors[system];
125*19c3b8c2SApple OSS Distributions 	sub = err_get_sub(err);
126*19c3b8c2SApple OSS Distributions 
127*19c3b8c2SApple OSS Distributions 	if (system <= err_max_system && sys_p->map_table) {
128*19c3b8c2SApple OSS Distributions 		sub = err_sparse_mapit(sub, sys_p->map_table, sys_p->map_count);
129*19c3b8c2SApple OSS Distributions 	}
130*19c3b8c2SApple OSS Distributions 
131*19c3b8c2SApple OSS Distributions 	if (system > err_max_system || sub >= sys_p->max_sub) {
132*19c3b8c2SApple OSS Distributions 		return (char *)"(?/?)";
133*19c3b8c2SApple OSS Distributions 	}
134*19c3b8c2SApple OSS Distributions 	return (char *) (sys_p->subsystem[sub].subsys_name);
135*19c3b8c2SApple OSS Distributions }
136*19c3b8c2SApple OSS Distributions 
137*19c3b8c2SApple OSS Distributions boolean_t mach_error_full_diag = FALSE;
138*19c3b8c2SApple OSS Distributions 
139*19c3b8c2SApple OSS Distributions __private_extern__ char *
mach_error_string_int(mach_error_t err,boolean_t * diag)140*19c3b8c2SApple OSS Distributions mach_error_string_int(mach_error_t err, boolean_t *diag)
141*19c3b8c2SApple OSS Distributions {
142*19c3b8c2SApple OSS Distributions 	const struct error_system *sys_p;
143*19c3b8c2SApple OSS Distributions 	const struct error_subsystem *sub_p;
144*19c3b8c2SApple OSS Distributions 	int sub, system, code;
145*19c3b8c2SApple OSS Distributions 
146*19c3b8c2SApple OSS Distributions 	do_compat( &err );
147*19c3b8c2SApple OSS Distributions 
148*19c3b8c2SApple OSS Distributions 	system = err_get_system(err);
149*19c3b8c2SApple OSS Distributions 	sys_p = &_mach_errors[system];
150*19c3b8c2SApple OSS Distributions 	sub = err_get_sub(err);
151*19c3b8c2SApple OSS Distributions 	code = err_get_code(err);
152*19c3b8c2SApple OSS Distributions 
153*19c3b8c2SApple OSS Distributions 	*diag = TRUE;
154*19c3b8c2SApple OSS Distributions 
155*19c3b8c2SApple OSS Distributions 	if (system > err_max_system) {
156*19c3b8c2SApple OSS Distributions 		return (char *)"(?/?) unknown error system";
157*19c3b8c2SApple OSS Distributions 	} else if (sys_p->map_table) {
158*19c3b8c2SApple OSS Distributions 		sub = err_sparse_mapit(sub, sys_p->map_table, sys_p->map_count);
159*19c3b8c2SApple OSS Distributions 	}
160*19c3b8c2SApple OSS Distributions 
161*19c3b8c2SApple OSS Distributions 	if (sub >= sys_p->max_sub) {
162*19c3b8c2SApple OSS Distributions 		return (char *)sys_p->bad_sub;
163*19c3b8c2SApple OSS Distributions 	}
164*19c3b8c2SApple OSS Distributions 
165*19c3b8c2SApple OSS Distributions 	sub_p = &sys_p->subsystem[sub];
166*19c3b8c2SApple OSS Distributions 	if (sub_p->map_table) {
167*19c3b8c2SApple OSS Distributions 		code = err_sparse_mapit(code, sub_p->map_table, sub_p->map_count);
168*19c3b8c2SApple OSS Distributions 	}
169*19c3b8c2SApple OSS Distributions 	if (code >= sub_p->max_code) {
170*19c3b8c2SApple OSS Distributions 		return (char *)NO_SUCH_ERROR;
171*19c3b8c2SApple OSS Distributions 	}
172*19c3b8c2SApple OSS Distributions 
173*19c3b8c2SApple OSS Distributions 	*diag = mach_error_full_diag;
174*19c3b8c2SApple OSS Distributions 	return (char *)sub_p->codes[code];
175*19c3b8c2SApple OSS Distributions }
176*19c3b8c2SApple OSS Distributions 
177*19c3b8c2SApple OSS Distributions char *
mach_error_string(mach_error_t err)178*19c3b8c2SApple OSS Distributions mach_error_string(mach_error_t err)
179*19c3b8c2SApple OSS Distributions {
180*19c3b8c2SApple OSS Distributions 	boolean_t diag;
181*19c3b8c2SApple OSS Distributions 
182*19c3b8c2SApple OSS Distributions 	return mach_error_string_int( err, &diag );
183*19c3b8c2SApple OSS Distributions }
184*19c3b8c2SApple OSS Distributions 
185*19c3b8c2SApple OSS Distributions /* vim: set ts=4: */
186