]> git.saurik.com Git - apple/xnu.git/blobdiff - osfmk/man/i386_io_port_add.html
xnu-792.6.76.tar.gz
[apple/xnu.git] / osfmk / man / i386_io_port_add.html
index 241c4d872835cb0a3475d5da20bbce00454fe99b..a65d732b327a4f083d2b799f25f41830e479ea4b 100755 (executable)
@@ -1 +1,46 @@
-<h2>i386_io_port_add</h2>\r<hr>\r<p>\r<strong>Function</strong> - Permit target thread to invoke operations on the specified device.\r<h3>SYNOPSIS</h3>\r<pre>\r<strong>kern_return_t   i386_io_port_add</strong>\r                <strong>(thread_act_t</strong>                        <var>target_act</var>,\r                 <strong>device_t</strong>                                <var>device</var><strong>);</strong>\r</pre>\r<h3>PARAMETERS</h3>\r<dl>\r<p>\r<dt> <var>target_act</var> \r<dd>\r[in thread send right]\rThread whose permission bitmap is to be set.\r<p>\r<dt> <var>device</var> \r<dd>\r[in device send right]\rThe device to which I/O instructions are to be\rpermitted.\r</dl>\r<h3>DESCRIPTION</h3>\r<p>\rThe <strong>i386_io_port_add</strong> function adds a device to the\rI/O permission bitmap for a \rthread, thereby permitting the thread to execute I/O instructions against the\rdevice.\r<h3>NOTES</h3>\r<p>\rNormally, the thread must have called <strong>i386_io_port_add</strong> \rfor all devices to which it will execute I/O instructions.  However, possessing\rsend rights to the <var>iopl</var> device port will cause the \r<var>iopl</var> device to be automatically added to the \rthread's I/O map upon first attempted access.  This is a backward\rcompatibility feature for the DOS emulator.\r<h3>RETURN VALUES</h3>\r<p>\rOnly generic errors apply.\r<h3>RELATED INFORMATION</h3>\r<p>\rFunctions:\r<a href="i386_io_port_list.html"><strong>i386_io_port_list<strong></a>,\r<a href="i386_io_port_remove.html"><strong>i386_io_port_remove<strong></a>.\r
\ No newline at end of file
+<h2>i386_io_port_add</h2>
+<hr>
+<p>
+<strong>Function</strong> - Permit target thread to invoke operations on the specified device.
+<h3>SYNOPSIS</h3>
+<pre>
+<strong>kern_return_t   i386_io_port_add</strong>
+                <strong>(thread_act_t</strong>                        <var>target_act</var>,
+                 <strong>device_t</strong>                                <var>device</var><strong>);</strong>
+</pre>
+<h3>PARAMETERS</h3>
+<dl>
+<p>
+<dt> <var>target_act</var> 
+<dd>
+[in thread send right]
+Thread whose permission bitmap is to be set.
+<p>
+<dt> <var>device</var> 
+<dd>
+[in device send right]
+The device to which I/O instructions are to be
+permitted.
+</dl>
+<h3>DESCRIPTION</h3>
+<p>
+The <strong>i386_io_port_add</strong> function adds a device to the
+I/O permission bitmap for a 
+thread, thereby permitting the thread to execute I/O instructions against the
+device.
+<h3>NOTES</h3>
+<p>
+Normally, the thread must have called <strong>i386_io_port_add</strong> 
+for all devices to which it will execute I/O instructions.  However, possessing
+send rights to the <var>iopl</var> device port will cause the 
+<var>iopl</var> device to be automatically added to the 
+thread's I/O map upon first attempted access.  This is a backward
+compatibility feature for the DOS emulator.
+<h3>RETURN VALUES</h3>
+<p>
+Only generic errors apply.
+<h3>RELATED INFORMATION</h3>
+<p>
+Functions:
+<a href="i386_io_port_list.html"><strong>i386_io_port_list<strong></a>,
+<a href="i386_io_port_remove.html"><strong>i386_io_port_remove<strong></a>.