uterror.c revision 306536 
1/*******************************************************************************
2 *
3 * Module Name: uterror - Various internal error/warning output functions
4 *
5 ******************************************************************************/
6
7/*
8 * Copyright (C) 2000 - 2016, Intel Corp.
9 * All rights reserved.
10 *
11 * Redistribution and use in source and binary forms, with or without
12 * modification, are permitted provided that the following conditions
13 * are met:
14 * 1. Redistributions of source code must retain the above copyright
15 *    notice, this list of conditions, and the following disclaimer,
16 *    without modification.
17 * 2. Redistributions in binary form must reproduce at minimum a disclaimer
18 *    substantially similar to the "NO WARRANTY" disclaimer below
19 *    ("Disclaimer") and any redistribution must be conditioned upon
20 *    including a substantially similar Disclaimer requirement for further
21 *    binary redistribution.
22 * 3. Neither the names of the above-listed copyright holders nor the names
23 *    of any contributors may be used to endorse or promote products derived
24 *    from this software without specific prior written permission.
25 *
26 * Alternatively, this software may be distributed under the terms of the
27 * GNU General Public License ("GPL") version 2 as published by the Free
28 * Software Foundation.
29 *
30 * NO WARRANTY
31 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
32 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
33 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
34 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
35 * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
36 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
37 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
38 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
39 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
40 * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
41 * POSSIBILITY OF SUCH DAMAGES.
42 */
43
44#include <contrib/dev/acpica/include/acpi.h>
45#include <contrib/dev/acpica/include/accommon.h>
46#include <contrib/dev/acpica/include/acnamesp.h>
47
48
49#define _COMPONENT          ACPI_UTILITIES
50        ACPI_MODULE_NAME    ("uterror")
51
52
53/*
54 * This module contains internal error functions that may
55 * be configured out.
56 */
57#if !defined (ACPI_NO_ERROR_MESSAGES)
58
59/*******************************************************************************
60 *
61 * FUNCTION:    AcpiUtPredefinedWarning
62 *
63 * PARAMETERS:  ModuleName      - Caller's module name (for error output)
64 *              LineNumber      - Caller's line number (for error output)
65 *              Pathname        - Full pathname to the node
66 *              NodeFlags       - From Namespace node for the method/object
67 *              Format          - Printf format string + additional args
68 *
69 * RETURN:      None
70 *
71 * DESCRIPTION: Warnings for the predefined validation module. Messages are
72 *              only emitted the first time a problem with a particular
73 *              method/object is detected. This prevents a flood of error
74 *              messages for methods that are repeatedly evaluated.
75 *
76 ******************************************************************************/
77
78void ACPI_INTERNAL_VAR_XFACE
79AcpiUtPredefinedWarning (
80    const char              *ModuleName,
81    UINT32                  LineNumber,
82    char                    *Pathname,
83    UINT8                   NodeFlags,
84    const char              *Format,
85    ...)
86{
87    va_list                 ArgList;
88
89
90    /*
91     * Warning messages for this method/object will be disabled after the
92     * first time a validation fails or an object is successfully repaired.
93     */
94    if (NodeFlags & ANOBJ_EVALUATED)
95    {
96        return;
97    }
98
99    AcpiOsPrintf (ACPI_MSG_WARNING "%s: ", Pathname);
100
101    va_start (ArgList, Format);
102    AcpiOsVprintf (Format, ArgList);
103    ACPI_MSG_SUFFIX;
104    va_end (ArgList);
105}
106
107
108/*******************************************************************************
109 *
110 * FUNCTION:    AcpiUtPredefinedInfo
111 *
112 * PARAMETERS:  ModuleName      - Caller's module name (for error output)
113 *              LineNumber      - Caller's line number (for error output)
114 *              Pathname        - Full pathname to the node
115 *              NodeFlags       - From Namespace node for the method/object
116 *              Format          - Printf format string + additional args
117 *
118 * RETURN:      None
119 *
120 * DESCRIPTION: Info messages for the predefined validation module. Messages
121 *              are only emitted the first time a problem with a particular
122 *              method/object is detected. This prevents a flood of
123 *              messages for methods that are repeatedly evaluated.
124 *
125 ******************************************************************************/
126
127void ACPI_INTERNAL_VAR_XFACE
128AcpiUtPredefinedInfo (
129    const char              *ModuleName,
130    UINT32                  LineNumber,
131    char                    *Pathname,
132    UINT8                   NodeFlags,
133    const char              *Format,
134    ...)
135{
136    va_list                 ArgList;
137
138
139    /*
140     * Warning messages for this method/object will be disabled after the
141     * first time a validation fails or an object is successfully repaired.
142     */
143    if (NodeFlags & ANOBJ_EVALUATED)
144    {
145        return;
146    }
147
148    AcpiOsPrintf (ACPI_MSG_INFO "%s: ", Pathname);
149
150    va_start (ArgList, Format);
151    AcpiOsVprintf (Format, ArgList);
152    ACPI_MSG_SUFFIX;
153    va_end (ArgList);
154}
155
156
157/*******************************************************************************
158 *
159 * FUNCTION:    AcpiUtPredefinedBiosError
160 *
161 * PARAMETERS:  ModuleName      - Caller's module name (for error output)
162 *              LineNumber      - Caller's line number (for error output)
163 *              Pathname        - Full pathname to the node
164 *              NodeFlags       - From Namespace node for the method/object
165 *              Format          - Printf format string + additional args
166 *
167 * RETURN:      None
168 *
169 * DESCRIPTION: BIOS error message for predefined names. Messages
170 *              are only emitted the first time a problem with a particular
171 *              method/object is detected. This prevents a flood of
172 *              messages for methods that are repeatedly evaluated.
173 *
174 ******************************************************************************/
175
176void ACPI_INTERNAL_VAR_XFACE
177AcpiUtPredefinedBiosError (
178    const char              *ModuleName,
179    UINT32                  LineNumber,
180    char                    *Pathname,
181    UINT8                   NodeFlags,
182    const char              *Format,
183    ...)
184{
185    va_list                 ArgList;
186
187
188    /*
189     * Warning messages for this method/object will be disabled after the
190     * first time a validation fails or an object is successfully repaired.
191     */
192    if (NodeFlags & ANOBJ_EVALUATED)
193    {
194        return;
195    }
196
197    AcpiOsPrintf (ACPI_MSG_BIOS_ERROR "%s: ", Pathname);
198
199    va_start (ArgList, Format);
200    AcpiOsVprintf (Format, ArgList);
201    ACPI_MSG_SUFFIX;
202    va_end (ArgList);
203}
204
205
206/*******************************************************************************
207 *
208 * FUNCTION:    AcpiUtNamespaceError
209 *
210 * PARAMETERS:  ModuleName          - Caller's module name (for error output)
211 *              LineNumber          - Caller's line number (for error output)
212 *              InternalName        - Name or path of the namespace node
213 *              LookupStatus        - Exception code from NS lookup
214 *
215 * RETURN:      None
216 *
217 * DESCRIPTION: Print error message with the full pathname for the NS node.
218 *
219 ******************************************************************************/
220
221void
222AcpiUtNamespaceError (
223    const char              *ModuleName,
224    UINT32                  LineNumber,
225    const char              *InternalName,
226    ACPI_STATUS             LookupStatus)
227{
228    ACPI_STATUS             Status;
229    UINT32                  BadName;
230    char                    *Name = NULL;
231
232
233    ACPI_MSG_REDIRECT_BEGIN;
234    AcpiOsPrintf (ACPI_MSG_ERROR);
235
236    if (LookupStatus == AE_BAD_CHARACTER)
237    {
238        /* There is a non-ascii character in the name */
239
240        ACPI_MOVE_32_TO_32 (&BadName, ACPI_CAST_PTR (UINT32, InternalName));
241        AcpiOsPrintf ("[0x%.8X] (NON-ASCII)", BadName);
242    }
243    else
244    {
245        /* Convert path to external format */
246
247        Status = AcpiNsExternalizeName (
248            ACPI_UINT32_MAX, InternalName, NULL, &Name);
249
250        /* Print target name */
251
252        if (ACPI_SUCCESS (Status))
253        {
254            AcpiOsPrintf ("[%s]", Name);
255        }
256        else
257        {
258            AcpiOsPrintf ("[COULD NOT EXTERNALIZE NAME]");
259        }
260
261        if (Name)
262        {
263            ACPI_FREE (Name);
264        }
265    }
266
267    AcpiOsPrintf (" Namespace lookup failure, %s",
268        AcpiFormatException (LookupStatus));
269
270    ACPI_MSG_SUFFIX;
271    ACPI_MSG_REDIRECT_END;
272}
273
274
275/*******************************************************************************
276 *
277 * FUNCTION:    AcpiUtMethodError
278 *
279 * PARAMETERS:  ModuleName          - Caller's module name (for error output)
280 *              LineNumber          - Caller's line number (for error output)
281 *              Message             - Error message to use on failure
282 *              PrefixNode          - Prefix relative to the path
283 *              Path                - Path to the node (optional)
284 *              MethodStatus        - Execution status
285 *
286 * RETURN:      None
287 *
288 * DESCRIPTION: Print error message with the full pathname for the method.
289 *
290 ******************************************************************************/
291
292void
293AcpiUtMethodError (
294    const char              *ModuleName,
295    UINT32                  LineNumber,
296    const char              *Message,
297    ACPI_NAMESPACE_NODE     *PrefixNode,
298    const char              *Path,
299    ACPI_STATUS             MethodStatus)
300{
301    ACPI_STATUS             Status;
302    ACPI_NAMESPACE_NODE     *Node = PrefixNode;
303
304
305    ACPI_MSG_REDIRECT_BEGIN;
306    AcpiOsPrintf (ACPI_MSG_ERROR);
307
308    if (Path)
309    {
310        Status = AcpiNsGetNode (PrefixNode, Path,
311            ACPI_NS_NO_UPSEARCH, &Node);
312        if (ACPI_FAILURE (Status))
313        {
314            AcpiOsPrintf ("[Could not get node by pathname]");
315        }
316    }
317
318    AcpiNsPrintNodePathname (Node, Message);
319    AcpiOsPrintf (", %s", AcpiFormatException (MethodStatus));
320
321    ACPI_MSG_SUFFIX;
322    ACPI_MSG_REDIRECT_END;
323}
324
325#endif /* ACPI_NO_ERROR_MESSAGES */
326