From 84ddfe05478670b9f27e20bd1238e4400f261f15 Mon Sep 17 00:00:00 2001 From: dlg Date: Sun, 23 Apr 2023 00:44:44 +0000 Subject: [PATCH] add a manpage for iosf(4) --- share/man/man4/Makefile | 4 ++-- share/man/man4/dwiic.4 | 11 +++++++-- share/man/man4/iosf.4 | 50 +++++++++++++++++++++++++++++++++++++++++ 3 files changed, 61 insertions(+), 4 deletions(-) create mode 100644 share/man/man4/iosf.4 diff --git a/share/man/man4/Makefile b/share/man/man4/Makefile index ad8d357442d..66d99f46b60 100644 --- a/share/man/man4/Makefile +++ b/share/man/man4/Makefile @@ -1,4 +1,4 @@ -# $OpenBSD: Makefile,v 1.840 2023/04/20 19:28:30 jcs Exp $ +# $OpenBSD: Makefile,v 1.841 2023/04/23 00:44:44 dlg Exp $ MAN= aac.4 abcrtc.4 abl.4 ac97.4 acphy.4 acrtc.4 \ acpi.4 acpiac.4 acpials.4 acpiasus.4 acpibat.4 \ @@ -47,7 +47,7 @@ MAN= aac.4 abcrtc.4 abl.4 ac97.4 acphy.4 acrtc.4 \ igc.4 iha.4 ihidev.4 iic.4 iicmux.4 ikbd.4 ims.4 imt.4 imxanatop.4 \ imxdog.4 imxesdhc.4 imxgpc.4 imxgpio.4 imxiic.4 imxpciephy.4 \ imxpwm.4 imxrtc.4 imxspi.4 imxsrc.4 imxtmu.4 imxuart.4 \ - inet.4 inet6.4 inphy.4 iophy.4 ip.4 ip6.4 ipcomp.4 ipgphy.4 \ + inet.4 inet6.4 inphy.4 iophy.4 iosf.4 ip.4 ip6.4 ipcomp.4 ipgphy.4 \ ipmi.4 ips.4 ipsec.4 ipw.4 isa.4 isagpio.4 isapnp.4 islrtc.4 \ it.4 itherm.4 iwi.4 iwn.4 iwm.4 iwx.4 ix.4 ixgb.4 ixl.4 \ jmb.4 jme.4 jmphy.4 \ diff --git a/share/man/man4/dwiic.4 b/share/man/man4/dwiic.4 index 91a2efac8dd..87ab0fae3ad 100644 --- a/share/man/man4/dwiic.4 +++ b/share/man/man4/dwiic.4 @@ -1,4 +1,4 @@ -.\" $OpenBSD: dwiic.4,v 1.4 2017/11/16 21:08:42 jmc Exp $ +.\" $OpenBSD: dwiic.4,v 1.5 2023/04/23 00:44:44 dlg Exp $ .\" .\" Copyright (c) 2016 Jonathan Gray .\" @@ -14,7 +14,7 @@ .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. .\" -.Dd $Mdocdate: November 16 2017 $ +.Dd $Mdocdate: April 23 2023 $ .Dt DWIIC 4 .Os .Sh NAME @@ -31,9 +31,16 @@ driver supports the Synopsys DesignWare I2C controller for use with the .Xr iic 4 framework. +.Pp +On systems using the Intel OnChip System Fabric, +.Nm +may need the +.Xr iosf 4 +driver to coordinate access to the I2C bus. .Sh SEE ALSO .Xr acpi 4 , .Xr iic 4 , +.Xr iosf 4 , .Xr pci 4 .Sh HISTORY The diff --git a/share/man/man4/iosf.4 b/share/man/man4/iosf.4 new file mode 100644 index 00000000000..29f8da7541e --- /dev/null +++ b/share/man/man4/iosf.4 @@ -0,0 +1,50 @@ +.\" $OpenBSD: iosf.4,v 1.1 2023/04/23 00:44:44 dlg Exp $ +.\" +.\" Copyright (c) 2023 David Gwynne +.\" +.\" Permission to use, copy, modify, and distribute this software for any +.\" purpose with or without fee is hereby granted, provided that the above +.\" copyright notice and this permission notice appear in all copies. +.\" +.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES +.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR +.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES +.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN +.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF +.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. +.\" +.Dd $Mdocdate: April 23 2023 $ +.Dt IOSF 4 +.Os +.Sh NAME +.Nm iosf +.Nd Intel OnChip System Fabric device +.Sh SYNOPSIS +.Cd "iosf* at acpi?" +.Cd "iosf* at pci?" +.Sh DESCRIPTION +The +.Nm +driver provides support routines for platforms using the +Intel OnChip System Fabric. +.Pp +The +.Xr dwiic 4 +driver uses the MailBox Interface (MBI) provided by +.Nm +to coordinate access to I2C devices. +.Sh SEE ALSO +.Xr acpi 4 , +.Xr dwiic 4 , +.Xr pci 4 +.Sh HISTORY +The +.Nm +device driver first appeared in +.Ox 7.4 . +.Sh AUTHORS +The +.Nm +driver was written by +.An David Gwynne Aq Mt dlg@openbsd.org . -- 2.20.1