1450d6964Smyers /*******************************************************************************
2450d6964Smyers *
3450d6964Smyers * Module Name: utstate - state object support procedures
4450d6964Smyers *
5450d6964Smyers ******************************************************************************/
6450d6964Smyers
7*35786f68SRobert Mustacchi /******************************************************************************
8*35786f68SRobert Mustacchi *
9*35786f68SRobert Mustacchi * 1. Copyright Notice
10*35786f68SRobert Mustacchi *
11*35786f68SRobert Mustacchi * Some or all of this work - Copyright (c) 1999 - 2018, Intel Corp.
12450d6964Smyers * All rights reserved.
13450d6964Smyers *
14*35786f68SRobert Mustacchi * 2. License
15*35786f68SRobert Mustacchi *
16*35786f68SRobert Mustacchi * 2.1. This is your license from Intel Corp. under its intellectual property
17*35786f68SRobert Mustacchi * rights. You may have additional license terms from the party that provided
18*35786f68SRobert Mustacchi * you this software, covering your right to use that party's intellectual
19*35786f68SRobert Mustacchi * property rights.
20*35786f68SRobert Mustacchi *
21*35786f68SRobert Mustacchi * 2.2. Intel grants, free of charge, to any person ("Licensee") obtaining a
22*35786f68SRobert Mustacchi * copy of the source code appearing in this file ("Covered Code") an
23*35786f68SRobert Mustacchi * irrevocable, perpetual, worldwide license under Intel's copyrights in the
24*35786f68SRobert Mustacchi * base code distributed originally by Intel ("Original Intel Code") to copy,
25*35786f68SRobert Mustacchi * make derivatives, distribute, use and display any portion of the Covered
26*35786f68SRobert Mustacchi * Code in any form, with the right to sublicense such rights; and
27*35786f68SRobert Mustacchi *
28*35786f68SRobert Mustacchi * 2.3. Intel grants Licensee a non-exclusive and non-transferable patent
29*35786f68SRobert Mustacchi * license (with the right to sublicense), under only those claims of Intel
30*35786f68SRobert Mustacchi * patents that are infringed by the Original Intel Code, to make, use, sell,
31*35786f68SRobert Mustacchi * offer to sell, and import the Covered Code and derivative works thereof
32*35786f68SRobert Mustacchi * solely to the minimum extent necessary to exercise the above copyright
33*35786f68SRobert Mustacchi * license, and in no event shall the patent license extend to any additions
34*35786f68SRobert Mustacchi * to or modifications of the Original Intel Code. No other license or right
35*35786f68SRobert Mustacchi * is granted directly or by implication, estoppel or otherwise;
36*35786f68SRobert Mustacchi *
37*35786f68SRobert Mustacchi * The above copyright and patent license is granted only if the following
38*35786f68SRobert Mustacchi * conditions are met:
39*35786f68SRobert Mustacchi *
40*35786f68SRobert Mustacchi * 3. Conditions
41*35786f68SRobert Mustacchi *
42*35786f68SRobert Mustacchi * 3.1. Redistribution of Source with Rights to Further Distribute Source.
43*35786f68SRobert Mustacchi * Redistribution of source code of any substantial portion of the Covered
44*35786f68SRobert Mustacchi * Code or modification with rights to further distribute source must include
45*35786f68SRobert Mustacchi * the above Copyright Notice, the above License, this list of Conditions,
46*35786f68SRobert Mustacchi * and the following Disclaimer and Export Compliance provision. In addition,
47*35786f68SRobert Mustacchi * Licensee must cause all Covered Code to which Licensee contributes to
48*35786f68SRobert Mustacchi * contain a file documenting the changes Licensee made to create that Covered
49*35786f68SRobert Mustacchi * Code and the date of any change. Licensee must include in that file the
50*35786f68SRobert Mustacchi * documentation of any changes made by any predecessor Licensee. Licensee
51*35786f68SRobert Mustacchi * must include a prominent statement that the modification is derived,
52*35786f68SRobert Mustacchi * directly or indirectly, from Original Intel Code.
53*35786f68SRobert Mustacchi *
54*35786f68SRobert Mustacchi * 3.2. Redistribution of Source with no Rights to Further Distribute Source.
55*35786f68SRobert Mustacchi * Redistribution of source code of any substantial portion of the Covered
56*35786f68SRobert Mustacchi * Code or modification without rights to further distribute source must
57*35786f68SRobert Mustacchi * include the following Disclaimer and Export Compliance provision in the
58*35786f68SRobert Mustacchi * documentation and/or other materials provided with distribution. In
59*35786f68SRobert Mustacchi * addition, Licensee may not authorize further sublicense of source of any
60*35786f68SRobert Mustacchi * portion of the Covered Code, and must include terms to the effect that the
61*35786f68SRobert Mustacchi * license from Licensee to its licensee is limited to the intellectual
62*35786f68SRobert Mustacchi * property embodied in the software Licensee provides to its licensee, and
63*35786f68SRobert Mustacchi * not to intellectual property embodied in modifications its licensee may
64*35786f68SRobert Mustacchi * make.
65*35786f68SRobert Mustacchi *
66*35786f68SRobert Mustacchi * 3.3. Redistribution of Executable. Redistribution in executable form of any
67*35786f68SRobert Mustacchi * substantial portion of the Covered Code or modification must reproduce the
68*35786f68SRobert Mustacchi * above Copyright Notice, and the following Disclaimer and Export Compliance
69*35786f68SRobert Mustacchi * provision in the documentation and/or other materials provided with the
70*35786f68SRobert Mustacchi * distribution.
71*35786f68SRobert Mustacchi *
72*35786f68SRobert Mustacchi * 3.4. Intel retains all right, title, and interest in and to the Original
73*35786f68SRobert Mustacchi * Intel Code.
74*35786f68SRobert Mustacchi *
75*35786f68SRobert Mustacchi * 3.5. Neither the name Intel nor any other trademark owned or controlled by
76*35786f68SRobert Mustacchi * Intel shall be used in advertising or otherwise to promote the sale, use or
77*35786f68SRobert Mustacchi * other dealings in products derived from or relating to the Covered Code
78*35786f68SRobert Mustacchi * without prior written authorization from Intel.
79*35786f68SRobert Mustacchi *
80*35786f68SRobert Mustacchi * 4. Disclaimer and Export Compliance
81*35786f68SRobert Mustacchi *
82*35786f68SRobert Mustacchi * 4.1. INTEL MAKES NO WARRANTY OF ANY KIND REGARDING ANY SOFTWARE PROVIDED
83*35786f68SRobert Mustacchi * HERE. ANY SOFTWARE ORIGINATING FROM INTEL OR DERIVED FROM INTEL SOFTWARE
84*35786f68SRobert Mustacchi * IS PROVIDED "AS IS," AND INTEL WILL NOT PROVIDE ANY SUPPORT, ASSISTANCE,
85*35786f68SRobert Mustacchi * INSTALLATION, TRAINING OR OTHER SERVICES. INTEL WILL NOT PROVIDE ANY
86*35786f68SRobert Mustacchi * UPDATES, ENHANCEMENTS OR EXTENSIONS. INTEL SPECIFICALLY DISCLAIMS ANY
87*35786f68SRobert Mustacchi * IMPLIED WARRANTIES OF MERCHANTABILITY, NONINFRINGEMENT AND FITNESS FOR A
88*35786f68SRobert Mustacchi * PARTICULAR PURPOSE.
89*35786f68SRobert Mustacchi *
90*35786f68SRobert Mustacchi * 4.2. IN NO EVENT SHALL INTEL HAVE ANY LIABILITY TO LICENSEE, ITS LICENSEES
91*35786f68SRobert Mustacchi * OR ANY OTHER THIRD PARTY, FOR ANY LOST PROFITS, LOST DATA, LOSS OF USE OR
92*35786f68SRobert Mustacchi * COSTS OF PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES, OR FOR ANY INDIRECT,
93*35786f68SRobert Mustacchi * SPECIAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THIS AGREEMENT, UNDER ANY
94*35786f68SRobert Mustacchi * CAUSE OF ACTION OR THEORY OF LIABILITY, AND IRRESPECTIVE OF WHETHER INTEL
95*35786f68SRobert Mustacchi * HAS ADVANCE NOTICE OF THE POSSIBILITY OF SUCH DAMAGES. THESE LIMITATIONS
96*35786f68SRobert Mustacchi * SHALL APPLY NOTWITHSTANDING THE FAILURE OF THE ESSENTIAL PURPOSE OF ANY
97*35786f68SRobert Mustacchi * LIMITED REMEDY.
98*35786f68SRobert Mustacchi *
99*35786f68SRobert Mustacchi * 4.3. Licensee shall not export, either directly or indirectly, any of this
100*35786f68SRobert Mustacchi * software or system incorporating such software without first obtaining any
101*35786f68SRobert Mustacchi * required license or other approval from the U. S. Department of Commerce or
102*35786f68SRobert Mustacchi * any other agency or department of the United States Government. In the
103*35786f68SRobert Mustacchi * event Licensee exports any such software from the United States or
104*35786f68SRobert Mustacchi * re-exports any such software from a foreign destination, Licensee shall
105*35786f68SRobert Mustacchi * ensure that the distribution and export/re-export of the software is in
106*35786f68SRobert Mustacchi * compliance with all laws, regulations, orders, or other restrictions of the
107*35786f68SRobert Mustacchi * U.S. Export Administration Regulations. Licensee agrees that neither it nor
108*35786f68SRobert Mustacchi * any of its subsidiaries will export/re-export any technical data, process,
109*35786f68SRobert Mustacchi * software, or service, directly or indirectly, to any country for which the
110*35786f68SRobert Mustacchi * United States government or any agency thereof requires an export license,
111*35786f68SRobert Mustacchi * other governmental approval, or letter of assurance, without first obtaining
112*35786f68SRobert Mustacchi * such license, approval or letter.
113*35786f68SRobert Mustacchi *
114*35786f68SRobert Mustacchi *****************************************************************************
115*35786f68SRobert Mustacchi *
116*35786f68SRobert Mustacchi * Alternatively, you may choose to be licensed under the terms of the
117*35786f68SRobert Mustacchi * following license:
118*35786f68SRobert Mustacchi *
11926f3cdf0SGordon Ross * Redistribution and use in source and binary forms, with or without
12026f3cdf0SGordon Ross * modification, are permitted provided that the following conditions
12126f3cdf0SGordon Ross * are met:
12226f3cdf0SGordon Ross * 1. Redistributions of source code must retain the above copyright
12326f3cdf0SGordon Ross * notice, this list of conditions, and the following disclaimer,
12426f3cdf0SGordon Ross * without modification.
12526f3cdf0SGordon Ross * 2. Redistributions in binary form must reproduce at minimum a disclaimer
12626f3cdf0SGordon Ross * substantially similar to the "NO WARRANTY" disclaimer below
12726f3cdf0SGordon Ross * ("Disclaimer") and any redistribution must be conditioned upon
12826f3cdf0SGordon Ross * including a substantially similar Disclaimer requirement for further
12926f3cdf0SGordon Ross * binary redistribution.
13026f3cdf0SGordon Ross * 3. Neither the names of the above-listed copyright holders nor the names
13126f3cdf0SGordon Ross * of any contributors may be used to endorse or promote products derived
13226f3cdf0SGordon Ross * from this software without specific prior written permission.
13326f3cdf0SGordon Ross *
13426f3cdf0SGordon Ross * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
13526f3cdf0SGordon Ross * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
136*35786f68SRobert Mustacchi * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
13726f3cdf0SGordon Ross * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
138*35786f68SRobert Mustacchi * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
139*35786f68SRobert Mustacchi * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
140*35786f68SRobert Mustacchi * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
141*35786f68SRobert Mustacchi * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
142*35786f68SRobert Mustacchi * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
143*35786f68SRobert Mustacchi * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
144*35786f68SRobert Mustacchi * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
145*35786f68SRobert Mustacchi *
146*35786f68SRobert Mustacchi * Alternatively, you may choose to be licensed under the terms of the
147*35786f68SRobert Mustacchi * GNU General Public License ("GPL") version 2 as published by the Free
148*35786f68SRobert Mustacchi * Software Foundation.
149*35786f68SRobert Mustacchi *
150*35786f68SRobert Mustacchi *****************************************************************************/
151450d6964Smyers
152450d6964Smyers #include "acpi.h"
153aa2aa9a6SDana Myers #include "accommon.h"
154450d6964Smyers
155450d6964Smyers #define _COMPONENT ACPI_UTILITIES
156450d6964Smyers ACPI_MODULE_NAME ("utstate")
157450d6964Smyers
158450d6964Smyers
159450d6964Smyers /*******************************************************************************
160450d6964Smyers *
161450d6964Smyers * FUNCTION: AcpiUtPushGenericState
162450d6964Smyers *
163450d6964Smyers * PARAMETERS: ListHead - Head of the state stack
164450d6964Smyers * State - State object to push
165450d6964Smyers *
166450d6964Smyers * RETURN: None
167450d6964Smyers *
168450d6964Smyers * DESCRIPTION: Push a state object onto a state stack
169450d6964Smyers *
170450d6964Smyers ******************************************************************************/
171450d6964Smyers
172450d6964Smyers void
AcpiUtPushGenericState(ACPI_GENERIC_STATE ** ListHead,ACPI_GENERIC_STATE * State)173450d6964Smyers AcpiUtPushGenericState (
174450d6964Smyers ACPI_GENERIC_STATE **ListHead,
175450d6964Smyers ACPI_GENERIC_STATE *State)
176450d6964Smyers {
1777b1019a6SJerry Jelinek ACPI_FUNCTION_ENTRY ();
178450d6964Smyers
179450d6964Smyers
180450d6964Smyers /* Push the state object onto the front of the list (stack) */
181450d6964Smyers
182450d6964Smyers State->Common.Next = *ListHead;
183450d6964Smyers *ListHead = State;
1847b1019a6SJerry Jelinek return;
185450d6964Smyers }
186450d6964Smyers
187450d6964Smyers
188450d6964Smyers /*******************************************************************************
189450d6964Smyers *
190450d6964Smyers * FUNCTION: AcpiUtPopGenericState
191450d6964Smyers *
192450d6964Smyers * PARAMETERS: ListHead - Head of the state stack
193450d6964Smyers *
194450d6964Smyers * RETURN: The popped state object
195450d6964Smyers *
196450d6964Smyers * DESCRIPTION: Pop a state object from a state stack
197450d6964Smyers *
198450d6964Smyers ******************************************************************************/
199450d6964Smyers
200450d6964Smyers ACPI_GENERIC_STATE *
AcpiUtPopGenericState(ACPI_GENERIC_STATE ** ListHead)201450d6964Smyers AcpiUtPopGenericState (
202450d6964Smyers ACPI_GENERIC_STATE **ListHead)
203450d6964Smyers {
204450d6964Smyers ACPI_GENERIC_STATE *State;
205450d6964Smyers
206450d6964Smyers
2077b1019a6SJerry Jelinek ACPI_FUNCTION_ENTRY ();
208450d6964Smyers
209450d6964Smyers
210450d6964Smyers /* Remove the state object at the head of the list (stack) */
211450d6964Smyers
212450d6964Smyers State = *ListHead;
213450d6964Smyers if (State)
214450d6964Smyers {
215450d6964Smyers /* Update the list head */
216450d6964Smyers
217450d6964Smyers *ListHead = State->Common.Next;
218450d6964Smyers }
219450d6964Smyers
2207b1019a6SJerry Jelinek return (State);
221450d6964Smyers }
222450d6964Smyers
223450d6964Smyers
224450d6964Smyers /*******************************************************************************
225450d6964Smyers *
226450d6964Smyers * FUNCTION: AcpiUtCreateGenericState
227450d6964Smyers *
228450d6964Smyers * PARAMETERS: None
229450d6964Smyers *
230450d6964Smyers * RETURN: The new state object. NULL on failure.
231450d6964Smyers *
2327b1019a6SJerry Jelinek * DESCRIPTION: Create a generic state object. Attempt to obtain one from
233450d6964Smyers * the global state cache; If none available, create a new one.
234450d6964Smyers *
235450d6964Smyers ******************************************************************************/
236450d6964Smyers
237450d6964Smyers ACPI_GENERIC_STATE *
AcpiUtCreateGenericState(void)238450d6964Smyers AcpiUtCreateGenericState (
239450d6964Smyers void)
240450d6964Smyers {
241450d6964Smyers ACPI_GENERIC_STATE *State;
242450d6964Smyers
243450d6964Smyers
244450d6964Smyers ACPI_FUNCTION_ENTRY ();
245450d6964Smyers
246450d6964Smyers
247450d6964Smyers State = AcpiOsAcquireObject (AcpiGbl_StateCache);
248450d6964Smyers if (State)
249450d6964Smyers {
250450d6964Smyers /* Initialize */
25127f7c583Smyers State->Common.DescriptorType = ACPI_DESC_TYPE_STATE;
252450d6964Smyers }
253450d6964Smyers
254450d6964Smyers return (State);
255450d6964Smyers }
256450d6964Smyers
257450d6964Smyers
258450d6964Smyers /*******************************************************************************
259450d6964Smyers *
260450d6964Smyers * FUNCTION: AcpiUtCreateThreadState
261450d6964Smyers *
262450d6964Smyers * PARAMETERS: None
263450d6964Smyers *
264450d6964Smyers * RETURN: New Thread State. NULL on failure
265450d6964Smyers *
266450d6964Smyers * DESCRIPTION: Create a "Thread State" - a flavor of the generic state used
267450d6964Smyers * to track per-thread info during method execution
268450d6964Smyers *
269450d6964Smyers ******************************************************************************/
270450d6964Smyers
271450d6964Smyers ACPI_THREAD_STATE *
AcpiUtCreateThreadState(void)272450d6964Smyers AcpiUtCreateThreadState (
273450d6964Smyers void)
274450d6964Smyers {
275450d6964Smyers ACPI_GENERIC_STATE *State;
276450d6964Smyers
277450d6964Smyers
2787b1019a6SJerry Jelinek ACPI_FUNCTION_ENTRY ();
279450d6964Smyers
280450d6964Smyers
281450d6964Smyers /* Create the generic state object */
282450d6964Smyers
283450d6964Smyers State = AcpiUtCreateGenericState ();
284450d6964Smyers if (!State)
285450d6964Smyers {
2867b1019a6SJerry Jelinek return (NULL);
287450d6964Smyers }
288450d6964Smyers
289450d6964Smyers /* Init fields specific to the update struct */
290450d6964Smyers
29127f7c583Smyers State->Common.DescriptorType = ACPI_DESC_TYPE_STATE_THREAD;
292450d6964Smyers State->Thread.ThreadId = AcpiOsGetThreadId ();
293450d6964Smyers
29427f7c583Smyers /* Check for invalid thread ID - zero is very bad, it will break things */
29527f7c583Smyers
29627f7c583Smyers if (!State->Thread.ThreadId)
29727f7c583Smyers {
29827f7c583Smyers ACPI_ERROR ((AE_INFO, "Invalid zero ID from AcpiOsGetThreadId"));
299aa2aa9a6SDana Myers State->Thread.ThreadId = (ACPI_THREAD_ID) 1;
30027f7c583Smyers }
30127f7c583Smyers
3027b1019a6SJerry Jelinek return ((ACPI_THREAD_STATE *) State);
303450d6964Smyers }
304450d6964Smyers
305450d6964Smyers
306450d6964Smyers /*******************************************************************************
307450d6964Smyers *
308450d6964Smyers * FUNCTION: AcpiUtCreateUpdateState
309450d6964Smyers *
310450d6964Smyers * PARAMETERS: Object - Initial Object to be installed in the state
311450d6964Smyers * Action - Update action to be performed
312450d6964Smyers *
313450d6964Smyers * RETURN: New state object, null on failure
314450d6964Smyers *
315450d6964Smyers * DESCRIPTION: Create an "Update State" - a flavor of the generic state used
316450d6964Smyers * to update reference counts and delete complex objects such
317450d6964Smyers * as packages.
318450d6964Smyers *
319450d6964Smyers ******************************************************************************/
320450d6964Smyers
321450d6964Smyers ACPI_GENERIC_STATE *
AcpiUtCreateUpdateState(ACPI_OPERAND_OBJECT * Object,UINT16 Action)322450d6964Smyers AcpiUtCreateUpdateState (
323450d6964Smyers ACPI_OPERAND_OBJECT *Object,
324450d6964Smyers UINT16 Action)
325450d6964Smyers {
326450d6964Smyers ACPI_GENERIC_STATE *State;
327450d6964Smyers
328450d6964Smyers
3297b1019a6SJerry Jelinek ACPI_FUNCTION_ENTRY ();
330450d6964Smyers
331450d6964Smyers
332450d6964Smyers /* Create the generic state object */
333450d6964Smyers
334450d6964Smyers State = AcpiUtCreateGenericState ();
335450d6964Smyers if (!State)
336450d6964Smyers {
3377b1019a6SJerry Jelinek return (NULL);
338450d6964Smyers }
339450d6964Smyers
340450d6964Smyers /* Init fields specific to the update struct */
341450d6964Smyers
34227f7c583Smyers State->Common.DescriptorType = ACPI_DESC_TYPE_STATE_UPDATE;
343450d6964Smyers State->Update.Object = Object;
34427f7c583Smyers State->Update.Value = Action;
3457b1019a6SJerry Jelinek return (State);
346450d6964Smyers }
347450d6964Smyers
348450d6964Smyers
349450d6964Smyers /*******************************************************************************
350450d6964Smyers *
351450d6964Smyers * FUNCTION: AcpiUtCreatePkgState
352450d6964Smyers *
353450d6964Smyers * PARAMETERS: Object - Initial Object to be installed in the state
354450d6964Smyers * Action - Update action to be performed
355450d6964Smyers *
356450d6964Smyers * RETURN: New state object, null on failure
357450d6964Smyers *
358450d6964Smyers * DESCRIPTION: Create a "Package State"
359450d6964Smyers *
360450d6964Smyers ******************************************************************************/
361450d6964Smyers
362450d6964Smyers ACPI_GENERIC_STATE *
AcpiUtCreatePkgState(void * InternalObject,void * ExternalObject,UINT32 Index)363450d6964Smyers AcpiUtCreatePkgState (
364450d6964Smyers void *InternalObject,
365450d6964Smyers void *ExternalObject,
366*35786f68SRobert Mustacchi UINT32 Index)
367450d6964Smyers {
368450d6964Smyers ACPI_GENERIC_STATE *State;
369450d6964Smyers
370450d6964Smyers
3717b1019a6SJerry Jelinek ACPI_FUNCTION_ENTRY ();
372450d6964Smyers
373450d6964Smyers
374450d6964Smyers /* Create the generic state object */
375450d6964Smyers
376450d6964Smyers State = AcpiUtCreateGenericState ();
377450d6964Smyers if (!State)
378450d6964Smyers {
3797b1019a6SJerry Jelinek return (NULL);
380450d6964Smyers }
381450d6964Smyers
382450d6964Smyers /* Init fields specific to the update struct */
383450d6964Smyers
38427f7c583Smyers State->Common.DescriptorType = ACPI_DESC_TYPE_STATE_PACKAGE;
385450d6964Smyers State->Pkg.SourceObject = (ACPI_OPERAND_OBJECT *) InternalObject;
38627f7c583Smyers State->Pkg.DestObject = ExternalObject;
38727f7c583Smyers State->Pkg.Index= Index;
38827f7c583Smyers State->Pkg.NumPackages = 1;
389450d6964Smyers
3907b1019a6SJerry Jelinek return (State);
391450d6964Smyers }
392450d6964Smyers
393450d6964Smyers
394450d6964Smyers /*******************************************************************************
395450d6964Smyers *
396450d6964Smyers * FUNCTION: AcpiUtCreateControlState
397450d6964Smyers *
398450d6964Smyers * PARAMETERS: None
399450d6964Smyers *
400450d6964Smyers * RETURN: New state object, null on failure
401450d6964Smyers *
402450d6964Smyers * DESCRIPTION: Create a "Control State" - a flavor of the generic state used
403450d6964Smyers * to support nested IF/WHILE constructs in the AML.
404450d6964Smyers *
405450d6964Smyers ******************************************************************************/
406450d6964Smyers
407450d6964Smyers ACPI_GENERIC_STATE *
AcpiUtCreateControlState(void)408450d6964Smyers AcpiUtCreateControlState (
409450d6964Smyers void)
410450d6964Smyers {
411450d6964Smyers ACPI_GENERIC_STATE *State;
412450d6964Smyers
413450d6964Smyers
4147b1019a6SJerry Jelinek ACPI_FUNCTION_ENTRY ();
415450d6964Smyers
416450d6964Smyers
417450d6964Smyers /* Create the generic state object */
418450d6964Smyers
419450d6964Smyers State = AcpiUtCreateGenericState ();
420450d6964Smyers if (!State)
421450d6964Smyers {
4227b1019a6SJerry Jelinek return (NULL);
423450d6964Smyers }
424450d6964Smyers
425450d6964Smyers /* Init fields specific to the control struct */
426450d6964Smyers
42727f7c583Smyers State->Common.DescriptorType = ACPI_DESC_TYPE_STATE_CONTROL;
42827f7c583Smyers State->Common.State = ACPI_CONTROL_CONDITIONAL_EXECUTING;
429450d6964Smyers
4307b1019a6SJerry Jelinek return (State);
431450d6964Smyers }
432450d6964Smyers
433450d6964Smyers
434450d6964Smyers /*******************************************************************************
435450d6964Smyers *
436450d6964Smyers * FUNCTION: AcpiUtDeleteGenericState
437450d6964Smyers *
438450d6964Smyers * PARAMETERS: State - The state object to be deleted
439450d6964Smyers *
440450d6964Smyers * RETURN: None
441450d6964Smyers *
44227f7c583Smyers * DESCRIPTION: Release a state object to the state cache. NULL state objects
44327f7c583Smyers * are ignored.
444450d6964Smyers *
445450d6964Smyers ******************************************************************************/
446450d6964Smyers
447450d6964Smyers void
AcpiUtDeleteGenericState(ACPI_GENERIC_STATE * State)448450d6964Smyers AcpiUtDeleteGenericState (
449450d6964Smyers ACPI_GENERIC_STATE *State)
450450d6964Smyers {
4517b1019a6SJerry Jelinek ACPI_FUNCTION_ENTRY ();
452450d6964Smyers
453450d6964Smyers
45427f7c583Smyers /* Ignore null state */
45527f7c583Smyers
45627f7c583Smyers if (State)
45727f7c583Smyers {
45827f7c583Smyers (void) AcpiOsReleaseObject (AcpiGbl_StateCache, State);
45927f7c583Smyers }
460450d6964Smyers
4617b1019a6SJerry Jelinek return;
4627b1019a6SJerry Jelinek }
463