From owner-freebsd-bugs@freebsd.org Wed Nov 22 01:29:48 2017 Return-Path: Delivered-To: freebsd-bugs@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 34F77DC09C3 for ; Wed, 22 Nov 2017 01:29:48 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from kenobi.freebsd.org (kenobi.freebsd.org [IPv6:2001:1900:2254:206a::16:76]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 23959660FE for ; Wed, 22 Nov 2017 01:29:48 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from bugs.freebsd.org ([127.0.1.118]) by kenobi.freebsd.org (8.15.2/8.15.2) with ESMTP id vAM1Tlni005202 for ; Wed, 22 Nov 2017 01:29:47 GMT (envelope-from bugzilla-noreply@freebsd.org) From: bugzilla-noreply@freebsd.org To: freebsd-bugs@FreeBSD.org Subject: [Bug 223794] ifconfig manual page doesn't match source about list scan and list sta Date: Wed, 22 Nov 2017 01:29:48 +0000 X-Bugzilla-Reason: AssignedTo X-Bugzilla-Type: new X-Bugzilla-Watch-Reason: None X-Bugzilla-Product: Base System X-Bugzilla-Component: bin X-Bugzilla-Version: CURRENT X-Bugzilla-Keywords: X-Bugzilla-Severity: Affects Many People X-Bugzilla-Who: reed@reedmedia.net X-Bugzilla-Status: New X-Bugzilla-Resolution: X-Bugzilla-Priority: --- X-Bugzilla-Assigned-To: freebsd-bugs@FreeBSD.org X-Bugzilla-Flags: X-Bugzilla-Changed-Fields: bug_id short_desc product version rep_platform op_sys bug_status bug_severity priority component assigned_to reporter Message-ID: Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable X-Bugzilla-URL: https://bugs.freebsd.org/bugzilla/ Auto-Submitted: auto-generated MIME-Version: 1.0 X-BeenThere: freebsd-bugs@freebsd.org X-Mailman-Version: 2.1.25 Precedence: list List-Id: Bug reports List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 22 Nov 2017 01:29:48 -0000 https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D223794 Bug ID: 223794 Summary: ifconfig manual page doesn't match source about list scan and list sta Product: Base System Version: CURRENT Hardware: Any OS: Any Status: New Severity: Affects Many People Priority: --- Component: bin Assignee: freebsd-bugs@FreeBSD.org Reporter: reed@reedmedia.net See sbin/ifconfig/ifieee80211.c and sbin/ifconfig/ifconfig.8 The list_scan() code uses getcaps() and printies(). The list_stations() code uses getcaps() and getflags() and printies().=20 For example: getcaps has A as CAPINFO_CHNL_AGILITY, E is CAPINFO_ESS, and P= is CAPINFO_PRIVACY; and getflags has A as NODE_AUTH, E is NODE_ERP, and P is NODE_PWR_MGT. The manpage has multiple problems. The list scan section has "Depending on the capabilities of the stations the following flags can be included in the output:" But it lists A as Authjoriz= ed, E as ERP, P as Powersave, etc. This has the getflags stuff and not capabiltiies. If you want you may consider some content or hints from the following: A -- Channel Agility allows channel switching or frequency hopping. B -- Packet Binary Convolutional Code (PBCC) mode provides error correction= to help improve performance. Nevertheless, newer technologies have faster rate= s. c -- Contention-free (CF) pollable uses Point coordination function (PCF) a= nd is able to participate in its QoS. C -- CF Pollable Request D -- This 802.11g feature provides both direct-sequence spread spectrum (DS= SS) and Orthogonal frequency-division multiplexing (OFDM) methods. E -- Extended Service Set (ESS). Infrastructure mode providing an Access Po= int where devices can communicate with each other. (It may have more than one AP for roaming.) I -- Independent Basic Service Set (IBBS) is an ad-hoc network with no acce= ss point. (It can only connect to one station at a time.) P -- Wired Equivalent Privacy (WEP). This is weak security that has been superseded by WPA. R -- Robust Security Network (RSN) encrypts the whole frame. This is WPA2. s -- Short Slot Times reduce retransmission delay after collisions to incre= ase throughput. S -- Short Preambles have reduced packet headers to improve performance. Old devices require long preambles. This is a 802.11g feature. Other problems are in the "list sta" section where it documents flags. S as "Short Preamble" but code is about "Short GI in HT40 enabled". (I thin= k is different.): T as "Transitional Security Network (TSN)" but code is about "AMPDU tx enabled". (I think that is wrong.) (I noticed all this as I originally saw mistakes in pfSense wireless stats = page and realized the upstream manual page also had mistakes. I am authoring a v= ery detailed book about pfSense. http://reedmedia.net/books/pfsense/ ) --=20 You are receiving this mail because: You are the assignee for the bug.=