From patchwork Thu Oct 22 03:54:11 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Ben Pfaff X-Patchwork-Id: 1385916 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Authentication-Results: ozlabs.org; spf=pass (sender SPF authorized) smtp.mailfrom=openvswitch.org (client-ip=140.211.166.136; helo=silver.osuosl.org; envelope-from=ovs-dev-bounces@openvswitch.org; receiver=) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=ovn.org Received: from silver.osuosl.org (smtp3.osuosl.org [140.211.166.136]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 4CGtm80X1tz9sSn for ; Thu, 22 Oct 2020 14:54:47 +1100 (AEDT) Received: from localhost (localhost [127.0.0.1]) by silver.osuosl.org (Postfix) with ESMTP id DAC1D2050A; Thu, 22 Oct 2020 03:54:44 +0000 (UTC) X-Virus-Scanned: amavisd-new at osuosl.org Received: from silver.osuosl.org ([127.0.0.1]) by localhost (.osuosl.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id PZhoJosr7p3K; Thu, 22 Oct 2020 03:54:39 +0000 (UTC) Received: from lists.linuxfoundation.org (lf-lists.osuosl.org [140.211.9.56]) by silver.osuosl.org (Postfix) with ESMTP id A5CE320505; Thu, 22 Oct 2020 03:54:37 +0000 (UTC) Received: from lf-lists.osuosl.org (localhost [127.0.0.1]) by lists.linuxfoundation.org (Postfix) with ESMTP id 8E520C08A1; Thu, 22 Oct 2020 03:54:37 +0000 (UTC) X-Original-To: dev@openvswitch.org Delivered-To: ovs-dev@lists.linuxfoundation.org Received: from whitealder.osuosl.org (smtp1.osuosl.org [140.211.166.138]) by lists.linuxfoundation.org (Postfix) with ESMTP id 3158EC08A1 for ; Thu, 22 Oct 2020 03:54:34 +0000 (UTC) Received: from localhost (localhost [127.0.0.1]) by whitealder.osuosl.org (Postfix) with ESMTP id EFBE186C76 for ; Thu, 22 Oct 2020 03:54:33 +0000 (UTC) X-Virus-Scanned: amavisd-new at osuosl.org Received: from whitealder.osuosl.org ([127.0.0.1]) by localhost (.osuosl.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id tWTD7wjrJhJg for ; Thu, 22 Oct 2020 03:54:33 +0000 (UTC) X-Greylist: domain auto-whitelisted by SQLgrey-1.7.6 Received: from relay1-d.mail.gandi.net (relay1-d.mail.gandi.net [217.70.183.193]) by whitealder.osuosl.org (Postfix) with ESMTPS id A05DF86C74 for ; Thu, 22 Oct 2020 03:54:32 +0000 (UTC) X-Originating-IP: 75.54.222.30 Received: from sigfpe.attlocal.net (75-54-222-30.lightspeed.rdcyca.sbcglobal.net [75.54.222.30]) (Authenticated sender: blp@ovn.org) by relay1-d.mail.gandi.net (Postfix) with ESMTPSA id DF1F1240009; Thu, 22 Oct 2020 03:54:29 +0000 (UTC) From: Ben Pfaff To: dev@openvswitch.org Date: Wed, 21 Oct 2020 20:54:11 -0700 Message-Id: <20201022035415.33541-4-blp@ovn.org> X-Mailer: git-send-email 2.26.2 In-Reply-To: <20201022035415.33541-1-blp@ovn.org> References: <20201022035415.33541-1-blp@ovn.org> MIME-Version: 1.0 Cc: Ben Pfaff Subject: [ovs-dev] [PATCH ovn 4/8] ovn-nb: Better document timestamp columns. X-BeenThere: ovs-dev@openvswitch.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: ovs-dev-bounces@openvswitch.org Sender: "dev" Signed-off-by: Ben Pfaff --- ovn-nb.xml | 21 +++++++++++++++++---- 1 file changed, 17 insertions(+), 4 deletions(-) diff --git a/ovn-nb.xml b/ovn-nb.xml index 27d6d056e508..5dbefdd6ae9e 100644 --- a/ovn-nb.xml +++ b/ovn-nb.xml @@ -55,8 +55,19 @@ - The timestamp (ms) when ovn-northd sees the latest - nb_cfg and starts processing. +

+ The timestamp, in milliseconds since the epoch, when + ovn-northd sees the latest nb_cfg and starts + processing. +

+ +

+ To print the timestamp as a human-readable date: +

+ + 
+          date -d "@$(ovn-nbctl get NB_Global . nb_cfg_timestamp | sed 's/...$//')"
+
@@ -66,7 +77,8 @@ - The timestamp (ms) when ovn-northd finishes applying the + The timestamp, in milliseconds since the epoch, when + ovn-northd finishes applying the corresponding configuration changes to the database successfully. @@ -82,7 +94,8 @@ - The largest timestamp (ms) of the smallest sequence number of all the + The largest timestamp, in milliseconds since the epoch, of the smallest + sequence number of all the chassis in the system, as reported in the Chassis_Private table in the southbound database. In other words, this timestamp reflects the time when the slowest chassis catches up with the