ia32: Remove the ia32_x87_attr_t from ia32_asm_attr_t.
[libfirm] / ir / lower / lower_calls.h
index 9a31b42..ba290bc 100644 (file)
@@ -1,54 +1,57 @@
 /*
- * Project:     libFIRM
- * File name:   ir/lower/lower_calls.h
- * Purpose:     lowering of Calls with compound parameters
- * Author:      Michael Beck
- * Created:
- * CVS-ID:      $Id$
- * Copyright:   (c) 1998-2005 Universität Karlsruhe
- * Licence:     This file protected by GPL -  GNU GENERAL PUBLIC LICENSE.
- */
-
-/**
- * @file lower_calls.h
+ * Copyright (C) 1995-2011 University of Karlsruhe.  All right reserved.
+ *
+ * This file is part of libFirm.
  *
- * Lowering of Calls with compound return types.
+ * This file may be distributed and/or modified under the terms of the
+ * GNU General Public License version 2 as published by the Free Software
+ * Foundation and appearing in the file LICENSE.GPL included in the
+ * packaging of this file.
  *
- * @author Michael Beck
+ * Licensees holding valid libFirm Professional Edition licenses may use
+ * this file in accordance with the libFirm Commercial License.
+ * Agreement provided with the Software.
+ *
+ * This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
+ * WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+ * PURPOSE.
  */
-#ifndef _LOWER_CALLS_H_
-#define _LOWER_CALLS_H_
 
 /**
- * A type telling where to add hidden parameters.
+ * @file
+ * @brief   Lowering of calls with compound arguments
+ * @author  Michael Beck
  */
-typedef enum add_hidden_params {
-  ADD_HIDDEN_ALWAYS_IN_FRONT = 0,   /**< always add hidden parameters in front (default). */
-  ADD_HIDDEN_ALWAYS_LAST     = 1,   /**< always add hidden parameters last, did not work for variadic functions. */
-  ADD_HIDDEN_SMART           = 2,   /**< add hidden parameters last for non-variadic and first for variadic functions. */
-} add_hidden;
+#ifndef FIRM_LOWER_CALLS_H
+#define FIRM_LOWER_CALLS_H
+
+#include "firm_types.h"
 
 /**
- * A struct containing all control parameters for
- * lower_compound_ret_calls().
+ * Additional flags for the lowering.
  */
-typedef struct {
-  int        def_ptr_alignment;   /**< Default alignment for data pointer. */
-  add_hidden hidden_params;       /**< Where to add hidden parameters. */
-
-  /**
-   * A function returning a pointer type for a given type.
-   * If this pointer is NULL, a new pointer type is always created.
-   */
-  ir_type *(*find_pointer_type)(ir_type *e_type, ir_mode *mode, int alignment);
-} lower_params_t;
+typedef enum compound_call_lowering_flags {
+       LF_NONE                 = 0,      /**< no additional flags */
+       LF_RETURN_HIDDEN        = 1 << 0, /**< return the hidden address instead of void */
+       LF_DONT_LOWER_ARGUMENTS = 1 << 1, /**< don't lower compound call arguments
+                                              (some backends can handle them themselves) */
+} compound_call_lowering_flags;
+ENUM_BITSET(compound_call_lowering_flags)
 
 /**
- * Lower calls with compound return types.
+ * Lower calls with compound parameter and return types.
  * This function does the following transformations:
  *
+ * If LF_COMPOUND_PARAM is set:
+ *
+ * - Copy compound parameters to a new location on the callers
+ *   stack and transmit the address of this new location
+ *
+ * If LF_COMPOUND_RETURN is set:
+ *
  * - Adds a new (hidden) pointer parameter for
- *   any return compound type.
+ *   any return compound type. The return type is replaced by void
+ *   or if LOWERING_FLAGS_RETURN_HIDDEN is set by the address.
  *
  * - Use of the hidden parameters in the function code.
  *
@@ -58,6 +61,8 @@ typedef struct {
  *
  * - Replace a possible block copy after the function call.
  *
+ * General:
+ *
  * - Changes the types of methods and calls to the lowered ones
  *
  * - lower all method types of existing entities
@@ -91,16 +96,7 @@ typedef struct {
      ret->a = a;
    }
    @endcode
- *
- * @param params  A structure containing the control parameter for this
- *                transformation.
- *
- * During the transformation, pointer types must be created or reused.
- * The caller can provide params->find_pointer_type for this task to
- * reduce the number of created pointer types.
- * If params->find_pointer_type is NULL, new pointer types
- * are always created automatically.
  */
-void lower_compound_ret_calls(const lower_params_t *params);
+void lower_calls_with_compounds(compound_call_lowering_flags flags);
 
-#endif /* _LOWER_CALLS_H_ */
+#endif