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

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

[Alejandro Colomar]

All but the last parameters of t[g]kill() use 'pid_t',
both in the kernel and glibc.  Fix them.

......

.../linux/linux$ grep_syscall tkill
kernel/signal.c:3870:
SYSCALL_DEFINE2(tkill, pid_t, pid, int, sig)
include/linux/syscalls.h:685:
asmlinkage long sys_tkill(pid_t pid, int sig);
.../linux/linux$

.../gnu/glibc$ grep_glibc_prototype tgkill
sysdeps/unix/sysv/linux/bits/signal_ext.h:29:
extern int tgkill (__pid_t __tgid, __pid_t __tid, int __signal);
.../gnu/glibc$

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
---
 man2/tkill.2 | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/man2/tkill.2 b/man2/tkill.2
index 4b4eae312..24636719d 100644
--- a/man2/tkill.2
+++ b/man2/tkill.2
@@ -31,8 +31,8 @@
 tkill, tgkill \- send a signal to a thread
 .SH SYNOPSIS
 .nf
-.BI "int tkill(int " tid ", int " sig );
-.BI "int tgkill(int " tgid ", int " tid ", int " sig );
+.BI "int tkill(pid_t " tid ", int " sig );
+.BI "int tgkill(pid_t " tgid ", pid_t " tid ", int " sig );
 .fi
 .PP
 .IR Note :
-- 
2.30.0

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

[Michael Kerrisk (man-pages)]

Hi Alex,

On 2/15/21 2:15 PM, Alejandro Colomar wrote:
> All but the last parameters of t[g]kill() use 'pid_t',
> both in the kernel and glibc.  Fix them.
> 
> ......
> 
> .../linux/linux$ grep_syscall tkill
> kernel/signal.c:3870:
> SYSCALL_DEFINE2(tkill, pid_t, pid, int, sig)
> include/linux/syscalls.h:685:
> asmlinkage long sys_tkill(pid_t pid, int sig);
> .../linux/linux$
> 
> .../gnu/glibc$ grep_glibc_prototype tgkill
> sysdeps/unix/sysv/linux/bits/signal_ext.h:29:
> extern int tgkill (__pid_t __tgid, __pid_t __tid, int __signal);
> .../gnu/glibc$
> 
> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>


Thanks! Patch applied.

Cheers,

Michael


> ---
>  man2/tkill.2 | 4 ++--
>  1 file changed, 2 insertions(+), 2 deletions(-)
> 
> diff --git a/man2/tkill.2 b/man2/tkill.2
> index 4b4eae312..24636719d 100644
> --- a/man2/tkill.2
> +++ b/man2/tkill.2
> @@ -31,8 +31,8 @@
>  tkill, tgkill \- send a signal to a thread
>  .SH SYNOPSIS
>  .nf
> -.BI "int tkill(int " tid ", int " sig );
> -.BI "int tgkill(int " tgid ", int " tid ", int " sig );
> +.BI "int tkill(pid_t " tid ", int " sig );
> +.BI "int tgkill(pid_t " tgid ", pid_t " tid ", int " sig );
>  .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/