pkgbase: Create a FreeBSD-ctf-tools package

[manu]

Summary

It contains the ctf tools that most users will never use.

Sponsored by: Beckhoff Automation GmbH & Co. KG

[emaste]

should we call it ctftools or ctfutils or such?
I might guess it contains the ctf data otherwise.

[manu]

In D38223#868781, @emaste wrote:

should we call it ctftools or ctfutils or such?
I might guess it contains the ctf data otherwise.

Sure, I'll rename it.

[manu]

Rename to ctf-tools

cddl/usr.bin/ctfconvert/Makefile

 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
 .\"     From: @(#)gethostbyname.3  8.4 (Berkeley) 5/25/95
 .\" $FreeBSD$
 .\"
-.Dd October 4, 2017
+.Dd June 20, 2022
 .Dt GETHOSTBYNAME 3
 .Os
 .Sh NAME
 .Nm gethostbyname ,
 .Nm gethostbyname2 ,
 .Nm gethostbyaddr ,
 .Nm gethostent ,
 .Nm sethostent ,
 .Nm endhostent ,
 .Nm herror ,
-.Nm hstrerror
+.Nm hstrerror ,
+.Nm gethostbyname_r ,
+.Nm gethostbyname2_r ,
+.Nm gethostbyaddr_r
 .Nd get network host entry
 .Sh LIBRARY
 .Lb libc
 .Sh SYNOPSIS
 .In netdb.h
 .Vt int h_errno ;
 .Ft struct hostent *
 .Fn gethostbyname "const char *name"
 .Ft struct hostent *
 .Fn gethostbyname2 "const char *name" "int af"
 .Ft struct hostent *
 .Fn gethostbyaddr "const void *addr" "socklen_t len" "int af"
 .Ft struct hostent *
 .Fn gethostent void
 .Ft void
 .Fn sethostent "int stayopen"
 .Ft void
 .Fn endhostent void
 .Ft void
 .Fn herror "const char *string"
 .Ft const char *
 .Fn hstrerror "int err"
+.Ft int
+.Fn gethostbyname_r "const char *name" "struct hostent *he" "char *buffer" "size_t buflen" "struct hostent **result" "int *h_errnop"
+.Ft int
+.Fn gethostbyname2_r "const char *name" "int af" "struct hostent *he" "char *buffer" "size_t buflen" "struct hostent **result" "int *h_errnop"
+.Ft int
+.Fn gethostbyaddr_r "const void *addr" "socklen_t len" "int af" "struct hostent *hp" "char *buf" "size_t buflen" "struct hostent **result" "int *h_errno"p
 .Sh DESCRIPTION
 .Bf -symbolic
 The
 .Xr getaddrinfo 3
 and
 .Xr getnameinfo 3
 functions are preferred over the
 .Fn gethostbyname ,

 .Va h_errno .
 .Pp
 The
 .Fn hstrerror
 function returns a string which is the message text corresponding to the
 value of the
 .Fa err
 argument.
+.Pp
+Functions with the
+.Em _r
+suffix provide reentrant versions of their respective counterparts.
+The caller must supply five additional parameters: a
+.Vt struct hostent
+variable to be filled on success, a
+.Va buffer
+of
+.Va buflen
+bytes in size, a
+.Vt struct hostent
+.Va result
+variable that will point to the result on success or be set to
+.Dv NULL
+on failure or if the name is not found.
+The
+.Va h_errnop
+variable will be filled with the error code if any.
+All these functions return 0 on success.
 .Sh FILES
 .Bl -tag -width /etc/nsswitch.conf -compact
 .It Pa /etc/hosts
 .It Pa /etc/nsswitch.conf
 .It Pa /etc/resolv.conf
 .El
 .Sh EXAMPLES
 Print out the hostname associated with a specific IP address:

cddl/usr.bin/ctfdump/Makefile

 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
 .\"     From: @(#)gethostbyname.3  8.4 (Berkeley) 5/25/95
 .\" $FreeBSD$
 .\"
-.Dd October 4, 2017
+.Dd June 20, 2022
 .Dt GETHOSTBYNAME 3
 .Os
 .Sh NAME
 .Nm gethostbyname ,
 .Nm gethostbyname2 ,
 .Nm gethostbyaddr ,
 .Nm gethostent ,
 .Nm sethostent ,
 .Nm endhostent ,
 .Nm herror ,
-.Nm hstrerror
+.Nm hstrerror ,
+.Nm gethostbyname_r ,
+.Nm gethostbyname2_r ,
+.Nm gethostbyaddr_r
 .Nd get network host entry
 .Sh LIBRARY
 .Lb libc
 .Sh SYNOPSIS
 .In netdb.h
 .Vt int h_errno ;
 .Ft struct hostent *
 .Fn gethostbyname "const char *name"
 .Ft struct hostent *
 .Fn gethostbyname2 "const char *name" "int af"
 .Ft struct hostent *
 .Fn gethostbyaddr "const void *addr" "socklen_t len" "int af"
 .Ft struct hostent *
 .Fn gethostent void
 .Ft void
 .Fn sethostent "int stayopen"
 .Ft void
 .Fn endhostent void
 .Ft void
 .Fn herror "const char *string"
 .Ft const char *
 .Fn hstrerror "int err"
+.Ft int
+.Fn gethostbyname_r "const char *name" "struct hostent *he" "char *buffer" "size_t buflen" "struct hostent **result" "int *h_errnop"
+.Ft int
+.Fn gethostbyname2_r "const char *name" "int af" "struct hostent *he" "char *buffer" "size_t buflen" "struct hostent **result" "int *h_errnop"
+.Ft int
+.Fn gethostbyaddr_r "const void *addr" "socklen_t len" "int af" "struct hostent *hp" "char *buf" "size_t buflen" "struct hostent **result" "int *h_errno"p
 .Sh DESCRIPTION
 .Bf -symbolic
 The
 .Xr getaddrinfo 3
 and
 .Xr getnameinfo 3
 functions are preferred over the
 .Fn gethostbyname ,

 .Va h_errno .
 .Pp
 The
 .Fn hstrerror
 function returns a string which is the message text corresponding to the
 value of the
 .Fa err
 argument.
+.Pp
+Functions with the
+.Em _r
+suffix provide reentrant versions of their respective counterparts.
+The caller must supply five additional parameters: a
+.Vt struct hostent
+variable to be filled on success, a
+.Va buffer
+of
+.Va buflen
+bytes in size, a
+.Vt struct hostent
+.Va result
+variable that will point to the result on success or be set to
+.Dv NULL
+on failure or if the name is not found.
+The
+.Va h_errnop
+variable will be filled with the error code if any.
+All these functions return 0 on success.
 .Sh FILES
 .Bl -tag -width /etc/nsswitch.conf -compact
 .It Pa /etc/hosts
 .It Pa /etc/nsswitch.conf
 .It Pa /etc/resolv.conf
 .El
 .Sh EXAMPLES
 Print out the hostname associated with a specific IP address:

cddl/usr.bin/ctfmerge/Makefile

 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
 .\"     From: @(#)gethostbyname.3  8.4 (Berkeley) 5/25/95
 .\" $FreeBSD$
 .\"
-.Dd October 4, 2017
+.Dd June 20, 2022
 .Dt GETHOSTBYNAME 3
 .Os
 .Sh NAME
 .Nm gethostbyname ,
 .Nm gethostbyname2 ,
 .Nm gethostbyaddr ,
 .Nm gethostent ,
 .Nm sethostent ,
 .Nm endhostent ,
 .Nm herror ,
-.Nm hstrerror
+.Nm hstrerror ,
+.Nm gethostbyname_r ,
+.Nm gethostbyname2_r ,
+.Nm gethostbyaddr_r
 .Nd get network host entry
 .Sh LIBRARY
 .Lb libc
 .Sh SYNOPSIS
 .In netdb.h
 .Vt int h_errno ;
 .Ft struct hostent *
 .Fn gethostbyname "const char *name"
 .Ft struct hostent *
 .Fn gethostbyname2 "const char *name" "int af"
 .Ft struct hostent *
 .Fn gethostbyaddr "const void *addr" "socklen_t len" "int af"
 .Ft struct hostent *
 .Fn gethostent void
 .Ft void
 .Fn sethostent "int stayopen"
 .Ft void
 .Fn endhostent void
 .Ft void
 .Fn herror "const char *string"
 .Ft const char *
 .Fn hstrerror "int err"
+.Ft int
+.Fn gethostbyname_r "const char *name" "struct hostent *he" "char *buffer" "size_t buflen" "struct hostent **result" "int *h_errnop"
+.Ft int
+.Fn gethostbyname2_r "const char *name" "int af" "struct hostent *he" "char *buffer" "size_t buflen" "struct hostent **result" "int *h_errnop"
+.Ft int
+.Fn gethostbyaddr_r "const void *addr" "socklen_t len" "int af" "struct hostent *hp" "char *buf" "size_t buflen" "struct hostent **result" "int *h_errno"p
 .Sh DESCRIPTION
 .Bf -symbolic
 The
 .Xr getaddrinfo 3
 and
 .Xr getnameinfo 3
 functions are preferred over the
 .Fn gethostbyname ,

 .Va h_errno .
 .Pp
 The
 .Fn hstrerror
 function returns a string which is the message text corresponding to the
 value of the
 .Fa err
 argument.
+.Pp
+Functions with the
+.Em _r
+suffix provide reentrant versions of their respective counterparts.
+The caller must supply five additional parameters: a
+.Vt struct hostent
+variable to be filled on success, a
+.Va buffer
+of
+.Va buflen
+bytes in size, a
+.Vt struct hostent
+.Va result
+variable that will point to the result on success or be set to
+.Dv NULL
+on failure or if the name is not found.
+The
+.Va h_errnop
+variable will be filled with the error code if any.
+All these functions return 0 on success.
 .Sh FILES
 .Bl -tag -width /etc/nsswitch.conf -compact
 .It Pa /etc/hosts
 .It Pa /etc/nsswitch.conf
 .It Pa /etc/resolv.conf
 .El
 .Sh EXAMPLES
 Print out the hostname associated with a specific IP address:

release/packages/Makefile.package

 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
 .\"     From: @(#)gethostbyname.3  8.4 (Berkeley) 5/25/95
 .\" $FreeBSD$
 .\"
-.Dd October 4, 2017
+.Dd June 20, 2022
 .Dt GETHOSTBYNAME 3
 .Os
 .Sh NAME
 .Nm gethostbyname ,
 .Nm gethostbyname2 ,
 .Nm gethostbyaddr ,
 .Nm gethostent ,
 .Nm sethostent ,
 .Nm endhostent ,
 .Nm herror ,
-.Nm hstrerror
+.Nm hstrerror ,
+.Nm gethostbyname_r ,
+.Nm gethostbyname2_r ,
+.Nm gethostbyaddr_r
 .Nd get network host entry
 .Sh LIBRARY
 .Lb libc
 .Sh SYNOPSIS
 .In netdb.h
 .Vt int h_errno ;
 .Ft struct hostent *
 .Fn gethostbyname "const char *name"
 .Ft struct hostent *
 .Fn gethostbyname2 "const char *name" "int af"
 .Ft struct hostent *
 .Fn gethostbyaddr "const void *addr" "socklen_t len" "int af"
 .Ft struct hostent *
 .Fn gethostent void
 .Ft void
 .Fn sethostent "int stayopen"
 .Ft void
 .Fn endhostent void
 .Ft void
 .Fn herror "const char *string"
 .Ft const char *
 .Fn hstrerror "int err"
+.Ft int
+.Fn gethostbyname_r "const char *name" "struct hostent *he" "char *buffer" "size_t buflen" "struct hostent **result" "int *h_errnop"
+.Ft int
+.Fn gethostbyname2_r "const char *name" "int af" "struct hostent *he" "char *buffer" "size_t buflen" "struct hostent **result" "int *h_errnop"
+.Ft int
+.Fn gethostbyaddr_r "const void *addr" "socklen_t len" "int af" "struct hostent *hp" "char *buf" "size_t buflen" "struct hostent **result" "int *h_errno"p
 .Sh DESCRIPTION
 .Bf -symbolic
 The
 .Xr getaddrinfo 3
 and
 .Xr getnameinfo 3
 functions are preferred over the
 .Fn gethostbyname ,

 .Va h_errno .
 .Pp
 The
 .Fn hstrerror
 function returns a string which is the message text corresponding to the
 value of the
 .Fa err
 argument.
+.Pp
+Functions with the
+.Em _r
+suffix provide reentrant versions of their respective counterparts.
+The caller must supply five additional parameters: a
+.Vt struct hostent
+variable to be filled on success, a
+.Va buffer
+of
+.Va buflen
+bytes in size, a
+.Vt struct hostent
+.Va result
+variable that will point to the result on success or be set to
+.Dv NULL
+on failure or if the name is not found.
+The
+.Va h_errnop
+variable will be filled with the error code if any.
+All these functions return 0 on success.
 .Sh FILES
 .Bl -tag -width /etc/nsswitch.conf -compact
 .It Pa /etc/hosts
 .It Pa /etc/nsswitch.conf
 .It Pa /etc/resolv.conf
 .El
 .Sh EXAMPLES
 Print out the hostname associated with a specific IP address: