From nobody Sat May 07 15:55:26 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 CCB7A1AC41A0; Sat, 7 May 2022 15:55:26 +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 4KwX8G5Lpdz3vvR; Sat, 7 May 2022 15:55:26 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1651938926; 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=VWnCy9kumFajIJucwB04KLPGIYP4iwuAV0vEmF5eiMU=; b=hk7QJ62LKFqSfMUEbGf+XsmA0h5FuEY0ITT+YZoUsq3Avs92xIFG8zp5d7c9a1N5WihqVK qLND1WlChw7AKvdSTfgKR/k3fypSEyWRJ24NEhwiZQBKE9rOrdwRLpAzCr8Mt/RyUhGMCo tjhk5Qs4w9nUm3umG0ZANZ7A9GHtYKnUBVHiNwD1QaNlJsrl2JJ3XntR07Tu/YcyjB/VF4 hOUuEBv+g/N6P+BI0MdPz2gvyOhhzIBWCWal6FWoWoPVgfXaKw0ocUlVZa7TeUqVOHl+c/ FgdGLGQVG0fsGR6D7vMNZftA7mkmq27zwPyuKiFWuYkwZriU/cBXMdlCgvMg1Q== 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 96EA513906; Sat, 7 May 2022 15:55:26 +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 247FtQ4O014681; Sat, 7 May 2022 15:55:26 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 247FtQC9014680; Sat, 7 May 2022 15:55:26 GMT (envelope-from git) Date: Sat, 7 May 2022 15:55:26 GMT Message-Id: <202205071555.247FtQC9014680@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Warner Losh Subject: git: 2f44ad86f555 - main - dmesg: Better wording from review 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: imp X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 2f44ad86f5553edb9e7854767424f22ba132ee92 Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1651938926; 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=VWnCy9kumFajIJucwB04KLPGIYP4iwuAV0vEmF5eiMU=; b=ZYtx+D45e/vORIElPxdE6SNJ2tGESbN68GYjMpuos6pEkqLxCoLxzGih8fSpWSz8cJA6DY Jahak9r0T7+deahhsgsY5Sn0qPZzq+ysA/D4OahJYJYlxRxY+t52rzU5Mt3GC4eZE7pECY 87FbDLo7R/v8Ke8v2m1LIJYk3FXkGp+CKGcq/GdOwo6RrBELL7Cn9HwRhBES3c9yc1SETg Fg3BwT88U+2NcQ64qLcmg0KWlyAneuKOuweGzx0K4X5KBQ/kMJ27R3ogiKRPR0mPJJamby YD6LvYrIeCeWqob4C2vXPXWGb0YcbH9WHX0ksrIpzd0yrJ3z9c2RP9hzBnqDEw== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1651938926; a=rsa-sha256; cv=none; b=ciMmcS9O4hCPrF8NxE3/7BFqgEyX+7KQ5CBJqwMdTuCOR3oU5tthnetSbK9rlTl0NkQy+d trLbZLrXRXkNSYqQICJ4fGgR4lyq+Flg1FwrI3xqrPQ/d1aY4OTmZoYxhX32EN3H9Mwq62 Y7c71oc/2N10Hg668J9+WCHC967tH23+leTkNk1TvvSG69Bs34c7L0Jj9Ocg8G7T4J/QLy S+QabyAhgRsoRsL/FEYZ6rupjNpEgP1QrwD+Sej1nAmwVFF+EK9LNpLPbTlLhVs8IFx4Ol k2wlDINry4D+0hzuC72fmvNb7LVP7ehFYkjwbS8L4hzvWtsUBLsvECtJRDQcLQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by imp: URL: https://cgit.FreeBSD.org/src/commit/?id=2f44ad86f5553edb9e7854767424f22ba132ee92 commit 2f44ad86f5553edb9e7854767424f22ba132ee92 Author: Warner Losh AuthorDate: 2022-05-07 15:49:22 +0000 Commit: Warner Losh CommitDate: 2022-05-07 15:55:40 +0000 dmesg: Better wording from review I pushed the last changes before I'd noticed the better wording suggestions in the review. Also include a note that not all lines will have a timestampe. Some multi-line messages are generated with sbuf, and when those are pushed, only the first line will have the timestamp. Document this quirky behavior as well since fixing it likely won't happen soon. CAM periph drivers generate all the lines in their announce message together so they aren't intermingled with other things, for example. Suggested by: allanjude, emaste, rpokala Sponsored by: Netflix Differential Revision: https://reviews.freebsd.org/D35139 Differential Revision: https://reviews.freebsd.org/D35141 --- sbin/dmesg/dmesg.8 | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/sbin/dmesg/dmesg.8 b/sbin/dmesg/dmesg.8 index a924549264cd..50b5e3e26404 100644 --- a/sbin/dmesg/dmesg.8 +++ b/sbin/dmesg/dmesg.8 @@ -28,7 +28,7 @@ .\" @(#)dmesg.8 8.1 (Berkeley) 6/5/93 .\" $FreeBSD$ .\" -.Dd May 6, 2022 +.Dd May 7, 2022 .Dt DMESG 8 .Os .Sh NAME @@ -73,8 +73,7 @@ which is the kernel image the system has booted from. .Sh SYSCTL VARIABLES The following .Xr sysctl 8 -variables can be used to control the behavior of the kernel's placing data into -the message buffer: +variables control how the kernel timestamps entries in the message buffer: The default value is shown next to each variable. .Bl -tag -width indent .It kern.msgbuf_show_timestamp : No 0 @@ -85,6 +84,8 @@ If set to 2, then a microsecond granularity timestamp will be added. This may also be set as a boot .Xr loader 8 tunable. +The timestamps are placed at the start of most lines that the kernel generates. +Some multi-line messages will have only the first line tagged with a timestamp. .El .Sh FILES .Bl -tag -width ".Pa /var/run/dmesg.boot" -compact