From 938c8215eb9a6076bb4c930d6be388d6ab3da3fb Mon Sep 17 00:00:00 2001 From: Alejandro Colomar Date: Sun, 28 Feb 2021 01:48:11 +0100 Subject: [PATCH] gethostbyname.3: SYNOPSIS: Use 'restrict' in prototypes glibc uses 'restrict' in gethostent_r(), gethostbyaddr_r(), gethostbyname_r(), gethostbyname2_r(). Let's use it here too. .../glibc$ grep_glibc_prototype gethostent_r resolv/netdb.h:165: extern int gethostent_r (struct hostent *__restrict __result_buf, char *__restrict __buf, size_t __buflen, struct hostent **__restrict __result, int *__restrict __h_errnop); .../glibc$ grep_glibc_prototype gethostbyaddr_r resolv/netdb.h:170: extern int gethostbyaddr_r (const void *__restrict __addr, __socklen_t __len, int __type, struct hostent *__restrict __result_buf, char *__restrict __buf, size_t __buflen, struct hostent **__restrict __result, int *__restrict __h_errnop); .../glibc$ grep_glibc_prototype gethostbyname_r resolv/netdb.h:177: extern int gethostbyname_r (const char *__restrict __name, struct hostent *__restrict __result_buf, char *__restrict __buf, size_t __buflen, struct hostent **__restrict __result, int *__restrict __h_errnop); .../glibc$ grep_glibc_prototype gethostbyname2_r resolv/netdb.h:183: extern int gethostbyname2_r (const char *__restrict __name, int __af, struct hostent *__restrict __result_buf, char *__restrict __buf, size_t __buflen, struct hostent **__restrict __result, int *__restrict __h_errnop); .../glibc$ Signed-off-by: Alejandro Colomar Signed-off-by: Michael Kerrisk --- man3/gethostbyname.3 | 31 ++++++++++++++++++++----------- 1 file changed, 20 insertions(+), 11 deletions(-) diff --git a/man3/gethostbyname.3 b/man3/gethostbyname.3 index ac1758ca0..d2c456072 100644 --- a/man3/gethostbyname.3 +++ b/man3/gethostbyname.3 @@ -65,18 +65,27 @@ gethostent_r \- get network host entry /* GNU extensions */ .BI "struct hostent *gethostbyname2(const char *" name ", int " af ); .PP -.BI "int gethostent_r(struct hostent *" ret ", char *" buf ", size_t " buflen , -.BI " struct hostent **" result ", int *" h_errnop ); +.BI "int gethostent_r(struct hostent *restrict " ret , +.BI " char *restrict " buf ", size_t " buflen , +.BI " struct hostent **restrict " result , +.BI " int *restrict " h_errnop ); .PP -.BI "int gethostbyaddr_r(const void *" addr ", socklen_t " len ", int " type , -.BI " struct hostent *" ret ", char *" buf ", size_t " buflen , -.BI " struct hostent **" result ", int *" h_errnop ); -.BI "int gethostbyname_r(const char *" name , -.BI " struct hostent *" ret ", char *" buf ", size_t " buflen , -.BI " struct hostent **" result ", int *" h_errnop ); -.BI "int gethostbyname2_r(const char *" name ", int " af, -.BI " struct hostent *" ret ", char *" buf ", size_t " buflen , -.BI " struct hostent **" result ", int *" h_errnop ); +.BI "int gethostbyaddr_r(const void *restrict " addr ", socklen_t " len \ +", int " type , +.BI " struct hostent *restrict " ret , +.BI " char *restrict " buf ", size_t " buflen , +.BI " struct hostent **restrict " result , +.BI " int *restrict " h_errnop ); +.BI "int gethostbyname_r(const char *restrict " name , +.BI " struct hostent *restrict " ret , +.BI " char *restrict " buf ", size_t " buflen , +.BI " struct hostent **restrict " result , +.BI " int *restrict " h_errnop ); +.BI "int gethostbyname2_r(const char *restrict " name ", int " af, +.BI " struct hostent *restrict " ret , +.BI " char *restrict " buf ", size_t " buflen , +.BI " struct hostent **restrict " result , +.BI " int *restrict " h_errnop ); .fi .PP .RS -4