From 45ea781022075716fc3221b663d3cb3afe05865e Mon Sep 17 00:00:00 2001 From: Sascha Wildner Date: Sun, 30 Apr 2006 18:46:39 +0000 Subject: [PATCH] Add some missing manual pages. Taken-from: FreeBSD --- share/man/man4/Makefile | 6 +- share/man/man4/fla.4 | 60 ++++++++ share/man/man4/man4.i386/Makefile | 6 +- share/man/man4/man4.i386/oltr.4 | 89 ++++++++++++ share/man/man4/man4.i386/streams.4 | 79 ++++++++++ share/man/man4/man4.i386/svr4.4 | 224 +++++++++++++++++++++++++++++ share/man/man4/rc.4 | 105 ++++++++++++++ share/man/man4/twa.4 | 90 ++++++++++++ share/man/man4/ufm.4 | 74 ++++++++++ 9 files changed, 729 insertions(+), 4 deletions(-) create mode 100644 share/man/man4/fla.4 create mode 100644 share/man/man4/man4.i386/oltr.4 create mode 100644 share/man/man4/man4.i386/streams.4 create mode 100644 share/man/man4/man4.i386/svr4.4 create mode 100644 share/man/man4/rc.4 create mode 100644 share/man/man4/twa.4 create mode 100644 share/man/man4/ufm.4 diff --git a/share/man/man4/Makefile b/share/man/man4/Makefile index 1781af437f..c713325eec 100644 --- a/share/man/man4/Makefile +++ b/share/man/man4/Makefile @@ -1,6 +1,6 @@ # @(#)Makefile 8.1 (Berkeley) 6/18/93 # $FreeBSD: src/share/man/man4/Makefile,v 1.83.2.66 2003/06/04 17:10:30 sam Exp $ -# $DragonFly: src/share/man/man4/Makefile,v 1.34 2006/04/17 21:32:57 swildner Exp $ +# $DragonFly: src/share/man/man4/Makefile,v 1.35 2006/04/30 18:46:39 swildner Exp $ MAN= aac.4 \ acpi.4 \ @@ -60,6 +60,7 @@ MAN= aac.4 \ fd.4 \ fdc.4 \ firewire.4 \ + fla.4 \ fpa.4 \ fwe.4 \ fwohci.4 \ @@ -171,6 +172,7 @@ MAN= aac.4 \ pt.4 \ pty.4 \ puc.4 \ + rc.4 \ re.4 \ rl.4 \ rndtest.4 \ @@ -216,12 +218,14 @@ MAN= aac.4 \ ttcp.4 \ tty.4 \ tun.4 \ + twa.4 \ twe.4 \ txp.4 \ ubsec.4 \ ucom.4 \ udp.4 \ ubsa.4 \ + ufm.4 \ uftdi.4 \ ugen.4 \ uhci.4 \ diff --git a/share/man/man4/fla.4 b/share/man/man4/fla.4 new file mode 100644 index 0000000000..2b0f9072f2 --- /dev/null +++ b/share/man/man4/fla.4 @@ -0,0 +1,60 @@ +.\" Copyright (c) 2003 David E. O'Brien +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS +.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED +.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR +.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS +.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) +.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE +.\" POSSIBILITY OF SUCH DAMAGE. +.\" +.\" $FreeBSD: src/share/man/man4/fla.4,v 1.2 2004/06/17 19:51:17 ru Exp $ +.\" $DragonFly: src/share/man/man4/Attic/fla.4,v 1.1 2006/04/30 18:46:39 swildner Exp $ +.\" +.Dd July 13, 2003 +.Dt FLA 4 +.Os +.Sh NAME +.Nm fla +.Nd M-systems DiskOnChip +.Sh SYNOPSIS +.Cd "device fla" +.Sh DESCRIPTION +DiskOnChip is a family of high-performance, +single-chip flash disks available in a wide range of capacities. +The +.Nm +driver supports the following in the family of M-systems DiskOnChip: +.Pp +.Bl -bullet -compact +.It +DiskOnChip2000 (8, 12, 24, 32, 40, 72, 144 MB) +.It +DiskOnChipMillenium (8 MB) +.It +DiskOnChipMillenium TSOP (8 MB) +.El +.Sh SEE ALSO +.Xr config 8 +.Pp +.Pa http://www.m-sys.com +.Sh HISTORY +The +.Nm +driver +appeared in +.Fx 3.3 . diff --git a/share/man/man4/man4.i386/Makefile b/share/man/man4/man4.i386/Makefile index edbf199126..c2b7ad0748 100644 --- a/share/man/man4/man4.i386/Makefile +++ b/share/man/man4/man4.i386/Makefile @@ -1,14 +1,14 @@ # $FreeBSD: src/share/man/man4/man4.i386/Makefile,v 1.122.2.12 2003/04/15 17:23:32 fjoe Exp $ -# $DragonFly: src/share/man/man4/man4.i386/Makefile,v 1.6 2006/04/12 13:10:16 swildner Exp $ +# $DragonFly: src/share/man/man4/man4.i386/Makefile,v 1.7 2006/04/30 18:46:39 swildner Exp $ MAN= acpi_toshiba.4 aic.4 alpm.4 amdpm.4 apm.4 ar.4 asc.4 asr.4 \ cs.4 cx.4 cy.4 \ dgb.4 el.4 en.4 ep.4 ex.4 fe.4 gsc.4 \ ie.4 io.4 labpc.4 le.4 linux.4 lnc.4 longrun.4 mcd.4 \ meteor.4 mse.4 ndis.4 npx.4 \ - pcf.4 perfmon.4 pnp.4 \ + oltr.4 pcf.4 perfmon.4 pnp.4 \ ray.4 rdp.4 sb.4 sbni.4 scd.4 \ - spkr.4 sr.4 tw.4 \ + spkr.4 sr.4 streams.4 svr4.4 tw.4 \ tx.4 viapm.4 vx.4 \ wl.4 wt.4 diff --git a/share/man/man4/man4.i386/oltr.4 b/share/man/man4/man4.i386/oltr.4 new file mode 100644 index 0000000000..e71fe0c1eb --- /dev/null +++ b/share/man/man4/man4.i386/oltr.4 @@ -0,0 +1,89 @@ +.\" Copyright (c) 2005 Christian Brueffer +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" $FreeBSD: src/share/man/man4/man4.i386/oltr.4,v 1.2 2005/02/12 00:42:14 brueffer Exp $ +.\" $DragonFly: src/share/man/man4/man4.i386/Attic/oltr.4,v 1.1 2006/04/30 18:46:39 swildner Exp $ +.\" +.Dd February 4, 2005 +.Dt OLTR 4 i386 +.Os +.Sh NAME +.Nm oltr +.Nd "Olicom Token Ring device driver" +.Sh SYNOPSIS +.Cd "device oltr" +.Cd "pseudo-device token" +.Sh DESCRIPTION +The +.Nm +driver provides support for Olicom Token Ring adapters. +Only ISA and PCI based devices are supported. +.Sh HARDWARE +The +.Nm +driver supports the following ISA based Olicom Token Ring adapters: +.Pp +.Bl -bullet -compact +.It +Olicom OC-3115 +.It +Olicom ISA 16/4 Adapter (OC-3117) +.It +Olicom ISA 16/4 Adapter (OC-3118) +.El +.Pp +The following PCI based adapters are supported: +.Pp +.Bl -bullet -compact +.It +Olicom PCI 16/4 Adapter (OC-3136) +.It +Olicom PCI/II 16/4 Adapter (OC-3137) +.It +Olicom PCI 16/4 Adapter (OC-3139) +.It +Olicom RapidFire 3140 16/4 PCI Adapter (OC-3140) +.It +Olicom RapidFire 3141 Fiber Adapter (OC-3141) +.It +Olicom RapidFire 3540 100/16/4 Adapter (OC-3540) +.El +.Sh SEE ALSO +.Xr netintro 4 , +.Xr ifconfig 8 +.Sh HISTORY +The +.Nm +driver first appeared in +.Fx 3.3 . +.Sh AUTHORS +The +.Nm +driver was written by +.An Larry Lile . +This manual page was written by +.An -nosplit +.An Christian Brueffer Aq brueffer@FreeBSD.org +based on input provided by +.An Matthew N. Dodd Aq mdodd@FreeBSD.org . diff --git a/share/man/man4/man4.i386/streams.4 b/share/man/man4/man4.i386/streams.4 new file mode 100644 index 0000000000..71dd36001e --- /dev/null +++ b/share/man/man4/man4.i386/streams.4 @@ -0,0 +1,79 @@ +.\" Copyright (c) 2000 Mark Newton +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" $FreeBSD: src/share/man/man4/man4.i386/streams.4,v 1.7 2005/01/21 08:36:39 ru Exp $ +.\" $DragonFly: src/share/man/man4/man4.i386/Attic/streams.4,v 1.1 2006/04/30 18:46:39 swildner Exp $ +.Dd November 6, 2000 +.Dt STREAMS 4 i386 +.Os +.Sh NAME +.Nm streams +.Nd System V STREAMS networking ABI support +.Sh SYNOPSIS +To link System V Release 4 (SVR4) STREAMS interprocess communication ABI +support into the kernel: +.Cd pseudo-device streams +.Pp +To load the SVR4 STREAMS interprocess communication ABI support kernel +module: +.Dl kldload streams +.Sh DESCRIPTION +The +.Nm +module provides limited +System V Release 4 STREAMS interprocess communication ABI +(application binary interface) compatibility +for userland applications. +.Pp +Internally, +.Nm +provides STREAMS handles by using socket creation kernel routines, and +adding state-tracking information to the socket to permit manipulation +by STREAMS emulation code in +.Xr svr4 4 . +Hence, opening a stream device produces a result similar to what would be +obtained by calling +.Xr socket 2 . +.Pp +Applications should never use this interface directly: STREAMS +emulation is only provided as a service to support ABI requirements in +the SVR4 environment which +.Xr svr4 4 +needs to present to client binaries. +.Sh SEE ALSO +.Xr svr4 4 +.Sh HISTORY +System V Release 4 ABI support first appeared in +.Fx 4.0 . +The ABI was ported from an equivalent facility present in +.Nx 1.3 +written by Christos Zoulas. +.Sh BUGS +This whole interface is a crude hack to produce STREAMS semantics +through emulation over sockets. +.Pp +Programmers who hope to be able to use this interface to provide +SVR4 STREAMS services to +.Bx +applications will be sorely disappointed. diff --git a/share/man/man4/man4.i386/svr4.4 b/share/man/man4/man4.i386/svr4.4 new file mode 100644 index 0000000000..f8949911aa --- /dev/null +++ b/share/man/man4/man4.i386/svr4.4 @@ -0,0 +1,224 @@ +.\" Copyright (c) 2000 Mark Newton +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" $FreeBSD: src/share/man/man4/man4.i386/svr4.4,v 1.12 2005/02/13 23:45:49 ru Exp $ +.\" $DragonFly: src/share/man/man4/man4.i386/Attic/svr4.4,v 1.1 2006/04/30 18:46:39 swildner Exp $ +.Dd October 28, 2003 +.Dt SVR4 4 i386 +.Os +.Sh NAME +.Nm svr4 +.Nd System V Release 4 ABI support +.Sh SYNOPSIS +To link System V Release 4 (SVR4) ABI support into the kernel: +.Cd options COMPAT_SVR4 +.Pp +To load the SVR4 ABI support kernel module: +.Bd -literal -offset indent +kldload streams +kldload svr4 +.Ed +.Sh DESCRIPTION +The +.Nm +module provides limited +System V Release 4 ABI (application binary interface) compatibility +for userland applications. +The module provides the following significant facilities: +.Bl -bullet +.It +An image activator +for correctly branded +.Xr elf 5 +executable images +.It +Special signal handling for activated images +.It +SVR4 to native system call translation +.It +STREAMS network API emulation (via the +.Xr streams 4 +loadable module, or by means of +.Dl pseudo-device streams +in a kernel configuration file) +.It +Mappings between +.Fx +and SVR4 +.Xr ioctl 2 +calls, or, where no such mappings exist, reverse-engineered implementations +of the SVR4 calls. +.El +.Pp +It is important to note that the SVR4 ABI support +it not provided through an emulator. +Rather, a true (albeit limited) "clean room" reverse-engineered ABI +implementation is provided. +.Sh LIMITATIONS +Because the provided ABI has been developed in ignorance of actual SVR4 +source code, there are bound to be unforeseen interactions between SVR4 +client applications and the emulated ABI which cause applications to +malfunction. +.Pp +Additionally, some SVR4 operating systems do not adhere to the SVR4 +ELF standard. +In particular, Solaris does not set the ELF interpreter field in the +ELF header to a value which would allow the kernel to correctly +identify a client executable as an SVR4 application. +Thus, in certain instances it is necessary to use the +.Xr brandelf 1 +utility to explicitly brand the executable, or to set the +kern.fallback_elf_brand +.Xr sysctl 8 +variable to define a "default" ABI for unbranded executables. +Value ELFOSABI_SOLARIS represents Solaris; ELFOSABI_SYSV represents other +SysVR4 operating systems. +See +.In sys/elf_common.h +for ELFOSABI branding definitions, and +.Xr brandelf 1 +for information on branding executables. +.Pp +The +.Nm +module can be linked into the kernel statically with the +.Dv COMPAT_SVR4 +kernel configuration option +or loaded as required. +The following command will load the module +if it is neither linked into the kernel +nor already loaded as a module: +.Bd -literal -offset indent +if ! kldstat -V | grep -E 'streams.ko' > /dev/null; then + kldload streams > /dev/null 2>&1 +fi + +if ! kldstat -v | grep -E 'svr4.ko' > /dev/null; then + kldload svr4 > /dev/null 2>&1 +fi +.Ed +.Pp +The kernel +will check for the presence of the +.Xr streams 4 +module, and load it if necessary. +.Pp +Note that dynamically linked SVR4 executables +will require a suitable environment in +.Pa /compat/svr4 . +.Pp +For information on loading the +.Nm +kernel loadable module automatically on system startup, +see +.Xr rc.conf 5 . +This information applies +regardless of whether the +.Nm +module is statically linked into the kernel +or loaded as a module. +.Pp +STREAMS emulation is limited but (largely) functional. +Assuming the +.Xr streams 4 +module is loaded, a STREAMS handle can be obtained by opening one of the +relevant files in +.Pa /dev +or +.Pa /compat/svr4/dev . +Internally, the +.Xr streams 4 +driver produces a socket descriptor and +.Dq tags +it with additional STREAMS +state information before returning it to the client application. +The +.Nm +environment uses the additional state information to recognize and +manipulate emulated STREAMS handles when STREAMS-specific +.Xr ioctl 2 +calls are executed. +.Pp +The subset of STREAMS functionality which is provided is small, probably +little more than what is required to enable programs on the Solaris CD +sets to run. +.Sh FILES +.Bl -tag -width /sys/emulation/svr4/syscalls.master -compact +.It Pa /compat/svr4 +minimal SVR4 run-time environment +.It Pa /sys/emulation/svr4/syscalls.master +mappings between SVR4 syscalls and +.Nm +module entrypoints. +.El +.Sh SEE ALSO +.Xr brandelf 1 , +.Xr streams 4 , +.Xr elf 5 +.Sh HISTORY +System V Release 4 ABI support first appeared in +.Fx 4.0 . +The ABI was ported from an equivalent facility present in +.Nx 1.3 +written by Christos Zoulas. +.Sh BUGS +Emulation of signal handlers is buggy. +.Pp +Emulated connectionless STREAMS fail to receive data from the network in +some circumstances (but succeed in others -- probably due to particular +ways of initializing them which the +.Xr streams 4 +module is mishandling, and interaction between STREAMS and +.Xr poll 2 ) . +Connection-oriented STREAMS appear to be functional. +.Pp +Ironically, this SVR4 emulator does not (yet) support SVR4 semaphores or +shared memory. +.Pp +.Xr ports 7 +to automatically create the +.Pa /compat/svr4 +environment do not exist. +.Xr tar 1 +archives containing pre-populated trees can be obtained from +.Pa http://people.FreeBSD.org/~newton/freebsd-svr4/ . +.Pp +Extensive testing has only really been carried out with Solaris 2.x binaries, +with anecdotal reports of limited success coming from testers with +early-revision SCO media. +In theory, the basic SVR4 ABI should be constant +across the set of vendors who produce SVR4 operating systems, but in +practice that is probably not the case. +If necessary, future work can +either implement additional +.Xr kld 4 +modules which produce functionality which contains OS-dependent +departures from the behaviour which has been implemented in this +ABI implementation. +Alternatively, +.Xr sysctl 8 +variables could set the +.Dq personality +the environment should present to +client applications. diff --git a/share/man/man4/rc.4 b/share/man/man4/rc.4 new file mode 100644 index 0000000000..f854401ca0 --- /dev/null +++ b/share/man/man4/rc.4 @@ -0,0 +1,105 @@ +.\" +.\" Copyright (c) 2004 Tom Rhodes +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" $FreeBSD: src/share/man/man4/rc.4,v 1.5 2005/03/18 02:38:03 brueffer Exp $ +.\" $DragonFly: src/share/man/man4/rc.4,v 1.1 2006/04/30 18:46:39 swildner Exp $ +.\" +.Dd March 18, 2005 +.Dt RC 4 +.Os +.Sh NAME +.Nm rc +.Nd RISCom/8 multiport card +.Sh SYNOPSIS +.Cd device isa +.Cd device rc +.Sh DESCRIPTION +The +.Tn RISCom/8 +is an eight port +.Tn ISA +.Tn RS-232C +communications multiplexer with a built in +.Tn RISC +processor. +It uses a block of sixteen +.Tn I/O +ports in the range 0x200 to 0x3f0 selectable by on-board +switches or jumpers. +The block must be aligned on a sixteen port boundary. +.Pp +This driver is mostly based on the Cirrus Logic CL-CD180 driver. +.Sh HARDWARE +The +.Nm +driver provides support for the +.Tn SDL +Communications +.Tn RISCom/8 +boards. +.Sh DIAGNOSTICS +The following driver specific error messages +may be reported: +.Bl -diag +.It "rc%d channel%d: interrupt-level buffer overflow" +An internal buffer overflow error has occurred on +the listed channel. +The +.Nm +driver will need to be reloaded to correct this. +.It "rc%d: Bad char chan %d" +The channel has obtained a bad set of characters. +.It "rc%d: Got extra chars chan %d" +The +.Nm +driver got more characters than expected on the channel shown. +.It "rc%d: data mismatch chan %d ptr %d (%d != %d)" +Data sent from channel +.Ar %d +to the rx buffer was different then expected. +.It "rc%d: channel %d command timeout, rc.c line: %d" +A command timeout has occurred on the channel, the +.Pa src/sys/dev/serial/rc/rc.c +file can be consulted for more information. +.El +.Sh SEE ALSO +.Xr tty 1 , +.Xr ttyname 3 , +.Xr sio 4 , +.Xr tty 4 , +.Xr comcontrol 8 , +.Xr getty 8 +.Pp +.Pa http://www.sdlcomm.com +.Sh HISTORY +The +.Nm +driver first appeared in +.Fx 2.0.5 . +This manual page first appeared in +.Fx 5.3 . +.Sh AUTHORS +This manual page was written by +.An Tom Rhodes Aq trhodes@FreeBSD.org . diff --git a/share/man/man4/twa.4 b/share/man/man4/twa.4 new file mode 100644 index 0000000000..af0f39e357 --- /dev/null +++ b/share/man/man4/twa.4 @@ -0,0 +1,90 @@ +.\" +.\" Copyright (c) 2004 3ware, Inc. +.\" Copyright (c) 2000 BSDi +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" $FreeBSD: src/share/man/man4/twa.4,v 1.4 2005/02/27 13:14:28 brueffer Exp $ +.\" $DragonFly: src/share/man/man4/twa.4,v 1.1 2006/04/30 18:46:39 swildner Exp $ +.\" +.Dd August 15, 2004 +.Dt TWA 4 +.Os +.Sh NAME +.Nm twa +.Nd 3ware 9000 series SATA RAID controllers driver +.Sh SYNOPSIS +.Cd "device twa" +.Sh DESCRIPTION +The +.Nm +driver provides support for the AMCC's 3ware 9000 series SATA controllers. +.Pp +These controllers are available in 4, 8 or 12-port configurations, +and support the following RAID levels: 0, 1, 10, 5, 50. +The device nodes for the controllers are of the form +.Pa /dev/twa Ns Ar X , +where +.Ar X +is the controller number. +The driver is implemented as a SCSI SIM +under CAM, and, as such, the logical units that it controls are accessible +via the device nodes, +.Pa /dev/da Ns Ar Y , +where +.Ar Y +is the logical unit number. +.Sh HARDWARE +The +.Nm +driver supports the following SATA RAID controllers: +.Pp +.Bl -bullet -compact +.It +AMCC's 3ware 9500S-4LP +.It +AMCC's 3ware 9500S-8 +.It +AMCC's 3ware 9500S-8MI +.It +AMCC's 3ware 9500S-12 +.It +AMCC's 3ware 9500S-12MI +.El +.Sh DIAGNOSTICS +Whenever the driver encounters a command failure, it prints out an error code in +the format: +.Qq Li "ERROR: (: ):" , +followed by a text description of the error. +There are other error messages and warnings that the +driver prints out, depending on the kinds of errors that it encounters. +If the driver is compiled with +.Dv TWA_DEBUG +defined, it prints out a whole bunch of debug +messages, the quantity of which varies depending on the value assigned to +.Dv TWA_DEBUG +(0 to 10). +.Sh AUTHORS +The +.Nm +driver and manpage were written by +.An Vinod Kashyap Aq vkashyap@FreeBSD.org . diff --git a/share/man/man4/ufm.4 b/share/man/man4/ufm.4 new file mode 100644 index 0000000000..f338feb394 --- /dev/null +++ b/share/man/man4/ufm.4 @@ -0,0 +1,74 @@ +.\" Copyright (c) 2003 M. Warner Losh +.\" . All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY FREEBSD AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL NICK HIBMA OR THE VOICES IN HIS HEAD +.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) +.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF +.\" THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" $FreeBSD: src/share/man/man4/ufm.4,v 1.5 2005/02/09 18:07:16 ru Exp $ +.\" $DragonFly: src/share/man/man4/ufm.4,v 1.1 2006/04/30 18:46:39 swildner Exp $ +.\" +.Dd November 7, 2003 +.Dt UFM 4 +.Os +.Sh NAME +.Nm ufm +.Nd USB driver for Cypress Semiconductor FM Radio +.Sh SYNOPSIS +.Cd "device ufm" +.Sh DESCRIPTION +The +.Nm +driver provides support for the D-Link/GEMTEK FM tuner. +The USB interface chip is the common Cypress 63001, and the tuner is a +Philips TEA5757 radio chip that uses a serial interface to set the +tuner parameters. +This design is used in the D-Link DSB-R100 USB Radio. +.Pp +The +.Nm +device must be configured in the kernel, along with +.Xr usb 4 +and one of the +.Xr uhci 4 +or +.Xr ohci 4 +controllers. +.Pp +Subsequently, the +.Pa /dev/ufm0 +device can be used by userland applications. +.Sh FILES +.Bl -tag -width ".Pa /dev/ufm0" -compact +.It Pa /dev/ufm0 +blocking device node +.El +.Sh SEE ALSO +.Xr ohci 4 , +.Xr uhci 4 , +.Xr usb 4 +.Sh AUTHORS +.An -nosplit +The +.Nm +driver was written by +.An M. Warner Losh Aq imp@FreeBSD.org +for +.Fx . -- 2.32.0