From owner-freebsd-doc@FreeBSD.ORG Wed Sep 20 14:40:41 2006 Return-Path: X-Original-To: freebsd-doc@hub.freebsd.org Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id ACEF516A403 for ; Wed, 20 Sep 2006 14:40:41 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 209B643D92 for ; Wed, 20 Sep 2006 14:40:26 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.13.4/8.13.4) with ESMTP id k8KEeQox047476 for ; Wed, 20 Sep 2006 14:40:26 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.13.4/8.13.4/Submit) id k8KEeQpu047475; Wed, 20 Sep 2006 14:40:26 GMT (envelope-from gnats) Resent-Date: Wed, 20 Sep 2006 14:40:26 GMT Resent-Message-Id: <200609201440.k8KEeQpu047475@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Rene Ladan Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 18CD916A49E; Wed, 20 Sep 2006 14:35:37 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id C070443D46; Wed, 20 Sep 2006 14:35:36 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.13.4/8.13.4) with ESMTP id k8KEZakm046663; Wed, 20 Sep 2006 14:35:36 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.13.4/8.13.4/Submit) id k8KEZa8i046662; Wed, 20 Sep 2006 14:35:36 GMT (envelope-from gnats) Message-Id: <200609201435.k8KEZa8i046662@freefall.freebsd.org> Date: Wed, 20 Sep 2006 14:35:36 GMT From: Rene Ladan To: freebsd-gnats-submit@FreeBSD.org Cc: Mark Linimon Subject: docs/103420: [patch] usbhidctl(1): update manual page to include write support X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 20 Sep 2006 14:40:41 -0000 >Number: 103420 >Category: docs >Synopsis: [patch] usbhidctl(1): update manual page to include write support >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: change-request >Submitter-Id: current-users >Arrival-Date: Wed Sep 20 14:40:26 GMT 2006 >Closed-Date: >Last-Modified: >Originator: Rene Ladan >Release: FreeBSD 6.2 PRELEASE i386 2006-09-19 >Organization: >Environment: FreeBSD s000655.campus.tue.nl 6.2-PRERELEASE FreeBSD 6.2-PRERELEASE #5: Tue Sep 19 21:13:50 CEST 2006 root@s000655.campus.tue.nl:/usr/obj/usr/src6/sys/RENE i386 >Description: Update the usbhidctl manual page to include write support by adding a description of the -w flag and updating the BUGS section. Also bump .Dd to 2006-09-20 [linimon's note while rescuing from GNATS spam-queue: this needs to be committed only after the usb PR for usbhidctl from the same submitter] >How-To-Repeat: >Fix: --- /usr/src/usr.bin/usbhidctl/usbhidctl.1 Tue Jan 18 14:43:55 2005 +++ usbhidctl.1 Tue Sep 19 23:46:47 2006 @@ -35,7 +35,7 @@ .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE .\" POSSIBILITY OF SUCH DAMAGE. .\" -.Dd July 12, 1998 +.Dd September 20, 2006 .Dt USBHIDCTL 1 .Os .Sh NAME @@ -51,13 +51,22 @@ .Op Fl t Ar table .Op Fl v .Op Ar item ... +.Nm +.Fl f Ar device +.Op t ar table +.Fl w Ar name Ns = Ar value ... .Sh DESCRIPTION The .Nm -utility can be used to dump the state of a USB HID (Human Interface Device). +utility can be used to dump or modify the state of a USB HID (Human Interface Device). Each named .Ar item is printed. +If the +.Fl w +flag is specified +.Nm +attempts to set the specified items to the given values. .Pp The options are as follows: .Bl -tag -width Ds @@ -67,6 +76,7 @@ Specify a path name for the device to operate on. .It Fl l Loop and dump the device data every time it changes. +Only 'input' items are displayed in this mode. .It Fl n Suppress printing of the item name. .It Fl r @@ -75,6 +85,9 @@ Specify a path name for the HID usage table file. .It Fl v Be verbose. +.It Fl w +Change item values. +Only 'output' and 'feature' kinds can be set with this option. .El .Sh FILES .Pa /usr/share/misc/usb_hid_usages @@ -91,4 +104,4 @@ .Sh BUGS The .Nm -utility cannot show nor set output and feature items. +utility cannot show feature items. >Release-Note: >Audit-Trail: >Unformatted: