Module Name: src
Committed By: hubertf
Date: Fri Jun 5 07:21:15 UTC 2009
Modified Files:
src/distrib/sets/lists/man: mi
src/share/man/man4: Makefile
Added Files:
src/share/man/man4: iic.4
Log Message:
Add iic(4) manpage, partly taken from OpenBSD.
To generate a diff of this commit:
cvs rdiff -u -r1.1136 -r1.1137 src/distrib/sets/lists/man/mi
cvs rdiff -u -r1.491 -r1.492 src/share/man/man4/Makefile
cvs rdiff -u -r0 -r1.1 src/share/man/man4/iic.4
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/distrib/sets/lists/man/mi
diff -u src/distrib/sets/lists/man/mi:1.1136 src/distrib/sets/lists/man/mi:1.1137
--- src/distrib/sets/lists/man/mi:1.1136 Sat May 9 15:04:25 2009
+++ src/distrib/sets/lists/man/mi Fri Jun 5 07:21:14 2009
@@ -1,4 +1,4 @@
-# $NetBSD: mi,v 1.1136 2009/05/09 15:04:25 pgoyette Exp $
+# $NetBSD: mi,v 1.1137 2009/06/05 07:21:14 hubertf Exp $
#
# Note: don't delete entries from here - mark them as "obsolete" instead.
#
@@ -1074,6 +1074,7 @@
./usr/share/man/cat4/ifpci.0 man-sys-catman .cat
./usr/share/man/cat4/igsfb.0 man-sys-catman .cat
./usr/share/man/cat4/iha.0 man-sys-catman .cat
+./usr/share/man/cat4/iic.0 man-sys-catman .cat
./usr/share/man/cat4/ikphy.0 man-sys-catman .cat
./usr/share/man/cat4/imp.0 man-obsolete obsolete
./usr/share/man/cat4/inet.0 man-sys-catman .cat
@@ -3639,6 +3640,7 @@
./usr/share/man/html4/ifpci.html man-sys-htmlman html
./usr/share/man/html4/igsfb.html man-sys-htmlman html
./usr/share/man/html4/iha.html man-sys-htmlman html
+./usr/share/man/html4/iic.html man-sys-htmlman html
./usr/share/man/html4/ikphy.html man-sys-htmlman html
./usr/share/man/html4/inet.html man-sys-htmlman html
./usr/share/man/html4/inet6.html man-sys-htmlman html
@@ -6044,6 +6046,7 @@
./usr/share/man/man4/ifpci.4 man-sys-man .man
./usr/share/man/man4/igsfb.4 man-sys-man .man
./usr/share/man/man4/iha.4 man-sys-man .man
+./usr/share/man/man4/iic.4 man-sys-man .man
./usr/share/man/man4/ikphy.4 man-sys-man .man
./usr/share/man/man4/imp.4 man-obsolete obsolete
./usr/share/man/man4/inet.4 man-sys-man .man
Index: src/share/man/man4/Makefile
diff -u src/share/man/man4/Makefile:1.491 src/share/man/man4/Makefile:1.492
--- src/share/man/man4/Makefile:1.491 Sat May 9 15:04:25 2009
+++ src/share/man/man4/Makefile Fri Jun 5 07:21:14 2009
@@ -1,4 +1,4 @@
-# $NetBSD: Makefile,v 1.491 2009/05/09 15:04:25 pgoyette Exp $
+# $NetBSD: Makefile,v 1.492 2009/06/05 07:21:14 hubertf Exp $
# @(#)Makefile 8.1 (Berkeley) 6/18/93
MAN= aac.4 ac97.4 acardide.4 aceride.4 acphy.4 acpidalb.4 \
@@ -28,7 +28,7 @@
glxtphy.4 gpib.4 gpio.4 gre.4 gphyter.4 gsip.4 hifn.4 hme.4 \
hpqlb.4 hptide.4 \
ichlpcib.4 ichsmb.4 icmp.4 icp.4 icsphy.4 iee.4 ieee80211.4 \
- ifmedia.4 igsfb.4 iha.4 inet.4 ikphy.4 inphy.4 intersil7170.4 \
+ ifmedia.4 igsfb.4 iha.4 iic.4 inet.4 ikphy.4 inphy.4 intersil7170.4 \
ioasic.4 ioat.4 iop.4 iophy.4 iopsp.4 ip.4 ipkdb.4 ipmi.4 ipw.4 \
iso.4 isp.4 isv.4 itesio.4 iteide.4 iwi.4 iwn.4 ixpide.4 \
jme.4 jmide.4 joy.4 \
Added files:
Index: src/share/man/man4/iic.4
diff -u /dev/null src/share/man/man4/iic.4:1.1
--- /dev/null Fri Jun 5 07:21:15 2009
+++ src/share/man/man4/iic.4 Fri Jun 5 07:21:14 2009
@@ -0,0 +1,178 @@
+.\" $NetBSD: iic.4,v 1.1 2009/06/05 07:21:14 hubertf Exp $
+.\" $OpenBSD: iic.4,v 1.74 2008/09/10 16:13:43 reyk Exp $
+.\"
+.\" Copyright (c) 2004, 2006 Alexander Yurchenko <[email protected]>
+.\" Copyright (c) 2009 Hubert Feyrer <[email protected]>
+.\"
+.\" 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 June 4, 2009
+.Dt IIC 4
+.Os
+.Sh NAME
+.Nm iic
+.Nd Inter IC (I2C) bus
+.Sh SYNOPSIS
+.\"
+.\" Use the following commands in (t)csh to output the list below:
+.\" cd .../src/sys/arch
+.\" grep -h '^iic.*at' */conf/* | sort -u -k +3 | sed -e 's,[ ][ ]*, ,g' -e 's, *#.*,,' | sh -c 'while read iic at ic ; do printf ".Cd \"$iic $at %-20s # %s\"\n" "$ic" "`grep \"iic.*at.*$ic\" */conf/* | sed \"s,/.*,,\" | sort -u | tr \"\012\" \ `" ; done' | uniq | tee /tmp/x
+.\" cat /tmp/x
+.\"
+.Cd "iic* at alipm? # sparc64 "
+.Cd "iic* at amdpm? # amd64 i386 "
+.Cd "iic* at armadillo9iic? # evbarm "
+.Cd "iic0 at at91twi? # evbarm "
+.Cd "iic0 at ausmbus0 # evbmips "
+.Cd "iic0 at cuda0 # macppc "
+.Cd "iic0 at gpiic? # evbppc "
+.Cd "iic* at gtiic? # evbppc "
+.Cd "iic* at gxiic? # evbarm "
+.Cd "iic* at ichsmb? # amd64 i386 "
+.Cd "iic0 at iociic0 # acorn26 "
+.Cd "iic0 at iomdiic? # acorn32 "
+.Cd "iic0 at iopiic? # evbarm iyonix "
+.Cd "iic* at ki2c? # macppc "
+.Cd "iic* at nfsmb? # amd64 i386 "
+.Cd "iic* at ociic? # sandpoint "
+.Cd "iic* at piixpm? # amd64 i386 "
+.Cd "iic0 at slugiic0 # evbarm "
+.Cd "iic* at viapcib? # i386 "
+.Sh DESCRIPTION
+.Tn I2C
+is a two-wire bus developed by Philips used for connecting
+integrated circuits.
+It is commonly used for connecting devices such as EEPROMs,
+temperature sensors, fan controllers, real-time clocks, tuners,
+and other types of integrated circuits.
+.Pp
+The
+.Nm
+driver provides a uniform programming interface layer between
+.Tn I2C
+master controllers and various
+.Tn I2C
+slave devices.
+Each
+.Tn I2C
+master controller attaches an
+.Nm
+framework; several slave devices can then be attached to the
+.Nm
+bus.
+.Pp
+All
+.Tn I2C
+slave devices are uniquely identified by the address on the bus.
+The master accesses a particular slave device using its address.
+.\" Devices are found on the bus using a sophisticated scanning routine
+.\" which attempts to identify commonly available devices.
+.\" On other machines (such as sparc64 and macppc) where the machine ROM
+.\" supplies a list of I2C devices, that list is used instead.
+.Pp
+System Management Bus (SMBus) protocol is also supported by emulating
+it with the
+.Tn I2C
+commands.
+.Sh SUPPORTED MASTERS
+A wide list of I2C masters are supported, among them
+are:
+.\"
+.\" Generate the following list with these (t)csh commands:
+.\" cd .../src/sys/arch
+.\" grep -h '^iic.*at' */conf/* | awk '{print $3}' | sed 's,.$,,' | sort -u | sh -c 'while read i ; do echo .It Xr $i 4; n=`grep -h ^.Nd ../../share/man/man4/$i* | sed "s,^.Nd ,,"`; if [ -n "$n" ]; then echo $n ; else echo "" ; fi ; done' | tee /tmp/x
+.\" cat /tmp/x
+.\"
+.Bl -tag -width 18n -compact
+.It Xr alipm 4
+Acer Labs M7101 SMBus controller
+.It Xr amdpm 4
+AMD768 Power Management Controller and AMD8111 System Management Controller
+.It Xr armadillo9iic 4
+
+.It Xr at91twi 4
+
+.It Xr ausmbus 4
+
+.It Xr cuda 4
+support for CUDA microcontrollers found in many Power Macintosh and
+.It Xr gpiic 4
+
+.It Xr gtiic 4
+
+.It Xr gxiic 4
+
+.It Xr ichsmb 4
+Intel ICH SMBus controller
+.It Xr iociic 4
+
+.It Xr iomdiic 4
+
+.It Xr iopiic 4
+
+.It Xr ki2c 4
+
+.It Xr nfsmb 4
+NVIDIA nForce 2/3/4 SMBus controller and SMBus driver
+.It Xr ociic 4
+
+.It Xr piixpm 4
+Intel PIIX and compatible Power Management controller
+.It Xr slugiic 4
+
+.It Xr viapcib 4
+
+.El
+.Sh SUPPORTED SLAVES
+A wide list of slaves are supported, among them:
+.\"
+.\" Create the following list with these commands:
+.\" cd .../src/sys/arch
+.\" grep -h '.* at iic.*' */conf/* | sed -e 's,^#,,' -e 's, .*,,' -e 's,.$,,' | sort -u | sh -c 'while read i ; do echo .It Xr $i 4 ; n=`grep ^.Nd ../../share/man/man4/$i* | sed "s,^.Nd ,,"` ; if [ -n "$n" ]; then echo $n ; else echo "" ; fi ; done' | tee /tmp/x
+.\" cat /tmp/x
+.\"
+.Bl -tag -width 13n -compact
+.It Xr dbcool 4
+dbCool(tm) family of environmental monitors and fan controllers
+.It Xr rs5c372rtc 4
+RICOH RS5C372A and RS5C372B real-time clock
+.It Xr sgsmix 4
+driver for SGS 7433 Basic Audio Processor found in some Apple machines
+.It Xr spdmem 4
+Generic Memory Module Serial Presence Detect
+.El
+.Sh SEE ALSO
+.Xr intro 4 ,
+.Xr iic 9
+.Sh HISTORY
+The
+.Tn I2C
+framework first appeared in
+.Nx 2.0 .
+.Ox
+support was added in
+.Ox 3.6 .
+This manpage first appeared in
+.Nx 6.0 ,
+it was ported from
+.Ox .
+.Sh AUTHORS
+The
+.Tn I2C
+framework was written by
+Steve C. Woodford and Jason R. Thorpe for
+.Nx
+and then ported to
+.Ox
+by
+.An Alexander Yurchenko Aq [email protected] .
