[Midnightbsd-cvs] src [11864] trunk/lib/libc/sys: fix some issues with standards in man pages.

[laffer1 at midnightbsd.org]

Revision: 11864
          http://svnweb.midnightbsd.org/src/?rev=11864
Author:   laffer1
Date:     2018-07-15 14:03:14 -0400 (Sun, 15 Jul 2018)
Log Message:
-----------
fix some issues with standards in man pages. Obtained from: FreeBSD svn 334440

Modified Paths:
--------------
    trunk/lib/libc/sys/brk.2
    trunk/lib/libc/sys/getgid.2
    trunk/lib/libc/sys/getpid.2
    trunk/lib/libc/sys/read.2
    trunk/lib/libc/sys/write.2

Modified: trunk/lib/libc/sys/brk.2
===================================================================
--- trunk/lib/libc/sys/brk.2	2018-07-15 17:57:18 UTC (rev 11863)
+++ trunk/lib/libc/sys/brk.2	2018-07-15 18:03:14 UTC (rev 11864)
@@ -29,7 +29,7 @@
 .\"     @(#)brk.2	8.4 (Berkeley) 5/1/95
 .\" $FreeBSD: stable/10/lib/libc/sys/brk.2 165903 2007-01-09 00:28:16Z imp $
 .\"
-.Dd July 12, 1999
+.Dd May 24, 2018
 .Dt BRK 2
 .Os
 .Sh NAME
@@ -39,7 +39,6 @@
 .Sh LIBRARY
 .Lb libc
 .Sh SYNOPSIS
-.In sys/types.h
 .In unistd.h
 .Ft int
 .Fn brk "const void *addr"
@@ -53,6 +52,10 @@
 .Fn sbrk
 functions are legacy interfaces from before the
 advent of modern virtual memory management.
+They are deprecated and not present on the arm64 or riscv architectures.
+The
+.Xr mmap 2
+interface should be used to allocate pages instead.
 .Ef
 .Pp
 The
@@ -154,6 +157,11 @@
 .Fn brk
 function appeared in
 .At v7 .
+.Fx 11.0
+introduced the arm64 and riscv architectures which do not support
+.Fn brk
+or
+.Fn sbrk .
 .Sh BUGS
 Mixing
 .Fn brk
@@ -170,3 +178,9 @@
 from a failure caused by exceeding the maximum size of
 the data segment without consulting
 .Xr getrlimit 2 .
+.Pp
+.Fn sbrk
+is sometimes used to monitor heap use by calling with an argument of 0.
+The result is unlikely to reflect actual utilization in combination with an
+.Xr mmap 2
+based malloc.

Modified: trunk/lib/libc/sys/getgid.2
===================================================================
--- trunk/lib/libc/sys/getgid.2	2018-07-15 17:57:18 UTC (rev 11863)
+++ trunk/lib/libc/sys/getgid.2	2018-07-15 18:03:14 UTC (rev 11864)
@@ -29,7 +29,7 @@
 .\"     @(#)getgid.2	8.1 (Berkeley) 6/4/93
 .\" $FreeBSD: stable/10/lib/libc/sys/getgid.2 165903 2007-01-09 00:28:16Z imp $
 .\"
-.Dd June 4, 1993
+.Dd December 15, 2015
 .Dt GETGID 2
 .Os
 .Sh NAME
@@ -39,7 +39,6 @@
 .Sh LIBRARY
 .Lb libc
 .Sh SYNOPSIS
-.In sys/types.h
 .In unistd.h
 .Ft gid_t
 .Fn getgid void

Modified: trunk/lib/libc/sys/getpid.2
===================================================================
--- trunk/lib/libc/sys/getpid.2	2018-07-15 17:57:18 UTC (rev 11863)
+++ trunk/lib/libc/sys/getpid.2	2018-07-15 18:03:14 UTC (rev 11864)
@@ -29,7 +29,7 @@
 .\"     @(#)getpid.2	8.1 (Berkeley) 6/4/93
 .\" $FreeBSD: stable/10/lib/libc/sys/getpid.2 165903 2007-01-09 00:28:16Z imp $
 .\"
-.Dd November 2, 2006
+.Dd December 15, 2015
 .Dt GETPID 2
 .Os
 .Sh NAME
@@ -39,7 +39,6 @@
 .Sh LIBRARY
 .Lb libc
 .Sh SYNOPSIS
-.In sys/types.h
 .In unistd.h
 .Ft pid_t
 .Fn getpid void

Modified: trunk/lib/libc/sys/read.2
===================================================================
--- trunk/lib/libc/sys/read.2	2018-07-15 17:57:18 UTC (rev 11863)
+++ trunk/lib/libc/sys/read.2	2018-07-15 18:03:14 UTC (rev 11864)
@@ -29,7 +29,7 @@
 .\"     @(#)read.2	8.4 (Berkeley) 2/26/94
 .\" $FreeBSD: stable/10/lib/libc/sys/read.2 255486 2013-09-12 00:53:38Z bdrewery $
 .\"
-.Dd September 11, 2013
+.Dd December 15, 2015
 .Dt READ 2
 .Os
 .Sh NAME
@@ -41,7 +41,6 @@
 .Sh LIBRARY
 .Lb libc
 .Sh SYNOPSIS
-.In sys/types.h
 .In unistd.h
 .Ft ssize_t
 .Fn read "int fd" "void *buf" "size_t nbytes"

Modified: trunk/lib/libc/sys/write.2
===================================================================
--- trunk/lib/libc/sys/write.2	2018-07-15 17:57:18 UTC (rev 11863)
+++ trunk/lib/libc/sys/write.2	2018-07-15 18:03:14 UTC (rev 11864)
@@ -28,7 +28,7 @@
 .\"     @(#)write.2	8.5 (Berkeley) 4/2/94
 .\" $FreeBSD: stable/10/lib/libc/sys/write.2 255486 2013-09-12 00:53:38Z bdrewery $
 .\" $MidnightBSD$
-.Dd September 11, 2013
+.Dd December 15, 2015
 .Dt WRITE 2
 .Os
 .Sh NAME
@@ -40,7 +40,6 @@
 .Sh LIBRARY
 .Lb libc
 .Sh SYNOPSIS
-.In sys/types.h
 .In unistd.h
 .Ft ssize_t
 .Fn write "int fd" "const void *buf" "size_t nbytes"