include/linux/acpi.h

   1 /*
   2  * acpi.h - ACPI Interface
   3  *
   4  * Copyright (C) 2001 Paul Diefenbaugh <paul.s.diefenbaugh@intel.com>
   5  *
   6  * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
   7  *
   8  * This program is free software; you can redistribute it and/or modify
   9  * it under the terms of the GNU General Public License as published by
  10  * the Free Software Foundation; either version 2 of the License, or
  11  * (at your option) any later version.
  12  *
  13  * This program is distributed in the hope that it will be useful,
  14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16  * GNU General Public License for more details.
  17  *
  18  * You should have received a copy of the GNU General Public License
  19  * along with this program; if not, write to the Free Software
  20  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  21  *
  22  * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  23  */
  24
  25 #ifndef _LINUX_ACPI_H
  26 #define _LINUX_ACPI_H
  27
  28 #include <linux/errno.h>
  29 #include <linux/ioport.h>       /* for struct resource */
  30 #include <linux/device.h>
  31
  32 #ifdef  CONFIG_ACPI
  33
  34 #ifndef _LINUX
  35 #define _LINUX
  36 #endif
  37
  38 #include <linux/list.h>
  39 #include <linux/mod_devicetable.h>
  40
  41 #include <acpi/acpi.h>
  42 #include <acpi/acpi_bus.h>
  43 #include <acpi/acpi_drivers.h>
  44 #include <acpi/acpi_numa.h>
  45 #include <asm/acpi.h>
  46
  47 enum acpi_irq_model_id {
  48         ACPI_IRQ_MODEL_PIC = 0,
  49         ACPI_IRQ_MODEL_IOAPIC,
  50         ACPI_IRQ_MODEL_IOSAPIC,
  51         ACPI_IRQ_MODEL_PLATFORM,
  52         ACPI_IRQ_MODEL_COUNT
  53 };
  54
  55 extern enum acpi_irq_model_id   acpi_irq_model;
  56
  57 enum acpi_interrupt_id {
  58         ACPI_INTERRUPT_PMI      = 1,
  59         ACPI_INTERRUPT_INIT,
  60         ACPI_INTERRUPT_CPEI,
  61         ACPI_INTERRUPT_COUNT
  62 };
  63
  64 #define ACPI_SPACE_MEM          0
  65
  66 enum acpi_address_range_id {
  67         ACPI_ADDRESS_RANGE_MEMORY = 1,
  68         ACPI_ADDRESS_RANGE_RESERVED = 2,
  69         ACPI_ADDRESS_RANGE_ACPI = 3,
  70         ACPI_ADDRESS_RANGE_NVS  = 4,
  71         ACPI_ADDRESS_RANGE_COUNT
  72 };
  73
  74
  75 /* Table Handlers */
  76
  77 typedef int (*acpi_table_handler) (struct acpi_table_header *table);
  78
  79 typedef int (*acpi_table_entry_handler) (struct acpi_subtable_header *header, const unsigned long end);
  80
  81 #ifdef CONFIG_ACPI_INITRD_TABLE_OVERRIDE
  82 void acpi_initrd_override(void *data, size_t size);
  83 #else
  84 static inline void acpi_initrd_override(void *data, size_t size)
  85 {
  86 }
  87 #endif
  88
  89 char * __acpi_map_table (unsigned long phys_addr, unsigned long size);
  90 void __acpi_unmap_table(char *map, unsigned long size);
  91 int early_acpi_boot_init(void);
  92 int acpi_boot_init (void);
  93 void acpi_boot_table_init (void);
  94 int acpi_mps_check (void);
  95 int acpi_numa_init (void);
  96
  97 int acpi_table_init (void);
  98 int acpi_table_parse (char *id, acpi_table_handler handler);
  99 int __init acpi_table_parse_entries(char *id, unsigned long table_size,
 100         int entry_id, acpi_table_entry_handler handler, unsigned int max_entries);
 101 int acpi_table_parse_madt (enum acpi_madt_type id, acpi_table_entry_handler handler, unsigned int max_entries);
 102 int acpi_parse_mcfg (struct acpi_table_header *header);
 103 void acpi_table_print_madt_entry (struct acpi_subtable_header *madt);
 104
 105 /* the following four functions are architecture-dependent */
 106 void acpi_numa_slit_init (struct acpi_table_slit *slit);
 107 void acpi_numa_processor_affinity_init (struct acpi_srat_cpu_affinity *pa);
 108 void acpi_numa_x2apic_affinity_init(struct acpi_srat_x2apic_cpu_affinity *pa);
 109 int acpi_numa_memory_affinity_init (struct acpi_srat_mem_affinity *ma);
 110 void acpi_numa_arch_fixup(void);
 111
 112 #ifdef CONFIG_ACPI_HOTPLUG_CPU
 113 /* Arch dependent functions for cpu hotplug support */
 114 int acpi_map_lsapic(acpi_handle handle, int *pcpu);
 115 int acpi_unmap_lsapic(int cpu);
 116 #endif /* CONFIG_ACPI_HOTPLUG_CPU */
 117
 118 int acpi_register_ioapic(acpi_handle handle, u64 phys_addr, u32 gsi_base);
 119 int acpi_unregister_ioapic(acpi_handle handle, u32 gsi_base);
 120 void acpi_irq_stats_init(void);
 121 extern u32 acpi_irq_handled;
 122 extern u32 acpi_irq_not_handled;
 123
 124 extern int sbf_port;
 125 extern unsigned long acpi_realmode_flags;
 126
 127 int acpi_register_gsi (struct device *dev, u32 gsi, int triggering, int polarity);
 128 int acpi_gsi_to_irq (u32 gsi, unsigned int *irq);
 129 int acpi_isa_irq_to_gsi (unsigned isa_irq, u32 *gsi);
 130
 131 #ifdef CONFIG_X86_IO_APIC
 132 extern int acpi_get_override_irq(u32 gsi, int *trigger, int *polarity);
 133 #else
 134 #define acpi_get_override_irq(gsi, trigger, polarity) (-1)
 135 #endif
 136 /*
 137  * This function undoes the effect of one call to acpi_register_gsi().
 138  * If this matches the last registration, any IRQ resources for gsi
 139  * are freed.
 140  */
 141 void acpi_unregister_gsi (u32 gsi);
 142
 143 struct pci_dev;
 144
 145 int acpi_pci_irq_enable (struct pci_dev *dev);
 146 void acpi_penalize_isa_irq(int irq, int active);
 147
 148 void acpi_pci_irq_disable (struct pci_dev *dev);
 149
 150 struct acpi_pci_driver {
 151         struct list_head node;
 152         int (*add)(struct acpi_pci_root *root);
 153         void (*remove)(struct acpi_pci_root *root);
 154 };
 155
 156 int acpi_pci_register_driver(struct acpi_pci_driver *driver);
 157 void acpi_pci_unregister_driver(struct acpi_pci_driver *driver);
 158
 159 extern int ec_read(u8 addr, u8 *val);
 160 extern int ec_write(u8 addr, u8 val);
 161 extern int ec_transaction(u8 command,
 162                           const u8 *wdata, unsigned wdata_len,
 163                           u8 *rdata, unsigned rdata_len);
 164 extern acpi_handle ec_get_handle(void);
 165
 166 #if defined(CONFIG_ACPI_WMI) || defined(CONFIG_ACPI_WMI_MODULE)
 167
 168 typedef void (*wmi_notify_handler) (u32 value, void *context);
 169
 170 extern acpi_status wmi_evaluate_method(const char *guid, u8 instance,
 171                                         u32 method_id,
 172                                         const struct acpi_buffer *in,
 173                                         struct acpi_buffer *out);
 174 extern acpi_status wmi_query_block(const char *guid, u8 instance,
 175                                         struct acpi_buffer *out);
 176 extern acpi_status wmi_set_block(const char *guid, u8 instance,
 177                                         const struct acpi_buffer *in);
 178 extern acpi_status wmi_install_notify_handler(const char *guid,
 179                                         wmi_notify_handler handler, void *data);
 180 extern acpi_status wmi_remove_notify_handler(const char *guid);
 181 extern acpi_status wmi_get_event_data(u32 event, struct acpi_buffer *out);
 182 extern bool wmi_has_guid(const char *guid);
 183
 184 #endif  /* CONFIG_ACPI_WMI */
 185
 186 #define ACPI_VIDEO_OUTPUT_SWITCHING                     0x0001
 187 #define ACPI_VIDEO_DEVICE_POSTING                       0x0002
 188 #define ACPI_VIDEO_ROM_AVAILABLE                        0x0004
 189 #define ACPI_VIDEO_BACKLIGHT                            0x0008
 190 #define ACPI_VIDEO_BACKLIGHT_FORCE_VENDOR               0x0010
 191 #define ACPI_VIDEO_BACKLIGHT_FORCE_VIDEO                0x0020
 192 #define ACPI_VIDEO_OUTPUT_SWITCHING_FORCE_VENDOR        0x0040
 193 #define ACPI_VIDEO_OUTPUT_SWITCHING_FORCE_VIDEO         0x0080
 194 #define ACPI_VIDEO_BACKLIGHT_DMI_VENDOR                 0x0100
 195 #define ACPI_VIDEO_BACKLIGHT_DMI_VIDEO                  0x0200
 196 #define ACPI_VIDEO_OUTPUT_SWITCHING_DMI_VENDOR          0x0400
 197 #define ACPI_VIDEO_OUTPUT_SWITCHING_DMI_VIDEO           0x0800
 198
 199 #if defined(CONFIG_ACPI_VIDEO) || defined(CONFIG_ACPI_VIDEO_MODULE)
 200
 201 extern long acpi_video_get_capabilities(acpi_handle graphics_dev_handle);
 202 extern long acpi_is_video_device(struct acpi_device *device);
 203 extern void acpi_video_dmi_promote_vendor(void);
 204 extern void acpi_video_dmi_demote_vendor(void);
 205 extern int acpi_video_backlight_support(void);
 206 extern int acpi_video_display_switch_support(void);
 207
 208 #else
 209
 210 static inline long acpi_video_get_capabilities(acpi_handle graphics_dev_handle)
 211 {
 212         return 0;
 213 }
 214
 215 static inline long acpi_is_video_device(struct acpi_device *device)
 216 {
 217         return 0;
 218 }
 219
 220 static inline void acpi_video_dmi_promote_vendor(void)
 221 {
 222 }
 223
 224 static inline void acpi_video_dmi_demote_vendor(void)
 225 {
 226 }
 227
 228 static inline int acpi_video_backlight_support(void)
 229 {
 230         return 0;
 231 }
 232
 233 static inline int acpi_video_display_switch_support(void)
 234 {
 235         return 0;
 236 }
 237
 238 #endif /* defined(CONFIG_ACPI_VIDEO) || defined(CONFIG_ACPI_VIDEO_MODULE) */
 239
 240 extern int acpi_blacklisted(void);
 241 extern void acpi_dmi_osi_linux(int enable, const struct dmi_system_id *d);
 242 extern void acpi_osi_setup(char *str);
 243
 244 #ifdef CONFIG_ACPI_NUMA
 245 int acpi_get_pxm(acpi_handle handle);
 246 int acpi_get_node(acpi_handle *handle);
 247 #else
 248 static inline int acpi_get_pxm(acpi_handle handle)
 249 {
 250         return 0;
 251 }
 252 static inline int acpi_get_node(acpi_handle *handle)
 253 {
 254         return 0;
 255 }
 256 #endif
 257 extern int acpi_paddr_to_node(u64 start_addr, u64 size);
 258
 259 extern int pnpacpi_disabled;
 260
 261 #define PXM_INVAL       (-1)
 262
 263 bool acpi_dev_resource_memory(struct acpi_resource *ares, struct resource *res);
 264 bool acpi_dev_resource_io(struct acpi_resource *ares, struct resource *res);
 265 bool acpi_dev_resource_address_space(struct acpi_resource *ares,
 266                                      struct resource *res);
 267 bool acpi_dev_resource_ext_address_space(struct acpi_resource *ares,
 268                                          struct resource *res);
 269 unsigned long acpi_dev_irq_flags(u8 triggering, u8 polarity, u8 shareable);
 270 bool acpi_dev_resource_interrupt(struct acpi_resource *ares, int index,
 271                                  struct resource *res);
 272
 273 struct resource_list_entry {
 274         struct list_head node;
 275         struct resource res;
 276 };
 277
 278 void acpi_dev_free_resource_list(struct list_head *list);
 279 int acpi_dev_get_resources(struct acpi_device *adev, struct list_head *list,
 280                            int (*preproc)(struct acpi_resource *, void *),
 281                            void *preproc_data);
 282
 283 int acpi_check_resource_conflict(const struct resource *res);
 284
 285 int acpi_check_region(resource_size_t start, resource_size_t n,
 286                       const char *name);
 287
 288 int acpi_resources_are_enforced(void);
 289
 290 #ifdef CONFIG_HIBERNATION
 291 void __init acpi_no_s4_hw_signature(void);
 292 #endif
 293
 294 #ifdef CONFIG_PM_SLEEP
 295 void __init acpi_old_suspend_ordering(void);
 296 void __init acpi_nvs_nosave(void);
 297 void __init acpi_nvs_nosave_s3(void);
 298 #endif /* CONFIG_PM_SLEEP */
 299
 300 struct acpi_osc_context {
 301         char *uuid_str; /* uuid string */
 302         int rev;
 303         struct acpi_buffer cap; /* arg2/arg3 */
 304         struct acpi_buffer ret; /* free by caller if success */
 305 };
 306
 307 #define OSC_QUERY_TYPE                  0
 308 #define OSC_SUPPORT_TYPE                1
 309 #define OSC_CONTROL_TYPE                2
 310
 311 /* _OSC DW0 Definition */
 312 #define OSC_QUERY_ENABLE                1
 313 #define OSC_REQUEST_ERROR               2
 314 #define OSC_INVALID_UUID_ERROR          4
 315 #define OSC_INVALID_REVISION_ERROR      8
 316 #define OSC_CAPABILITIES_MASK_ERROR     16
 317
 318 acpi_status acpi_run_osc(acpi_handle handle, struct acpi_osc_context *context);
 319
 320 /* platform-wide _OSC bits */
 321 #define OSC_SB_PAD_SUPPORT              1
 322 #define OSC_SB_PPC_OST_SUPPORT          2
 323 #define OSC_SB_PR3_SUPPORT              4
 324 #define OSC_SB_HOTPLUG_OST_SUPPORT      8
 325 #define OSC_SB_APEI_SUPPORT             16
 326
 327 extern bool osc_sb_apei_support_acked;
 328
 329 /* PCI defined _OSC bits */
 330 /* _OSC DW1 Definition (OS Support Fields) */
 331 #define OSC_EXT_PCI_CONFIG_SUPPORT              1
 332 #define OSC_ACTIVE_STATE_PWR_SUPPORT            2
 333 #define OSC_CLOCK_PWR_CAPABILITY_SUPPORT        4
 334 #define OSC_PCI_SEGMENT_GROUPS_SUPPORT          8
 335 #define OSC_MSI_SUPPORT                         16
 336 #define OSC_PCI_SUPPORT_MASKS                   0x1f
 337
 338 /* _OSC DW1 Definition (OS Control Fields) */
 339 #define OSC_PCI_EXPRESS_NATIVE_HP_CONTROL       1
 340 #define OSC_SHPC_NATIVE_HP_CONTROL              2
 341 #define OSC_PCI_EXPRESS_PME_CONTROL             4
 342 #define OSC_PCI_EXPRESS_AER_CONTROL             8
 343 #define OSC_PCI_EXPRESS_CAP_STRUCTURE_CONTROL   16
 344
 345 #define OSC_PCI_CONTROL_MASKS   (OSC_PCI_EXPRESS_NATIVE_HP_CONTROL |    \
 346                                 OSC_SHPC_NATIVE_HP_CONTROL |            \
 347                                 OSC_PCI_EXPRESS_PME_CONTROL |           \
 348                                 OSC_PCI_EXPRESS_AER_CONTROL |           \
 349                                 OSC_PCI_EXPRESS_CAP_STRUCTURE_CONTROL)
 350
 351 #define OSC_PCI_NATIVE_HOTPLUG  (OSC_PCI_EXPRESS_NATIVE_HP_CONTROL |    \
 352                                 OSC_SHPC_NATIVE_HP_CONTROL)
 353
 354 extern acpi_status acpi_pci_osc_control_set(acpi_handle handle,
 355                                              u32 *mask, u32 req);
 356
 357 /* Enable _OST when all relevant hotplug operations are enabled */
 358 #if defined(CONFIG_ACPI_HOTPLUG_CPU) &&                 \
 359         (defined(CONFIG_ACPI_HOTPLUG_MEMORY) ||         \
 360          defined(CONFIG_ACPI_HOTPLUG_MEMORY_MODULE)) && \
 361         (defined(CONFIG_ACPI_CONTAINER) ||              \
 362          defined(CONFIG_ACPI_CONTAINER_MODULE))
 363 #define ACPI_HOTPLUG_OST
 364 #endif
 365
 366 /* _OST Source Event Code (OSPM Action) */
 367 #define ACPI_OST_EC_OSPM_SHUTDOWN               0x100
 368 #define ACPI_OST_EC_OSPM_EJECT                  0x103
 369 #define ACPI_OST_EC_OSPM_INSERTION              0x200
 370
 371 /* _OST General Processing Status Code */
 372 #define ACPI_OST_SC_SUCCESS                     0x0
 373 #define ACPI_OST_SC_NON_SPECIFIC_FAILURE        0x1
 374 #define ACPI_OST_SC_UNRECOGNIZED_NOTIFY         0x2
 375
 376 /* _OST OS Shutdown Processing (0x100) Status Code */
 377 #define ACPI_OST_SC_OS_SHUTDOWN_DENIED          0x80
 378 #define ACPI_OST_SC_OS_SHUTDOWN_IN_PROGRESS     0x81
 379 #define ACPI_OST_SC_OS_SHUTDOWN_COMPLETED       0x82
 380 #define ACPI_OST_SC_OS_SHUTDOWN_NOT_SUPPORTED   0x83
 381
 382 /* _OST Ejection Request (0x3, 0x103) Status Code */
 383 #define ACPI_OST_SC_EJECT_NOT_SUPPORTED         0x80
 384 #define ACPI_OST_SC_DEVICE_IN_USE               0x81
 385 #define ACPI_OST_SC_DEVICE_BUSY                 0x82
 386 #define ACPI_OST_SC_EJECT_DEPENDENCY_BUSY       0x83
 387 #define ACPI_OST_SC_EJECT_IN_PROGRESS           0x84
 388
 389 /* _OST Insertion Request (0x200) Status Code */
 390 #define ACPI_OST_SC_INSERT_IN_PROGRESS          0x80
 391 #define ACPI_OST_SC_DRIVER_LOAD_FAILURE         0x81
 392 #define ACPI_OST_SC_INSERT_NOT_SUPPORTED        0x82
 393
 394 extern void acpi_early_init(void);
 395
 396 extern int acpi_nvs_register(__u64 start, __u64 size);
 397
 398 extern int acpi_nvs_for_each_region(int (*func)(__u64, __u64, void *),
 399                                     void *data);
 400
 401 const struct acpi_device_id *acpi_match_device(const struct acpi_device_id *ids,
 402                                                const struct device *dev);
 403
 404 static inline bool acpi_driver_match_device(struct device *dev,
 405                                             const struct device_driver *drv)
 406 {
 407         return !!acpi_match_device(drv->acpi_match_table, dev);
 408 }
 409
 410 #define ACPI_PTR(_ptr)  (_ptr)
 411
 412 #else   /* !CONFIG_ACPI */
 413
 414 #define acpi_disabled 1
 415
 416 static inline void acpi_early_init(void) { }
 417
 418 static inline int early_acpi_boot_init(void)
 419 {
 420         return 0;
 421 }
 422 static inline int acpi_boot_init(void)
 423 {
 424         return 0;
 425 }
 426
 427 static inline void acpi_boot_table_init(void)
 428 {
 429         return;
 430 }
 431
 432 static inline int acpi_mps_check(void)
 433 {
 434         return 0;
 435 }
 436
 437 static inline int acpi_check_resource_conflict(struct resource *res)
 438 {
 439         return 0;
 440 }
 441
 442 static inline int acpi_check_region(resource_size_t start, resource_size_t n,
 443                                     const char *name)
 444 {
 445         return 0;
 446 }
 447
 448 struct acpi_table_header;
 449 static inline int acpi_table_parse(char *id,
 450                                 int (*handler)(struct acpi_table_header *))
 451 {
 452         return -1;
 453 }
 454
 455 static inline int acpi_nvs_register(__u64 start, __u64 size)
 456 {
 457         return 0;
 458 }
 459
 460 static inline int acpi_nvs_for_each_region(int (*func)(__u64, __u64, void *),
 461                                            void *data)
 462 {
 463         return 0;
 464 }
 465
 466 struct acpi_device_id;
 467
 468 static inline const struct acpi_device_id *acpi_match_device(
 469         const struct acpi_device_id *ids, const struct device *dev)
 470 {
 471         return NULL;
 472 }
 473
 474 static inline bool acpi_driver_match_device(struct device *dev,
 475                                             const struct device_driver *drv)
 476 {
 477         return false;
 478 }
 479
 480 #define ACPI_PTR(_ptr)  (NULL)
 481
 482 #endif  /* !CONFIG_ACPI */
 483
 484 #ifdef CONFIG_ACPI
 485 void acpi_os_set_prepare_sleep(int (*func)(u8 sleep_state,
 486                                u32 pm1a_ctrl,  u32 pm1b_ctrl));
 487
 488 acpi_status acpi_os_prepare_sleep(u8 sleep_state,
 489                                   u32 pm1a_control, u32 pm1b_control);
 490 #ifdef CONFIG_X86
 491 void arch_reserve_mem_area(acpi_physical_address addr, size_t size);
 492 #else
 493 static inline void arch_reserve_mem_area(acpi_physical_address addr,
 494                                           size_t size)
 495 {
 496 }
 497 #endif /* CONFIG_X86 */
 498 #else
 499 #define acpi_os_set_prepare_sleep(func, pm1a_ctrl, pm1b_ctrl) do { } while (0)
 500 #endif
 501
 502 #if defined(CONFIG_ACPI) && defined(CONFIG_PM_RUNTIME)
 503 int acpi_dev_runtime_suspend(struct device *dev);
 504 int acpi_dev_runtime_resume(struct device *dev);
 505 int acpi_subsys_runtime_suspend(struct device *dev);
 506 int acpi_subsys_runtime_resume(struct device *dev);
 507 #else
 508 static inline int acpi_dev_runtime_suspend(struct device *dev) { return 0; }
 509 static inline int acpi_dev_runtime_resume(struct device *dev) { return 0; }
 510 static inline int acpi_subsys_runtime_suspend(struct device *dev) { return 0; }
 511 static inline int acpi_subsys_runtime_resume(struct device *dev) { return 0; }
 512 #endif
 513
 514 #ifdef CONFIG_ACPI_SLEEP
 515 int acpi_dev_suspend_late(struct device *dev);
 516 int acpi_dev_resume_early(struct device *dev);
 517 int acpi_subsys_prepare(struct device *dev);
 518 int acpi_subsys_suspend_late(struct device *dev);
 519 int acpi_subsys_resume_early(struct device *dev);
 520 #else
 521 static inline int acpi_dev_suspend_late(struct device *dev) { return 0; }
 522 static inline int acpi_dev_resume_early(struct device *dev) { return 0; }
 523 static inline int acpi_subsys_prepare(struct device *dev) { return 0; }
 524 static inline int acpi_subsys_suspend_late(struct device *dev) { return 0; }
 525 static inline int acpi_subsys_resume_early(struct device *dev) { return 0; }
 526 #endif
 527
 528 #if defined(CONFIG_ACPI) && defined(CONFIG_PM)
 529 int acpi_dev_pm_attach(struct device *dev, bool power_on);
 530 void acpi_dev_pm_detach(struct device *dev, bool power_off);
 531 #else
 532 static inline int acpi_dev_pm_attach(struct device *dev, bool power_on)
 533 {
 534         return -ENODEV;
 535 }
 536 static inline void acpi_dev_pm_detach(struct device *dev, bool power_off) {}
 537 #endif
 538
 539 #ifdef CONFIG_ACPI
 540 __printf(3, 4)
 541 void acpi_handle_printk(const char *level, acpi_handle handle,
 542                         const char *fmt, ...);
 543 #else   /* !CONFIG_ACPI */
 544 static inline __printf(3, 4) void
 545 acpi_handle_printk(const char *level, void *handle, const char *fmt, ...) {}
 546 #endif  /* !CONFIG_ACPI */
 547
 548 /*
 549  * acpi_handle_<level>: Print message with ACPI prefix and object path
 550  *
 551  * These interfaces acquire the global namespace mutex to obtain an object
 552  * path.  In interrupt context, it shows the object path as <n/a>.
 553  */
 554 #define acpi_handle_emerg(handle, fmt, ...)                             \
 555         acpi_handle_printk(KERN_EMERG, handle, fmt, ##__VA_ARGS__)
 556 #define acpi_handle_alert(handle, fmt, ...)                             \
 557         acpi_handle_printk(KERN_ALERT, handle, fmt, ##__VA_ARGS__)
 558 #define acpi_handle_crit(handle, fmt, ...)                              \
 559         acpi_handle_printk(KERN_CRIT, handle, fmt, ##__VA_ARGS__)
 560 #define acpi_handle_err(handle, fmt, ...)                               \
 561         acpi_handle_printk(KERN_ERR, handle, fmt, ##__VA_ARGS__)
 562 #define acpi_handle_warn(handle, fmt, ...)                              \
 563         acpi_handle_printk(KERN_WARNING, handle, fmt, ##__VA_ARGS__)
 564 #define acpi_handle_notice(handle, fmt, ...)                            \
 565         acpi_handle_printk(KERN_NOTICE, handle, fmt, ##__VA_ARGS__)
 566 #define acpi_handle_info(handle, fmt, ...)                              \
 567         acpi_handle_printk(KERN_INFO, handle, fmt, ##__VA_ARGS__)
 568
 569 /* REVISIT: Support CONFIG_DYNAMIC_DEBUG when necessary */
 570 #if defined(DEBUG) || defined(CONFIG_DYNAMIC_DEBUG)
 571 #define acpi_handle_debug(handle, fmt, ...)                             \
 572         acpi_handle_printk(KERN_DEBUG, handle, fmt, ##__VA_ARGS__)
 573 #else
 574 #define acpi_handle_debug(handle, fmt, ...)                             \
 575 ({                                                                      \
 576         if (0)                                                          \
 577                 acpi_handle_printk(KERN_DEBUG, handle, fmt, ##__VA_ARGS__); \
 578         0;                                                              \
 579 })
 580 #endif
 581
 582 #endif  /*_LINUX_ACPI_H*/