add man page for chio.conf; missing file spotted by deraadt

ok beck

3 files changed, 76 insertions, 5 deletions

diff --git a/bin/chio/Makefile b/bin/chio/Makefile
index 86bf7a8a612..4292e90299c 100644
--- a/bin/chio/Makefile
+++ b/bin/chio/Makefile
@@ -1,8 +1,9 @@
-#	$OpenBSD: Makefile,v 1.11 2006/06/03 19:33:35 deraadt Exp $
+#	$OpenBSD: Makefile,v 1.12 2007/11/02 15:26:07 jmc Exp $
 
 PROG=	chio
 SRCS=	chio.c parse.y
 DPADD=	${LIBUTIL}
 LDADD=	-lutil
+MAN=	chio.1 chio.conf.5
 
 .include <bsd.prog.mk>
diff --git a/bin/chio/chio.1 b/bin/chio/chio.1
index fc6d1479b02..c45a2a43f5b 100644
--- a/bin/chio/chio.1
+++ b/bin/chio/chio.1
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: chio.1,v 1.29 2007/10/16 20:19:26 sobrado Exp $
+.\"	$OpenBSD: chio.1,v 1.30 2007/11/02 15:26:07 jmc Exp $
 .\"	$NetBSD: chio.1,v 1.1.1.1 1996/04/03 00:34:38 thorpej Exp $
 .\"
 .\" Copyright (c) 1996 Jason R. Thorpe <thorpej@and.com>
@@ -31,7 +31,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: October 16 2007 $
+.Dd $Mdocdate: November 2 2007 $
 .Dt CHIO 1
 .Os
 .Sh NAME
@@ -155,7 +155,7 @@ is used, where
 is the
 .Ar from-EU .
 This mapping can be changed by using the
-.Pa /etc/chio.conf
+.Xr chio.conf 5
 file.
 .It Cm params
 Report the number of slots, drives, pickers, and portals in the changer,
@@ -238,7 +238,8 @@ Configure the changer to use picker 2 (third picker) for operations:
 .Sh SEE ALSO
 .Xr mt 1 ,
 .Xr ch 4 ,
-.Xr st 4
+.Xr st 4 ,
+.Xr chio.conf 5
 .Sh AUTHORS
 The
 .Nm
diff --git a/bin/chio/chio.conf.5 b/bin/chio/chio.conf.5
new file mode 100644
index 00000000000..8de52e8c025
--- /dev/null
+++ b/bin/chio/chio.conf.5
@@ -0,0 +1,69 @@
+.\"	$OpenBSD: chio.conf.5,v 1.1 2007/11/02 15:26:07 jmc Exp $
+.\"
+.\" Copyright (c) 2007 Jason McIntyre <jmc@openbsd.org>
+.\"
+.\" 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: November 2 2007 $
+.Dt CHIO.CONF 5
+.Os
+.Sh NAME
+.Nm chio.conf
+.Nd medium changer configuration file
+.Sh DESCRIPTION
+.Nm
+is used to configure some aspects of
+.Xr chio 1 ,
+a medium changer.
+.Pp
+The configuration file consists of a series of stanzas,
+one per changer,
+enclosed in curly braces.
+Empty lines and lines beginning with
+.Sq #
+in either file are ignored.
+.Pp
+The following aspects may be configured:
+.Bl -tag -width Ds
+.It Ic drive
+Provides a non-default mapping between
+.Xr st 4
+devices and changer drives.
+For example,
+to map drive 0 to rst3 and drive 1 to rst2, for changer
+.Pa /dev/ch0 :
+.Bd -literal -offset indent
+changer ch0 {
+	drive rst3
+	drive rst2
+}
+.Ed
+.El
+.Sh FILES
+.Bl -tag -width "/etc/chio.confXXX" -compact
+.It /dev/ch0
+Default changer device.
+.It /etc/chio.conf
+Default location for
+.Xr chio 1
+configuration file.
+.El
+.Sh SEE ALSO
+.Xr chio 1 ,
+.Xr mt 1
+.Sh HISTORY
+The
+.Nm
+file format first appeared in
+.Ox 4.0 .