[Lsb-messages] /var/www/bzr/lsb/devel/lsbspec r3978: move ioperm.sgml (and iopl) to generic so all 3 arches pick up (bug 3875)

Mats Wichmann mats at linuxfoundation.org
Fri Jan 17 14:53:12 UTC 2014


------------------------------------------------------------
revno: 3978
committer: Mats Wichmann <mats at linuxfoundation.org>
branch nick: lsbspec
timestamp: Fri 2014-01-17 07:53:12 -0700
message:
  move ioperm.sgml (and iopl) to generic so all 3 arches pick up (bug 3875)
renamed:
  LSB/AMD64/baselib/ioperm.sgml => LSB/generic/baselib/ioperm.sgml
  LSB/AMD64/baselib/iopl.sgml => LSB/generic/baselib/iopl.sgml
modified:
  LSB/AMD64/baselib/libc.sgml
  LSB/IA32/baselib/baselib.sgml
  LSB/IA32/baselib/libc.sgml
  LSB/IA64/baselib/baselib.sgml
  LSB/IA64/baselib/libc.sgml
-------------- next part --------------
=== modified file 'LSB/AMD64/baselib/libc.sgml'
--- a/LSB/AMD64/baselib/libc.sgml	2014-01-09 19:15:37 +0000
+++ b/LSB/AMD64/baselib/libc.sgml	2014-01-17 14:53:12 +0000
@@ -3985,7 +3985,7 @@
 Other interfaces listed in <XREF LINKEND=libc> shall behave as described
 in the referenced base document. For interfaces referencing LSB and not listed below, please see the generic part of the specification.
 </PARA>
-m4_sinclude(m4_ifdef('ioperm','',ioperm.sgml))
+m4_sinclude(m4_ifdef('ioperm','',../../generic/baselib/ioperm.sgml))
 m4_define('ioperm','1')
 </SECT1>
 <!-- End of text generated from database -->

=== modified file 'LSB/IA32/baselib/baselib.sgml'
--- a/LSB/IA32/baselib/baselib.sgml	2014-01-09 19:15:37 +0000
+++ b/LSB/IA32/baselib/baselib.sgml	2014-01-17 14:53:12 +0000
@@ -4021,8 +4021,62 @@
 Other interfaces listed in <XREF LINKEND=libc> shall behave as described
 in the referenced base document. For interfaces referencing LSB and not listed below, please see the generic part of the specification.
 </PARA>
-<!-- MISSING DEFINITION FOR ioperm -->
-<!-- Lets just hope nobody notices -->
+<REFENTRY ID="baselib-ioperm-2"> <REFMETA>
+<REFENTRYTITLE>ioperm</REFENTRYTITLE>
+<REFMISCINFO>Base Libraries</REFMISCINFO>
+</REFMETA>
+<REFNAMEDIV>
+<REFNAME>ioperm
+</REFNAME>
+<REFPURPOSE>
+set port input/output permissions
+</REFPURPOSE>
+</REFNAMEDIV>
+
+<REFSYNOPSISDIV>
+<REFSYNOPSISDIVINFO>
+<DATE>13 April 2001</DATE>
+</REFSYNOPSISDIVINFO>
+<SYNOPSIS>
+#include &lt;sys/io.h> /* for glibc */
+
+int ioperm(unsigned long from, unsigned long num, int turn_on);
+</SYNOPSIS>
+</REFSYNOPSISDIV>
+
+<REFSECT1>
+<REFSECT1INFO>
+<DATE>13 April 2001</DATE>
+</REFSECT1INFO>
+<TITLE>Description
+</TITLE>
+<PARA>
+ioperm sets the port access permission bits for the process for num bytes starting from port address from to the value turn_on. The use of ioperm requires root privileges.
+</PARA><PARA>
+Only the first 0x3ff I/O ports can be specified in this manner. For more ports, the iopl function must be used. Permissions are not inherited on fork, but on exec they are. This is useful for giving port access permissions to non-privileged tasks.
+</PARA>
+</REFSECT1>
+
+<REFSECT1>
+<TITLE>Return Value
+</TITLE>
+<PARA>
+On success, zero is returned. On error, -1 is returned, and errno is set appropriately.
+</PARA>
+</REFSECT1>
+
+<REFSECT1>
+<TITLE>Notes
+</TITLE>
+<PARA>
+Libc5 treats it as a system call and has a prototype in &lt;unistd.h>. Glibc1 does not have a prototype. Glibc2 has a prototype both in &lt;sys/io.h> and in &lt;sys/perm.h>. Avoid the latter, it is available on i386 only.
+</PARA>
+</REFSECT1>
+<!--	  LDP GENERAL PUBLIC LICENSE  -->
+<!--        Version 1a, November 1998   -->
+</REFENTRY>
+
+
 </SECT1>
 <!-- End of text generated from database -->
 

=== modified file 'LSB/IA32/baselib/libc.sgml'
--- a/LSB/IA32/baselib/libc.sgml	2014-01-09 19:15:37 +0000
+++ b/LSB/IA32/baselib/libc.sgml	2014-01-17 14:53:12 +0000
@@ -3995,7 +3995,7 @@
 Other interfaces listed in <XREF LINKEND=libc> shall behave as described
 in the referenced base document. For interfaces referencing LSB and not listed below, please see the generic part of the specification.
 </PARA>
-<!-- MISSING DEFINITION FOR ioperm -->
-<!-- Lets just hope nobody notices -->
+m4_sinclude(m4_ifdef('ioperm','',../../generic/baselib/ioperm.sgml))
+m4_define('ioperm','1')
 </SECT1>
 <!-- End of text generated from database -->

=== modified file 'LSB/IA64/baselib/baselib.sgml'
--- a/LSB/IA64/baselib/baselib.sgml	2014-01-09 19:15:37 +0000
+++ b/LSB/IA64/baselib/baselib.sgml	2014-01-17 14:53:12 +0000
@@ -3940,8 +3940,62 @@
 Other interfaces listed in <XREF LINKEND=libc> shall behave as described
 in the referenced base document. For interfaces referencing LSB and not listed below, please see the generic part of the specification.
 </PARA>
-<!-- MISSING DEFINITION FOR ioperm -->
-<!-- Lets just hope nobody notices -->
+<REFENTRY ID="baselib-ioperm-2"> <REFMETA>
+<REFENTRYTITLE>ioperm</REFENTRYTITLE>
+<REFMISCINFO>Base Libraries</REFMISCINFO>
+</REFMETA>
+<REFNAMEDIV>
+<REFNAME>ioperm
+</REFNAME>
+<REFPURPOSE>
+set port input/output permissions
+</REFPURPOSE>
+</REFNAMEDIV>
+
+<REFSYNOPSISDIV>
+<REFSYNOPSISDIVINFO>
+<DATE>13 April 2001</DATE>
+</REFSYNOPSISDIVINFO>
+<SYNOPSIS>
+#include &lt;sys/io.h> /* for glibc */
+
+int ioperm(unsigned long from, unsigned long num, int turn_on);
+</SYNOPSIS>
+</REFSYNOPSISDIV>
+
+<REFSECT1>
+<REFSECT1INFO>
+<DATE>13 April 2001</DATE>
+</REFSECT1INFO>
+<TITLE>Description
+</TITLE>
+<PARA>
+ioperm sets the port access permission bits for the process for num bytes starting from port address from to the value turn_on. The use of ioperm requires root privileges.
+</PARA><PARA>
+Only the first 0x3ff I/O ports can be specified in this manner. For more ports, the iopl function must be used. Permissions are not inherited on fork, but on exec they are. This is useful for giving port access permissions to non-privileged tasks.
+</PARA>
+</REFSECT1>
+
+<REFSECT1>
+<TITLE>Return Value
+</TITLE>
+<PARA>
+On success, zero is returned. On error, -1 is returned, and errno is set appropriately.
+</PARA>
+</REFSECT1>
+
+<REFSECT1>
+<TITLE>Notes
+</TITLE>
+<PARA>
+Libc5 treats it as a system call and has a prototype in &lt;unistd.h>. Glibc1 does not have a prototype. Glibc2 has a prototype both in &lt;sys/io.h> and in &lt;sys/perm.h>. Avoid the latter, it is available on i386 only.
+</PARA>
+</REFSECT1>
+<!--	  LDP GENERAL PUBLIC LICENSE  -->
+<!--        Version 1a, November 1998   -->
+</REFENTRY>
+
+
 </SECT1>
 <!-- End of text generated from database -->
 

=== modified file 'LSB/IA64/baselib/libc.sgml'
--- a/LSB/IA64/baselib/libc.sgml	2014-01-09 19:15:37 +0000
+++ b/LSB/IA64/baselib/libc.sgml	2014-01-17 14:53:12 +0000
@@ -3912,7 +3912,7 @@
 Other interfaces listed in <XREF LINKEND=libc> shall behave as described
 in the referenced base document. For interfaces referencing LSB and not listed below, please see the generic part of the specification.
 </PARA>
-<!-- MISSING DEFINITION FOR ioperm -->
-<!-- Lets just hope nobody notices -->
+m4_sinclude(m4_ifdef('ioperm','',../../generic/baselib/ioperm.sgml))
+m4_define('ioperm','1')
 </SECT1>
 <!-- End of text generated from database -->

=== renamed file 'LSB/AMD64/baselib/ioperm.sgml' => 'LSB/generic/baselib/ioperm.sgml'
=== renamed file 'LSB/AMD64/baselib/iopl.sgml' => 'LSB/generic/baselib/iopl.sgml'


More information about the lsb-messages mailing list