[prev in list] [next in list] [prev in thread] [next in thread] 

List:       openbsd-tech
Subject:    man4/openprom.4 missing for armv7
From:       Denis Fondras <openbsd () ledeuns ! net>
Date:       2019-04-24 15:55:05
Message-ID: 20190424155505.GA57009 () jig-ai ! ledeuns ! net
[Download RAW message or body]

Noticed by visa@

Index: Makefile
===================================================================
RCS file: /cvs/src/share/man/man4/man4.armv7/Makefile,v
retrieving revision 1.24
diff -u -p -r1.24 Makefile
--- Makefile	1 Feb 2019 01:41:52 -0000	1.24
+++ Makefile	24 Apr 2019 15:53:05 -0000
@@ -3,7 +3,7 @@
 MAN=	agtimer.4 amdisplay.4 ampintc.4 amptimer.4 armliicc.4 \
 	cortex.4 cpsw.4 dmtimer.4 edma.4 gptimer.4 \
 	imxtemp.4 intc.4 intro.4 \
-	omap.4 omdog.4 omgpio.4 ommmc.4 omwugen.4 \
+	omap.4 omdog.4 omgpio.4 ommmc.4 omwugen.4 openprom.4 \
 	prcm.4 sitaracm.4 \
 	sxidog.4 sxie.4 sxiintc.4 \
 	sxitimer.4 sxits.4 sysreg.4
Index: openprom.4
===================================================================
RCS file: openprom.4
diff -N openprom.4
--- /dev/null	1 Jan 1970 00:00:00 -0000
+++ openprom.4	24 Apr 2019 15:53:05 -0000
@@ -0,0 +1,148 @@
+.\"	$OpenBSD$
+.\" Copyright (c) 1992, 1993
+.\"	The Regents of the University of California.  All rights reserved.
+.\"
+.\" This software was developed by the Computer Systems Engineering group
+.\" at Lawrence Berkeley Laboratory under DARPA contract BG 91-66 and
+.\" contributed to Berkeley.
+.\"
+.\" 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.
+.\" 3. Neither the name of the University nor the names of its contributors
+.\"    may be used to endorse or promote products derived from this software
+.\"    without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS 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 REGENTS 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.
+.\"
+.\"     from: @(#)openprom.4	8.1 (Berkeley) 6/5/93
+.\"
+.Dd $Mdocdate: April 24 2019 $
+.Dt OPENPROM 4 armv7
+.Os
+.Sh NAME
+.Nm openprom
+.Nd OPENPROM interface
+.Sh SYNOPSIS
+.In machine/openpromio.h
+.Sh DESCRIPTION
+The file
+.Pa /dev/openprom
+is an interface to the ARM OPENPROM.
+This interface is highly stylized,
+ioctls are used for all operations.
+These ioctls refer to
+.Dq nodes ,
+which are simply
+.Dq magic
+integer values describing data areas.
+Occasionally the number 0 may be used or returned instead,
+as described below.
+.Pp
+The calls that take and/or return a node
+use a pointer to an
+.Li int
+variable for this purpose;
+others use a pointer to a
+.Li struct opiocdesc
+descriptor,
+which contains a node and two counted strings.
+The first string is comprised of the fields
+.Li op_namelen
+(an
+.Li int )
+and
+.Li op_name
+(a
+.Li "char *" ) ,
+giving the name of a field.
+The second string is comprised of the fields
+.Li op_buflen
+and
+.Li op_buf ,
+used analogously.
+These two counted strings work in a
+.Dq value-result
+fashion.
+At entry to the ioctl,
+the counts are expected to reflect the buffer size;
+on return,
+the counts are updated to reflect the buffer contents.
+.Pp
+The following ioctls are supported:
+.Bl -tag -width OPIOCGETOPTNODE
+.It Dv OPIOCGETOPTNODE
+Takes nothing, and fills in the options node number.
+.It Dv OPIOCGETNEXT
+Takes a node number and returns the number of the following node.
+The node following the last node is number 0;
+the node following number 0 is the first node.
+.It Dv OPIOCGETCHILD
+Takes a node number and returns the number of the first
+.Dq child
+of that node.
+This child may have siblings; these can be discovered by using
+.Dv OPIOCGETNEXT .
+.It Dv OPIOCGET
+Fills in the value of the named property for the given node.
+If no such property is associated with that node,
+the value length is set to -1.
+If the named property exists but has no value,
+the value length is set to 0.
+.Dv EINVAL
+is returned.
+.It Dv OPIOCNEXTPROP
+Finds the property whose name follows the given name
+in OPENPROM internal order.
+The resulting name is returned in the value field.
+If the named property is the last, the
+.Dq next
+name is the empty string.
+As with
+.Dv OPIOCGETNEXT ,
+the next name after the empty string is the first name.
+.El
+.Sh FILES
+.Pa /dev/openprom
+.Sh ERRORS
+The following may result in rejection of an operation:
+.Bl -tag -width "[ENAMETOOLONG]"
+.It Bq Er EINVAL
+The given node number
+is not zero
+and does not correspond to any valid node,
+or is zero where zero is not allowed.
+.It Bq Er EBADF
+The requested operation requires permissions not specified at the call to
+.Fn open .
+.It Bq Er ENAMETOOLONG
+The given name or value field
+exceeds the maximum allowed length (8191 bytes).
+.It Bq Er ENOMEM
+Memory could not be allocated.
+.El
+.Sh SEE ALSO
+.Xr ioctl 2 ,
+.Xr eeprom 8
+.Sh HISTORY
+The ARM OPENPROM interface first appeared in
+.Ox 6.0 .
+.Sh BUGS
+Due to limitations within the OPENPROM itself,
+these functions run at elevated priority
+and may adversely affect system performance.

[prev in list] [next in list] [prev in thread] [next in thread]