xfnw/plan9fox
1
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

aml(2): english

Browse source
This commit is contained in:
stanley lieber 2013-11-03 20:01:03 -05:00
parent f73bf5f90d
commit f637986cae
1 changed files with 8 additions and 8 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

16
sys/man/2/aml
View file

@ -31,7 +31,7 @@ void* amlroot;
int amldebug; int amldebug;
.EE .EE
.SH DESCRIPTION .SH DESCRIPTION
The aml library implements a interpreter for the ACPI machine language The aml library implements an interpreter for the ACPI machine language
byte code. byte code.
.PP .PP
The interpreter runtime state is initialized by calling The interpreter runtime state is initialized by calling
@ -40,7 +40,7 @@ and frees all the resources when
.I amlexit .I amlexit
is called. is called.
The runtime state consists of objects organized in a global The runtime state consists of objects organized in a global
namespace. The name object refered by namespace. The name object referred to by
.I amlroot .I amlroot
is the root of that namespace. is the root of that namespace.
.PP .PP
@ -74,7 +74,7 @@ underlying type:
.PP .PP
Name objects (like Name objects (like
.IR amlroot ) .IR amlroot )
can be traversed with can be traversed with the
.I amlenum .I amlenum
and and
.I amlwalk .I amlwalk
@ -107,19 +107,19 @@ for the current dot.
returns the value of a name, reference or field object. returns the value of a name, reference or field object.
Calling Calling
.I amlval .I amlval
on any other object yiedls the same object. on any other object yields the same object.
.PP .PP
.I Amllen .I Amllen
is defined for variable length objects like buffers, strings and packages. is defined for variable length objects like buffers, strings and packages.
For strings, the number of characters (not including terminating null byte) For strings, the number of characters (not including the terminating null byte)
is returned. For buffers, the size of the buffer in bytes is returned. is returned. For buffers, the size of the buffer in bytes is returned.
For packages (arrays), the number of elements is returned. For any other For packages (arrays), the number of elements is returned. For any other
object types, the return value is undefined. object types, the return value is undefined.
.PP .PP
.I Amlint .I Amlint
returns the integer value of an object. For strings, the string is interpreted returns the integer value of an object. For strings, the string is interpreted
as hexadecimal number. For buffers and buffer fields, the binary value is returned. as an hexadecimal number. For buffers and buffer fields, the binary value is returned.
Integers just return ther value. Any other object types yield zero. Integers just return their value. Any other object types yield zero.
.PP .PP
Integer, buffer, string and package objects can be created with the Integer, buffer, string and package objects can be created with the
.I amlnew .I amlnew
@ -191,7 +191,7 @@ extern void amlfree(void*);
.I Amlalloc .I Amlalloc
and and
.I amlfree .I amlfree
can be optionaly defined to control dynamic memory allocation can be optionally defined to control dynamic memory allocation
providing a way to limit or pool the memory allocated by acpi. providing a way to limit or pool the memory allocated by acpi.
If not provided, the library will use the functions If not provided, the library will use the functions
defined in defined in