From patchwork Wed Mar 11 17:49:17 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Gregory Rose X-Patchwork-Id: 1253108 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.137; helo=fraxinus.osuosl.org; envelope-from=ovs-dev-bounces@openvswitch.org; receiver=) Authentication-Results: ozlabs.org; dmarc=fail (p=none dis=none) header.from=gmail.com Authentication-Results: ozlabs.org; dkim=fail reason="signature verification failed" (2048-bit key; unprotected) header.d=gmail.com header.i=@gmail.com header.a=rsa-sha256 header.s=20161025 header.b=IOHCyUi4; dkim-atps=neutral Received: from fraxinus.osuosl.org (smtp4.osuosl.org [140.211.166.137]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 48czxD00fpz9sPK for ; Thu, 12 Mar 2020 04:49:30 +1100 (AEDT) Received: from localhost (localhost [127.0.0.1]) by fraxinus.osuosl.org (Postfix) with ESMTP id DE990867F6; Wed, 11 Mar 2020 17:49:28 +0000 (UTC) X-Virus-Scanned: amavisd-new at osuosl.org Received: from fraxinus.osuosl.org ([127.0.0.1]) by localhost (.osuosl.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 2SCuMGIwDdTT; Wed, 11 Mar 2020 17:49:25 +0000 (UTC) Received: from lists.linuxfoundation.org (lf-lists.osuosl.org [140.211.9.56]) by fraxinus.osuosl.org (Postfix) with ESMTP id 2FFD4865E0; Wed, 11 Mar 2020 17:49:25 +0000 (UTC) Received: from lf-lists.osuosl.org (localhost [127.0.0.1]) by lists.linuxfoundation.org (Postfix) with ESMTP id 17655C07FF; Wed, 11 Mar 2020 17:49:25 +0000 (UTC) X-Original-To: dev@openvswitch.org Delivered-To: ovs-dev@lists.linuxfoundation.org Received: from silver.osuosl.org (smtp3.osuosl.org [140.211.166.136]) by lists.linuxfoundation.org (Postfix) with ESMTP id 28421C0177 for ; Wed, 11 Mar 2020 17:49:23 +0000 (UTC) Received: from localhost (localhost [127.0.0.1]) by silver.osuosl.org (Postfix) with ESMTP id 133D422668 for ; Wed, 11 Mar 2020 17:49:23 +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 rXtuAer0CKL6 for ; Wed, 11 Mar 2020 17:49:22 +0000 (UTC) X-Greylist: domain auto-whitelisted by SQLgrey-1.7.6 Received: from mail-pg1-f196.google.com (mail-pg1-f196.google.com [209.85.215.196]) by silver.osuosl.org (Postfix) with ESMTPS id 970C220131 for ; Wed, 11 Mar 2020 17:49:22 +0000 (UTC) Received: by mail-pg1-f196.google.com with SMTP id t3so1603060pgn.1 for ; Wed, 11 Mar 2020 10:49:22 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:date:message-id; bh=Eu3YwnzJzaeQpeueEIl1xWyITaBdWEkcHvs34pXzGKA=; b=IOHCyUi4L06//X87UBed2dc8h/9vWOKixXnnlpu8YXJ0bFYNk/nGiAA1FfRVmaM2iC LufNeH78LtvLjplMOSBY5cXG1lTb+PzxowG++XPP42VIbj71du5BodroeCBXnLgYxdA9 yM08wpNIxPQbOjBGzgrSRNiw7KrqAXHDBTNrP4pjK2AKOFvzuTC84nXaRGNyxc6lZlDn IBq0eXLb9680oozA0SvBm8z3XQhTDYPinlsrBtIpHKbaiO/VcAcBW35WE0e9bFR+6BZ1 4VUGAMxtqtJIMHbnV352/7lyNG+VYqX/woDZnN/v/rRZUE5KdZiyKLYL/DTtJc67cMLy DCeA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id; bh=Eu3YwnzJzaeQpeueEIl1xWyITaBdWEkcHvs34pXzGKA=; b=q2Km5B/4E3ENta3GH0BVO9FXwRcbmcoJnJYSrxbQaG8q4p7Jh2a3kqC0Y022eCv/eT WJ+yN+oG/UmCOus90PjlTZq+UNRaXPG939htB79kATs4Kc6ZO6L+d0GIPh3WbQGf5QwI Pa0e8ZSaCdjit3NoJUspq33Y6PvvI5NjdSCuBs+OXI8WZwa1mz3kxKVTsziZQPsTtVGQ 1roOtcRZVNIR+W1CCC4CMi9V2oTsdNcboN7UBGQOlZGTtfDzCg11l9YDROsojAao9oKN x/3pE/9zSdcJ6MBTzRH/3KD2J4GEB8nTWLvAVScoi6QA83xKP4ko7jy2WYBPUbQr/PXI XBhA== X-Gm-Message-State: ANhLgQ2E8HpOWxpbwGC61ZkxoQNwxDhf9VCSHgoEf/A/VQN+f6STBxn3 Zb0v7VRtetgDtCkDNgJLM921JkLmm9I= X-Google-Smtp-Source: ADFU+vsHJ6vDcTjRMBwB8QYuOFkUi2jDgeuxP0PENASQ9OZl0U5M5jTyEmSkgI8EyH0RH/c6IfiUWw== X-Received: by 2002:a63:180c:: with SMTP id y12mr4084118pgl.120.1583948961872; Wed, 11 Mar 2020 10:49:21 -0700 (PDT) Received: from gizo.domain (97-115-106-43.ptld.qwest.net. [97.115.106.43]) by smtp.gmail.com with ESMTPSA id h2sm50122480pgv.40.2020.03.11.10.49.20 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Wed, 11 Mar 2020 10:49:21 -0700 (PDT) From: Greg Rose To: dev@openvswitch.org Date: Wed, 11 Mar 2020 10:49:17 -0700 Message-Id: <1583948957-3571-1-git-send-email-gvrose8192@gmail.com> X-Mailer: git-send-email 1.8.3.1 Subject: [ovs-dev] [PATCH] Documentation: Add note about iproute2 requirements for check-kmod 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: , MIME-Version: 1.0 Errors-To: ovs-dev-bounces@openvswitch.org Sender: "dev" On many systems the check-kmod and check-kernel test suites have many failures due to the lack of feature support in the older iproute2 utility packages shipped with those systems. Add a note indicating that it might be necessary to update the iproute2 utility package in order to fix those errors. Signed-off-by: Greg Rose Acked-by: William Tu --- Documentation/topics/testing.rst | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/Documentation/topics/testing.rst b/Documentation/topics/testing.rst index 161e9d4..b9fa94d 100644 --- a/Documentation/topics/testing.rst +++ b/Documentation/topics/testing.rst @@ -381,6 +381,17 @@ The results of the testsuite are in ``tests/system-kmod-testsuite.dir``. All the features documented under `Unit Tests`_ are available for the kernel datapath testsuite. +.. note:: + Many of the kernel tests are dependent on the utilities present in the + iproute2 package, especially the 'ip' command. If there are many + otherwise unexplained errors it may be necessary to update the iproute2 + package utilities on the system. It is beyond the scope of this + documentation to explain all that is necessary to build and install + an updated iproute2 utilities package. The package is available from + the Linux kernel organization open source git repositories. + + https://git.kernel.org/pub/scm/linux/kernel/git/shemminger/iproute2.git + .. _testing-static-analysis: Static Code Analysis