Date: Sun, 14 Jun 2020 05:35:02 +0000 (UTC) From: Gordon Bergling <gbe@FreeBSD.org> To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Subject: svn commit: r362169 - head/lib/libutil Message-ID: <202006140535.05E5Z2qH067440@repo.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: gbe (doc committer) Date: Sun Jun 14 05:35:02 2020 New Revision: 362169 URL: https://svnweb.freebsd.org/changeset/base/362169 Log: libutil: Document function HISTORY within the manpages Reviewed by: bcr (mentor) Approved by: bcr (mentor) MFC after: 7 days Differential Revision: https://reviews.freebsd.org/D24795 Modified: head/lib/libutil/_secure_path.3 head/lib/libutil/hexdump.3 head/lib/libutil/kinfo_getallproc.3 head/lib/libutil/kinfo_getfile.3 head/lib/libutil/kinfo_getproc.3 head/lib/libutil/kinfo_getvmmap.3 head/lib/libutil/kinfo_getvmobject.3 head/lib/libutil/login.conf.5 head/lib/libutil/login_auth.3 head/lib/libutil/login_cap.3 head/lib/libutil/login_class.3 head/lib/libutil/login_ok.3 head/lib/libutil/login_times.3 head/lib/libutil/login_tty.3 head/lib/libutil/pidfile.3 head/lib/libutil/pw_util.3 head/lib/libutil/realhostname.3 head/lib/libutil/trimdomain.3 head/lib/libutil/uucplock.3 Modified: head/lib/libutil/_secure_path.3 ============================================================================== --- head/lib/libutil/_secure_path.3 Sun Jun 14 05:33:25 2020 (r362168) +++ head/lib/libutil/_secure_path.3 Sun Jun 14 05:35:02 2020 (r362169) @@ -19,7 +19,7 @@ .\" .\" $FreeBSD$ .\" -.Dd May 2, 1997 +.Dd May 10, 2020 .Dt _SECURE_PATH 3 .Os .Sh NAME @@ -69,6 +69,10 @@ reason, at LOG_ERR priority. Code from which this function was derived was contributed to the .Fx project by Berkeley Software Design, Inc. +The function +.Fn _secure_path +first appeared in +.Fx 2.2.5 . .Sh BUGS The checks carried out are rudimentary and no attempt is made to eliminate race conditions between use of this function and Modified: head/lib/libutil/hexdump.3 ============================================================================== --- head/lib/libutil/hexdump.3 Sun Jun 14 05:33:25 2020 (r362168) +++ head/lib/libutil/hexdump.3 Sun Jun 14 05:35:02 2020 (r362169) @@ -28,7 +28,7 @@ .\" .\" $FreeBSD$ .\" -.Dd March 21, 2017 +.Dd May 8, 2020 .Dt HEXDUMP 3 .Os .Sh NAME @@ -83,6 +83,11 @@ Do not print the character values on each line. .Sh SEE ALSO .Xr ascii 7 , .Xr sbuf_hexdump 9 +.Sh HISTORY +The +.Fn hexdump +function first appeared in +.Fx 6.4 . .Sh AUTHORS This manual page was written by .An Scott Long . Modified: head/lib/libutil/kinfo_getallproc.3 ============================================================================== --- head/lib/libutil/kinfo_getallproc.3 Sun Jun 14 05:33:25 2020 (r362168) +++ head/lib/libutil/kinfo_getallproc.3 Sun Jun 14 05:35:02 2020 (r362169) @@ -25,7 +25,7 @@ .\" .\" $FreeBSD$ .\" -.Dd May 27, 2015 +.Dd May 8, 2020 .Dt KINFO_GETALLPROC 3 .Os .Sh NAME @@ -73,3 +73,8 @@ function returns .Xr free 3 , .Xr malloc 3 , .Xr sysctl 3 +.Sh HISTORY +The +.Fn kinfo_getallproc +function first appeared in +.Fx 8.3 . Modified: head/lib/libutil/kinfo_getfile.3 ============================================================================== --- head/lib/libutil/kinfo_getfile.3 Sun Jun 14 05:33:25 2020 (r362168) +++ head/lib/libutil/kinfo_getfile.3 Sun Jun 14 05:35:02 2020 (r362169) @@ -78,3 +78,8 @@ function returns .Xr kinfo_getvmmap 3 , .Xr malloc 3 , .Xr sysctl 3 +.Sh HISTORY +The +.Fn kinfo_getfile +function first appeared in +.Fx 7.0 . Modified: head/lib/libutil/kinfo_getproc.3 ============================================================================== --- head/lib/libutil/kinfo_getproc.3 Sun Jun 14 05:33:25 2020 (r362168) +++ head/lib/libutil/kinfo_getproc.3 Sun Jun 14 05:35:02 2020 (r362169) @@ -25,7 +25,7 @@ .\" .\" $FreeBSD$ .\" -.Dd May 27, 2015 +.Dd May 10, 2020 .Dt KINFO_GETPROC 3 .Os .Sh NAME @@ -72,3 +72,8 @@ function returns .Xr free 3 , .Xr malloc 3 , .Xr sysctl 3 +.Sh HISTORY +The +.Fn kinfo_getproc +function first appeared in +.Fx 7.0 . Modified: head/lib/libutil/kinfo_getvmmap.3 ============================================================================== --- head/lib/libutil/kinfo_getvmmap.3 Sun Jun 14 05:33:25 2020 (r362168) +++ head/lib/libutil/kinfo_getvmmap.3 Sun Jun 14 05:35:02 2020 (r362169) @@ -25,7 +25,7 @@ .\" .\" $FreeBSD$ .\" -.Dd August 18, 2017 +.Dd May 10, 2020 .Dt KINFO_GETVMMAP 3 .Os .Sh NAME @@ -84,3 +84,8 @@ function returns .Xr free 3 , .Xr kinfo_getfile 3 , .Xr malloc 3 +.Sh HISTORY +The +.Fn kinfo_getvmmap +function first appeared in +.Fx 7.0 . Modified: head/lib/libutil/kinfo_getvmobject.3 ============================================================================== --- head/lib/libutil/kinfo_getvmobject.3 Sun Jun 14 05:33:25 2020 (r362168) +++ head/lib/libutil/kinfo_getvmobject.3 Sun Jun 14 05:35:02 2020 (r362169) @@ -24,7 +24,7 @@ .\" .\" $FreeBSD$ .\" -.Dd May 27, 2015 +.Dd May 20, 2020 .Dt KINFO_GETVMOBJECT 3 .Os .Sh NAME @@ -71,3 +71,8 @@ function returns .Xr free 3 , .Xr kinfo_getvmmap 3 , .Xr malloc 3 +.Sh HISTORY +The +.Fn kinfo_getvmobject +function first appeared in +.Fx 10.2 . Modified: head/lib/libutil/login.conf.5 ============================================================================== --- head/lib/libutil/login.conf.5 Sun Jun 14 05:33:25 2020 (r362168) +++ head/lib/libutil/login.conf.5 Sun Jun 14 05:35:02 2020 (r362169) @@ -19,7 +19,7 @@ .\" .\" $FreeBSD$ .\" -.Dd January 19, 2020 +.Dd May 10, 2020 .Dt LOGIN.CONF 5 .Os .Sh NAME @@ -471,3 +471,8 @@ lists. .Xr ttys 5 , .Xr ftpd 8 , .Xr pam_passwdqc 8 +.Sh HISTORY +The file +.Nm +first appeared in +.Fx 2.1.5 . Modified: head/lib/libutil/login_auth.3 ============================================================================== --- head/lib/libutil/login_auth.3 Sun Jun 14 05:33:25 2020 (r362168) +++ head/lib/libutil/login_auth.3 Sun Jun 14 05:35:02 2020 (r362169) @@ -19,7 +19,7 @@ .\" .\" $FreeBSD$ .\" -.Dd December 29, 1996 +.Dd May 10, 2020 .Dt LOGIN_AUTH 3 .Os .Sh NAME @@ -70,3 +70,10 @@ by .Xr login_class 3 , .Xr login.conf 5 , .Xr termcap 5 +.Sh HISTORY +The functions +.Fn auth_checknologin +and +.Fn auth_cat +first appeared in +.Fx 2.1.5 . Modified: head/lib/libutil/login_cap.3 ============================================================================== --- head/lib/libutil/login_cap.3 Sun Jun 14 05:33:25 2020 (r362168) +++ head/lib/libutil/login_cap.3 Sun Jun 14 05:35:02 2020 (r362169) @@ -19,7 +19,7 @@ .\" .\" $FreeBSD$ .\" -.Dd June 14, 2007 +.Dd May 10, 2020 .Dt LOGIN_CAP 3 .Os .Sh NAME @@ -577,3 +577,21 @@ is returned to indicate this. .Xr login_class 3 , .Xr login.conf 5 , .Xr termcap 5 +.Sh HISTORY +The functions +.Fn login_close , +.Fn login_getcapbool , +.Fn login_getcaplist , +.Fn login_getcapnum , +.Fn login_getcapstr , +.Fn login_getcapsize , +.Fn login_getcaptime , +.Fn login_getclass , +.Fn login_getclassbyname , +.Fn login_getpwclass , +.Fn login_getstyle , +.Fn login_getuserclass +and +.Fn login_setcryptfmt +first appeared in +.Fx 2.1.5 . Modified: head/lib/libutil/login_class.3 ============================================================================== --- head/lib/libutil/login_class.3 Sun Jun 14 05:33:25 2020 (r362168) +++ head/lib/libutil/login_class.3 Sun Jun 14 05:35:02 2020 (r362169) @@ -19,7 +19,7 @@ .\" .\" $FreeBSD$ .\" -.Dd March 24, 2011 +.Dd May 10, 2020 .Dt LOGIN_CLASS 3 .Os .Sh NAME @@ -221,3 +221,13 @@ with LOG_ERR priority and directed to the currently ac .Xr mac_set_proc 3 , .Xr login.conf 5 , .Xr termcap 5 +.Sh HISTORY +The functions +.Fn setclasscontext , +.Fn setclasscpumask , +.Fn setclassenvironment , +.Fn setclassresources +and +.Fn setusercontext +first appeared in +.Fx 2.1.5 . Modified: head/lib/libutil/login_ok.3 ============================================================================== --- head/lib/libutil/login_ok.3 Sun Jun 14 05:33:25 2020 (r362168) +++ head/lib/libutil/login_ok.3 Sun Jun 14 05:35:02 2020 (r362169) @@ -19,7 +19,7 @@ .\" .\" $FreeBSD$ .\" -.Dd January 2, 1997 +.Dd May 10, 2020 .Dt LOGIN_OK 3 .Os .Sh NAME @@ -140,3 +140,11 @@ access list. .Xr login_times 3 , .Xr login.conf 5 , .Xr termcap 5 +.Sh HISTORY +The functions +.Fn auth_ttyok , +.Fn auth_hostok + and +.Fn auth_timeok +functions first appeared in +.Fx 2.1.5 . Modified: head/lib/libutil/login_times.3 ============================================================================== --- head/lib/libutil/login_times.3 Sun Jun 14 05:33:25 2020 (r362168) +++ head/lib/libutil/login_times.3 Sun Jun 14 05:35:02 2020 (r362169) @@ -19,7 +19,7 @@ .\" .\" $FreeBSD$ .\" -.Dd October 20, 2008 +.Dd May 10, 2020 .Dt LOGIN_TIMES 3 .Os .Sh NAME @@ -177,3 +177,13 @@ time falls, or -1 if none of them apply. .Xr login_class 3 , .Xr login.conf 5 , .Xr termcap 5 +.Sh HISTORY +The functions +.Fn parse_lt , +.Fn in_lt , +.Fn in_ltm , +.Fn in_ltms +and +.Fn in_lts +first appeared in +.Fx 2.1.5 . Modified: head/lib/libutil/login_tty.3 ============================================================================== --- head/lib/libutil/login_tty.3 Sun Jun 14 05:33:25 2020 (r362168) +++ head/lib/libutil/login_tty.3 Sun Jun 14 05:35:02 2020 (r362169) @@ -25,7 +25,7 @@ .\" .\" $FreeBSD$ .\" " -.Dd December 29, 1996 +.Dd May 10, 2020 .Dt LOGIN_TTY 3 .Os .Sh NAME @@ -63,3 +63,9 @@ the controlling terminal of the calling process, and 0 .Xr ioctl 2 , .Xr setsid 2 , .Xr tty 4 +.Sh HISTORY +The function +.Fn login_tty +first appeared in +.Bx 4.4 . + Modified: head/lib/libutil/pidfile.3 ============================================================================== --- head/lib/libutil/pidfile.3 Sun Jun 14 05:33:25 2020 (r362168) +++ head/lib/libutil/pidfile.3 Sun Jun 14 05:35:02 2020 (r362169) @@ -24,7 +24,7 @@ .\" .\" $FreeBSD$ .\" -.Dd February 8, 2012 +.Dd May 10, 2020 .Dt PIDFILE 3 .Os .Sh NAME @@ -286,6 +286,15 @@ Probably called not from the process which used .Xr open 2 , .Xr daemon 3 , .Xr flopen 3 +.Sh HISTORY +The functions +.Fn pidfile_open , +.Fn pidfile_write , +.Fn pidfile_close +and +.Fn pidfile_remove +first appeared in +.Fx 5.5 . .Sh AUTHORS .An -nosplit The Modified: head/lib/libutil/pw_util.3 ============================================================================== --- head/lib/libutil/pw_util.3 Sun Jun 14 05:33:25 2020 (r362168) +++ head/lib/libutil/pw_util.3 Sun Jun 14 05:35:02 2020 (r362169) @@ -24,7 +24,7 @@ .\" .\" $FreeBSD$ .\" -.Dd July 26, 2018 +.Dd May 10, 2020 .Dt PW_UTIL 3 .Os .Sh NAME @@ -288,6 +288,9 @@ The .Fn pw_tmp returns an open file descriptor to the temporary password file or -1 in case of failure. +.Sh HISTORY +The functions for passwd file handling first appeared in +.Bx 4.4 . .Sh AUTHORS Portions of this software were developed for the .Fx Modified: head/lib/libutil/realhostname.3 ============================================================================== --- head/lib/libutil/realhostname.3 Sun Jun 14 05:33:25 2020 (r362168) +++ head/lib/libutil/realhostname.3 Sun Jun 14 05:35:02 2020 (r362169) @@ -100,3 +100,8 @@ now contains the numeric value of .Xr gethostbyname 3 , .Xr inet_ntoa 3 , .Xr realhostname_sa 3 +.Sh HISTORY +The +.Fn realhostname +function first appeared in +.Fx 3.2 . Modified: head/lib/libutil/trimdomain.3 ============================================================================== --- head/lib/libutil/trimdomain.3 Sun Jun 14 05:33:25 2020 (r362168) +++ head/lib/libutil/trimdomain.3 Sun Jun 14 05:35:02 2020 (r362169) @@ -83,3 +83,8 @@ The function does not return a value. .Sh SEE ALSO .Xr gethostname 3 +.Sh HISTORY +The function +.Fn trimdomain +first appeared in +.Fx 3.2 . Modified: head/lib/libutil/uucplock.3 ============================================================================== --- head/lib/libutil/uucplock.3 Sun Jun 14 05:33:25 2020 (r362168) +++ head/lib/libutil/uucplock.3 Sun Jun 14 05:35:02 2020 (r362169) @@ -25,7 +25,7 @@ .\" .\" $FreeBSD$ .\" " -.Dd March 30, 1997 +.Dd May 10, 2020 .Dt UUCPLOCK 3 .Os .Sh NAME @@ -170,6 +170,14 @@ for further details. .Xr open 2 , .Xr read 2 , .Xr write 2 +.Sh HISTORY +The functions +.Fn uu_lock , +.Fn uu_unlock +and +.Fn uu_lockerr +first appeared in +.Fx 2.0.5 . .Sh BUGS It is possible that a stale lock is not recognised as such if a new processes is assigned the same processes id as the program that left
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?202006140535.05E5Z2qH067440>