From patchwork Fri Jun 24 10:14:23 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Phil Sutter X-Patchwork-Id: 640128 X-Patchwork-Delegate: shemminger@vyatta.com Return-Path: X-Original-To: patchwork-incoming@ozlabs.org Delivered-To: patchwork-incoming@ozlabs.org Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by ozlabs.org (Postfix) with ESMTP id 3rbZ263szZz9s9n for ; Fri, 24 Jun 2016 20:14:38 +1000 (AEST) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1750996AbcFXKOg (ORCPT ); Fri, 24 Jun 2016 06:14:36 -0400 Received: from orbyte.nwl.cc ([151.80.46.58]:60063 "EHLO mail.nwl.cc" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1750853AbcFXKOf (ORCPT ); Fri, 24 Jun 2016 06:14:35 -0400 Received: from mail.nwl.cc (orbyte.nwl.cc [127.0.0.1]) by mail.nwl.cc (Postfix) with ESMTP id 5C76B67997; Fri, 24 Jun 2016 12:15:24 +0200 (CEST) Received: from xsao (localhost [IPv6:::1]) by mail.nwl.cc (Postfix) with ESMTP id EAB2466C6C; Fri, 24 Jun 2016 12:15:23 +0200 (CEST) From: Phil Sutter To: Stephen Hemminger Cc: netdev@vger.kernel.org Subject: [iproute PATCH] man: ip-address, ip-link: Document 'type' quirk Date: Fri, 24 Jun 2016 12:14:23 +0200 Message-Id: <1466763263-1994-1-git-send-email-phil@nwl.cc> X-Mailer: git-send-email 2.8.2 X-Virus-Scanned: ClamAV using ClamSMTP Sender: netdev-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: netdev@vger.kernel.org This covers the fact that calling 'ip {link|addr} show type foobar' does not return an error. Signed-off-by: Phil Sutter --- man/man8/ip-address.8.in | 6 ++++++ man/man8/ip-link.8.in | 6 ++++++ 2 files changed, 12 insertions(+) diff --git a/man/man8/ip-address.8.in b/man/man8/ip-address.8.in index ab0942d7e94e2..8d34adb336af4 100644 --- a/man/man8/ip-address.8.in +++ b/man/man8/ip-address.8.in @@ -280,6 +280,12 @@ only list interfaces enslaved to this master device. .BI type " TYPE" only list interfaces of the given type. +Note that the type name is not checked against the list of supported types - +instead it is sent as-is to the kernel. Later it is used to filter the returned +interface list by comparing it with the relevant attribute in case the kernel +didn't filter already. Therefore any string is accepted, but may lead to empty +output. + .TP .B up only list running interfaces. diff --git a/man/man8/ip-link.8.in b/man/man8/ip-link.8.in index d5673639d9ddf..e10f541b20bcf 100644 --- a/man/man8/ip-link.8.in +++ b/man/man8/ip-link.8.in @@ -1242,6 +1242,12 @@ specifies the master device which enslaves devices to show. .I TYPE specifies the type of devices to show. +Note that the type name is not checked against the list of supported types - +instead it is sent as-is to the kernel. Later it is used to filter the returned +interface list by comparing it with the relevant attribute in case the kernel +didn't filter already. Therefore any string is accepted, but may lead to empty +output. + .SS ip link help - display help .PP