From 1264a8f1089fad85cabb024c930b19b0a36864b4 Mon Sep 17 00:00:00 2001
From: Amar Takhar <amar@rtems.org>
Date: Sun, 17 Jan 2016 00:55:21 -0500
Subject: Split document into seperate files by section.

---
 posix_users/timer.rst | 157 ++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 157 insertions(+)
 create mode 100644 posix_users/timer.rst

(limited to 'posix_users/timer.rst')

diff --git a/posix_users/timer.rst b/posix_users/timer.rst
new file mode 100644
index 0000000..4adf320
--- /dev/null
+++ b/posix_users/timer.rst
@@ -0,0 +1,157 @@
+Timer Manager
+#############
+
+Introduction
+============
+
+The timer manager is ...
+
+The services provided by the timer manager are:
+
+- ``timer_create`` - Create a Per-Process Timer
+
+- ``timer_delete`` - Delete a Per-Process Timer
+
+- ``timer_settime`` - Set Next Timer Expiration
+
+- ``timer_gettime`` - Get Time Remaining on Timer
+
+- ``timer_getoverrun`` - Get Timer Overrun Count
+
+Background
+==========
+
+Operations
+==========
+
+System Calls
+============
+
+This section details the timer manager’s services.
+A subsection is dedicated to each of this manager’s services
+and describes the calling sequence, related constants, usage,
+and status codes.
+
+.. COMMENT: timer_create
+
+timer_create - Create a Per-Process Timer
+-----------------------------------------
+
+**CALLING SEQUENCE:**
+
+.. code:: c
+
+    #include <time.h>
+    #include <signal.h>
+    int timer_create(
+    clockid_t        clock_id,
+    struct sigevent \*evp,
+    timer_t         \*timerid
+    );
+
+**STATUS CODES:**
+
+``EXXX`` -
+
+**DESCRIPTION:**
+
+**NOTES:**
+
+.. COMMENT: timer_delete
+
+timer_delete - Delete a Per-Process Timer
+-----------------------------------------
+
+**CALLING SEQUENCE:**
+
+.. code:: c
+
+    #include <time.h>
+    int timer_delete(
+    timer_t timerid
+    );
+
+**STATUS CODES:**
+
+``EXXX`` -
+
+**DESCRIPTION:**
+
+**NOTES:**
+
+.. COMMENT: timer_settime
+
+timer_settime - Set Next Timer Expiration
+-----------------------------------------
+
+**CALLING SEQUENCE:**
+
+.. code:: c
+
+    #include <time.h>
+    int timer_settime(
+    timer_t                  timerid,
+    int                      flags,
+    const struct itimerspec \*value,
+    struct itimerspec       \*ovalue
+    );
+
+**STATUS CODES:**
+
+``EXXX`` -
+
+**DESCRIPTION:**
+
+**NOTES:**
+
+.. COMMENT: timer_gettime
+
+timer_gettime - Get Time Remaining on Timer
+-------------------------------------------
+
+**CALLING SEQUENCE:**
+
+.. code:: c
+
+    #include <time.h>
+    int timer_gettime(
+    timer_t            timerid,
+    struct itimerspec \*value
+    );
+
+**STATUS CODES:**
+
+``EXXX`` -
+
+**DESCRIPTION:**
+
+**NOTES:**
+
+.. COMMENT: timer_getoverrun
+
+timer_getoverrun - Get Timer Overrun Count
+------------------------------------------
+
+**CALLING SEQUENCE:**
+
+.. code:: c
+
+    #include <time.h>
+    int timer_getoverrun(
+    timer_t   timerid
+    );
+
+**STATUS CODES:**
+
+``EXXX`` -
+
+**DESCRIPTION:**
+
+**NOTES:**
+
+.. COMMENT: COPYRIGHT(c) 1988-2002.
+
+.. COMMENT: On-Line Applications Research Corporation(OAR).
+
+.. COMMENT: All rights reserved.
+
-- 
cgit v1.2.3