<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On Thu, Mar 23, 2017 at 3:14 PM, Chris Johns <span dir="ltr"><<a href="mailto:chrisj@rtems.org" target="_blank">chrisj@rtems.org</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div class="HOEnZb"><div class="h5">On 24/3/17 2:56 am, Joel Sherrill wrote:<br>
> ---<br>
>  posix-users/devctl.rst | 76 ++++++++++++++++++++++++++++++<wbr>++++++++++++++++++++<br>
>  posix-users/index.rst  |  1 +<br>
>  2 files changed, 77 insertions(+)<br>
>  create mode 100644 posix-users/devctl.rst<br>
><br>
> diff --git a/posix-users/devctl.rst b/posix-users/devctl.rst<br>
> new file mode 100644<br>
> index 0000000..6434cb5<br>
> --- /dev/null<br>
> +++ b/posix-users/devctl.rst<br>
> @@ -0,0 +1,76 @@<br>
> +.. comment SPDX-License-Identifier: CC-BY-SA-4.0<br>
> +<br>
> +.. COMMENT: COPYRIGHT(c) 2017.<br>
> +.. COMMENT: On-Line Applications Research Corporation(OAR).<br>
> +.. COMMENT: All rights reserved.<br>
> +<br>
> +Device Control<br>
> +##############<br>
> +<br>
> +Introduction<br>
> +============<br>
> +<br>
> +The POSIX Device Control API is defined by POSIX 1003.26 and attempts<br>
> +to provides a portable alternative to the ioctl() service which is<br>
> +not standardized across POSIX implementations.  Support for this<br>
> +standard is required by the Open Group's FACE Technical Standard<br>
> +:cits:"FACE:2012:FTS".  Unfortunately, this part of the POSIX standard<br>
> +is not widely implemented.<br>
> +<br>
> +The services provided by the timer manager are:<br>
> +<br>
> +- posix_devctl_ - Control a Device<br>
> +<br>
> +Background<br>
> +==========<br>
> +<br>
> +Operations<br>
> +==========<br>
> +<br>
> +System Calls<br>
> +============<br>
> +<br>
> +This section details the POSIX device control's services.  A subsection<br>
> +is dedicated to each of this manager's services and describes the calling<br>
> +sequence, related constants, usage, and status codes.<br>
> +<br>
> +.. COMMENT: posix_devctl<br>
> +<br>
> +.. _posix_devctl<br>
> +<br>
> +posix_devctl - Control a Device<br>
> +-----------------------------<wbr>--<br>
> +<br>
> +**CALLING SEQUENCE:**<br>
> +<br>
> +.. code-block:: c<br>
> +<br>
> +    #include <devctl.h><br>
> +    int posix_devctl(<br>
> +      int            fd,<br>
<br>
</div></div>The other code in the POSIX manual has 4 spaces for the indent. :)<br>
<div><div class="h5"><br>
> +      int            dcmd,<br>
> +      void *restrict dev_data_ptr,<br>
> +      size_t         nbyte,<br>
> +      int *restrict  dev_info_ptr<br>
> +    );<br>
> +<br>
> +**STATUS CODES:**<br>
> +<br>
> +The status codes returned reflect those returned by the ``ioctl()`` service<br>
> +and the underlying device drivers.<br>
> +<br>
> +**DESCRIPTION:**<br>
> +<br>
> +This method is intended to be a portable alternative to the ``ioctl()``<br>
> +method. The RTEMS implementation follows what is referred to as a library<br>
> +implementation which is a simple wrapper for the ``ioctl()`` method.<br>
> +The fd, fcmd, dev_data_ptr, and nbyte parameters are passed unmodified<br>
> +to the ``ioctl()`` method.<br>
> +<br>
> +If the dev_info_ptr parameter is not NULL, then the location pointed<br>
> +to by dev_info_ptr is set to 0.<br>
> +<br>
> +**NOTES:**<br>
> +<br>
> +NONE<br>
> +<br>
> diff --git a/posix-users/index.rst b/posix-users/index.rst<br>
> index b2e2154..6c359ec 100644<br>
> --- a/posix-users/index.rst<br>
> +++ b/posix-users/index.rst<br>
> @@ -60,6 +60,7 @@ to the Community Project hosted at <a href="http://www.rtems.org/" rel="noreferrer" target="_blank">http://www.rtems.org/</a>.<br>
>       thread_cancellation<br>
>       services_provided_by_c<br>
>       services_provided_by_math<br>
> +        devctl<br>
<br>
</div></div>Tabs or spaces? I suspect tabs are being used here. I suspect my emacs<br>
learned the formatting I inherited.<br>
<br></blockquote><div><br></div><div>Do you mean the master list of chapters or somewhere else? The chapter</div><div>itself was based on a copy of the POSIX Timer Manager.</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
Chris<br>
<br>
>       status_of_implementation<br>
>       command<br>
><br>
><br>
</blockquote></div><br></div></div>