From 291ffd2fb47a8972c9c80453b8d272f6356da1e7 Mon Sep 17 00:00:00 2001 From: Sascha Wildner Date: Sun, 4 Nov 2007 19:04:42 +0000 Subject: [PATCH] Use .Dv for ioctls. --- share/man/man4/bpf.4 | 7 ++++--- share/man/man4/cd.4 | 8 ++++---- share/man/man4/ch.4 | 4 ++-- share/man/man4/crypto.4 | 4 ++-- share/man/man4/da.4 | 4 ++-- share/man/man4/gre.4 | 14 +++++++------- share/man/man4/inet.4 | 4 ++-- share/man/man4/joy.4 | 4 ++-- share/man/man4/keyboard.4 | 18 +++++++++++++----- share/man/man4/man4.i386/apm.4 | 18 +++++++++--------- share/man/man4/man4.i386/asc.4 | 4 ++-- share/man/man4/man4.i386/cx.4 | 20 ++++++++++---------- share/man/man4/man4.i386/perfmon.4 | 4 ++-- 13 files changed, 61 insertions(+), 52 deletions(-) diff --git a/share/man/man4/bpf.4 b/share/man/man4/bpf.4 index 67c3ba9b81..564221b769 100644 --- a/share/man/man4/bpf.4 +++ b/share/man/man4/bpf.4 @@ -21,7 +21,7 @@ .\" distributed with 4.3BSD Unix. .\" .\" $FreeBSD: src/share/man/man4/bpf.4,v 1.21.2.11 2002/04/07 04:57:13 dd Exp $ -.\" $DragonFly: src/share/man/man4/bpf.4,v 1.5 2006/05/26 19:39:39 swildner Exp $ +.\" $DragonFly: src/share/man/man4/bpf.4,v 1.6 2007/11/04 19:04:42 swildner Exp $ .\" .Dd January 16, 1996 .Dt BPF 4 @@ -127,7 +127,7 @@ file. The (third) argument to .Xr ioctl 2 should be a pointer to the type indicated. -.Bl -tag -width BIOCGRTIMEOUT +.Bl -tag -width ".Dv BIOCGRTIMEOUT" .It Dv BIOCGBLEN .Pq Li u_int Returns the required buffer length for reads on @@ -163,7 +163,8 @@ packets promiscuously. This problem can be remedied with an appropriate filter. .It Dv BIOCFLUSH Flushes the buffer of incoming packets, -and resets the statistics that are returned by BIOCGSTATS. +and resets the statistics that are returned by +.Dv BIOCGSTATS . .It Dv BIOCGETIF .Pq Li "struct ifreq" Returns the name of the hardware interface that the file is listening on. diff --git a/share/man/man4/cd.4 b/share/man/man4/cd.4 index 6b5be21233..31186cb008 100644 --- a/share/man/man4/cd.4 +++ b/share/man/man4/cd.4 @@ -24,7 +24,7 @@ .\" SUCH DAMAGE. .\" .\" $FreeBSD: src/share/man/man4/cd.4,v 1.17.2.8 2003/06/03 14:32:09 hmp Exp $ -.\" $DragonFly: src/share/man/man4/cd.4,v 1.4 2006/05/26 19:39:39 swildner Exp $ +.\" $DragonFly: src/share/man/man4/cd.4,v 1.5 2007/11/04 19:04:42 swildner Exp $ .\" .Dd October 10, 1998 .Dt CD 4 @@ -35,8 +35,8 @@ .Sh SYNOPSIS .Cd device cd .Cd device cd1 at scbus0 target 4 unit 0 -.Cd "options ""CHANGER_MIN_BUSY_SECONDS=3""" -.Cd "options ""CHANGER_MAX_BUSY_SECONDS=11"" +.Cd "options CHANGER_MIN_BUSY_SECONDS=3" +.Cd "options CHANGER_MAX_BUSY_SECONDS=11" .Sh DESCRIPTION The .Nm @@ -118,7 +118,7 @@ in the header files and .In sys/disklabel.h . .Pp -.Bl -tag -width CDIOCREADSUBCHANNEL +.Bl -tag -width ".Dv CDIOCREADSUBCHANNEL" .It Dv DIOCGDINFO .It Dv DIOCSDINFO .Pq Li "struct disklabel" diff --git a/share/man/man4/ch.4 b/share/man/man4/ch.4 index 92d82dc919..bf0652e9e9 100644 --- a/share/man/man4/ch.4 +++ b/share/man/man4/ch.4 @@ -1,5 +1,5 @@ .\" $FreeBSD: src/share/man/man4/ch.4,v 1.18.2.7 2001/08/17 13:08:37 ru Exp $ -.\" $DragonFly: src/share/man/man4/ch.4,v 1.9 2007/05/17 08:19:01 swildner Exp $ +.\" $DragonFly: src/share/man/man4/ch.4,v 1.10 2007/11/04 19:04:42 swildner Exp $ .\" Copyright (c) 1996 .\" Julian Elischer . All rights reserved. .\" @@ -94,7 +94,7 @@ They are defined in the header file .In sys/chio.h . .Pp -.Bl -tag -width CHIOEXCHANGE +.Bl -tag -width ".Dv CHIOEXCHANGE" .It Dv CHIOMOVE .Pq Vt "struct changer_move" Move a medium from one element to another diff --git a/share/man/man4/crypto.4 b/share/man/man4/crypto.4 index 3d10cb7b85..1d55dfc93e 100644 --- a/share/man/man4/crypto.4 +++ b/share/man/man4/crypto.4 @@ -1,6 +1,6 @@ .\" $OpenBSD: crypto.4,v 1.4 2002/09/12 07:15:03 deraadt Exp $ .\" $FreeBSD: src/share/man/man4/crypto.4,v 1.1.2.2 2002/12/29 16:35:38 schweikh Exp $ -.\" $DragonFly: src/share/man/man4/crypto.4,v 1.6 2007/07/29 17:27:45 swildner Exp $ +.\" $DragonFly: src/share/man/man4/crypto.4,v 1.7 2007/11/04 19:04:42 swildner Exp $ .\" .\" Copyright (c) 2001 Theo de Raadt .\" All rights reserved. @@ -59,7 +59,7 @@ The following calls apply only to the .Nm devices: -.Bl -tag -width CIOCGSESSION +.Bl -tag -width ".Dv CIOCGSESSION" .It Dv CIOCGSESSION Setup a new crypto session for a new type of operation. .It Dv CIOCFSESSION diff --git a/share/man/man4/da.4 b/share/man/man4/da.4 index 4a509bfbc0..8e8655b34a 100644 --- a/share/man/man4/da.4 +++ b/share/man/man4/da.4 @@ -24,7 +24,7 @@ .\" SUCH DAMAGE. .\" .\" $FreeBSD: src/share/man/man4/da.4,v 1.22.2.7 2001/10/01 13:07:23 dd Exp $ -.\" $DragonFly: src/share/man/man4/da.4,v 1.5 2007/05/17 08:19:01 swildner Exp $ +.\" $DragonFly: src/share/man/man4/da.4,v 1.6 2007/11/04 19:04:42 swildner Exp $ .\" .Dd October 15, 1998 .Dt DA 4 @@ -156,7 +156,7 @@ calls apply to disks as well as to other disks. They are defined in the header file .In sys/disklabel.h . .Pp -.Bl -tag -width DIOCSDINFO +.Bl -tag -width ".Dv DIOCSDINFO" .It Dv DIOCSBAD Usually used to set up a bad-block mapping system on the disk. .Tn SCSI diff --git a/share/man/man4/gre.4 b/share/man/man4/gre.4 index 66b0eaff12..47c4c59b30 100644 --- a/share/man/man4/gre.4 +++ b/share/man/man4/gre.4 @@ -1,6 +1,6 @@ .\" $NetBSD: gre.4,v 1.28 2002/06/10 02:49:35 itojun Exp $ .\" $FreeBSD: src/share/man/man4/gre.4,v 1.1.2.1 2002/12/01 14:03:11 sobomax Exp $ -.\" $DragonFly: src/share/man/man4/gre.4,v 1.3 2007/07/29 17:27:45 swildner Exp $ +.\" $DragonFly: src/share/man/man4/gre.4,v 1.4 2007/11/04 19:04:42 swildner Exp $ .\" .\" Copyright 1998 (c) The NetBSD Foundation, Inc. .\" All rights reserved. @@ -87,25 +87,25 @@ interfaces support a number of .Xr ioctl 2 Ns s , such as: .Bl -tag -width aaa -.It GRESADDRS : +.It Dv GRESADDRS : Set the IP address of the local tunnel end. This is the source address set by or displayed by ifconfig for the .Sy gre Ns Ar X interface. -.It GRESADDRD : +.It Dv GRESADDRD : Set the IP address of the remote tunnel end. This is the destination address set by or displayed by ifconfig for the .Sy gre Ns Ar X interface. -.It GREGADDRS : +.It Dv GREGADDRS : Query the IP address that is set for the local tunnel end. This is the address the encapsulation header carries as local address (i.e. the real address of the tunnel start point.) -.It GREGADDRD : +.It Dv GREGADDRD : Query the IP address that is set for the remote tunnel end. This is the address the encapsulated packets are sent to (i.e. the real address of the remote tunnel endpoint.) -.It GRESPROTO : +.It Dv GRESPROTO : Set the operation mode to the specified IP protocol value. The protocol is passed to the interface in (struct ifreq)-\*[Gt]ifr_flags. The operation mode can also be given as @@ -123,7 +123,7 @@ The link1 flag is not used to choose encapsulation, but to modify the internal route search for the remote tunnel endpoint, see the .Sx BUGS section below. -.It GREGPROTO : +.It Dv GREGPROTO : Query operation mode. .El .Pp diff --git a/share/man/man4/inet.4 b/share/man/man4/inet.4 index 117c327050..ee4b64f0fe 100644 --- a/share/man/man4/inet.4 +++ b/share/man/man4/inet.4 @@ -31,7 +31,7 @@ .\" .\" From: @(#)inet.4 8.1 (Berkeley) 6/5/93 .\" $FreeBSD: src/share/man/man4/inet.4,v 1.11.2.6 2001/12/17 11:30:12 ru Exp $ -.\" $DragonFly: src/share/man/man4/inet.4,v 1.5 2007/07/14 21:48:15 swildner Exp $ +.\" $DragonFly: src/share/man/man4/inet.4,v 1.6 2007/11/04 19:04:42 swildner Exp $ .\" .Dd February 14, 1995 .Dt INET 4 @@ -137,7 +137,7 @@ they have the same form as the command (see .Xr intro 4 ) . .Pp -.Bl -tag -width SIOCSIFNETMASK +.Bl -tag -width ".Dv SIOCSIFNETMASK" .It Dv SIOCSIFNETMASK Set interface network mask. The network mask defines the network part of the address; diff --git a/share/man/man4/joy.4 b/share/man/man4/joy.4 index 71941de41a..19c74dbcca 100644 --- a/share/man/man4/joy.4 +++ b/share/man/man4/joy.4 @@ -1,6 +1,6 @@ .\" .\" $FreeBSD: src/share/man/man4/joy.4,v 1.12.4.10 2002/07/22 14:21:51 ru Exp $ -.\" $DragonFly: src/share/man/man4/joy.4,v 1.4 2007/10/13 09:01:11 swildner Exp $ +.\" $DragonFly: src/share/man/man4/joy.4,v 1.5 2007/11/04 19:04:42 swildner Exp $ .\" .Dd January 23, 1995 .Dt JOY 4 @@ -45,7 +45,7 @@ perl -e 'open(JOY,"/dev/joy0")||die;while(1) Several ioctl() calls are also available. They take an argument of type int * -.Bl -tag -width JOY_SET_X_OFFSET +.Bl -tag -width ".Dv JOY_SET_X_OFFSET" .It Dv JOY_SETTIMEOUT Fa int *limit Set the time limit (in microseconds) for reading the joystick status. diff --git a/share/man/man4/keyboard.4 b/share/man/man4/keyboard.4 index 3d86d49a51..3179f5cb9e 100644 --- a/share/man/man4/keyboard.4 +++ b/share/man/man4/keyboard.4 @@ -1,6 +1,6 @@ .\" .\" $FreeBSD: src/share/man/man4/keyboard.4,v 1.19.2.5 2001/08/17 13:08:38 ru Exp $ -.\" $DragonFly: src/share/man/man4/keyboard.4,v 1.2 2003/06/17 04:36:59 dillon Exp $ +.\" $DragonFly: src/share/man/man4/keyboard.4,v 1.3 2007/11/04 19:04:42 swildner Exp $ .\" .Dd January 8, 1995 .Dt KEYBOARD 4 @@ -59,7 +59,9 @@ pressed, and the number with bit 7 as 1 when released. This makes it possible to make the mapping of the keys fully configurable. .Pp -The meaning of every key is programmable via the PIO_KEYMAP ioctl call, that +The meaning of every key is programmable via the +.Dv PIO_KEYMAP +ioctl call, that takes a structure keymap_t as argument. The layout of this structure is as follows: @@ -113,10 +115,14 @@ The utility is used to load such a description into/outof the kernel at runtime. This makes it possible to change the key -assignments at runtime, or more important to get (GIO_KEYMAP ioctl) +assignments at runtime, or more important to get +.Dv ( GIO_KEYMAP +ioctl) the exact key meanings from the kernel (fx. used by the X server). .Pp -The function keys can be programmed using the SETFKEY ioctl call. +The function keys can be programmed using the +.Dv SETFKEY +ioctl call. .Pp This ioctl takes a argument of the type fkeyarg_t: .Bd -literal -offset indent @@ -131,7 +137,9 @@ The field keynum defines which function key that is programmed. The array keydef should contain the new string to be used (MAXFK long), and the length should be entered in flen. .Pp -The GETFKEY ioctl call works in a similar manner, except it returns +The +.Dv GETFKEY +ioctl call works in a similar manner, except it returns the current setting of keynum. .Pp The function keys are numbered like this: diff --git a/share/man/man4/man4.i386/apm.4 b/share/man/man4/man4.i386/apm.4 index e3bd2a4a77..48161fda55 100644 --- a/share/man/man4/man4.i386/apm.4 +++ b/share/man/man4/man4.i386/apm.4 @@ -10,7 +10,7 @@ .\" use. .\" .\" $FreeBSD: src/share/man/man4/man4.i386/apm.4,v 1.13.2.5 2001/08/17 13:08:45 ru Exp $ -.\" $DragonFly: src/share/man/man4/man4.i386/apm.4,v 1.5 2007/05/12 21:15:35 swildner Exp $ +.\" $DragonFly: src/share/man/man4/man4.i386/apm.4,v 1.6 2007/11/04 19:04:42 swildner Exp $ .\" .Dd November 1, 1994 .Dt APM 4 i386 @@ -51,17 +51,17 @@ can control APM, or retrieve APM status information via this interface. exports the following interfaces. These symbols are defined in .In machine/apm_bios.h . .Bl -tag -width 4n -offset indent -.It Sy APMIO_SUSPEND +.It Dv APMIO_SUSPEND Suspend system. -.It Sy APMIO_GET +.It Dv APMIO_GET Get power management information. -.It Sy APMIO_ENABLE -.It Sy APMIO_DISABLE +.It Dv APMIO_ENABLE +.It Dv APMIO_DISABLE Enable / Disable power management. -.It Sy APMIO_HALTCPU -.It Sy APMIO_NOTHALTCPU +.It Dv APMIO_HALTCPU +.It Dv APMIO_NOTHALTCPU Control execution of HLT in the kernel context switch routine. -.It Sy APMIO_GETPWSTATUS +.It Dv APMIO_GETPWSTATUS Get per battery information. .Pp Some APM implementations execute the HLT @@ -82,7 +82,7 @@ On some implementations that do not support CPU clock slowdown, APM might not execute HLT. .Nm disables -.Sy APMIO_NOTHALTCPU +.Dv APMIO_NOTHALTCPU operation on such machines. .Pp The current version of diff --git a/share/man/man4/man4.i386/asc.4 b/share/man/man4/man4.i386/asc.4 index ff17a9a213..649540ff07 100644 --- a/share/man/man4/man4.i386/asc.4 +++ b/share/man/man4/man4.i386/asc.4 @@ -30,7 +30,7 @@ .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" .\" $FreeBSD: src/share/man/man4/man4.i386/asc.4,v 1.14.2.2 2001/08/17 13:08:45 ru Exp $ -.\" $DragonFly: src/share/man/man4/man4.i386/asc.4,v 1.3 2006/02/17 19:37:10 swildner Exp $ +.\" $DragonFly: src/share/man/man4/man4.i386/asc.4,v 1.4 2007/11/04 19:04:42 swildner Exp $ .Dd January 19, 1995 .Dt ASC 4 i386 .Os @@ -81,7 +81,7 @@ are listed below. The .Xr sasc 1 provides user-level access to these commands. -.Bl -tag -width "ASC_GHEIGHT" +.Bl -tag -width ".Dv ASC_GHEIGHT" .It Dv ASC_GRES .Pq Li int Get current resolution in dots per inch (dpi). diff --git a/share/man/man4/man4.i386/cx.4 b/share/man/man4/man4.i386/cx.4 index fa3608cdfc..3f9413989e 100644 --- a/share/man/man4/man4.i386/cx.4 +++ b/share/man/man4/man4.i386/cx.4 @@ -1,6 +1,6 @@ .\" .\" $FreeBSD: src/share/man/man4/man4.i386/cx.4,v 1.7.2.6 2001/08/17 13:08:45 ru Exp $ -.\" $DragonFly: src/share/man/man4/man4.i386/cx.4,v 1.4 2006/11/14 22:27:49 swildner Exp $ +.\" $DragonFly: src/share/man/man4/man4.i386/cx.4,v 1.5 2007/11/04 19:04:42 swildner Exp $ .\" .Dd December 12, 1994 .Dt CX 4 i386 @@ -94,7 +94,7 @@ Here # is the channel number in hexadecimal form, 0-9-a-f. The driver fulfills the following standard ioctl requests (see .Xr ioctl 2 ) : .Pp -.Bl -tag -width TIOCXXXXX -compact +.Bl -tag -width ".Dv TIOCSBRK" -compact .It Dv TIOCSBRK Start sending BREAK. .It Dv TIOCCBRK @@ -110,30 +110,30 @@ and could be changed by .Dv TIOCMBIS , .Dv TIOCMBIC ioctl calls. -.It TIOCCDTR +.It Dv TIOCCDTR Clear DTR signal (DTR := 0). -.It TIOCMSET +.It Dv TIOCMSET Set the given values of DTR and RTS signals ( := data). The signals DTR and RTS are controlled by .Dv TIOCM_DTR and .Dv TIOCM_RTS bits of the data argument of the ioctl system call. -.It TIOCMBIS +.It Dv TIOCMBIS Set DTR and RTS signals ( |= data). The signals DTR and RTS are controlled by .Dv TIOCM_DTR and .Dv TIOCM_RTS bits of the data argument of the ioctl system call. -.It TIOCMBIC +.It Dv TIOCMBIC Clear DTR and RTS signals ( &= ~data). The signals DTR and RTS are controlled by .Dv TIOCM_DTR and .Dv TIOCM_RTS bits of the data argument of the ioctl system call. -.It TIOCMGET +.It Dv TIOCMGET Determine the state of the modem signals of the line. After the call the data argument contains the following bits: .Pp @@ -202,10 +202,10 @@ The actual channel options control functions are implemented via the ioctl-s on the special device file /dev/cronyx. There are the following ioctl-s available: .Pp -.Bl -tag -width CXIOCXXXXXXX -compact -.It CXIOCGETMODE +.Bl -tag -width ".Dv CXIOCGETMODE" -compact +.It Dv CXIOCGETMODE Get the channel option values. -.It CXIOCSETMODE +.It Dv CXIOCSETMODE Set the channel option values. .El .Pp diff --git a/share/man/man4/man4.i386/perfmon.4 b/share/man/man4/man4.i386/perfmon.4 index 2b46595d3c..5663fc516a 100644 --- a/share/man/man4/man4.i386/perfmon.4 +++ b/share/man/man4/man4.i386/perfmon.4 @@ -27,7 +27,7 @@ .\" SUCH DAMAGE. .\" .\" $FreeBSD: src/share/man/man4/man4.i386/perfmon.4,v 1.8.2.5 2001/08/17 13:08:46 ru Exp $ -.\" $DragonFly: src/share/man/man4/man4.i386/perfmon.4,v 1.3 2006/05/26 19:39:40 swildner Exp $ +.\" $DragonFly: src/share/man/man4/man4.i386/perfmon.4,v 1.4 2007/11/04 19:04:42 swildner Exp $ .Dd March 26, 1996 .Dt PERFMON 4 i386 .Os @@ -75,7 +75,7 @@ numbers used are the correct ones for the CPU type being measured. The following .Xr ioctl 2 requests are defined: -.Bl -tag -width PMIOTSTAMP +.Bl -tag -width ".Dv PMIOTSTAMP" .It Dv PMIOSETUP .Pq Li "struct pmc" Set up a counter with parameters and flags defined in the structure. -- 2.41.0