[LTP] [PATCH] c-test-tutorial-simple.txt: improve documentation

Petr Vorel pvorel@suse.cz
Thu Jan 12 01:05:40 CET 2023


Hi Avinesh,

> Signed-off-by: Avinesh Kumar <akumar@suse.de>
> ---
>  doc/c-test-tutorial-simple.txt | 12 ++++++------
>  1 file changed, 6 insertions(+), 6 deletions(-)

> diff --git a/doc/c-test-tutorial-simple.txt b/doc/c-test-tutorial-simple.txt
> index 89b0ad4e7..c5861cb36 100644
> --- a/doc/c-test-tutorial-simple.txt
> +++ b/doc/c-test-tutorial-simple.txt
> @@ -333,16 +333,16 @@ call in the +*.in+ files (e.g. +x86_64.in+) which are used to generate
>  may find the system call number is missing from the +*.in+ files and will need
>  to add it (see +include/lapi/syscalls/strip_syscall.awk+).

> -System call numbers vary between architectures, hence why there are multiple
> +System call numbers vary between architectures, hence there are multiple
>  +*.in+ files for each architecture. You can find the various values for the
> -+statx+ system call across a number of +uinstd.h+ files in the Linux kernel.
> ++statx+ system call across a number of +unistd.h+ files in the Linux kernel.

>  Note that we don't use the system-call-identifier value available in
> -+/usr/include/linux/uinstd.h+ because the kernel might be much newer than the
> ++/include/uapi/linux/unistd.h+ because the kernel might be much newer than the
NOTE: /include/uapi/linux/unistd.h does not exists. include/uapi/linux/unistd.h
is relative path in kernel git tree. The same file exists as
/usr/include/linux/unistd.h as part of kernel headers distro package.

I'd prefer to keep /usr/include/linux/unistd.h as a real path.

The other changes are good. Thank you for carefully reading docs and fixing
them!

Reviewed-by: Petr Vorel <pvorel@suse.cz>

Kind regards,
Petr

>  user land development packages.

> -For +statx+ we had to add +statx 332+ to +testcases/kernel/include/x86_64.in+,
> -+statx 383+ to +testcases/kernel/include/powerpc.in+, etc.  Now lets look at
> +For +statx+ we had to add +statx 332+ to +include/lapi/syscalls/x86_64.in+,
> ++statx 383+ to +include/lapi/syscalls/powerpc.in+, etc.  Now lets look at
>  the code, which I will explain in more detail further down.

>  [source,c]
> @@ -1007,7 +1007,7 @@ We can then send this patch with the following command sans +--dry-run+.
>  $ git send-email --dry-run output/v2-0001-tutorial-Add-a-step-by-step-C-test-tutorial.patch
>  --------------------------------------------------------------------------------

> -Git will ask some questions (which you an ignore) and then tell you what it
> +Git will ask some questions (which you can ignore) and then tell you what it
>  would do if this weren't a dry-run. In order for this to work you have to have
>  a valid SMTP server set in +.gitconfig+ and also be signed up to the LTP
>  mailing list under the same e-mail address you have configured in Git. You can


More information about the ltp mailing list