From owner-svn-src-stable-12@freebsd.org Sat Jun 27 12:12:49 2020 Return-Path: Delivered-To: svn-src-stable-12@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 98DF834EE08; Sat, 27 Jun 2020 12:12:49 +0000 (UTC) (envelope-from gbe@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "Let's Encrypt Authority X3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 49vCLn3Vgrz3XTT; Sat, 27 Jun 2020 12:12:49 +0000 (UTC) (envelope-from gbe@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 734E725027; Sat, 27 Jun 2020 12:12:49 +0000 (UTC) (envelope-from gbe@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id 05RCCnpq092833; Sat, 27 Jun 2020 12:12:49 GMT (envelope-from gbe@FreeBSD.org) Received: (from gbe@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id 05RCCmuI092827; Sat, 27 Jun 2020 12:12:48 GMT (envelope-from gbe@FreeBSD.org) Message-Id: <202006271212.05RCCmuI092827@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: gbe set sender to gbe@FreeBSD.org using -f From: Gordon Bergling Date: Sat, 27 Jun 2020 12:12:48 +0000 (UTC) To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-stable@freebsd.org, svn-src-stable-12@freebsd.org Subject: svn commit: r362682 - in stable/12/lib/libc: stdio string sys X-SVN-Group: stable-12 X-SVN-Commit-Author: gbe X-SVN-Commit-Paths: in stable/12/lib/libc: stdio string sys X-SVN-Commit-Revision: 362682 X-SVN-Commit-Repository: base MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-src-stable-12@freebsd.org X-Mailman-Version: 2.1.33 Precedence: list List-Id: SVN commit messages for only the 12-stable src tree List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 27 Jun 2020 12:12:49 -0000 Author: gbe (doc committer) Date: Sat Jun 27 12:12:47 2020 New Revision: 362682 URL: https://svnweb.freebsd.org/changeset/base/362682 Log: MFC r362171: libc manpages: various improvements from NetBSD - Add STANDARDS and HISTORY sections within the appropriate manpages - Mention two USENIX papers within kqueue(2) and strlcpy(3) Reviewed by: bcr (mentor) Approved by: bcr (mentor) Obtained from: NetBSD Differential Revision: https://reviews.freebsd.org/D24650 Modified: stable/12/lib/libc/stdio/fflush.3 stable/12/lib/libc/stdio/fopen.3 stable/12/lib/libc/stdio/setbuf.3 stable/12/lib/libc/string/strlcpy.3 stable/12/lib/libc/sys/getgid.2 stable/12/lib/libc/sys/getitimer.2 stable/12/lib/libc/sys/kqueue.2 Directory Properties: stable/12/ (props changed) Modified: stable/12/lib/libc/stdio/fflush.3 ============================================================================== --- stable/12/lib/libc/stdio/fflush.3 Sat Jun 27 12:02:01 2020 (r362681) +++ stable/12/lib/libc/stdio/fflush.3 Sat Jun 27 12:12:47 2020 (r362682) @@ -32,7 +32,7 @@ .\" @(#)fflush.3 8.1 (Berkeley) 6/4/93 .\" $FreeBSD$ .\" -.Dd January 23, 2020 +.Dd May 1, 2020 .Dt FFLUSH 3 .Os .Sh NAME @@ -125,3 +125,12 @@ The function conforms to .St -isoC . +.Sh HISTORY +The +.Fn fflush +function first appeared in +.At v4 . +The +.Fn fpurge +function first appeared in +.Bx 4.4 . Modified: stable/12/lib/libc/stdio/fopen.3 ============================================================================== --- stable/12/lib/libc/stdio/fopen.3 Sat Jun 27 12:02:01 2020 (r362681) +++ stable/12/lib/libc/stdio/fopen.3 Sat Jun 27 12:12:47 2020 (r362682) @@ -32,7 +32,7 @@ .\" @(#)fopen.3 8.1 (Berkeley) 6/4/93 .\" $FreeBSD$ .\" -.Dd January 30, 2013 +.Dd May 1, 2020 .Dt FOPEN 3 .Os .Sh NAME @@ -356,3 +356,8 @@ The .Dq Li b mode does not conform to any standard but is also supported by glibc. +.Sh HISTORY +An +.Fn fopen +function appeared in +.At v1 . Modified: stable/12/lib/libc/stdio/setbuf.3 ============================================================================== --- stable/12/lib/libc/stdio/setbuf.3 Sat Jun 27 12:02:01 2020 (r362681) +++ stable/12/lib/libc/stdio/setbuf.3 Sat Jun 27 12:12:47 2020 (r362682) @@ -32,7 +32,7 @@ .\" @(#)setbuf.3 8.1 (Berkeley) 6/4/93 .\" $FreeBSD$ .\" -.Dd February 18, 2013 +.Dd May 1, 2020 .Dt SETBUF 3 .Os .Sh NAME @@ -195,6 +195,23 @@ and functions conform to .St -isoC . +.Sh HISTORY +The +.Fn setbuf +function first appeared in +.At v7 . +The +.Fn setbuffer +function first appeared in +.Bx 4.1c . +The +.Fn setlinebuf +function first appeared in +.Bx 4.2 . +The +.Fn setvbuf +function first appeared in +.Bx 4.4 . .Sh BUGS .Fn setbuf usually uses a suboptimal buffer size and should be avoided. Modified: stable/12/lib/libc/string/strlcpy.3 ============================================================================== --- stable/12/lib/libc/string/strlcpy.3 Sat Jun 27 12:02:01 2020 (r362681) +++ stable/12/lib/libc/string/strlcpy.3 Sat Jun 27 12:12:47 2020 (r362682) @@ -27,7 +27,7 @@ .\" .\" $FreeBSD$ .\" -.Dd February 26, 2016 +.Dd May 1, 2020 .Dt STRLCPY 3 .Os .Sh NAME @@ -189,6 +189,16 @@ As a matter of fact, the first version of this manual .Xr strncat 3 , .Xr strncpy 3 , .Xr wcslcpy 3 +.Rs +.%A Todd C. Miller +.%A Theo de Raadt +.%T strlcpy and strlcat -- Consistent, Safe, String Copy and Concatenation +.%I USENIX Association +.%B Proceedings of the FREENIX Track: 1999 USENIX Annual Technical Conference +.%D June 6-11, 1999 +.%U http://www.usenix.org/publications/library/proceedings/usenix99/ +.%U full_papers/millert/millert.pdf +.Re .Sh HISTORY The .Fn strlcpy Modified: stable/12/lib/libc/sys/getgid.2 ============================================================================== --- stable/12/lib/libc/sys/getgid.2 Sat Jun 27 12:02:01 2020 (r362681) +++ stable/12/lib/libc/sys/getgid.2 Sat Jun 27 12:12:47 2020 (r362682) @@ -28,7 +28,7 @@ .\" @(#)getgid.2 8.1 (Berkeley) 6/4/93 .\" $FreeBSD$ .\" -.Dd December 15, 2015 +.Dd May 1, 2020 .Dt GETGID 2 .Os .Sh NAME @@ -78,3 +78,8 @@ and .Fn getegid system calls are expected to conform to .St -p1003.1-90 . +.Sh HISTORY +The +.Fn getgid +function appeared in +.At v4 . Modified: stable/12/lib/libc/sys/getitimer.2 ============================================================================== --- stable/12/lib/libc/sys/getitimer.2 Sat Jun 27 12:02:01 2020 (r362681) +++ stable/12/lib/libc/sys/getitimer.2 Sat Jun 27 12:12:47 2020 (r362682) @@ -28,7 +28,7 @@ .\" @(#)getitimer.2 8.3 (Berkeley) 5/16/95 .\" $FreeBSD$ .\" -.Dd May 16, 1995 +.Dd May 1, 2020 .Dt GETITIMER 2 .Os .Sh NAME @@ -173,6 +173,21 @@ to be handled. .Xr select 2 , .Xr sigaction 2 , .Xr clocks 7 +.Sh STANDARDS +The +.Fn getitimer +and +.Fn setitimer +functions conform to +.St -p1003.1-2001 . +The later +.St -p1003.1-2008 +revision however marked both functions as obsolescent, +recommending the use of +.Xr timer_gettime 2 +and +.Xr timer_settime 2 +instead. .Sh HISTORY The .Fn getitimer Modified: stable/12/lib/libc/sys/kqueue.2 ============================================================================== --- stable/12/lib/libc/sys/kqueue.2 Sat Jun 27 12:02:01 2020 (r362681) +++ stable/12/lib/libc/sys/kqueue.2 Sat Jun 27 12:12:47 2020 (r362682) @@ -24,7 +24,7 @@ .\" .\" $FreeBSD$ .\" -.Dd April 27, 2020 +.Dd May 1, 2020 .Dt KQUEUE 2 .Os .Sh NAME @@ -776,6 +776,14 @@ have been applied. .Xr write 2 , .Xr pthread_setcancelstate 3 , .Xr signal 3 +.Rs +.%A Jonathan Lemon +.%T "Kqueue: A Generic and Scalable Event Notification Facility" +.%I USENIX Association +.%B Proceedings of the FREENIX Track: 2001 USENIX Annual Technical Conference +.%D June 25-30, 2001 +.\".http://www.usenix.org/event/usenix01/freenix01/full_papers/lemon/lemon.pdf +.Re .Sh HISTORY The .Fn kqueue