From patchwork Thu Jul 20 11:05:38 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Bruce Richardson X-Patchwork-Id: 129666 Return-Path: X-Original-To: patchwork@inbox.dpdk.org Delivered-To: patchwork@inbox.dpdk.org Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id 6C89042EC5; Thu, 20 Jul 2023 13:05:49 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id E5C4140E2D; Thu, 20 Jul 2023 13:05:48 +0200 (CEST) Received: from mga14.intel.com (mga14.intel.com [192.55.52.115]) by mails.dpdk.org (Postfix) with ESMTP id E0D3E40DF5 for ; Thu, 20 Jul 2023 13:05:46 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1689851147; x=1721387147; h=from:to:cc:subject:date:message-id:in-reply-to: references:mime-version:content-transfer-encoding; bh=heeuAV5mD2Y1pr7htMa+FyfoI2AWVRtXk314WZHsSJw=; b=HODeBnaQqoUwIaQi13lzsOZftO5XqRbeclSPvqThve7xAoCrNJjcGkqJ BGI00LLbW16GdD8r7BBczqbsgCfwvx/cPyhCHVKGKNUcUMJXcelTchcbW 2EkxgnZZENKFt8vOisUIZDP5YyY3HdHvrBaJy1lt8+F31DAwBYm3Ll0a0 Pg335Hylc4tOw4y/q1mK7oRX9CeK6j8VU7Q3HjbJA1dPGE5pClS0dDumv yncVBleggDmJcdRrb5+F7NZpxAabvmWdwUppQNvzTw3SvcEAZDHFfnJ8+ IgyNvIQD0Cjr7W2PUD8p2hT55koz7ILmEvnSDF5iwktIseMoVWwojAiNa Q==; X-IronPort-AV: E=McAfee;i="6600,9927,10776"; a="366731403" X-IronPort-AV: E=Sophos;i="6.01,218,1684825200"; d="scan'208";a="366731403" Received: from orsmga003.jf.intel.com ([10.7.209.27]) by fmsmga103.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 20 Jul 2023 04:05:45 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=McAfee;i="6600,9927,10776"; a="674650211" X-IronPort-AV: E=Sophos;i="6.01,218,1684825200"; d="scan'208";a="674650211" Received: from silpixa00401385.ir.intel.com ([10.237.214.156]) by orsmga003.jf.intel.com with ESMTP; 20 Jul 2023 04:05:44 -0700 From: Bruce Richardson To: dev@dpdk.org Cc: Bruce Richardson Subject: [PATCH v4 0/2] Improve docs on getting info on running process Date: Thu, 20 Jul 2023 12:05:38 +0100 Message-Id: <20230720110540.231342-1-bruce.richardson@intel.com> X-Mailer: git-send-email 2.39.2 In-Reply-To: <20230613143355.77914-1-bruce.richardson@intel.com> References: <20230613143355.77914-1-bruce.richardson@intel.com> MIME-Version: 1.0 X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Add details to our documentation on how to register logging for a component. Also provide guidelines on when to use logs vs tracing vs telemetry. V4: Added note to patch 1 saying not to use the old static logging method V3: Moved new doc section on runtime info, and other minor changes flagged by David on review. V2: extended second patch based on the feedback provided. Bruce Richardson (2): doc/contributing: provide coding details for dynamic logging doc/contributing: guidelines for logging, tracing and telemetry doc/guides/contributing/coding_style.rst | 24 ++++++++++++ doc/guides/contributing/design.rst | 49 ++++++++++++++++++++++++ doc/guides/prog_guide/telemetry_lib.rst | 2 + doc/guides/prog_guide/trace_lib.rst | 2 + lib/cfgfile/rte_cfgfile.c | 2 + 5 files changed, 79 insertions(+) Acked-by: Ferruh Yigit --- 2.39.2