diff options
Diffstat (limited to 'generate/unix/readme.txt')
| -rw-r--r-- | generate/unix/readme.txt | 83 |
1 files changed, 76 insertions, 7 deletions
diff --git a/generate/unix/readme.txt b/generate/unix/readme.txt index 6e20a437b5de..c68b936bb6f2 100644 --- a/generate/unix/readme.txt +++ b/generate/unix/readme.txt @@ -1,26 +1,44 @@ -Unix ACPICA makefiles ---------------------- +Generic Unix ACPICA makefiles +----------------------------- -These makefiles are intended for generating the ACPICA utilities in +These makefiles are intended to generate the ACPICA utilities in a Unix-like environment, with the original ACPICA code (not linuxized), and in the original (git tree) ACPICA directory structure. +Windows binary versions of these tools are available at: + +http://www.acpica.org/downloads/binary_tools.php + +Documentation is available at acpica.org: + +http://www.acpica.org/documentation/ + The top level makefile will generate the following utilities: +Note: These utilities are tested and supported as 32-bit versions +only. +acpibin acpiexec +acpihelp acpinames acpisrc acpixtract iasl +To generate all utilities: + +cd acpica/generate/unix +make +make install /* install all binaries to /usr/bin */ + Requirements ------------ make -gcc compiler (3+ or 4+) -bison -flex +gcc compiler (4+) +bison or yacc +flex or lex Configuration @@ -29,7 +47,7 @@ Configuration The Makefile.config file contains the configuration information: HOST = _CYGWIN /* Host system, must appear in acenv.h */ -CC = gcc-4 /* C compiler */ +CC = gcc /* C compiler */ ACPICA_SRC = ../../../source /* Location of acpica source tree */ @@ -49,3 +67,54 @@ The executable utilities are copied to the local bin directory. "make install" will install the binaries to /usr/bin + + +1) acpibin, an AML file tool + +acpibin compares AML files, dumps AML binary files to text files, +extracts binary AML from text files, and other AML file +manipulation. + + +2) acpiexec, a user-space AML interpreter + +acpiexec allows the loading of ACPI tables and execution of control +methods from user space. Useful for debugging AML code and testing +the AML interpreter. Hardware access is simulated. + + +3) acpihelp, syntax help for ASL operators and reserved names + +acpihelp displays the syntax for all of the ASL operators, as well +as information about the ASL/ACPI reserved names (4-char names that +start with underscore.) + + +4) acpinames, load and dump acpi namespace + +acpinames loads an ACPI namespace from a binary ACPI table file. +This is a smaller version of acpiexec that loads an acpi table and +dumps the resulting namespace. It is primarily intended to demonstrate +the configurability of ACPICA. + + +5) acpisrc, a source code conversion tool + +acpisrc converts the standard form of the acpica source release (included +here) into a version that meets Linux coding guidelines. This consists +mainly of performing a series of string replacements and transformations +to the code. It can also be used to clean the acpica source and generate +statistics. + + +6) acpixtract, extract binary ACPI tables from an acpidump + +acpixtract is used to extract binary ACPI tables from the ASCII text +output of an acpidump utility (available on several different hosts.) + + +7) iasl, an optimizing ASL compiler/disassembler + +iasl compiles ASL (ACPI Source Language) into AML (ACPI Machine +Language). This AML is suitable for inclusion as a DSDT in system +firmware. It also can disassemble AML, for debugging purposes. |