From owner-freebsd-doc  Wed Jul 10  9:30:11 2002
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 50D2037B401
	for <freebsd-doc@hub.freebsd.org>; Wed, 10 Jul 2002 09:30:04 -0700 (PDT)
Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21])
	by mx1.FreeBSD.org (Postfix) with ESMTP id A87C543E52
	for <freebsd-doc@hub.freebsd.org>; Wed, 10 Jul 2002 09:30:03 -0700 (PDT)
	(envelope-from gnats@FreeBSD.org)
Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1])
	by freefall.freebsd.org (8.12.4/8.12.4) with ESMTP id g6AGU3JU096075
	for <freebsd-doc@freefall.freebsd.org>; Wed, 10 Jul 2002 09:30:03 -0700 (PDT)
	(envelope-from gnats@freefall.freebsd.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.12.4/8.12.4/Submit) id g6AGU3Ja096074;
	Wed, 10 Jul 2002 09:30:03 -0700 (PDT)
Received: from mx1.FreeBSD.org (mx1.FreeBSD.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id CA52637B400
	for <FreeBSD-gnats-submit@freebsd.org>; Wed, 10 Jul 2002 09:26:34 -0700 (PDT)
Received: from skynet.stack.nl (insgate.stack.nl [131.155.140.2])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 4355B43E42
	for <FreeBSD-gnats-submit@freebsd.org>; Wed, 10 Jul 2002 09:26:34 -0700 (PDT)
	(envelope-from marcov@stack.nl)
Received: from toad.stack.nl (toad.stack.nl [2001:610:1108:5010:202:b3ff:fe17:9e1a])
	by skynet.stack.nl (Postfix) with ESMTP id 484923FF3
	for <FreeBSD-gnats-submit@freebsd.org>; Wed, 10 Jul 2002 18:26:33 +0200 (CEST)
Received: by toad.stack.nl (Postfix, from userid 816)
	id 1F9B998D1; Wed, 10 Jul 2002 18:26:33 +0200 (CEST)
Message-Id: <20020710162633.1F9B998D1@toad.stack.nl>
Date: Wed, 10 Jul 2002 18:26:33 +0200 (CEST)
From: Marco van de Voort <marcov@stack.nl>
Reply-To: Marco van de Voort <marcov@stack.nl>
To: FreeBSD-gnats-submit@FreeBSD.org
X-Send-Pr-Version: 3.113
Subject: docs/40423: Keyboard(4)'s definition of parameters to GETFKEY/SETFKEY off by one.
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
List-ID: <freebsd-doc.FreeBSD.ORG>
List-Archive: <http://docs.freebsd.org/mail/> (Web Archive)
List-Help: <mailto:majordomo@FreeBSD.ORG?subject=help> (List Instructions)
List-Subscribe: <mailto:majordomo@FreeBSD.ORG?subject=subscribe%20freebsd-doc>
List-Unsubscribe: <mailto:majordomo@FreeBSD.ORG?subject=unsubscribe%20freebsd-doc>
X-Loop: FreeBSD.org


>Number:         40423
>Category:       docs
>Synopsis:       Keyboard(4)'s definition of parameters to GETFKEY/SETFKEY off by one.
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Wed Jul 10 09:30:02 PDT 2002
>Closed-Date:
>Last-Modified:
>Originator:     Marco van de Voort
>Release:        FreeBSD 4.6-STABLE i386
>Organization:
MCGV Stack
>Environment:
System: FreeBSD toad.stack.nl 4.6-STABLE FreeBSD 4.6-STABLE #0: Sun Jun 23 17:18:50 CEST 2002 marcolz@toad.stack.nl:/toad.mnt/sources/4.x/sys/compile/toad_vwww i386
 (Man page, system unimportant)
>Description:
The C IOCTL (SET/GETFKEY) interface to set "function keys" requires
parameters in the range 0..63 (actually 0..95)

Kbdcontrol -f remaps them to 1..64 (1..96)

Keyboard(4) which describes (amongst others) the SET/GETFKEY functions
specifies the range as 1..64, while not mentioning that kbdcontrol
add/subtracts 1 internally when necessary

>How-To-Repeat:
 man 4 keyboard
>Fix:
Mention that there is a difference between the C level interface and the
kbdcontrol parameter with respect to the range of the function keys.


>Release-Note:
>Audit-Trail:
>Unformatted:

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message