From nobody Wed Aug 10 12:27:48 2022 X-Original-To: dev-commits-src-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4M2q2s1nHGz4YJTL; Wed, 10 Aug 2022 12:27:49 +0000 (UTC) (envelope-from git@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 "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4M2q2s0sLwz3bmF; Wed, 10 Aug 2022 12:27:49 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1660134469; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=Z5IyvH2S2YBbSRSD6nFx+ZkM8EEnTUm4ikLAlcuak1Y=; b=rdGGq15gQUhH1rcbxZVVMgIE1ExTq3US4IyGheCHkwAKXzyZkQZ6rhz1z7uJ5u4H7v2N1c ycrR5QCm6fm/tMdnCl4FKs5AbaSymunzbOI9WaOZNPG7yg3En4c57IA/QsqLyka+YIXm9A KGUFiRBILIo668izY2+qGwBlJsmZPAr0Ttj2WbC1fMoHkKYKqgGrWrTV8imBPvWbSU5tFu 07FCLdMyT/2l6yIAwkyBFFrsA6z2C3cANlBN8iGTWHts74gw4HiW7xs2fe9od5eKCJsf5g Vxmfm4D28jG+xaixuEGTFgQl35jNaIeJfd2ErxGfXRE2wqgPkp7dP3PhjKn8dQ== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (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 did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4M2q2r6nPWz1B7P; Wed, 10 Aug 2022 12:27:48 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 27ACRmiB073252; Wed, 10 Aug 2022 12:27:48 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 27ACRmX8073251; Wed, 10 Aug 2022 12:27:48 GMT (envelope-from git) Date: Wed, 10 Aug 2022 12:27:48 GMT Message-Id: <202208101227.27ACRmX8073251@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org From: Gordon Bergling Subject: git: 6d8e1fd525dc - stable/12 - libutil: Fix mandoc warnings List-Id: Commit messages for all branches of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-src-all@freebsd.org X-BeenThere: dev-commits-src-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: gbe X-Git-Repository: src X-Git-Refname: refs/heads/stable/12 X-Git-Reftype: branch X-Git-Commit: 6d8e1fd525dc8ace3d2435e21ae7dd04eae0c993 Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1660134469; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=Z5IyvH2S2YBbSRSD6nFx+ZkM8EEnTUm4ikLAlcuak1Y=; b=LD9XDLnK0YrZPjF8FUYIVupuaW0O/kr1YU7EPK8LZIG16POykw2/V55DI8kgY3MYsdZzGq ef0fYEAtmPPGXuryAQx2SosZtaF6UT/pysk4lTHKSuU4dYWcdq7orvse95kav/M4+6o9Xu XxQEITNW8Np0CKHJnnd8qvl5uQYlgrfZYk5szpdUzwPrmj805H7lm8xE8b68Um3wXF26aU ho6In9RnqU36TIP/0bko7h46HVW7maRPUVq5EnlvLixjZk4RRLRMF5MHYiUcq66SRnquWb 78bDrW/+YkhIs46VStSL4wfcVWwcx8z541uI200FK/EtxrZCl7/noQUW3XEm5A== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1660134469; a=rsa-sha256; cv=none; b=HcBzRp1uBJu7SKPQAL5ciOiP0LPU0+WKF3bXCwiJI1Pd6mvcx4t7lK8nQiEGVYc0toZcht 7LRiUhguVLYj8U+VxwBl54LffE82pekUF8c30vQZ9Tqcf7QAoCR9Tm0a1/jx36aih+sMe6 oD6Seb4rdR7z/95TsD+NhaN6NARcWGGZT6Hc9H7Jc4IUWsRGWFHPmJEhc6Pc6saRz6ZFcC aEdIrGNztfKuQR7KZ9QG12NkfWvlRfTCefADMfPRIJaT6fyYLJX+aX143DjctoqYCs9zXb LefmcZ/cAMM75xTImUPYEfOnZFfGj5nVUypoE2KFbnq6uTqRCgc9+uKywffznA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch stable/12 has been updated by gbe (doc committer): URL: https://cgit.FreeBSD.org/src/commit/?id=6d8e1fd525dc8ace3d2435e21ae7dd04eae0c993 commit 6d8e1fd525dc8ace3d2435e21ae7dd04eae0c993 Author: Gordon Bergling AuthorDate: 2022-08-07 14:30:24 +0000 Commit: Gordon Bergling CommitDate: 2022-08-10 12:27:39 +0000 libutil: Fix mandoc warnings - missing comma before name - possible typo in section name: Sh CAVEAT instead of CAVEATS - useless macro: Tn - blank line in fill mode, using .sp - no blank before trailing delimiter: Dv NULL? (cherry picked from commit 816ca3d10fd2f0c9283005a189fac156071d748d) --- lib/libutil/humanize_number.3 | 8 ++------ lib/libutil/kinfo_getvmmap.3 | 14 +++++++------- lib/libutil/login_tty.3 | 1 - lib/libutil/pty.3 | 2 +- lib/libutil/pw_util.3 | 2 +- lib/libutil/quotafile.3 | 22 +++++++++++----------- 6 files changed, 22 insertions(+), 27 deletions(-) diff --git a/lib/libutil/humanize_number.3 b/lib/libutil/humanize_number.3 index 9259f377abf2..2617317d6e18 100644 --- a/lib/libutil/humanize_number.3 +++ b/lib/libutil/humanize_number.3 @@ -183,12 +183,8 @@ The and .Dv HN_IEC_PREFIXES flags -conform to -.Tn ISO/IEC -Std\~80000-13:2008 -and -.Tn IEEE -Std\~1541-2002. +conform to ISO/IEC Std\~80000-13:2008 +and IEEE Std\~1541-2002. .Sh HISTORY The .Fn humanize_number diff --git a/lib/libutil/kinfo_getvmmap.3 b/lib/libutil/kinfo_getvmmap.3 index c36f5fc5b6b5..cd996128d9e0 100644 --- a/lib/libutil/kinfo_getvmmap.3 +++ b/lib/libutil/kinfo_getvmmap.3 @@ -58,13 +58,6 @@ with the mib. While the kernel returns a packed structure, this function expands the data into a fixed record format. -.Sh CAVEAT -.Fn kinfo_getvmmap -calls can cause significant CPU consumption because calculating the residency -counts requires iterating over all memory pages of the process. -Setting the sysctl variable -.Va kern.proc_vmmap_skip_resident_count -to 1 prevents this calculation. .Sh RETURN VALUES On success the .Fn kinfo_getvmmap @@ -89,3 +82,10 @@ The .Fn kinfo_getvmmap function first appeared in .Fx 7.0 . +.Sh CAVEATS +.Fn kinfo_getvmmap +calls can cause significant CPU consumption because calculating the residency +counts requires iterating over all memory pages of the process. +Setting the sysctl variable +.Va kern.proc_vmmap_skip_resident_count +to 1 prevents this calculation. diff --git a/lib/libutil/login_tty.3 b/lib/libutil/login_tty.3 index 89636d86686d..97327db13714 100644 --- a/lib/libutil/login_tty.3 +++ b/lib/libutil/login_tty.3 @@ -68,4 +68,3 @@ The function .Fn login_tty first appeared in .Bx 4.4 . - diff --git a/lib/libutil/pty.3 b/lib/libutil/pty.3 index c676447d20e4..86280299a43f 100644 --- a/lib/libutil/pty.3 +++ b/lib/libutil/pty.3 @@ -149,7 +149,7 @@ The and .Fn forkpty functions first appeared in -.Bx 4.3 Reno. +.Bx 4.3 Reno . .Sh BUGS .Fn openpty writes the slave terminal's name to diff --git a/lib/libutil/pw_util.3 b/lib/libutil/pw_util.3 index 8855eba8d925..d91e19373515 100644 --- a/lib/libutil/pw_util.3 +++ b/lib/libutil/pw_util.3 @@ -191,7 +191,7 @@ it will default to .Fa master is the name of the password file. If set to -.Dv NULL? +.Dv NULL ? it will default to .Pa master.passwd .Pp diff --git a/lib/libutil/quotafile.3 b/lib/libutil/quotafile.3 index 362cf018554a..153fc106c589 100644 --- a/lib/libutil/quotafile.3 +++ b/lib/libutil/quotafile.3 @@ -29,17 +29,17 @@ .Dt QUOTAFILE 3 .Os .Sh NAME -.Nm quota_open -.Nm quota_close -.Nm quota_on -.Nm quota_off -.Nm quota_read -.Nm quota_write_limits -.Nm quota_write_usage -.Nm quota_fsname -.Nm quota_qfname -.Nm quota_maxid -.Nm quota_check_path +.Nm quota_open , +.Nm quota_close , +.Nm quota_on , +.Nm quota_off , +.Nm quota_read , +.Nm quota_write_limits , +.Nm quota_write_usage , +.Nm quota_fsname , +.Nm quota_qfname , +.Nm quota_maxid , +.Nm quota_check_path , .Nm quota_convert .Nd "Manipulate quotas" .Sh LIBRARY