[PATCH] keyctl.2: SYNOPSIS: Fix prototype parameter types

[PATCH] keyctl.2: SYNOPSIS: Fix prototype parameter types

[Alejandro Colomar]

The Linux kernel uses 'unsigned long'.
There's no reason to use the typedef '__kernel_ulong_t'.

......

$ syscall='keyctl';
$ find linux/ -type f -name '*.c' \
  |xargs pcregrep -Mn "(?s)^[\w_]*SYSCALL_DEFINE.\(${syscall},.*?\)";
linux/security/keys/keyctl.c:1869:
SYSCALL_DEFINE5(keyctl, int, option, unsigned long, arg2, unsigned long, arg3,
		unsigned long, arg4, unsigned long, arg5)
linux/security/keys/compat.c:17:
COMPAT_SYSCALL_DEFINE5(keyctl, u32, option,
		       u32, arg2, u32, arg3, u32, arg4, u32, arg5)

Cc: Eugene Syromyatnikov <evgsyr@gmail.com>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
---
 man2/keyctl.2 | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/man2/keyctl.2 b/man2/keyctl.2
index 9311100cf..ea3a5d3dd 100644
--- a/man2/keyctl.2
+++ b/man2/keyctl.2
@@ -40,9 +40,9 @@ keyctl \- manipulate the kernel's key management facility
 .B #include <linux/keyctl.h>
 .B #include <unistd.h>
 .PP
-.BI "long syscall(__NR_keyctl, int " operation ", __kernel_ulong_t " arg2 ,
-.BI "             __kernel_ulong_t " arg3 ", __kernel_ulong_t " arg4 ,
-.BI "             __kernel_ulong_t " arg5 );
+.BI "long syscall(__NR_keyctl, int " operation ", unsigned long " arg2 ,
+.BI "             unsigned long " arg3 ", unsigned long " arg4 ,
+.BI "             unsigned long " arg5 );
 .fi
 .PP
 .IR Note :
-- 
2.29.2

Re: [PATCH] keyctl.2: SYNOPSIS: Fix prototype parameter types

[Michael Kerrisk (man-pages)]

Hi Alex,

On 12/30/20 10:41 PM, Alejandro Colomar wrote:
> The Linux kernel uses 'unsigned long'.
> There's no reason to use the typedef '__kernel_ulong_t'.
> 
> ......
> 
> $ syscall='keyctl';
> $ find linux/ -type f -name '*.c' \
>   |xargs pcregrep -Mn "(?s)^[\w_]*SYSCALL_DEFINE.\(${syscall},.*?\)";
> linux/security/keys/keyctl.c:1869:
> SYSCALL_DEFINE5(keyctl, int, option, unsigned long, arg2, unsigned long, arg3,
> 		unsigned long, arg4, unsigned long, arg5)
> linux/security/keys/compat.c:17:
> COMPAT_SYSCALL_DEFINE5(keyctl, u32, option,
> 		       u32, arg2, u32, arg3, u32, arg4, u32, arg5)
> 
> Cc: Eugene Syromyatnikov <evgsyr@gmail.com>
> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

Thanks. Patch applied.

Cheers,

Michael

> ---
>  man2/keyctl.2 | 6 +++---
>  1 file changed, 3 insertions(+), 3 deletions(-)
> 
> diff --git a/man2/keyctl.2 b/man2/keyctl.2
> index 9311100cf..ea3a5d3dd 100644
> --- a/man2/keyctl.2
> +++ b/man2/keyctl.2
> @@ -40,9 +40,9 @@ keyctl \- manipulate the kernel's key management facility
>  .B #include <linux/keyctl.h>
>  .B #include <unistd.h>
>  .PP
> -.BI "long syscall(__NR_keyctl, int " operation ", __kernel_ulong_t " arg2 ,
> -.BI "             __kernel_ulong_t " arg3 ", __kernel_ulong_t " arg4 ,
> -.BI "             __kernel_ulong_t " arg5 );
> +.BI "long syscall(__NR_keyctl, int " operation ", unsigned long " arg2 ,
> +.BI "             unsigned long " arg3 ", unsigned long " arg4 ,
> +.BI "             unsigned long " arg5 );
>  .fi
>  .PP
>  .IR Note :
> 


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/