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 "acpi.h"
45 #include "accommon.h"
46 #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 
78 void ACPI_INTERNAL_VAR_XFACE
79 AcpiUtPredefinedWarning (
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 
127 void ACPI_INTERNAL_VAR_XFACE
128 AcpiUtPredefinedInfo (
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 
176 void ACPI_INTERNAL_VAR_XFACE
177 AcpiUtPredefinedBiosError (
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 
221 void
222 AcpiUtNamespaceError (
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 
292 void
293 AcpiUtMethodError (
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