1 // SPDX-License-Identifier: BSD-3-Clause OR GPL-2.0 2 /****************************************************************************** 3 * 4 * Module Name: osunixxf - UNIX OSL interfaces 5 * 6 * Copyright (C) 2000 - 2023, Intel Corp. 7 * 8 *****************************************************************************/ 9 10 /* 11 * These interfaces are required in order to compile the ASL compiler and the 12 * various ACPICA tools under Linux or other Unix-like system. 13 */ 14 #include <acpi/acpi.h> 15 #include "accommon.h" 16 #include "amlcode.h" 17 #include "acparser.h" 18 #include "acdebug.h" 19 20 #include <stdio.h> 21 #include <stdlib.h> 22 #include <stdarg.h> 23 #include <unistd.h> 24 #include <sys/time.h> 25 #include <semaphore.h> 26 #include <pthread.h> 27 #include <errno.h> 28 29 #define _COMPONENT ACPI_OS_SERVICES 30 ACPI_MODULE_NAME("osunixxf") 31 32 /* Upcalls to acpi_exec */ 33 void 34 ae_table_override(struct acpi_table_header *existing_table, 35 struct acpi_table_header **new_table); 36 37 typedef void *(*PTHREAD_CALLBACK) (void *); 38 39 /* Buffer used by acpi_os_vprintf */ 40 41 #define ACPI_VPRINTF_BUFFER_SIZE 512 42 #define _ASCII_NEWLINE '\n' 43 44 /* Terminal support for acpi_exec only */ 45 46 #ifdef ACPI_EXEC_APP 47 #include <termios.h> 48 49 struct termios original_term_attributes; 50 int term_attributes_were_set = 0; 51 52 acpi_status acpi_ut_read_line(char *buffer, u32 buffer_length, u32 *bytes_read); 53 54 static void os_enter_line_edit_mode(void); 55 56 static void os_exit_line_edit_mode(void); 57 58 /****************************************************************************** 59 * 60 * FUNCTION: os_enter_line_edit_mode, os_exit_line_edit_mode 61 * 62 * PARAMETERS: None 63 * 64 * RETURN: None 65 * 66 * DESCRIPTION: Enter/Exit the raw character input mode for the terminal. 67 * 68 * Interactive line-editing support for the AML debugger. Used with the 69 * common/acgetline module. 70 * 71 * readline() is not used because of non-portability. It is not available 72 * on all systems, and if it is, often the package must be manually installed. 73 * 74 * Therefore, we use the POSIX tcgetattr/tcsetattr and do the minimal line 75 * editing that we need in acpi_os_get_line. 76 * 77 * If the POSIX tcgetattr/tcsetattr interfaces are unavailable, these 78 * calls will also work: 79 * For os_enter_line_edit_mode: system ("stty cbreak -echo") 80 * For os_exit_line_edit_mode: system ("stty cooked echo") 81 * 82 *****************************************************************************/ 83 84 static void os_enter_line_edit_mode(void) 85 { 86 struct termios local_term_attributes; 87 88 term_attributes_were_set = 0; 89 90 /* STDIN must be a terminal */ 91 92 if (!isatty(STDIN_FILENO)) { 93 return; 94 } 95 96 /* Get and keep the original attributes */ 97 98 if (tcgetattr(STDIN_FILENO, &original_term_attributes)) { 99 fprintf(stderr, "Could not get terminal attributes!\n"); 100 return; 101 } 102 103 /* Set the new attributes to enable raw character input */ 104 105 memcpy(&local_term_attributes, &original_term_attributes, 106 sizeof(struct termios)); 107 108 local_term_attributes.c_lflag &= ~(ICANON | ECHO); 109 local_term_attributes.c_cc[VMIN] = 1; 110 local_term_attributes.c_cc[VTIME] = 0; 111 112 if (tcsetattr(STDIN_FILENO, TCSANOW, &local_term_attributes)) { 113 fprintf(stderr, "Could not set terminal attributes!\n"); 114 return; 115 } 116 117 term_attributes_were_set = 1; 118 } 119 120 static void os_exit_line_edit_mode(void) 121 { 122 123 if (!term_attributes_were_set) { 124 return; 125 } 126 127 /* Set terminal attributes back to the original values */ 128 129 if (tcsetattr(STDIN_FILENO, TCSANOW, &original_term_attributes)) { 130 fprintf(stderr, "Could not restore terminal attributes!\n"); 131 } 132 } 133 134 #else 135 136 /* These functions are not needed for other ACPICA utilities */ 137 138 #define os_enter_line_edit_mode() 139 #define os_exit_line_edit_mode() 140 #endif 141 142 /****************************************************************************** 143 * 144 * FUNCTION: acpi_os_initialize, acpi_os_terminate 145 * 146 * PARAMETERS: None 147 * 148 * RETURN: Status 149 * 150 * DESCRIPTION: Initialize and terminate this module. 151 * 152 *****************************************************************************/ 153 154 acpi_status acpi_os_initialize(void) 155 { 156 acpi_status status; 157 158 acpi_gbl_output_file = stdout; 159 160 os_enter_line_edit_mode(); 161 162 status = acpi_os_create_lock(&acpi_gbl_print_lock); 163 if (ACPI_FAILURE(status)) { 164 return (status); 165 } 166 167 return (AE_OK); 168 } 169 170 acpi_status acpi_os_terminate(void) 171 { 172 173 os_exit_line_edit_mode(); 174 return (AE_OK); 175 } 176 177 #ifndef ACPI_USE_NATIVE_RSDP_POINTER 178 /****************************************************************************** 179 * 180 * FUNCTION: acpi_os_get_root_pointer 181 * 182 * PARAMETERS: None 183 * 184 * RETURN: RSDP physical address 185 * 186 * DESCRIPTION: Gets the ACPI root pointer (RSDP) 187 * 188 *****************************************************************************/ 189 190 acpi_physical_address acpi_os_get_root_pointer(void) 191 { 192 193 return (0); 194 } 195 #endif 196 197 /****************************************************************************** 198 * 199 * FUNCTION: acpi_os_predefined_override 200 * 201 * PARAMETERS: init_val - Initial value of the predefined object 202 * new_val - The new value for the object 203 * 204 * RETURN: Status, pointer to value. Null pointer returned if not 205 * overriding. 206 * 207 * DESCRIPTION: Allow the OS to override predefined names 208 * 209 *****************************************************************************/ 210 211 acpi_status 212 acpi_os_predefined_override(const struct acpi_predefined_names *init_val, 213 acpi_string *new_val) 214 { 215 216 if (!init_val || !new_val) { 217 return (AE_BAD_PARAMETER); 218 } 219 220 *new_val = NULL; 221 return (AE_OK); 222 } 223 224 /****************************************************************************** 225 * 226 * FUNCTION: acpi_os_table_override 227 * 228 * PARAMETERS: existing_table - Header of current table (probably 229 * firmware) 230 * new_table - Where an entire new table is returned. 231 * 232 * RETURN: Status, pointer to new table. Null pointer returned if no 233 * table is available to override 234 * 235 * DESCRIPTION: Return a different version of a table if one is available 236 * 237 *****************************************************************************/ 238 239 acpi_status 240 acpi_os_table_override(struct acpi_table_header *existing_table, 241 struct acpi_table_header **new_table) 242 { 243 244 if (!existing_table || !new_table) { 245 return (AE_BAD_PARAMETER); 246 } 247 248 *new_table = NULL; 249 250 #ifdef ACPI_EXEC_APP 251 252 ae_table_override(existing_table, new_table); 253 return (AE_OK); 254 #else 255 256 return (AE_NO_ACPI_TABLES); 257 #endif 258 } 259 260 /****************************************************************************** 261 * 262 * FUNCTION: acpi_os_physical_table_override 263 * 264 * PARAMETERS: existing_table - Header of current table (probably firmware) 265 * new_address - Where new table address is returned 266 * (Physical address) 267 * new_table_length - Where new table length is returned 268 * 269 * RETURN: Status, address/length of new table. Null pointer returned 270 * if no table is available to override. 271 * 272 * DESCRIPTION: Returns AE_SUPPORT, function not used in user space. 273 * 274 *****************************************************************************/ 275 276 acpi_status 277 acpi_os_physical_table_override(struct acpi_table_header *existing_table, 278 acpi_physical_address *new_address, 279 u32 *new_table_length) 280 { 281 282 return (AE_SUPPORT); 283 } 284 285 /****************************************************************************** 286 * 287 * FUNCTION: acpi_os_enter_sleep 288 * 289 * PARAMETERS: sleep_state - Which sleep state to enter 290 * rega_value - Register A value 291 * regb_value - Register B value 292 * 293 * RETURN: Status 294 * 295 * DESCRIPTION: A hook before writing sleep registers to enter the sleep 296 * state. Return AE_CTRL_TERMINATE to skip further sleep register 297 * writes. 298 * 299 *****************************************************************************/ 300 301 acpi_status acpi_os_enter_sleep(u8 sleep_state, u32 rega_value, u32 regb_value) 302 { 303 304 return (AE_OK); 305 } 306 307 /****************************************************************************** 308 * 309 * FUNCTION: acpi_os_redirect_output 310 * 311 * PARAMETERS: destination - An open file handle/pointer 312 * 313 * RETURN: None 314 * 315 * DESCRIPTION: Causes redirect of acpi_os_printf and acpi_os_vprintf 316 * 317 *****************************************************************************/ 318 319 void acpi_os_redirect_output(void *destination) 320 { 321 322 acpi_gbl_output_file = destination; 323 } 324 325 /****************************************************************************** 326 * 327 * FUNCTION: acpi_os_printf 328 * 329 * PARAMETERS: fmt, ... - Standard printf format 330 * 331 * RETURN: None 332 * 333 * DESCRIPTION: Formatted output. Note: very similar to acpi_os_vprintf 334 * (performance), changes should be tracked in both functions. 335 * 336 *****************************************************************************/ 337 338 void ACPI_INTERNAL_VAR_XFACE acpi_os_printf(const char *fmt, ...) 339 { 340 va_list args; 341 u8 flags; 342 343 flags = acpi_gbl_db_output_flags; 344 if (flags & ACPI_DB_REDIRECTABLE_OUTPUT) { 345 346 /* Output is directable to either a file (if open) or the console */ 347 348 if (acpi_gbl_debug_file) { 349 350 /* Output file is open, send the output there */ 351 352 va_start(args, fmt); 353 vfprintf(acpi_gbl_debug_file, fmt, args); 354 va_end(args); 355 } else { 356 /* No redirection, send output to console (once only!) */ 357 358 flags |= ACPI_DB_CONSOLE_OUTPUT; 359 } 360 } 361 362 if (flags & ACPI_DB_CONSOLE_OUTPUT) { 363 va_start(args, fmt); 364 vfprintf(acpi_gbl_output_file, fmt, args); 365 va_end(args); 366 } 367 } 368 369 /****************************************************************************** 370 * 371 * FUNCTION: acpi_os_vprintf 372 * 373 * PARAMETERS: fmt - Standard printf format 374 * args - Argument list 375 * 376 * RETURN: None 377 * 378 * DESCRIPTION: Formatted output with argument list pointer. Note: very 379 * similar to acpi_os_printf, changes should be tracked in both 380 * functions. 381 * 382 *****************************************************************************/ 383 384 void acpi_os_vprintf(const char *fmt, va_list args) 385 { 386 u8 flags; 387 char buffer[ACPI_VPRINTF_BUFFER_SIZE]; 388 389 /* 390 * We build the output string in a local buffer because we may be 391 * outputting the buffer twice. Using vfprintf is problematic because 392 * some implementations modify the args pointer/structure during 393 * execution. Thus, we use the local buffer for portability. 394 * 395 * Note: Since this module is intended for use by the various ACPICA 396 * utilities/applications, we can safely declare the buffer on the stack. 397 * Also, This function is used for relatively small error messages only. 398 */ 399 vsnprintf(buffer, ACPI_VPRINTF_BUFFER_SIZE, fmt, args); 400 401 flags = acpi_gbl_db_output_flags; 402 if (flags & ACPI_DB_REDIRECTABLE_OUTPUT) { 403 404 /* Output is directable to either a file (if open) or the console */ 405 406 if (acpi_gbl_debug_file) { 407 408 /* Output file is open, send the output there */ 409 410 fputs(buffer, acpi_gbl_debug_file); 411 } else { 412 /* No redirection, send output to console (once only!) */ 413 414 flags |= ACPI_DB_CONSOLE_OUTPUT; 415 } 416 } 417 418 if (flags & ACPI_DB_CONSOLE_OUTPUT) { 419 fputs(buffer, acpi_gbl_output_file); 420 } 421 } 422 423 #ifndef ACPI_EXEC_APP 424 /****************************************************************************** 425 * 426 * FUNCTION: acpi_os_get_line 427 * 428 * PARAMETERS: buffer - Where to return the command line 429 * buffer_length - Maximum length of Buffer 430 * bytes_read - Where the actual byte count is returned 431 * 432 * RETURN: Status and actual bytes read 433 * 434 * DESCRIPTION: Get the next input line from the terminal. NOTE: For the 435 * acpi_exec utility, we use the acgetline module instead to 436 * provide line-editing and history support. 437 * 438 *****************************************************************************/ 439 440 acpi_status acpi_os_get_line(char *buffer, u32 buffer_length, u32 *bytes_read) 441 { 442 int input_char; 443 u32 end_of_line; 444 445 /* Standard acpi_os_get_line for all utilities except acpi_exec */ 446 447 for (end_of_line = 0;; end_of_line++) { 448 if (end_of_line >= buffer_length) { 449 return (AE_BUFFER_OVERFLOW); 450 } 451 452 if ((input_char = getchar()) == EOF) { 453 return (AE_ERROR); 454 } 455 456 if (!input_char || input_char == _ASCII_NEWLINE) { 457 break; 458 } 459 460 buffer[end_of_line] = (char)input_char; 461 } 462 463 /* Null terminate the buffer */ 464 465 buffer[end_of_line] = 0; 466 467 /* Return the number of bytes in the string */ 468 469 if (bytes_read) { 470 *bytes_read = end_of_line; 471 } 472 473 return (AE_OK); 474 } 475 #endif 476 477 #ifndef ACPI_USE_NATIVE_MEMORY_MAPPING 478 /****************************************************************************** 479 * 480 * FUNCTION: acpi_os_map_memory 481 * 482 * PARAMETERS: where - Physical address of memory to be mapped 483 * length - How much memory to map 484 * 485 * RETURN: Pointer to mapped memory. Null on error. 486 * 487 * DESCRIPTION: Map physical memory into caller's address space 488 * 489 *****************************************************************************/ 490 491 void *acpi_os_map_memory(acpi_physical_address where, acpi_size length) 492 { 493 494 return (ACPI_TO_POINTER((acpi_size)where)); 495 } 496 497 /****************************************************************************** 498 * 499 * FUNCTION: acpi_os_unmap_memory 500 * 501 * PARAMETERS: where - Logical address of memory to be unmapped 502 * length - How much memory to unmap 503 * 504 * RETURN: None. 505 * 506 * DESCRIPTION: Delete a previously created mapping. Where and Length must 507 * correspond to a previous mapping exactly. 508 * 509 *****************************************************************************/ 510 511 void acpi_os_unmap_memory(void *where, acpi_size length) 512 { 513 514 return; 515 } 516 #endif 517 518 /****************************************************************************** 519 * 520 * FUNCTION: acpi_os_allocate 521 * 522 * PARAMETERS: size - Amount to allocate, in bytes 523 * 524 * RETURN: Pointer to the new allocation. Null on error. 525 * 526 * DESCRIPTION: Allocate memory. Algorithm is dependent on the OS. 527 * 528 *****************************************************************************/ 529 530 void *acpi_os_allocate(acpi_size size) 531 { 532 void *mem; 533 534 mem = (void *)malloc((size_t) size); 535 return (mem); 536 } 537 538 #ifdef USE_NATIVE_ALLOCATE_ZEROED 539 /****************************************************************************** 540 * 541 * FUNCTION: acpi_os_allocate_zeroed 542 * 543 * PARAMETERS: size - Amount to allocate, in bytes 544 * 545 * RETURN: Pointer to the new allocation. Null on error. 546 * 547 * DESCRIPTION: Allocate and zero memory. Algorithm is dependent on the OS. 548 * 549 *****************************************************************************/ 550 551 void *acpi_os_allocate_zeroed(acpi_size size) 552 { 553 void *mem; 554 555 mem = (void *)calloc(1, (size_t) size); 556 return (mem); 557 } 558 #endif 559 560 /****************************************************************************** 561 * 562 * FUNCTION: acpi_os_free 563 * 564 * PARAMETERS: mem - Pointer to previously allocated memory 565 * 566 * RETURN: None. 567 * 568 * DESCRIPTION: Free memory allocated via acpi_os_allocate 569 * 570 *****************************************************************************/ 571 572 void acpi_os_free(void *mem) 573 { 574 575 free(mem); 576 } 577 578 #ifdef ACPI_SINGLE_THREADED 579 /****************************************************************************** 580 * 581 * FUNCTION: Semaphore stub functions 582 * 583 * DESCRIPTION: Stub functions used for single-thread applications that do 584 * not require semaphore synchronization. Full implementations 585 * of these functions appear after the stubs. 586 * 587 *****************************************************************************/ 588 589 acpi_status 590 acpi_os_create_semaphore(u32 max_units, 591 u32 initial_units, acpi_handle *out_handle) 592 { 593 *out_handle = (acpi_handle)1; 594 return (AE_OK); 595 } 596 597 acpi_status acpi_os_delete_semaphore(acpi_handle handle) 598 { 599 return (AE_OK); 600 } 601 602 acpi_status acpi_os_wait_semaphore(acpi_handle handle, u32 units, u16 timeout) 603 { 604 return (AE_OK); 605 } 606 607 acpi_status acpi_os_signal_semaphore(acpi_handle handle, u32 units) 608 { 609 return (AE_OK); 610 } 611 612 #else 613 /****************************************************************************** 614 * 615 * FUNCTION: acpi_os_create_semaphore 616 * 617 * PARAMETERS: initial_units - Units to be assigned to the new semaphore 618 * out_handle - Where a handle will be returned 619 * 620 * RETURN: Status 621 * 622 * DESCRIPTION: Create an OS semaphore 623 * 624 *****************************************************************************/ 625 626 acpi_status 627 acpi_os_create_semaphore(u32 max_units, 628 u32 initial_units, acpi_handle *out_handle) 629 { 630 sem_t *sem; 631 632 if (!out_handle) { 633 return (AE_BAD_PARAMETER); 634 } 635 #ifdef __APPLE__ 636 { 637 static int semaphore_count = 0; 638 char semaphore_name[32]; 639 640 snprintf(semaphore_name, sizeof(semaphore_name), "acpi_sem_%d", 641 semaphore_count++); 642 printf("%s\n", semaphore_name); 643 sem = 644 sem_open(semaphore_name, O_EXCL | O_CREAT, 0755, 645 initial_units); 646 if (!sem) { 647 return (AE_NO_MEMORY); 648 } 649 sem_unlink(semaphore_name); /* This just deletes the name */ 650 } 651 652 #else 653 sem = acpi_os_allocate(sizeof(sem_t)); 654 if (!sem) { 655 return (AE_NO_MEMORY); 656 } 657 658 if (sem_init(sem, 0, initial_units) == -1) { 659 acpi_os_free(sem); 660 return (AE_BAD_PARAMETER); 661 } 662 #endif 663 664 *out_handle = (acpi_handle)sem; 665 return (AE_OK); 666 } 667 668 /****************************************************************************** 669 * 670 * FUNCTION: acpi_os_delete_semaphore 671 * 672 * PARAMETERS: handle - Handle returned by acpi_os_create_semaphore 673 * 674 * RETURN: Status 675 * 676 * DESCRIPTION: Delete an OS semaphore 677 * 678 *****************************************************************************/ 679 680 acpi_status acpi_os_delete_semaphore(acpi_handle handle) 681 { 682 sem_t *sem = (sem_t *) handle; 683 684 if (!sem) { 685 return (AE_BAD_PARAMETER); 686 } 687 #ifdef __APPLE__ 688 if (sem_close(sem) == -1) { 689 return (AE_BAD_PARAMETER); 690 } 691 #else 692 if (sem_destroy(sem) == -1) { 693 return (AE_BAD_PARAMETER); 694 } 695 #endif 696 697 return (AE_OK); 698 } 699 700 /****************************************************************************** 701 * 702 * FUNCTION: acpi_os_wait_semaphore 703 * 704 * PARAMETERS: handle - Handle returned by acpi_os_create_semaphore 705 * units - How many units to wait for 706 * msec_timeout - How long to wait (milliseconds) 707 * 708 * RETURN: Status 709 * 710 * DESCRIPTION: Wait for units 711 * 712 *****************************************************************************/ 713 714 acpi_status 715 acpi_os_wait_semaphore(acpi_handle handle, u32 units, u16 msec_timeout) 716 { 717 acpi_status status = AE_OK; 718 sem_t *sem = (sem_t *) handle; 719 int ret_val; 720 #ifndef ACPI_USE_ALTERNATE_TIMEOUT 721 struct timespec time; 722 #endif 723 724 if (!sem) { 725 return (AE_BAD_PARAMETER); 726 } 727 728 switch (msec_timeout) { 729 /* 730 * No Wait: 731 * -------- 732 * A zero timeout value indicates that we shouldn't wait - just 733 * acquire the semaphore if available otherwise return AE_TIME 734 * (a.k.a. 'would block'). 735 */ 736 case 0: 737 738 if (sem_trywait(sem) == -1) { 739 status = (AE_TIME); 740 } 741 break; 742 743 /* Wait Indefinitely */ 744 745 case ACPI_WAIT_FOREVER: 746 747 while (((ret_val = sem_wait(sem)) == -1) && (errno == EINTR)) { 748 continue; /* Restart if interrupted */ 749 } 750 if (ret_val != 0) { 751 status = (AE_TIME); 752 } 753 break; 754 755 /* Wait with msec_timeout */ 756 757 default: 758 759 #ifdef ACPI_USE_ALTERNATE_TIMEOUT 760 /* 761 * Alternate timeout mechanism for environments where 762 * sem_timedwait is not available or does not work properly. 763 */ 764 while (msec_timeout) { 765 if (sem_trywait(sem) == 0) { 766 767 /* Got the semaphore */ 768 return (AE_OK); 769 } 770 771 if (msec_timeout >= 10) { 772 msec_timeout -= 10; 773 usleep(10 * ACPI_USEC_PER_MSEC); /* ten milliseconds */ 774 } else { 775 msec_timeout--; 776 usleep(ACPI_USEC_PER_MSEC); /* one millisecond */ 777 } 778 } 779 status = (AE_TIME); 780 #else 781 /* 782 * The interface to sem_timedwait is an absolute time, so we need to 783 * get the current time, then add in the millisecond Timeout value. 784 */ 785 if (clock_gettime(CLOCK_REALTIME, &time) == -1) { 786 perror("clock_gettime"); 787 return (AE_TIME); 788 } 789 790 time.tv_sec += (msec_timeout / ACPI_MSEC_PER_SEC); 791 time.tv_nsec += 792 ((msec_timeout % ACPI_MSEC_PER_SEC) * ACPI_NSEC_PER_MSEC); 793 794 /* Handle nanosecond overflow (field must be less than one second) */ 795 796 if (time.tv_nsec >= ACPI_NSEC_PER_SEC) { 797 time.tv_sec += (time.tv_nsec / ACPI_NSEC_PER_SEC); 798 time.tv_nsec = (time.tv_nsec % ACPI_NSEC_PER_SEC); 799 } 800 801 while (((ret_val = sem_timedwait(sem, &time)) == -1) 802 && (errno == EINTR)) { 803 continue; /* Restart if interrupted */ 804 805 } 806 807 if (ret_val != 0) { 808 if (errno != ETIMEDOUT) { 809 perror("sem_timedwait"); 810 } 811 status = (AE_TIME); 812 } 813 #endif 814 break; 815 } 816 817 return (status); 818 } 819 820 /****************************************************************************** 821 * 822 * FUNCTION: acpi_os_signal_semaphore 823 * 824 * PARAMETERS: handle - Handle returned by acpi_os_create_semaphore 825 * units - Number of units to send 826 * 827 * RETURN: Status 828 * 829 * DESCRIPTION: Send units 830 * 831 *****************************************************************************/ 832 833 acpi_status acpi_os_signal_semaphore(acpi_handle handle, u32 units) 834 { 835 sem_t *sem = (sem_t *) handle; 836 837 if (!sem) { 838 return (AE_BAD_PARAMETER); 839 } 840 841 if (sem_post(sem) == -1) { 842 return (AE_LIMIT); 843 } 844 845 return (AE_OK); 846 } 847 848 #endif /* ACPI_SINGLE_THREADED */ 849 850 /****************************************************************************** 851 * 852 * FUNCTION: Spinlock interfaces 853 * 854 * DESCRIPTION: Map these interfaces to semaphore interfaces 855 * 856 *****************************************************************************/ 857 858 acpi_status acpi_os_create_lock(acpi_spinlock * out_handle) 859 { 860 861 return (acpi_os_create_semaphore(1, 1, out_handle)); 862 } 863 864 void acpi_os_delete_lock(acpi_spinlock handle) 865 { 866 acpi_os_delete_semaphore(handle); 867 } 868 869 acpi_cpu_flags acpi_os_acquire_lock(acpi_handle handle) 870 { 871 acpi_os_wait_semaphore(handle, 1, 0xFFFF); 872 return (0); 873 } 874 875 void acpi_os_release_lock(acpi_spinlock handle, acpi_cpu_flags flags) 876 { 877 acpi_os_signal_semaphore(handle, 1); 878 } 879 880 /****************************************************************************** 881 * 882 * FUNCTION: acpi_os_install_interrupt_handler 883 * 884 * PARAMETERS: interrupt_number - Level handler should respond to. 885 * isr - Address of the ACPI interrupt handler 886 * except_ptr - Where status is returned 887 * 888 * RETURN: Handle to the newly installed handler. 889 * 890 * DESCRIPTION: Install an interrupt handler. Used to install the ACPI 891 * OS-independent handler. 892 * 893 *****************************************************************************/ 894 895 u32 896 acpi_os_install_interrupt_handler(u32 interrupt_number, 897 acpi_osd_handler service_routine, 898 void *context) 899 { 900 901 return (AE_OK); 902 } 903 904 /****************************************************************************** 905 * 906 * FUNCTION: acpi_os_remove_interrupt_handler 907 * 908 * PARAMETERS: handle - Returned when handler was installed 909 * 910 * RETURN: Status 911 * 912 * DESCRIPTION: Uninstalls an interrupt handler. 913 * 914 *****************************************************************************/ 915 916 acpi_status 917 acpi_os_remove_interrupt_handler(u32 interrupt_number, 918 acpi_osd_handler service_routine) 919 { 920 921 return (AE_OK); 922 } 923 924 /****************************************************************************** 925 * 926 * FUNCTION: acpi_os_stall 927 * 928 * PARAMETERS: microseconds - Time to sleep 929 * 930 * RETURN: Blocks until sleep is completed. 931 * 932 * DESCRIPTION: Sleep at microsecond granularity 933 * 934 *****************************************************************************/ 935 936 void acpi_os_stall(u32 microseconds) 937 { 938 939 if (microseconds) { 940 usleep(microseconds); 941 } 942 } 943 944 /****************************************************************************** 945 * 946 * FUNCTION: acpi_os_sleep 947 * 948 * PARAMETERS: milliseconds - Time to sleep 949 * 950 * RETURN: Blocks until sleep is completed. 951 * 952 * DESCRIPTION: Sleep at millisecond granularity 953 * 954 *****************************************************************************/ 955 956 void acpi_os_sleep(u64 milliseconds) 957 { 958 959 /* Sleep for whole seconds */ 960 961 sleep(milliseconds / ACPI_MSEC_PER_SEC); 962 963 /* 964 * Sleep for remaining microseconds. 965 * Arg to usleep() is in usecs and must be less than 1,000,000 (1 second). 966 */ 967 usleep((milliseconds % ACPI_MSEC_PER_SEC) * ACPI_USEC_PER_MSEC); 968 } 969 970 /****************************************************************************** 971 * 972 * FUNCTION: acpi_os_get_timer 973 * 974 * PARAMETERS: None 975 * 976 * RETURN: Current time in 100 nanosecond units 977 * 978 * DESCRIPTION: Get the current system time 979 * 980 *****************************************************************************/ 981 982 u64 acpi_os_get_timer(void) 983 { 984 struct timeval time; 985 986 /* This timer has sufficient resolution for user-space application code */ 987 988 gettimeofday(&time, NULL); 989 990 /* (Seconds * 10^7 = 100ns(10^-7)) + (Microseconds(10^-6) * 10^1 = 100ns) */ 991 992 return (((u64)time.tv_sec * ACPI_100NSEC_PER_SEC) + 993 ((u64)time.tv_usec * ACPI_100NSEC_PER_USEC)); 994 } 995 996 /****************************************************************************** 997 * 998 * FUNCTION: acpi_os_read_pci_configuration 999 * 1000 * PARAMETERS: pci_id - Seg/Bus/Dev 1001 * pci_register - Device Register 1002 * value - Buffer where value is placed 1003 * width - Number of bits 1004 * 1005 * RETURN: Status 1006 * 1007 * DESCRIPTION: Read data from PCI configuration space 1008 * 1009 *****************************************************************************/ 1010 1011 acpi_status 1012 acpi_os_read_pci_configuration(struct acpi_pci_id *pci_id, 1013 u32 pci_register, u64 *value, u32 width) 1014 { 1015 1016 *value = 0; 1017 return (AE_OK); 1018 } 1019 1020 /****************************************************************************** 1021 * 1022 * FUNCTION: acpi_os_write_pci_configuration 1023 * 1024 * PARAMETERS: pci_id - Seg/Bus/Dev 1025 * pci_register - Device Register 1026 * value - Value to be written 1027 * width - Number of bits 1028 * 1029 * RETURN: Status. 1030 * 1031 * DESCRIPTION: Write data to PCI configuration space 1032 * 1033 *****************************************************************************/ 1034 1035 acpi_status 1036 acpi_os_write_pci_configuration(struct acpi_pci_id *pci_id, 1037 u32 pci_register, u64 value, u32 width) 1038 { 1039 1040 return (AE_OK); 1041 } 1042 1043 /****************************************************************************** 1044 * 1045 * FUNCTION: acpi_os_read_port 1046 * 1047 * PARAMETERS: address - Address of I/O port/register to read 1048 * value - Where value is placed 1049 * width - Number of bits 1050 * 1051 * RETURN: Value read from port 1052 * 1053 * DESCRIPTION: Read data from an I/O port or register 1054 * 1055 *****************************************************************************/ 1056 1057 acpi_status acpi_os_read_port(acpi_io_address address, u32 *value, u32 width) 1058 { 1059 1060 switch (width) { 1061 case 8: 1062 1063 *value = 0xFF; 1064 break; 1065 1066 case 16: 1067 1068 *value = 0xFFFF; 1069 break; 1070 1071 case 32: 1072 1073 *value = 0xFFFFFFFF; 1074 break; 1075 1076 default: 1077 1078 return (AE_BAD_PARAMETER); 1079 } 1080 1081 return (AE_OK); 1082 } 1083 1084 /****************************************************************************** 1085 * 1086 * FUNCTION: acpi_os_write_port 1087 * 1088 * PARAMETERS: address - Address of I/O port/register to write 1089 * value - Value to write 1090 * width - Number of bits 1091 * 1092 * RETURN: None 1093 * 1094 * DESCRIPTION: Write data to an I/O port or register 1095 * 1096 *****************************************************************************/ 1097 1098 acpi_status acpi_os_write_port(acpi_io_address address, u32 value, u32 width) 1099 { 1100 1101 return (AE_OK); 1102 } 1103 1104 /****************************************************************************** 1105 * 1106 * FUNCTION: acpi_os_read_memory 1107 * 1108 * PARAMETERS: address - Physical Memory Address to read 1109 * value - Where value is placed 1110 * width - Number of bits (8,16,32, or 64) 1111 * 1112 * RETURN: Value read from physical memory address. Always returned 1113 * as a 64-bit integer, regardless of the read width. 1114 * 1115 * DESCRIPTION: Read data from a physical memory address 1116 * 1117 *****************************************************************************/ 1118 1119 acpi_status 1120 acpi_os_read_memory(acpi_physical_address address, u64 *value, u32 width) 1121 { 1122 1123 switch (width) { 1124 case 8: 1125 case 16: 1126 case 32: 1127 case 64: 1128 1129 *value = 0; 1130 break; 1131 1132 default: 1133 1134 return (AE_BAD_PARAMETER); 1135 } 1136 return (AE_OK); 1137 } 1138 1139 /****************************************************************************** 1140 * 1141 * FUNCTION: acpi_os_write_memory 1142 * 1143 * PARAMETERS: address - Physical Memory Address to write 1144 * value - Value to write 1145 * width - Number of bits (8,16,32, or 64) 1146 * 1147 * RETURN: None 1148 * 1149 * DESCRIPTION: Write data to a physical memory address 1150 * 1151 *****************************************************************************/ 1152 1153 acpi_status 1154 acpi_os_write_memory(acpi_physical_address address, u64 value, u32 width) 1155 { 1156 1157 return (AE_OK); 1158 } 1159 1160 /****************************************************************************** 1161 * 1162 * FUNCTION: acpi_os_readable 1163 * 1164 * PARAMETERS: pointer - Area to be verified 1165 * length - Size of area 1166 * 1167 * RETURN: TRUE if readable for entire length 1168 * 1169 * DESCRIPTION: Verify that a pointer is valid for reading 1170 * 1171 *****************************************************************************/ 1172 1173 u8 acpi_os_readable(void *pointer, acpi_size length) 1174 { 1175 1176 return (TRUE); 1177 } 1178 1179 /****************************************************************************** 1180 * 1181 * FUNCTION: acpi_os_writable 1182 * 1183 * PARAMETERS: pointer - Area to be verified 1184 * length - Size of area 1185 * 1186 * RETURN: TRUE if writable for entire length 1187 * 1188 * DESCRIPTION: Verify that a pointer is valid for writing 1189 * 1190 *****************************************************************************/ 1191 1192 u8 acpi_os_writable(void *pointer, acpi_size length) 1193 { 1194 1195 return (TRUE); 1196 } 1197 1198 /****************************************************************************** 1199 * 1200 * FUNCTION: acpi_os_signal 1201 * 1202 * PARAMETERS: function - ACPI A signal function code 1203 * info - Pointer to function-dependent structure 1204 * 1205 * RETURN: Status 1206 * 1207 * DESCRIPTION: Miscellaneous functions. Example implementation only. 1208 * 1209 *****************************************************************************/ 1210 1211 acpi_status acpi_os_signal(u32 function, void *info) 1212 { 1213 1214 switch (function) { 1215 case ACPI_SIGNAL_FATAL: 1216 1217 break; 1218 1219 case ACPI_SIGNAL_BREAKPOINT: 1220 1221 break; 1222 1223 default: 1224 1225 break; 1226 } 1227 1228 return (AE_OK); 1229 } 1230 1231 /* Optional multi-thread support */ 1232 1233 #ifndef ACPI_SINGLE_THREADED 1234 /****************************************************************************** 1235 * 1236 * FUNCTION: acpi_os_get_thread_id 1237 * 1238 * PARAMETERS: None 1239 * 1240 * RETURN: Id of the running thread 1241 * 1242 * DESCRIPTION: Get the ID of the current (running) thread 1243 * 1244 *****************************************************************************/ 1245 1246 acpi_thread_id acpi_os_get_thread_id(void) 1247 { 1248 pthread_t thread; 1249 1250 thread = pthread_self(); 1251 return (ACPI_CAST_PTHREAD_T(thread)); 1252 } 1253 1254 /****************************************************************************** 1255 * 1256 * FUNCTION: acpi_os_execute 1257 * 1258 * PARAMETERS: type - Type of execution 1259 * function - Address of the function to execute 1260 * context - Passed as a parameter to the function 1261 * 1262 * RETURN: Status. 1263 * 1264 * DESCRIPTION: Execute a new thread 1265 * 1266 *****************************************************************************/ 1267 1268 acpi_status 1269 acpi_os_execute(acpi_execute_type type, 1270 acpi_osd_exec_callback function, void *context) 1271 { 1272 pthread_t thread; 1273 int ret; 1274 1275 ret = 1276 pthread_create(&thread, NULL, (PTHREAD_CALLBACK) function, context); 1277 if (ret) { 1278 acpi_os_printf("Create thread failed"); 1279 } 1280 return (0); 1281 } 1282 1283 #else /* ACPI_SINGLE_THREADED */ 1284 acpi_thread_id acpi_os_get_thread_id(void) 1285 { 1286 return (1); 1287 } 1288 1289 acpi_status 1290 acpi_os_execute(acpi_execute_type type, 1291 acpi_osd_exec_callback function, void *context) 1292 { 1293 1294 function(context); 1295 1296 return (AE_OK); 1297 } 1298 1299 #endif /* ACPI_SINGLE_THREADED */ 1300 1301 /****************************************************************************** 1302 * 1303 * FUNCTION: acpi_os_wait_events_complete 1304 * 1305 * PARAMETERS: None 1306 * 1307 * RETURN: None 1308 * 1309 * DESCRIPTION: Wait for all asynchronous events to complete. This 1310 * implementation does nothing. 1311 * 1312 *****************************************************************************/ 1313 1314 void acpi_os_wait_events_complete(void) 1315 { 1316 return; 1317 } 1318