utclib.c revision 1.1.1.6 1 1.1 jruoho /******************************************************************************
2 1.1 jruoho *
3 1.1.1.6 christos * Module Name: utclib - ACPICA implementations of C library functions
4 1.1 jruoho *
5 1.1 jruoho *****************************************************************************/
6 1.1 jruoho
7 1.1.1.2 jruoho /*
8 1.1.1.5 christos * Copyright (C) 2000 - 2015, Intel Corp.
9 1.1 jruoho * All rights reserved.
10 1.1 jruoho *
11 1.1.1.2 jruoho * Redistribution and use in source and binary forms, with or without
12 1.1.1.2 jruoho * modification, are permitted provided that the following conditions
13 1.1.1.2 jruoho * are met:
14 1.1.1.2 jruoho * 1. Redistributions of source code must retain the above copyright
15 1.1.1.2 jruoho * notice, this list of conditions, and the following disclaimer,
16 1.1.1.2 jruoho * without modification.
17 1.1.1.2 jruoho * 2. Redistributions in binary form must reproduce at minimum a disclaimer
18 1.1.1.2 jruoho * substantially similar to the "NO WARRANTY" disclaimer below
19 1.1.1.2 jruoho * ("Disclaimer") and any redistribution must be conditioned upon
20 1.1.1.2 jruoho * including a substantially similar Disclaimer requirement for further
21 1.1.1.2 jruoho * binary redistribution.
22 1.1.1.2 jruoho * 3. Neither the names of the above-listed copyright holders nor the names
23 1.1.1.2 jruoho * of any contributors may be used to endorse or promote products derived
24 1.1.1.2 jruoho * from this software without specific prior written permission.
25 1.1.1.2 jruoho *
26 1.1.1.2 jruoho * Alternatively, this software may be distributed under the terms of the
27 1.1.1.2 jruoho * GNU General Public License ("GPL") version 2 as published by the Free
28 1.1.1.2 jruoho * Software Foundation.
29 1.1.1.2 jruoho *
30 1.1.1.2 jruoho * NO WARRANTY
31 1.1.1.2 jruoho * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
32 1.1.1.2 jruoho * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
33 1.1.1.2 jruoho * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
34 1.1.1.2 jruoho * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
35 1.1.1.2 jruoho * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
36 1.1.1.2 jruoho * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
37 1.1.1.2 jruoho * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
38 1.1.1.2 jruoho * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
39 1.1.1.2 jruoho * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
40 1.1.1.2 jruoho * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
41 1.1.1.2 jruoho * POSSIBILITY OF SUCH DAMAGES.
42 1.1.1.2 jruoho */
43 1.1 jruoho
44 1.1.1.6 christos #define ACPI_CLIBRARY
45 1.1 jruoho #include "acpi.h"
46 1.1 jruoho #include "accommon.h"
47 1.1 jruoho
48 1.1 jruoho /*
49 1.1.1.6 christos * This module contains implementations of the standard C library functions
50 1.1.1.6 christos * that are required by the ACPICA code at both application level and kernel
51 1.1.1.6 christos * level.
52 1.1.1.6 christos *
53 1.1.1.6 christos * The module is an optional feature that can be used if a local/system
54 1.1.1.6 christos * C library is not available. Some operating system kernels may not have
55 1.1.1.6 christos * an internal C library.
56 1.1.1.6 christos *
57 1.1.1.6 christos * In general, these functions are less efficient than an inline or assembly
58 1.1.1.6 christos * code implementation.
59 1.1.1.6 christos *
60 1.1.1.6 christos * These C functions and the associated prototypes are enabled by default
61 1.1.1.6 christos * unless the ACPI_USE_SYSTEM_CLIBRARY symbol is defined. This is usually
62 1.1.1.6 christos * automatically defined for the ACPICA applications such as iASL and
63 1.1.1.6 christos * AcpiExec, so that these user-level applications use the local C library
64 1.1.1.6 christos * instead of the functions in this module.
65 1.1 jruoho */
66 1.1 jruoho
67 1.1.1.6 christos /*******************************************************************************
68 1.1.1.6 christos *
69 1.1.1.6 christos * Functions implemented in this module:
70 1.1.1.6 christos *
71 1.1.1.6 christos * FUNCTION: memcmp
72 1.1.1.6 christos * FUNCTION: memcpy
73 1.1.1.6 christos * FUNCTION: memset
74 1.1.1.6 christos * FUNCTION: strlen
75 1.1.1.6 christos * FUNCTION: strcpy
76 1.1.1.6 christos * FUNCTION: strncpy
77 1.1.1.6 christos * FUNCTION: strcmp
78 1.1.1.6 christos * FUNCTION: strchr
79 1.1.1.6 christos * FUNCTION: strncmp
80 1.1.1.6 christos * FUNCTION: strcat
81 1.1.1.6 christos * FUNCTION: strncat
82 1.1.1.6 christos * FUNCTION: strstr
83 1.1.1.6 christos * FUNCTION: strtoul
84 1.1.1.6 christos * FUNCTION: toupper
85 1.1.1.6 christos * FUNCTION: tolower
86 1.1.1.6 christos * FUNCTION: is* functions
87 1.1.1.6 christos *
88 1.1.1.6 christos ******************************************************************************/
89 1.1 jruoho
90 1.1.1.6 christos #define _COMPONENT ACPI_UTILITIES
91 1.1.1.6 christos ACPI_MODULE_NAME ("utclib")
92 1.1 jruoho
93 1.1 jruoho
94 1.1.1.6 christos #ifndef ACPI_USE_SYSTEM_CLIBRARY /* Entire module */
95 1.1 jruoho
96 1.1 jruoho
97 1.1 jruoho /*******************************************************************************
98 1.1 jruoho *
99 1.1.1.6 christos * FUNCTION: memcmp
100 1.1 jruoho *
101 1.1 jruoho * PARAMETERS: Buffer1 - First Buffer
102 1.1 jruoho * Buffer2 - Second Buffer
103 1.1 jruoho * Count - Maximum # of bytes to compare
104 1.1 jruoho *
105 1.1 jruoho * RETURN: Index where Buffers mismatched, or 0 if Buffers matched
106 1.1 jruoho *
107 1.1 jruoho * DESCRIPTION: Compare two Buffers, with a maximum length
108 1.1 jruoho *
109 1.1 jruoho ******************************************************************************/
110 1.1 jruoho
111 1.1 jruoho int
112 1.1.1.6 christos memcmp (
113 1.1.1.6 christos void *VBuffer1,
114 1.1.1.6 christos void *VBuffer2,
115 1.1 jruoho ACPI_SIZE Count)
116 1.1 jruoho {
117 1.1.1.6 christos char *Buffer1 = (char *) VBuffer1;
118 1.1.1.6 christos char *Buffer2 = (char *) VBuffer2;
119 1.1.1.6 christos
120 1.1 jruoho
121 1.1 jruoho for ( ; Count-- && (*Buffer1 == *Buffer2); Buffer1++, Buffer2++)
122 1.1 jruoho {
123 1.1 jruoho }
124 1.1 jruoho
125 1.1 jruoho return ((Count == ACPI_SIZE_MAX) ? 0 : ((unsigned char) *Buffer1 -
126 1.1 jruoho (unsigned char) *Buffer2));
127 1.1 jruoho }
128 1.1 jruoho
129 1.1 jruoho
130 1.1 jruoho /*******************************************************************************
131 1.1 jruoho *
132 1.1.1.6 christos * FUNCTION: memcpy
133 1.1 jruoho *
134 1.1 jruoho * PARAMETERS: Dest - Target of the copy
135 1.1 jruoho * Src - Source buffer to copy
136 1.1 jruoho * Count - Number of bytes to copy
137 1.1 jruoho *
138 1.1 jruoho * RETURN: Dest
139 1.1 jruoho *
140 1.1 jruoho * DESCRIPTION: Copy arbitrary bytes of memory
141 1.1 jruoho *
142 1.1 jruoho ******************************************************************************/
143 1.1 jruoho
144 1.1 jruoho void *
145 1.1.1.6 christos memcpy (
146 1.1 jruoho void *Dest,
147 1.1 jruoho const void *Src,
148 1.1 jruoho ACPI_SIZE Count)
149 1.1 jruoho {
150 1.1 jruoho char *New = (char *) Dest;
151 1.1 jruoho char *Old = (char *) Src;
152 1.1 jruoho
153 1.1 jruoho
154 1.1 jruoho while (Count)
155 1.1 jruoho {
156 1.1 jruoho *New = *Old;
157 1.1 jruoho New++;
158 1.1 jruoho Old++;
159 1.1 jruoho Count--;
160 1.1 jruoho }
161 1.1 jruoho
162 1.1 jruoho return (Dest);
163 1.1 jruoho }
164 1.1 jruoho
165 1.1 jruoho
166 1.1 jruoho /*******************************************************************************
167 1.1 jruoho *
168 1.1.1.6 christos * FUNCTION: memset
169 1.1 jruoho *
170 1.1 jruoho * PARAMETERS: Dest - Buffer to set
171 1.1 jruoho * Value - Value to set each byte of memory
172 1.1 jruoho * Count - Number of bytes to set
173 1.1 jruoho *
174 1.1 jruoho * RETURN: Dest
175 1.1 jruoho *
176 1.1 jruoho * DESCRIPTION: Initialize a buffer to a known value.
177 1.1 jruoho *
178 1.1 jruoho ******************************************************************************/
179 1.1 jruoho
180 1.1 jruoho void *
181 1.1.1.6 christos memset (
182 1.1 jruoho void *Dest,
183 1.1.1.6 christos int Value,
184 1.1 jruoho ACPI_SIZE Count)
185 1.1 jruoho {
186 1.1 jruoho char *New = (char *) Dest;
187 1.1 jruoho
188 1.1 jruoho
189 1.1 jruoho while (Count)
190 1.1 jruoho {
191 1.1 jruoho *New = (char) Value;
192 1.1 jruoho New++;
193 1.1 jruoho Count--;
194 1.1 jruoho }
195 1.1 jruoho
196 1.1 jruoho return (Dest);
197 1.1 jruoho }
198 1.1 jruoho
199 1.1 jruoho
200 1.1 jruoho /*******************************************************************************
201 1.1 jruoho *
202 1.1.1.6 christos * FUNCTION: strlen
203 1.1 jruoho *
204 1.1 jruoho * PARAMETERS: String - Null terminated string
205 1.1 jruoho *
206 1.1 jruoho * RETURN: Length
207 1.1 jruoho *
208 1.1 jruoho * DESCRIPTION: Returns the length of the input string
209 1.1 jruoho *
210 1.1 jruoho ******************************************************************************/
211 1.1 jruoho
212 1.1 jruoho
213 1.1 jruoho ACPI_SIZE
214 1.1.1.6 christos strlen (
215 1.1 jruoho const char *String)
216 1.1 jruoho {
217 1.1 jruoho UINT32 Length = 0;
218 1.1 jruoho
219 1.1 jruoho
220 1.1 jruoho /* Count the string until a null is encountered */
221 1.1 jruoho
222 1.1 jruoho while (*String)
223 1.1 jruoho {
224 1.1 jruoho Length++;
225 1.1 jruoho String++;
226 1.1 jruoho }
227 1.1 jruoho
228 1.1 jruoho return (Length);
229 1.1 jruoho }
230 1.1 jruoho
231 1.1 jruoho
232 1.1 jruoho /*******************************************************************************
233 1.1 jruoho *
234 1.1.1.6 christos * FUNCTION: strcpy
235 1.1 jruoho *
236 1.1 jruoho * PARAMETERS: DstString - Target of the copy
237 1.1 jruoho * SrcString - The source string to copy
238 1.1 jruoho *
239 1.1 jruoho * RETURN: DstString
240 1.1 jruoho *
241 1.1 jruoho * DESCRIPTION: Copy a null terminated string
242 1.1 jruoho *
243 1.1 jruoho ******************************************************************************/
244 1.1 jruoho
245 1.1 jruoho char *
246 1.1.1.6 christos strcpy (
247 1.1 jruoho char *DstString,
248 1.1 jruoho const char *SrcString)
249 1.1 jruoho {
250 1.1 jruoho char *String = DstString;
251 1.1 jruoho
252 1.1 jruoho
253 1.1 jruoho /* Move bytes brute force */
254 1.1 jruoho
255 1.1 jruoho while (*SrcString)
256 1.1 jruoho {
257 1.1 jruoho *String = *SrcString;
258 1.1 jruoho
259 1.1 jruoho String++;
260 1.1 jruoho SrcString++;
261 1.1 jruoho }
262 1.1 jruoho
263 1.1 jruoho /* Null terminate */
264 1.1 jruoho
265 1.1 jruoho *String = 0;
266 1.1 jruoho return (DstString);
267 1.1 jruoho }
268 1.1 jruoho
269 1.1 jruoho
270 1.1 jruoho /*******************************************************************************
271 1.1 jruoho *
272 1.1.1.6 christos * FUNCTION: strncpy
273 1.1 jruoho *
274 1.1 jruoho * PARAMETERS: DstString - Target of the copy
275 1.1 jruoho * SrcString - The source string to copy
276 1.1 jruoho * Count - Maximum # of bytes to copy
277 1.1 jruoho *
278 1.1 jruoho * RETURN: DstString
279 1.1 jruoho *
280 1.1 jruoho * DESCRIPTION: Copy a null terminated string, with a maximum length
281 1.1 jruoho *
282 1.1 jruoho ******************************************************************************/
283 1.1 jruoho
284 1.1 jruoho char *
285 1.1.1.6 christos strncpy (
286 1.1 jruoho char *DstString,
287 1.1 jruoho const char *SrcString,
288 1.1 jruoho ACPI_SIZE Count)
289 1.1 jruoho {
290 1.1 jruoho char *String = DstString;
291 1.1 jruoho
292 1.1 jruoho
293 1.1 jruoho /* Copy the string */
294 1.1 jruoho
295 1.1 jruoho for (String = DstString;
296 1.1 jruoho Count && (Count--, (*String++ = *SrcString++)); )
297 1.1 jruoho {;}
298 1.1 jruoho
299 1.1 jruoho /* Pad with nulls if necessary */
300 1.1 jruoho
301 1.1 jruoho while (Count--)
302 1.1 jruoho {
303 1.1 jruoho *String = 0;
304 1.1 jruoho String++;
305 1.1 jruoho }
306 1.1 jruoho
307 1.1 jruoho /* Return original pointer */
308 1.1 jruoho
309 1.1 jruoho return (DstString);
310 1.1 jruoho }
311 1.1 jruoho
312 1.1 jruoho
313 1.1 jruoho /*******************************************************************************
314 1.1 jruoho *
315 1.1.1.6 christos * FUNCTION: strcmp
316 1.1 jruoho *
317 1.1 jruoho * PARAMETERS: String1 - First string
318 1.1 jruoho * String2 - Second string
319 1.1 jruoho *
320 1.1 jruoho * RETURN: Index where strings mismatched, or 0 if strings matched
321 1.1 jruoho *
322 1.1 jruoho * DESCRIPTION: Compare two null terminated strings
323 1.1 jruoho *
324 1.1 jruoho ******************************************************************************/
325 1.1 jruoho
326 1.1 jruoho int
327 1.1.1.6 christos strcmp (
328 1.1 jruoho const char *String1,
329 1.1 jruoho const char *String2)
330 1.1 jruoho {
331 1.1 jruoho
332 1.1 jruoho
333 1.1 jruoho for ( ; (*String1 == *String2); String2++)
334 1.1 jruoho {
335 1.1 jruoho if (!*String1++)
336 1.1 jruoho {
337 1.1 jruoho return (0);
338 1.1 jruoho }
339 1.1 jruoho }
340 1.1 jruoho
341 1.1 jruoho return ((unsigned char) *String1 - (unsigned char) *String2);
342 1.1 jruoho }
343 1.1 jruoho
344 1.1 jruoho
345 1.1 jruoho /*******************************************************************************
346 1.1 jruoho *
347 1.1.1.6 christos * FUNCTION: strchr
348 1.1 jruoho *
349 1.1 jruoho * PARAMETERS: String - Search string
350 1.1 jruoho * ch - character to search for
351 1.1 jruoho *
352 1.1 jruoho * RETURN: Ptr to char or NULL if not found
353 1.1 jruoho *
354 1.1 jruoho * DESCRIPTION: Search a string for a character
355 1.1 jruoho *
356 1.1 jruoho ******************************************************************************/
357 1.1 jruoho
358 1.1 jruoho char *
359 1.1.1.6 christos strchr (
360 1.1 jruoho const char *String,
361 1.1 jruoho int ch)
362 1.1 jruoho {
363 1.1 jruoho
364 1.1 jruoho
365 1.1 jruoho for ( ; (*String); String++)
366 1.1 jruoho {
367 1.1 jruoho if ((*String) == (char) ch)
368 1.1 jruoho {
369 1.1 jruoho return ((char *) String);
370 1.1 jruoho }
371 1.1 jruoho }
372 1.1 jruoho
373 1.1 jruoho return (NULL);
374 1.1 jruoho }
375 1.1.1.4 christos
376 1.1 jruoho
377 1.1 jruoho /*******************************************************************************
378 1.1 jruoho *
379 1.1.1.6 christos * FUNCTION: strncmp
380 1.1 jruoho *
381 1.1 jruoho * PARAMETERS: String1 - First string
382 1.1 jruoho * String2 - Second string
383 1.1 jruoho * Count - Maximum # of bytes to compare
384 1.1 jruoho *
385 1.1 jruoho * RETURN: Index where strings mismatched, or 0 if strings matched
386 1.1 jruoho *
387 1.1 jruoho * DESCRIPTION: Compare two null terminated strings, with a maximum length
388 1.1 jruoho *
389 1.1 jruoho ******************************************************************************/
390 1.1 jruoho
391 1.1 jruoho int
392 1.1.1.6 christos strncmp (
393 1.1 jruoho const char *String1,
394 1.1 jruoho const char *String2,
395 1.1 jruoho ACPI_SIZE Count)
396 1.1 jruoho {
397 1.1 jruoho
398 1.1 jruoho
399 1.1 jruoho for ( ; Count-- && (*String1 == *String2); String2++)
400 1.1 jruoho {
401 1.1 jruoho if (!*String1++)
402 1.1 jruoho {
403 1.1 jruoho return (0);
404 1.1 jruoho }
405 1.1 jruoho }
406 1.1 jruoho
407 1.1 jruoho return ((Count == ACPI_SIZE_MAX) ? 0 : ((unsigned char) *String1 -
408 1.1 jruoho (unsigned char) *String2));
409 1.1 jruoho }
410 1.1 jruoho
411 1.1 jruoho
412 1.1 jruoho /*******************************************************************************
413 1.1 jruoho *
414 1.1.1.6 christos * FUNCTION: strcat
415 1.1 jruoho *
416 1.1 jruoho * PARAMETERS: DstString - Target of the copy
417 1.1 jruoho * SrcString - The source string to copy
418 1.1 jruoho *
419 1.1 jruoho * RETURN: DstString
420 1.1 jruoho *
421 1.1 jruoho * DESCRIPTION: Append a null terminated string to a null terminated string
422 1.1 jruoho *
423 1.1 jruoho ******************************************************************************/
424 1.1 jruoho
425 1.1 jruoho char *
426 1.1.1.6 christos strcat (
427 1.1 jruoho char *DstString,
428 1.1 jruoho const char *SrcString)
429 1.1 jruoho {
430 1.1 jruoho char *String;
431 1.1 jruoho
432 1.1 jruoho
433 1.1 jruoho /* Find end of the destination string */
434 1.1 jruoho
435 1.1 jruoho for (String = DstString; *String++; )
436 1.1 jruoho { ; }
437 1.1 jruoho
438 1.1 jruoho /* Concatenate the string */
439 1.1 jruoho
440 1.1 jruoho for (--String; (*String++ = *SrcString++); )
441 1.1 jruoho { ; }
442 1.1 jruoho
443 1.1 jruoho return (DstString);
444 1.1 jruoho }
445 1.1 jruoho
446 1.1 jruoho
447 1.1 jruoho /*******************************************************************************
448 1.1 jruoho *
449 1.1.1.6 christos * FUNCTION: strncat
450 1.1 jruoho *
451 1.1 jruoho * PARAMETERS: DstString - Target of the copy
452 1.1 jruoho * SrcString - The source string to copy
453 1.1 jruoho * Count - Maximum # of bytes to copy
454 1.1 jruoho *
455 1.1 jruoho * RETURN: DstString
456 1.1 jruoho *
457 1.1 jruoho * DESCRIPTION: Append a null terminated string to a null terminated string,
458 1.1 jruoho * with a maximum count.
459 1.1 jruoho *
460 1.1 jruoho ******************************************************************************/
461 1.1 jruoho
462 1.1 jruoho char *
463 1.1.1.6 christos strncat (
464 1.1 jruoho char *DstString,
465 1.1 jruoho const char *SrcString,
466 1.1 jruoho ACPI_SIZE Count)
467 1.1 jruoho {
468 1.1 jruoho char *String;
469 1.1 jruoho
470 1.1 jruoho
471 1.1 jruoho if (Count)
472 1.1 jruoho {
473 1.1 jruoho /* Find end of the destination string */
474 1.1 jruoho
475 1.1 jruoho for (String = DstString; *String++; )
476 1.1 jruoho { ; }
477 1.1 jruoho
478 1.1 jruoho /* Concatenate the string */
479 1.1 jruoho
480 1.1 jruoho for (--String; (*String++ = *SrcString++) && --Count; )
481 1.1 jruoho { ; }
482 1.1 jruoho
483 1.1 jruoho /* Null terminate if necessary */
484 1.1 jruoho
485 1.1 jruoho if (!Count)
486 1.1 jruoho {
487 1.1 jruoho *String = 0;
488 1.1 jruoho }
489 1.1 jruoho }
490 1.1 jruoho
491 1.1 jruoho return (DstString);
492 1.1 jruoho }
493 1.1 jruoho
494 1.1 jruoho
495 1.1 jruoho /*******************************************************************************
496 1.1 jruoho *
497 1.1.1.6 christos * FUNCTION: strstr
498 1.1 jruoho *
499 1.1 jruoho * PARAMETERS: String1 - Target string
500 1.1 jruoho * String2 - Substring to search for
501 1.1 jruoho *
502 1.1 jruoho * RETURN: Where substring match starts, Null if no match found
503 1.1 jruoho *
504 1.1 jruoho * DESCRIPTION: Checks if String2 occurs in String1. This is not really a
505 1.1 jruoho * full implementation of strstr, only sufficient for command
506 1.1 jruoho * matching
507 1.1 jruoho *
508 1.1 jruoho ******************************************************************************/
509 1.1 jruoho
510 1.1 jruoho char *
511 1.1.1.6 christos strstr (
512 1.1 jruoho char *String1,
513 1.1 jruoho char *String2)
514 1.1 jruoho {
515 1.1.1.5 christos UINT32 Length;
516 1.1 jruoho
517 1.1 jruoho
518 1.1.1.6 christos Length = strlen (String2);
519 1.1.1.5 christos if (!Length)
520 1.1 jruoho {
521 1.1.1.5 christos return (String1);
522 1.1 jruoho }
523 1.1 jruoho
524 1.1.1.6 christos while (strlen (String1) >= Length)
525 1.1 jruoho {
526 1.1.1.6 christos if (memcmp (String1, String2, Length) == 0)
527 1.1 jruoho {
528 1.1.1.5 christos return (String1);
529 1.1 jruoho }
530 1.1.1.5 christos String1++;
531 1.1 jruoho }
532 1.1 jruoho
533 1.1.1.5 christos return (NULL);
534 1.1 jruoho }
535 1.1 jruoho
536 1.1 jruoho
537 1.1 jruoho /*******************************************************************************
538 1.1 jruoho *
539 1.1.1.6 christos * FUNCTION: strtoul
540 1.1 jruoho *
541 1.1 jruoho * PARAMETERS: String - Null terminated string
542 1.1 jruoho * Terminater - Where a pointer to the terminating byte is
543 1.1 jruoho * returned
544 1.1 jruoho * Base - Radix of the string
545 1.1 jruoho *
546 1.1 jruoho * RETURN: Converted value
547 1.1 jruoho *
548 1.1 jruoho * DESCRIPTION: Convert a string into a 32-bit unsigned value.
549 1.1.1.6 christos * Note: use strtoul64 for 64-bit integers.
550 1.1 jruoho *
551 1.1 jruoho ******************************************************************************/
552 1.1 jruoho
553 1.1 jruoho UINT32
554 1.1.1.6 christos strtoul (
555 1.1 jruoho const char *String,
556 1.1 jruoho char **Terminator,
557 1.1 jruoho UINT32 Base)
558 1.1 jruoho {
559 1.1 jruoho UINT32 converted = 0;
560 1.1 jruoho UINT32 index;
561 1.1 jruoho UINT32 sign;
562 1.1 jruoho const char *StringStart;
563 1.1 jruoho UINT32 ReturnValue = 0;
564 1.1 jruoho ACPI_STATUS Status = AE_OK;
565 1.1 jruoho
566 1.1 jruoho
567 1.1 jruoho /*
568 1.1 jruoho * Save the value of the pointer to the buffer's first
569 1.1 jruoho * character, save the current errno value, and then
570 1.1 jruoho * skip over any white space in the buffer:
571 1.1 jruoho */
572 1.1 jruoho StringStart = String;
573 1.1.1.6 christos while (isspace (*String) || *String == '\t')
574 1.1 jruoho {
575 1.1 jruoho ++String;
576 1.1 jruoho }
577 1.1 jruoho
578 1.1 jruoho /*
579 1.1 jruoho * The buffer may contain an optional plus or minus sign.
580 1.1 jruoho * If it does, then skip over it but remember what is was:
581 1.1 jruoho */
582 1.1 jruoho if (*String == '-')
583 1.1 jruoho {
584 1.1.1.6 christos sign = ACPI_SIGN_NEGATIVE;
585 1.1 jruoho ++String;
586 1.1 jruoho }
587 1.1 jruoho else if (*String == '+')
588 1.1 jruoho {
589 1.1 jruoho ++String;
590 1.1.1.6 christos sign = ACPI_SIGN_POSITIVE;
591 1.1 jruoho }
592 1.1 jruoho else
593 1.1 jruoho {
594 1.1.1.6 christos sign = ACPI_SIGN_POSITIVE;
595 1.1 jruoho }
596 1.1 jruoho
597 1.1 jruoho /*
598 1.1 jruoho * If the input parameter Base is zero, then we need to
599 1.1 jruoho * determine if it is octal, decimal, or hexadecimal:
600 1.1 jruoho */
601 1.1 jruoho if (Base == 0)
602 1.1 jruoho {
603 1.1 jruoho if (*String == '0')
604 1.1 jruoho {
605 1.1.1.6 christos if (tolower (*(++String)) == 'x')
606 1.1 jruoho {
607 1.1 jruoho Base = 16;
608 1.1 jruoho ++String;
609 1.1 jruoho }
610 1.1 jruoho else
611 1.1 jruoho {
612 1.1 jruoho Base = 8;
613 1.1 jruoho }
614 1.1 jruoho }
615 1.1 jruoho else
616 1.1 jruoho {
617 1.1 jruoho Base = 10;
618 1.1 jruoho }
619 1.1 jruoho }
620 1.1 jruoho else if (Base < 2 || Base > 36)
621 1.1 jruoho {
622 1.1 jruoho /*
623 1.1 jruoho * The specified Base parameter is not in the domain of
624 1.1 jruoho * this function:
625 1.1 jruoho */
626 1.1 jruoho goto done;
627 1.1 jruoho }
628 1.1 jruoho
629 1.1 jruoho /*
630 1.1 jruoho * For octal and hexadecimal bases, skip over the leading
631 1.1 jruoho * 0 or 0x, if they are present.
632 1.1 jruoho */
633 1.1 jruoho if (Base == 8 && *String == '0')
634 1.1 jruoho {
635 1.1 jruoho String++;
636 1.1 jruoho }
637 1.1 jruoho
638 1.1 jruoho if (Base == 16 &&
639 1.1 jruoho *String == '0' &&
640 1.1.1.6 christos tolower (*(++String)) == 'x')
641 1.1 jruoho {
642 1.1 jruoho String++;
643 1.1 jruoho }
644 1.1 jruoho
645 1.1 jruoho /*
646 1.1 jruoho * Main loop: convert the string to an unsigned long:
647 1.1 jruoho */
648 1.1 jruoho while (*String)
649 1.1 jruoho {
650 1.1.1.6 christos if (isdigit (*String))
651 1.1 jruoho {
652 1.1 jruoho index = (UINT32) ((UINT8) *String - '0');
653 1.1 jruoho }
654 1.1 jruoho else
655 1.1 jruoho {
656 1.1.1.6 christos index = (UINT32) toupper (*String);
657 1.1.1.6 christos if (isupper (index))
658 1.1 jruoho {
659 1.1 jruoho index = index - 'A' + 10;
660 1.1 jruoho }
661 1.1 jruoho else
662 1.1 jruoho {
663 1.1 jruoho goto done;
664 1.1 jruoho }
665 1.1 jruoho }
666 1.1 jruoho
667 1.1 jruoho if (index >= Base)
668 1.1 jruoho {
669 1.1 jruoho goto done;
670 1.1 jruoho }
671 1.1 jruoho
672 1.1 jruoho /*
673 1.1 jruoho * Check to see if value is out of range:
674 1.1 jruoho */
675 1.1 jruoho
676 1.1 jruoho if (ReturnValue > ((ACPI_UINT32_MAX - (UINT32) index) /
677 1.1 jruoho (UINT32) Base))
678 1.1 jruoho {
679 1.1 jruoho Status = AE_ERROR;
680 1.1 jruoho ReturnValue = 0; /* reset */
681 1.1 jruoho }
682 1.1 jruoho else
683 1.1 jruoho {
684 1.1 jruoho ReturnValue *= Base;
685 1.1 jruoho ReturnValue += index;
686 1.1 jruoho converted = 1;
687 1.1 jruoho }
688 1.1 jruoho
689 1.1 jruoho ++String;
690 1.1 jruoho }
691 1.1 jruoho
692 1.1 jruoho done:
693 1.1 jruoho /*
694 1.1 jruoho * If appropriate, update the caller's pointer to the next
695 1.1 jruoho * unconverted character in the buffer.
696 1.1 jruoho */
697 1.1 jruoho if (Terminator)
698 1.1 jruoho {
699 1.1 jruoho if (converted == 0 && ReturnValue == 0 && String != NULL)
700 1.1 jruoho {
701 1.1 jruoho *Terminator = (char *) StringStart;
702 1.1 jruoho }
703 1.1 jruoho else
704 1.1 jruoho {
705 1.1 jruoho *Terminator = (char *) String;
706 1.1 jruoho }
707 1.1 jruoho }
708 1.1 jruoho
709 1.1 jruoho if (Status == AE_ERROR)
710 1.1 jruoho {
711 1.1 jruoho ReturnValue = ACPI_UINT32_MAX;
712 1.1 jruoho }
713 1.1 jruoho
714 1.1 jruoho /*
715 1.1 jruoho * If a minus sign was present, then "the conversion is negated":
716 1.1 jruoho */
717 1.1.1.6 christos if (sign == ACPI_SIGN_NEGATIVE)
718 1.1 jruoho {
719 1.1 jruoho ReturnValue = (ACPI_UINT32_MAX - ReturnValue) + 1;
720 1.1 jruoho }
721 1.1 jruoho
722 1.1 jruoho return (ReturnValue);
723 1.1 jruoho }
724 1.1 jruoho
725 1.1 jruoho
726 1.1 jruoho /*******************************************************************************
727 1.1 jruoho *
728 1.1.1.6 christos * FUNCTION: toupper
729 1.1 jruoho *
730 1.1 jruoho * PARAMETERS: c - Character to convert
731 1.1 jruoho *
732 1.1 jruoho * RETURN: Converted character as an int
733 1.1 jruoho *
734 1.1 jruoho * DESCRIPTION: Convert character to uppercase
735 1.1 jruoho *
736 1.1 jruoho ******************************************************************************/
737 1.1 jruoho
738 1.1 jruoho int
739 1.1.1.6 christos toupper (
740 1.1 jruoho int c)
741 1.1 jruoho {
742 1.1 jruoho
743 1.1.1.6 christos return (islower(c) ? ((c)-0x20) : (c));
744 1.1 jruoho }
745 1.1 jruoho
746 1.1 jruoho
747 1.1 jruoho /*******************************************************************************
748 1.1 jruoho *
749 1.1.1.6 christos * FUNCTION: tolower
750 1.1 jruoho *
751 1.1 jruoho * PARAMETERS: c - Character to convert
752 1.1 jruoho *
753 1.1 jruoho * RETURN: Converted character as an int
754 1.1 jruoho *
755 1.1 jruoho * DESCRIPTION: Convert character to lowercase
756 1.1 jruoho *
757 1.1 jruoho ******************************************************************************/
758 1.1 jruoho
759 1.1 jruoho int
760 1.1.1.6 christos tolower (
761 1.1 jruoho int c)
762 1.1 jruoho {
763 1.1 jruoho
764 1.1.1.6 christos return (isupper(c) ? ((c)+0x20) : (c));
765 1.1 jruoho }
766 1.1 jruoho
767 1.1 jruoho
768 1.1 jruoho /*******************************************************************************
769 1.1 jruoho *
770 1.1.1.6 christos * FUNCTION: is* function array
771 1.1 jruoho *
772 1.1 jruoho * DESCRIPTION: is* functions use the ctype table below
773 1.1 jruoho *
774 1.1 jruoho ******************************************************************************/
775 1.1 jruoho
776 1.1.1.6 christos const UINT8 AcpiGbl_Ctypes[257] = {
777 1.1.1.3 christos _ACPI_CN, /* 0x00 0 NUL */
778 1.1.1.3 christos _ACPI_CN, /* 0x01 1 SOH */
779 1.1.1.3 christos _ACPI_CN, /* 0x02 2 STX */
780 1.1.1.3 christos _ACPI_CN, /* 0x03 3 ETX */
781 1.1.1.3 christos _ACPI_CN, /* 0x04 4 EOT */
782 1.1.1.3 christos _ACPI_CN, /* 0x05 5 ENQ */
783 1.1.1.3 christos _ACPI_CN, /* 0x06 6 ACK */
784 1.1.1.3 christos _ACPI_CN, /* 0x07 7 BEL */
785 1.1.1.3 christos _ACPI_CN, /* 0x08 8 BS */
786 1.1.1.3 christos _ACPI_CN|_ACPI_SP, /* 0x09 9 TAB */
787 1.1.1.3 christos _ACPI_CN|_ACPI_SP, /* 0x0A 10 LF */
788 1.1.1.3 christos _ACPI_CN|_ACPI_SP, /* 0x0B 11 VT */
789 1.1.1.3 christos _ACPI_CN|_ACPI_SP, /* 0x0C 12 FF */
790 1.1.1.3 christos _ACPI_CN|_ACPI_SP, /* 0x0D 13 CR */
791 1.1.1.3 christos _ACPI_CN, /* 0x0E 14 SO */
792 1.1.1.3 christos _ACPI_CN, /* 0x0F 15 SI */
793 1.1.1.3 christos _ACPI_CN, /* 0x10 16 DLE */
794 1.1.1.3 christos _ACPI_CN, /* 0x11 17 DC1 */
795 1.1.1.3 christos _ACPI_CN, /* 0x12 18 DC2 */
796 1.1.1.3 christos _ACPI_CN, /* 0x13 19 DC3 */
797 1.1.1.3 christos _ACPI_CN, /* 0x14 20 DC4 */
798 1.1.1.3 christos _ACPI_CN, /* 0x15 21 NAK */
799 1.1.1.3 christos _ACPI_CN, /* 0x16 22 SYN */
800 1.1.1.3 christos _ACPI_CN, /* 0x17 23 ETB */
801 1.1.1.3 christos _ACPI_CN, /* 0x18 24 CAN */
802 1.1.1.3 christos _ACPI_CN, /* 0x19 25 EM */
803 1.1.1.3 christos _ACPI_CN, /* 0x1A 26 SUB */
804 1.1.1.3 christos _ACPI_CN, /* 0x1B 27 ESC */
805 1.1.1.3 christos _ACPI_CN, /* 0x1C 28 FS */
806 1.1.1.3 christos _ACPI_CN, /* 0x1D 29 GS */
807 1.1.1.3 christos _ACPI_CN, /* 0x1E 30 RS */
808 1.1.1.3 christos _ACPI_CN, /* 0x1F 31 US */
809 1.1.1.3 christos _ACPI_XS|_ACPI_SP, /* 0x20 32 ' ' */
810 1.1.1.3 christos _ACPI_PU, /* 0x21 33 '!' */
811 1.1.1.3 christos _ACPI_PU, /* 0x22 34 '"' */
812 1.1.1.3 christos _ACPI_PU, /* 0x23 35 '#' */
813 1.1.1.3 christos _ACPI_PU, /* 0x24 36 '$' */
814 1.1.1.3 christos _ACPI_PU, /* 0x25 37 '%' */
815 1.1.1.3 christos _ACPI_PU, /* 0x26 38 '&' */
816 1.1.1.3 christos _ACPI_PU, /* 0x27 39 ''' */
817 1.1.1.3 christos _ACPI_PU, /* 0x28 40 '(' */
818 1.1.1.3 christos _ACPI_PU, /* 0x29 41 ')' */
819 1.1.1.3 christos _ACPI_PU, /* 0x2A 42 '*' */
820 1.1.1.3 christos _ACPI_PU, /* 0x2B 43 '+' */
821 1.1.1.3 christos _ACPI_PU, /* 0x2C 44 ',' */
822 1.1.1.3 christos _ACPI_PU, /* 0x2D 45 '-' */
823 1.1.1.3 christos _ACPI_PU, /* 0x2E 46 '.' */
824 1.1.1.3 christos _ACPI_PU, /* 0x2F 47 '/' */
825 1.1.1.3 christos _ACPI_XD|_ACPI_DI, /* 0x30 48 '0' */
826 1.1.1.3 christos _ACPI_XD|_ACPI_DI, /* 0x31 49 '1' */
827 1.1.1.3 christos _ACPI_XD|_ACPI_DI, /* 0x32 50 '2' */
828 1.1.1.3 christos _ACPI_XD|_ACPI_DI, /* 0x33 51 '3' */
829 1.1.1.3 christos _ACPI_XD|_ACPI_DI, /* 0x34 52 '4' */
830 1.1.1.3 christos _ACPI_XD|_ACPI_DI, /* 0x35 53 '5' */
831 1.1.1.3 christos _ACPI_XD|_ACPI_DI, /* 0x36 54 '6' */
832 1.1.1.3 christos _ACPI_XD|_ACPI_DI, /* 0x37 55 '7' */
833 1.1.1.3 christos _ACPI_XD|_ACPI_DI, /* 0x38 56 '8' */
834 1.1.1.3 christos _ACPI_XD|_ACPI_DI, /* 0x39 57 '9' */
835 1.1.1.3 christos _ACPI_PU, /* 0x3A 58 ':' */
836 1.1.1.3 christos _ACPI_PU, /* 0x3B 59 ';' */
837 1.1.1.3 christos _ACPI_PU, /* 0x3C 60 '<' */
838 1.1.1.3 christos _ACPI_PU, /* 0x3D 61 '=' */
839 1.1.1.3 christos _ACPI_PU, /* 0x3E 62 '>' */
840 1.1.1.3 christos _ACPI_PU, /* 0x3F 63 '?' */
841 1.1.1.3 christos _ACPI_PU, /* 0x40 64 '@' */
842 1.1.1.3 christos _ACPI_XD|_ACPI_UP, /* 0x41 65 'A' */
843 1.1.1.3 christos _ACPI_XD|_ACPI_UP, /* 0x42 66 'B' */
844 1.1.1.3 christos _ACPI_XD|_ACPI_UP, /* 0x43 67 'C' */
845 1.1.1.3 christos _ACPI_XD|_ACPI_UP, /* 0x44 68 'D' */
846 1.1.1.3 christos _ACPI_XD|_ACPI_UP, /* 0x45 69 'E' */
847 1.1.1.3 christos _ACPI_XD|_ACPI_UP, /* 0x46 70 'F' */
848 1.1.1.3 christos _ACPI_UP, /* 0x47 71 'G' */
849 1.1.1.3 christos _ACPI_UP, /* 0x48 72 'H' */
850 1.1.1.3 christos _ACPI_UP, /* 0x49 73 'I' */
851 1.1.1.3 christos _ACPI_UP, /* 0x4A 74 'J' */
852 1.1.1.3 christos _ACPI_UP, /* 0x4B 75 'K' */
853 1.1.1.3 christos _ACPI_UP, /* 0x4C 76 'L' */
854 1.1.1.3 christos _ACPI_UP, /* 0x4D 77 'M' */
855 1.1.1.3 christos _ACPI_UP, /* 0x4E 78 'N' */
856 1.1.1.3 christos _ACPI_UP, /* 0x4F 79 'O' */
857 1.1.1.3 christos _ACPI_UP, /* 0x50 80 'P' */
858 1.1.1.3 christos _ACPI_UP, /* 0x51 81 'Q' */
859 1.1.1.3 christos _ACPI_UP, /* 0x52 82 'R' */
860 1.1.1.3 christos _ACPI_UP, /* 0x53 83 'S' */
861 1.1.1.3 christos _ACPI_UP, /* 0x54 84 'T' */
862 1.1.1.3 christos _ACPI_UP, /* 0x55 85 'U' */
863 1.1.1.3 christos _ACPI_UP, /* 0x56 86 'V' */
864 1.1.1.3 christos _ACPI_UP, /* 0x57 87 'W' */
865 1.1.1.3 christos _ACPI_UP, /* 0x58 88 'X' */
866 1.1.1.3 christos _ACPI_UP, /* 0x59 89 'Y' */
867 1.1.1.3 christos _ACPI_UP, /* 0x5A 90 'Z' */
868 1.1.1.3 christos _ACPI_PU, /* 0x5B 91 '[' */
869 1.1.1.3 christos _ACPI_PU, /* 0x5C 92 '\' */
870 1.1.1.3 christos _ACPI_PU, /* 0x5D 93 ']' */
871 1.1.1.3 christos _ACPI_PU, /* 0x5E 94 '^' */
872 1.1.1.3 christos _ACPI_PU, /* 0x5F 95 '_' */
873 1.1.1.3 christos _ACPI_PU, /* 0x60 96 '`' */
874 1.1.1.3 christos _ACPI_XD|_ACPI_LO, /* 0x61 97 'a' */
875 1.1.1.3 christos _ACPI_XD|_ACPI_LO, /* 0x62 98 'b' */
876 1.1.1.3 christos _ACPI_XD|_ACPI_LO, /* 0x63 99 'c' */
877 1.1.1.3 christos _ACPI_XD|_ACPI_LO, /* 0x64 100 'd' */
878 1.1.1.3 christos _ACPI_XD|_ACPI_LO, /* 0x65 101 'e' */
879 1.1.1.3 christos _ACPI_XD|_ACPI_LO, /* 0x66 102 'f' */
880 1.1.1.3 christos _ACPI_LO, /* 0x67 103 'g' */
881 1.1.1.3 christos _ACPI_LO, /* 0x68 104 'h' */
882 1.1.1.3 christos _ACPI_LO, /* 0x69 105 'i' */
883 1.1.1.3 christos _ACPI_LO, /* 0x6A 106 'j' */
884 1.1.1.3 christos _ACPI_LO, /* 0x6B 107 'k' */
885 1.1.1.3 christos _ACPI_LO, /* 0x6C 108 'l' */
886 1.1.1.3 christos _ACPI_LO, /* 0x6D 109 'm' */
887 1.1.1.3 christos _ACPI_LO, /* 0x6E 110 'n' */
888 1.1.1.3 christos _ACPI_LO, /* 0x6F 111 'o' */
889 1.1.1.3 christos _ACPI_LO, /* 0x70 112 'p' */
890 1.1.1.3 christos _ACPI_LO, /* 0x71 113 'q' */
891 1.1.1.3 christos _ACPI_LO, /* 0x72 114 'r' */
892 1.1.1.3 christos _ACPI_LO, /* 0x73 115 's' */
893 1.1.1.3 christos _ACPI_LO, /* 0x74 116 't' */
894 1.1.1.3 christos _ACPI_LO, /* 0x75 117 'u' */
895 1.1.1.3 christos _ACPI_LO, /* 0x76 118 'v' */
896 1.1.1.3 christos _ACPI_LO, /* 0x77 119 'w' */
897 1.1.1.3 christos _ACPI_LO, /* 0x78 120 'x' */
898 1.1.1.3 christos _ACPI_LO, /* 0x79 121 'y' */
899 1.1.1.3 christos _ACPI_LO, /* 0x7A 122 'z' */
900 1.1.1.3 christos _ACPI_PU, /* 0x7B 123 '{' */
901 1.1.1.3 christos _ACPI_PU, /* 0x7C 124 '|' */
902 1.1.1.3 christos _ACPI_PU, /* 0x7D 125 '}' */
903 1.1.1.3 christos _ACPI_PU, /* 0x7E 126 '~' */
904 1.1.1.3 christos _ACPI_CN, /* 0x7F 127 DEL */
905 1.1 jruoho
906 1.1 jruoho 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, /* 0x80 to 0x8F */
907 1.1 jruoho 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, /* 0x90 to 0x9F */
908 1.1 jruoho 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, /* 0xA0 to 0xAF */
909 1.1 jruoho 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, /* 0xB0 to 0xBF */
910 1.1 jruoho 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, /* 0xC0 to 0xCF */
911 1.1 jruoho 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, /* 0xD0 to 0xDF */
912 1.1 jruoho 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, /* 0xE0 to 0xEF */
913 1.1.1.3 christos 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, /* 0xF0 to 0xFF */
914 1.1.1.3 christos 0 /* 0x100 */
915 1.1 jruoho };
916 1.1 jruoho
917 1.1 jruoho
918 1.1 jruoho #endif /* ACPI_USE_SYSTEM_CLIBRARY */
919