From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-8.8 required=3.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,FREEMAIL_FORGED_FROMDOMAIN,FREEMAIL_FROM, HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_PATCH,MAILING_LIST_MULTI,SIGNED_OFF_BY, SPF_PASS,USER_AGENT_GIT autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 51468C43381 for ; Fri, 22 Mar 2019 14:59:58 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.kernel.org (Postfix) with ESMTP id 1DF3F218B0 for ; Fri, 22 Mar 2019 14:59:58 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="tcsjCsFi" Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1729369AbfCVO74 (ORCPT ); Fri, 22 Mar 2019 10:59:56 -0400 Received: from mail-qk1-f193.google.com ([209.85.222.193]:39615 "EHLO mail-qk1-f193.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1728024AbfCVO74 (ORCPT ); Fri, 22 Mar 2019 10:59:56 -0400 Received: by mail-qk1-f193.google.com with SMTP id c189so1379441qke.6 for ; Fri, 22 Mar 2019 07:59:56 -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:mime-version :content-transfer-encoding; bh=Ln389ly7JTMN/CyIJ8kTUf00nei89fSdTettHd8VI/0=; b=tcsjCsFibQnrjULpYvT950a/xEAGjW+BBVXfSEW4ha/Omq1VNC/yWGAVJ/3b0lcJfe lkFI46hYUyPc61TpPgMTClT992aXWnLBo/1xEn5byNsRst7v7NHWxAIw9LlAjdJdH+Rm 98gPyGXMZpDwmewDgdTXajw/FwTDbpWEDZs3Jy+dopXwf//OaeiNmdOEw1PAukjX/U6U kfyc4APcXUBSzWvWDcREl1ZkfUEpksERPZQ/2/U4noH77Ub1i4shNpMSDgmaOI0553Er b5x0NfttZcN8VRYw1RTmmsLtJtCiF4EJ4nmIJPS1iwvPMJxUpSNZdqXUFxFHyMSxqT0T H2Zg== 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:mime-version :content-transfer-encoding; bh=Ln389ly7JTMN/CyIJ8kTUf00nei89fSdTettHd8VI/0=; b=F9gxKMyGh7Y+A4oA9c4yHS4vR7lBEDLLQRdvmp1h2z6R1ddkDdLe4qVJrOAO3booWY u5ff+cxOqVxPgwBhSANwKK8bltK2x6UhE2pPxx4KCqt2GBs9af03qDYiXh5slvsJBfRc VnkZLfUS0UaOIRb+3EUOJ1+fS7unfllEm8zZDwg9cFz2Pbt9tlVVGMYgHPUR05IGj2IH uvyxPgcT4L97HjtPKBcXwnexMFb1xVp1Xvz1y0dZ81GrLs/8USWN65yCmeaKAGsu5gmU uj72mScE5pTz7bRqYh0FhDj7RSyrEkvlikmRkWqgG1c+jTtvIUpid6AFNv0ww0/ugWvG oxuA== X-Gm-Message-State: APjAAAV0Elr4RPp+1OWl1RB1KaGi8HzlHyKcql8PKMLCTai4eBvamMSX +w1kMvlDnYYOjApGSxWMzxA= X-Google-Smtp-Source: APXvYqwcEObzfHE9A4t8hxC0txeW5fpaQvpW8a4xXlGSLxaGcNIqaerzqA+iB2+dgDrYve3eEKNnFw== X-Received: by 2002:a37:ae85:: with SMTP id x127mr7826822qke.337.1553266795320; Fri, 22 Mar 2019 07:59:55 -0700 (PDT) Received: from soheil24.nyc.corp.google.com ([2620:0:1003:315:d7ab:1a20:d24a:a109]) by smtp.gmail.com with ESMTPSA id f22sm1203299qkm.22.2019.03.22.07.59.54 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Fri, 22 Mar 2019 07:59:54 -0700 (PDT) From: Soheil Hassas Yeganeh To: davem@davemloft.net, netdev@vger.kernel.org Cc: edumazet@google.com, ycheng@google.com, ncardwell@google.com, Soheil Hassas Yeganeh , Sowmini Varadhan Subject: [PATCH net-next] tcp: add documentation for tcp_ca_state Date: Fri, 22 Mar 2019 10:59:47 -0400 Message-Id: <20190322145947.201084-1-soheil.kdev@gmail.com> X-Mailer: git-send-email 2.21.0.392.gf8f6787159e-goog MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Sender: netdev-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: netdev@vger.kernel.org From: Soheil Hassas Yeganeh Add documentation to the tcp_ca_state enum, since this enum is exposed in uapi. Signed-off-by: Neal Cardwell Signed-off-by: Yuchung Cheng Signed-off-by: Eric Dumazet Signed-off-by: Soheil Hassas Yeganeh Cc: Sowmini Varadhan --- include/uapi/linux/tcp.h | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) diff --git a/include/uapi/linux/tcp.h b/include/uapi/linux/tcp.h index 8bb6cc5f3235..b521464ea962 100644 --- a/include/uapi/linux/tcp.h +++ b/include/uapi/linux/tcp.h @@ -160,15 +160,42 @@ enum { #define TCPI_OPT_ECN_SEEN 16 /* we received at least one packet with ECT */ #define TCPI_OPT_SYN_DATA 32 /* SYN-ACK acked data in SYN sent or rcvd */ +/* + * Sender's congestion state indicating normal or abnormal situations + * in the last round of packets sent. The state is driven by the ACK + * information and timer events. + */ enum tcp_ca_state { + /* + * Nothing bad has been observed recently. + * No apparent reordering, packet loss, or ECN marks. + */ TCP_CA_Open = 0, #define TCPF_CA_Open (1<