# epoll\_wait.2: epoll\_pwait2(2) prototype

- List: linux-api
- 3 messages, 2 authors
- Page: https://ratatoskr.run/linux-api/2021/03/201570/t

## epoll\_wait.2: epoll\_pwait2(2) prototype

- From: Alejandro Colomar (man-pages) \<hidden\>
- Date: 2021-03-13 16:48:54 
- Message: https://ratatoskr.run/linux-api/2021/03/201570.md

```text
Hi Willem,

I checked that the prototype of the kernel epoll_pwait2() syscall is different from the one we recently merged; it has one more parameter 'size_t sigsetsize':

$ grep_syscall epoll_pwait2
fs/eventpoll.c:2272:
SYSCALL_DEFINE6(epoll_pwait2, int, epfd, struct epoll_event __user *, events,
		int, maxevents, const struct __kernel_timespec __user *, timeout,
		const sigset_t __user *, sigmask, size_t, sigsetsize)
fs/eventpoll.c:2326:
COMPAT_SYSCALL_DEFINE6(epoll_pwait2, int, epfd,
		       struct epoll_event __user *, events,
		       int, maxevents,
		       const struct __kernel_timespec __user *, timeout,
		       const compat_sigset_t __user *, sigmask,
		       compat_size_t, sigsetsize)
include/linux/compat.h:540:
asmlinkage long compat_sys_epoll_pwait2(int epfd,
			struct epoll_event __user *events,
			int maxevents,
			const struct __kernel_timespec __user *timeout,
			const compat_sigset_t __user *sigmask,
			compat_size_t sigsetsize);
include/linux/syscalls.h:389:
asmlinkage long sys_epoll_pwait2(int epfd, struct epoll_event __user *events,
				 int maxevents,
				 const struct __kernel_timespec __user *timeout,
				 const sigset_t __user *sigmask,
				 size_t sigsetsize);

I'm could fix the prototype, but maybe there are more changes needed for the manual page.

Would you mind fixing it?

Thanks,

Alex

-- 
Alejandro Colomar
Linux man-pages comaintainer; https://www.kernel.org/doc/man-pages/
http://www.alejandro-colomar.es/
```

## Re: epoll\_wait.2: epoll\_pwait2(2) prototype

- From: Dmitry V. Levin \<hidden\>
- Date: 2021-03-13 17:03:30 
- Message: https://ratatoskr.run/linux-api/2021/03/201571.md

```text
Hi Alex,

On Sat, Mar 13, 2021 at 05:48:08PM +0100, Alejandro Colomar (man-pages) wrote:
> Hi Willem,
> 
> I checked that the prototype of the kernel epoll_pwait2() syscall is 
> different from the one we recently merged; it has one more parameter 
> 'size_t sigsetsize':
> 
> $ grep_syscall epoll_pwait2
> fs/eventpoll.c:2272:
> SYSCALL_DEFINE6(epoll_pwait2, int, epfd, struct epoll_event __user *, 
> events,
> 		int, maxevents, const struct __kernel_timespec __user *, timeout,
> 		const sigset_t __user *, sigmask, size_t, sigsetsize)
> fs/eventpoll.c:2326:
> COMPAT_SYSCALL_DEFINE6(epoll_pwait2, int, epfd,
> 		       struct epoll_event __user *, events,
> 		       int, maxevents,
> 		       const struct __kernel_timespec __user *, timeout,
> 		       const compat_sigset_t __user *, sigmask,
> 		       compat_size_t, sigsetsize)
> include/linux/compat.h:540:
> asmlinkage long compat_sys_epoll_pwait2(int epfd,
> 			struct epoll_event __user *events,
> 			int maxevents,
> 			const struct __kernel_timespec __user *timeout,
> 			const compat_sigset_t __user *sigmask,
> 			compat_size_t sigsetsize);
> include/linux/syscalls.h:389:
> asmlinkage long sys_epoll_pwait2(int epfd, struct epoll_event __user 
> *events,
> 				 int maxevents,
> 				 const struct __kernel_timespec __user *timeout,
> 				 const sigset_t __user *sigmask,
> 				 size_t sigsetsize);
> 
> I'm could fix the prototype, but maybe there are more changes needed for 
> the manual page.
> 
> Would you mind fixing it?

Looks like the 6th argument of epoll_pwait and epoll_pwait2 syscalls
is already described in "C library/kernel differences" subsection of
epoll_pwait2(2).


-- 
ldv
```

## Re: epoll\_wait.2: epoll\_pwait2(2) prototype

- From: Alejandro Colomar (man-pages) \<hidden\>
- Date: 2021-03-13 17:10:59 
- Message: https://ratatoskr.run/linux-api/2021/03/201572.md

```text
Hi Dmitry,

On 3/13/21 6:02 PM, Dmitry V. Levin wrote:
> Hi Alex,
>
> On Sat, Mar 13, 2021 at 05:48:08PM +0100, Alejandro Colomar (man-pages) wrote:
>> Hi Willem,
>>
>> I checked that the prototype of the kernel epoll_pwait2() syscall is
>> different from the one we recently merged; it has one more parameter
>> 'size_t sigsetsize':
[...]
>>
>> I'm could fix the prototype, but maybe there are more changes needed for
>> the manual page.
>>
>> Would you mind fixing it?
>
> Looks like the 6th argument of epoll_pwait and epoll_pwait2 syscalls
> is already described in "C library/kernel differences" subsection of
> epoll_pwait2(2).

Ahhh, I didn't see it, ok.  That's in BUGS by mistake.  I'll move it to NOTES, where it should be.

Thanks,

Alex

-- 
Alejandro Colomar
Linux man-pages comaintainer; https://www.kernel.org/doc/man-pages/
http://www.alejandro-colomar.es/
```