execveat.2: Normalize notes about missing wrappers

Message ID 20210116145858.7754-1-alx.manpages@gmail.com
State Not applicable
Headers
Series execveat.2: Normalize notes about missing wrappers |

Commit Message

Alejandro Colomar Jan. 16, 2021, 2:58 p.m. UTC
  It's been a long time sine kernel 3.19.
There's still no glibc wrapper.

......

$ grep -rn 'execveat *(' glibc/
$

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

Comments

Michael Kerrisk \(man-pages\) Jan. 17, 2021, 8:35 p.m. UTC | #1
Hi Alex,

On 1/16/21 3:58 PM, Alejandro Colomar wrote:
> It's been a long time sine kernel 3.19.
> There's still no glibc wrapper.

Fair enough! Patch applid.

Thanks,

Michael

> 
> ......
> 
> $ grep -rn 'execveat *(' glibc/
> $
> 
> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
> ---
>  man2/execveat.2 | 12 ++++++++----
>  1 file changed, 8 insertions(+), 4 deletions(-)
> 
> diff --git a/man2/execveat.2 b/man2/execveat.2
> index ef3606d8b..02d9c7331 100644
> --- a/man2/execveat.2
> +++ b/man2/execveat.2
> @@ -30,10 +30,13 @@ execveat \- execute program relative to a directory file descriptor
>  .nf
>  .B #include <unistd.h>
>  .PP
> -.BI "int execveat(int " dirfd ", const char *" pathname ","
> -.BI "             char *const " argv "[], char *const " envp "[],"
> +.BI "int execveat(int " dirfd ", const char *" pathname ,
> +.BI "             char *const " argv "[], char *const " envp [],
>  .BI "             int " flags );
>  .fi
> +.PP
> +.IR Note :
> +There is no glibc wrapper for this system call; see NOTES.
>  .SH DESCRIPTION
>  .\" commit 51f39a1f0cea1cacf8c787f652f26dfee9611874
>  The
> @@ -160,8 +163,6 @@ is a file descriptor referring to a file other than a directory.
>  .SH VERSIONS
>  .BR execveat ()
>  was added to Linux in kernel 3.19.
> -GNU C library support is pending.
> -.\" FIXME . check for glibc support in a future release
>  .SH CONFORMING TO
>  The
>  .BR execveat ()
> @@ -207,6 +208,9 @@ the natural idiom when using
>  is to set the close-on-exec flag on
>  .IR dirfd .
>  (But see BUGS.)
> +.PP
> +Glibc does not provide a wrapper for this system call; call it using
> +.BR syscall (2).
>  .SH BUGS
>  The
>  .B ENOENT
>
  

Patch

diff --git a/man2/execveat.2 b/man2/execveat.2
index ef3606d8b..02d9c7331 100644
--- a/man2/execveat.2
+++ b/man2/execveat.2
@@ -30,10 +30,13 @@  execveat \- execute program relative to a directory file descriptor
 .nf
 .B #include <unistd.h>
 .PP
-.BI "int execveat(int " dirfd ", const char *" pathname ","
-.BI "             char *const " argv "[], char *const " envp "[],"
+.BI "int execveat(int " dirfd ", const char *" pathname ,
+.BI "             char *const " argv "[], char *const " envp [],
 .BI "             int " flags );
 .fi
+.PP
+.IR Note :
+There is no glibc wrapper for this system call; see NOTES.
 .SH DESCRIPTION
 .\" commit 51f39a1f0cea1cacf8c787f652f26dfee9611874
 The
@@ -160,8 +163,6 @@  is a file descriptor referring to a file other than a directory.
 .SH VERSIONS
 .BR execveat ()
 was added to Linux in kernel 3.19.
-GNU C library support is pending.
-.\" FIXME . check for glibc support in a future release
 .SH CONFORMING TO
 The
 .BR execveat ()
@@ -207,6 +208,9 @@  the natural idiom when using
 is to set the close-on-exec flag on
 .IR dirfd .
 (But see BUGS.)
+.PP
+Glibc does not provide a wrapper for this system call; call it using
+.BR syscall (2).
 .SH BUGS
 The
 .B ENOENT