[PATCH 4/8] lib: fwts_iasl.c: add more comments

[Keng-Yu Lin]

On Fri, May 25, 2012 at 6:40 PM, Colin King <colin.king at canonical.com> wrote:
> From: Colin Ian King <colin.king at canonical.com>
>
> Signed-off-by: Colin Ian King <colin.king at canonical.com>
> ---
>  src/lib/src/fwts_iasl.c |   34 +++++++++++++++++++++++++++++++++-
>  1 file changed, 33 insertions(+), 1 deletion(-)
>
> diff --git a/src/lib/src/fwts_iasl.c b/src/lib/src/fwts_iasl.c
> index d75d997..e3ef36a 100644
> --- a/src/lib/src/fwts_iasl.c
> +++ b/src/lib/src/fwts_iasl.c
> @@ -30,7 +30,14 @@
>  #include "fwts.h"
>  #include "fwts_iasl_interface.h"
>
> -static int fwts_iasl_dump_aml_to_file(fwts_framework *fw, const uint8_t *data, const int length, const char *amlfile)
> +/*
> + *  fwts_iasl_dump_aml_to_file()
> + *     write AML data of given length to file amlfile.
> + */
> +static int fwts_iasl_dump_aml_to_file(fwts_framework *fw,
> +       const uint8_t *data,
> +       const int length,
> +       const char *amlfile)
>  {
>        int fd;
>
> @@ -51,6 +58,13 @@ static int fwts_iasl_dump_aml_to_file(fwts_framework *fw, const uint8_t *data, c
>        return FWTS_OK;
>  }
>
> +/*
> + *  fwts_iasl_disassemble_to_file()
> + *     Disassemble a given table and dump disassembly to a file.
> + *     For tables where there are multiple matches, e.g. SSDT, we
> + *     specify the Nth table with 'which'.
> + *
> + */
>  int fwts_iasl_disassemble_to_file(fwts_framework *fw,
>        const char *tablename,
>        const int which,
> @@ -83,6 +97,13 @@ int fwts_iasl_disassemble_to_file(fwts_framework *fw,
>        return FWTS_OK;
>  }
>
> +/*
> + *  fwts_iasl_disassemble()
> + *     Disassemble a given table and dump disassembly list of strings.
> + *     For tables where there are multiple matches, e.g. SSDT, we
> + *     specify the Nth table with 'which'.
> + *
> + */
>  int fwts_iasl_disassemble(fwts_framework *fw,
>        const char *tablename,
>        const int which,
> @@ -108,6 +129,11 @@ int fwts_iasl_disassemble(fwts_framework *fw,
>        return *iasl_output ? FWTS_OK : FWTS_ERROR;
>  }
>
> +
> +/*
> + *  fwts_iasl_disassemble_all_to_file()
> + *     Disassemble DSDT and SSDT tables to separate files.
> + */
>  int fwts_iasl_disassemble_all_to_file(fwts_framework *fw)
>  {
>        int i;
> @@ -133,6 +159,12 @@ int fwts_iasl_disassemble_all_to_file(fwts_framework *fw)
>        return FWTS_OK;
>  }
>
> +/*
> + *  fwts_iasl_reassemble()
> + *     given a ACPI table in 'data', lenth 'len, go and disassemble it
> + *     and re-assemble it.  Dump the disassembly into list iasl_disassembly and
> + *     any re-assembly errors into list iasl_errors.
> + */
>  int fwts_iasl_reassemble(fwts_framework *fw,
>        const uint8_t *data,
>        const int len,
> --
> 1.7.10
>
Acked-by: Keng-Yu Lin <kengyu at canonical.com>