> Date: Tue, 23 Apr 2019 18:50:50 +0200 > From: Denis Fondras <[email protected]> > > Noticed by visa@
I don't think HOSTORY should describe the history of the man page itself, but rather the history of the functionality it describes. Since openprom(4) has been there from the start for OpenBSD/arm64, the HISTORY section probably shouldn't be there. > Index: man4.arm64/Makefile > =================================================================== > RCS file: /cvs/src/share/man/man4/man4.arm64/Makefile,v > retrieving revision 1.6 > diff -u -p -r1.6 Makefile > --- man4.arm64/Makefile 2 Apr 2019 19:41:53 -0000 1.6 > +++ man4.arm64/Makefile 23 Apr 2019 16:46:49 -0000 > @@ -1,6 +1,6 @@ > # $OpenBSD: Makefile,v 1.6 2019/04/02 19:41:53 jmc Exp $ > > -MAN= agtimer.4 ampintc.4 apm.4 efi.4 intro.4 > +MAN= agtimer.4 ampintc.4 apm.4 efi.4 intro.4 openprom.4 > > MANSUBDIR=arm64 > > Index: man4.arm64/openprom.4 > =================================================================== > RCS file: man4.arm64/openprom.4 > diff -N man4.arm64/openprom.4 > --- /dev/null 1 Jan 1970 00:00:00 -0000 > +++ man4.arm64/openprom.4 23 Apr 2019 16:46:49 -0000 > @@ -0,0 +1,151 @@ > +.\" $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 23 2019 $ > +.Dt OPENPROM 4 arm64 > +.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 > +An > +ARM > +.Nm openprom > +manual page first appeared in > +.Ox 6.6 . > +.Sh BUGS > +Due to limitations within the OPENPROM itself, > +these functions run at elevated priority > +and may adversely affect system performance. > >
