[src/trunk]: src/share/man/man4 document ioctl(WSDISPLAYIO_GET_EDID)

[macallan <macallan%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/c83e6aebbd2b
branches:  trunk
changeset: 766692:c83e6aebbd2b
user:      macallan <macallan%NetBSD.org@localhost>
date:      Thu Jun 30 14:52:37 2011 +0000

description:
document ioctl(WSDISPLAYIO_GET_EDID)

diffstat:

 share/man/man4/wsdisplay.4 |  19 +++++++++++++++++--
 1 files changed, 17 insertions(+), 2 deletions(-)

diffs (40 lines):

diff -r 6823e06cab66 -r c83e6aebbd2b share/man/man4/wsdisplay.4
--- a/share/man/man4/wsdisplay.4        Thu Jun 30 07:16:59 2011 +0000
+++ b/share/man/man4/wsdisplay.4        Thu Jun 30 14:52:37 2011 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: wsdisplay.4,v 1.35 2010/03/22 18:58:31 joerg Exp $
+.\" $NetBSD: wsdisplay.4,v 1.36 2011/06/30 14:52:37 macallan Exp $
 .\"
 .\" Copyright (c) 1999 Matthias Drochner.
 .\" Copyright (c) 2002 Ben Harris.
@@ -119,7 +119,7 @@
 (In some cases \- if no screen is set up or if a screen
 was just deleted \- it is possible that no focus is present at all.)
 The focus can be switched by either special keyboard input (typically
-.Tn CTRL-ALT-F Ns Ar n )
+.Tn CTRL-ALT-F Ns Ar n, STOP-F Ns Ar n on Sun hardware )
 or an ioctl command issued by a user program.
 Screens are created and deleted through the
 .Pa /dev/ttyEcfg
@@ -543,6 +543,21 @@
 and
 .Dv SPLASHSCREEN_PROGRESS
 kernel options.
+.It Dv WSDISPLAYIO_GET_EDID Pq Li struct wsdisplay_edid_info
+Retrieve EDID data from a driver.
+.Bd -literal -offset indent
+struct wsdisplayio_edid_info {
+       uint32_t buffer_size;
+       uint32_t data_size;
+       void *edid_data;
+};
+.Ed
+The caller is responsible for allocating a buffer of at least 128 bytes
+( the minimum size of an EDID block ) and set data_size to its size. If
+the EDID block is bigger the call will fail with EAGAIN and the driver
+will set data_size to the required buffer size. Otherwise the EDID
+block will be written into the buffer pointed at by edid_data and 
+data_size will be set to the number of bytes written.
 .El
 .Sh FILES
 .Bl -item