malloc(9): update names and hardlinks

Give all documented functions a .Nm entry in the man page, following the
order they are listed in the synopsis. Create MLINKs for each of the
functions as well.

While here, add a missing include directive to the synopsis, and appease
mandoc by wrapping a long line.

Reviewed by:	markj, imp (previous version), jhb (previous version)
MFC after:	1 week
Sponsored by:	The FreeBSD Foundation
Differential Revision:	https://reviews.freebsd.org/D36940
This commit is contained in:
Mitchell Horne 2022-10-12 13:43:57 -03:00
parent ed02be352d
commit 30c6a66864
2 changed files with 21 additions and 4 deletions

View File

@ -1418,13 +1418,19 @@ MLINKS+=make_dev.9 destroy_dev.9 \
make_dev.9 make_dev_p.9 \
make_dev.9 make_dev_s.9
MLINKS+=malloc.9 free.9 \
malloc.9 malloc_aligned.9 \
malloc.9 malloc_domainset.9 \
malloc.9 malloc_domainset_aligned.9 \
malloc.9 malloc_domainset_exec.9 \
malloc.9 malloc_exec.9 \
malloc.9 malloc_usable_size.9 \
malloc.9 mallocarray.9 \
malloc.9 mallocarray_domainset.9 \
malloc.9 MALLOC_DECLARE.9 \
malloc.9 MALLOC_DEFINE.9 \
malloc.9 realloc.9 \
malloc.9 reallocf.9
malloc.9 reallocf.9 \
malloc.9 zfree.9
MLINKS+=mbchain.9 mb_detach.9 \
mbchain.9 mb_done.9 \
mbchain.9 mb_fixhdr.9 \

View File

@ -29,16 +29,25 @@
.\" $NetBSD: malloc.9,v 1.3 1996/11/11 00:05:11 lukem Exp $
.\" $FreeBSD$
.\"
.Dd July 2, 2021
.Dd October 12, 2022
.Dt MALLOC 9
.Os
.Sh NAME
.Nm malloc ,
.Nm mallocarray ,
.Nm free ,
.Nm zfree ,
.Nm realloc ,
.Nm reallocf ,
.Nm malloc_usable_size ,
.Nm malloc_aligned ,
.Nm malloc_exec ,
.Nm MALLOC_DECLARE ,
.Nm MALLOC_DEFINE ,
.Nm MALLOC_DECLARE
.Nm malloc_domainset ,
.Nm malloc_domainset_aligned ,
.Nm malloc_domainset_exec ,
.Nm mallocarray_domainset
.Nd kernel memory management routines
.Sh SYNOPSIS
.In sys/types.h
@ -73,6 +82,7 @@
.Fn MALLOC_DEFINE type shortdesc longdesc
.In sys/param.h
.In sys/domainset.h
.In sys/malloc.h
.Ft void *
.Fn malloc_domainset "size_t size" "struct malloc_type *type" "struct domainset *ds" "int flags"
.Ft void *
@ -116,7 +126,8 @@ Both
and
.Fn malloc_domainset_exec
can be used to return executable memory.
Not all platforms enforce a distinction between executable and non-executable memory.
Not all platforms enforce a distinction between executable and non-executable
memory.
.Pp
The
.Fn mallocarray