From d389819eea3a84e388935153e3be847342809da3 Mon Sep 17 00:00:00 2001 From: Amar Takhar Date: Mon, 18 Jan 2016 00:37:40 -0500 Subject: Convert all Unicode to ASCII(128) --- posix_users/clock.rst | 4 +-- posix_users/condition_variable.rst | 4 +-- posix_users/device_and_class_specific.rst | 4 +-- posix_users/files_and_directory.rst | 46 +++++++++++++------------- posix_users/index.rst | 4 +-- posix_users/input_and_output.rst | 10 +++--- posix_users/key.rst | 4 +-- posix_users/language_specific_services.rst | 4 +-- posix_users/memory_managment.rst | 4 +-- posix_users/message_passing.rst | 16 ++++----- posix_users/mutex.rst | 4 +-- posix_users/preface.rst | 6 ++-- posix_users/process_creation_and_execution.rst | 4 +-- posix_users/process_environment.rst | 6 ++-- posix_users/scheduler.rst | 4 +-- posix_users/semaphore.rst | 4 +-- posix_users/services_provided_by_c.rst | 2 +- posix_users/signal.rst | 6 ++-- posix_users/system_database.rst | 4 +-- posix_users/thread.rst | 10 +++--- posix_users/thread_cancellation.rst | 4 +-- posix_users/timer.rst | 4 +-- 22 files changed, 79 insertions(+), 79 deletions(-) (limited to 'posix_users') diff --git a/posix_users/clock.rst b/posix_users/clock.rst index f37c1b9..fe6aec3 100644 --- a/posix_users/clock.rst +++ b/posix_users/clock.rst @@ -41,8 +41,8 @@ There is currently no text in this section. Directives ========== -This section details the clock manager’s directives. -A subsection is dedicated to each of this manager’s directives +This section details the clock manager's directives. +A subsection is dedicated to each of this manager's directives and describes the calling sequence, related constants, usage, and status codes. diff --git a/posix_users/condition_variable.rst b/posix_users/condition_variable.rst index 35bd3ad..d940e33 100644 --- a/posix_users/condition_variable.rst +++ b/posix_users/condition_variable.rst @@ -41,8 +41,8 @@ There is currently no text in this section. Directives ========== -This section details the condition variable manager’s directives. -A subsection is dedicated to each of this manager’s directives +This section details the condition variable manager's directives. +A subsection is dedicated to each of this manager's directives and describes the calling sequence, related constants, usage, and status codes. diff --git a/posix_users/device_and_class_specific.rst b/posix_users/device_and_class_specific.rst index b2dda8c..0c344d2 100644 --- a/posix_users/device_and_class_specific.rst +++ b/posix_users/device_and_class_specific.rst @@ -46,8 +46,8 @@ There is currently no text in this section. Directives ========== -This section details the device- and class- specific functions manager’s -directives. A subsection is dedicated to each of this manager’s directives +This section details the device- and class- specific functions manager's +directives. A subsection is dedicated to each of this manager's directives and describes the calling sequence, related constants, usage, and status codes. diff --git a/posix_users/files_and_directory.rst b/posix_users/files_and_directory.rst index ea39ba3..7ebb8b4 100644 --- a/posix_users/files_and_directory.rst +++ b/posix_users/files_and_directory.rst @@ -103,8 +103,8 @@ There is currently no text in this section. Directives ========== -This section details the files and directories manager’s directives. -A subsection is dedicated to each of this manager’s directives +This section details the files and directories manager's directives. +A subsection is dedicated to each of this manager's directives and describes the calling sequence, related constants, usage, and status codes. @@ -342,7 +342,7 @@ On error, this routine returns -1 and sets ``errno`` to one of the following: *EACCES* - Search permission is denied for a directory in a file’s path prefix. + Search permission is denied for a directory in a file's path prefix. *ENAMETOOLONG* Length of a filename string exceeds PATH_MAX and _POSIX_NO_TRUNC is @@ -388,7 +388,7 @@ On error, this routine returns -1 and sets ``errno`` to one of the following: *EACCES* - Search permission is denied for a directory in a file’s path prefix. + Search permission is denied for a directory in a file's path prefix. *ENAMETOOLONG* Length of a filename string exceeds PATH_MAX and _POSIX_NO_TRUNC is @@ -435,7 +435,7 @@ getcwd - Gets current working directory Result is too large *EACCES* - Search permission is denied for a directory in a file’s path prefix. + Search permission is denied for a directory in a file's path prefix. **DESCRIPTION:** @@ -475,7 +475,7 @@ open - Opens a file **STATUS CODES:** *EACCES* - Search permission is denied for a directory in a file’s path prefix. + Search permission is denied for a directory in a file's path prefix. *EEXIST* The named file already exists. @@ -695,7 +695,7 @@ link - Creates a link to a file **STATUS CODES:** *EACCES* - Search permission is denied for a directory in a file’s path prefix + Search permission is denied for a directory in a file's path prefix *EEXIST* The named file already exists. @@ -760,7 +760,7 @@ symlink - Creates a symbolic link to a file **STATUS CODES:** *EACCES* - Search permission is denied for a directory in a file’s path prefix + Search permission is denied for a directory in a file's path prefix *EEXIST* The named file already exists. @@ -818,7 +818,7 @@ readlink - Obtain the name of a symbolic link destination **STATUS CODES:** *EACCES* - Search permission is denied for a directory in a file’s path prefix + Search permission is denied for a directory in a file's path prefix *ENAMETOOLONG* Length of a filename string exceeds PATH_MAX and _POSIX_NO_TRUNC is in @@ -870,7 +870,7 @@ mkdir - Makes a directory **STATUS CODES:** *EACCES* - Search permission is denied for a directory in a file’s path prefix + Search permission is denied for a directory in a file's path prefix *EEXIST* The name file already exist. @@ -928,7 +928,7 @@ mkfifo - Makes a FIFO special file **STATUS CODES:** *EACCES* - Search permission is denied for a directory in a file’s path prefix + Search permission is denied for a directory in a file's path prefix *EEXIST* The named file already exists. @@ -973,7 +973,7 @@ unlink - Removes a directory entry **STATUS CODES:** *EACCES* - Search permission is denied for a directory in a file’s path prefix + Search permission is denied for a directory in a file's path prefix *EBUSY* The directory is in use. @@ -1032,11 +1032,11 @@ rmdir - Delete a directory *EACCES* Write access to the directory containing ``pathname`` was not - allowed for the process’s effective uid, or one of the directories in``pathname`` did not allow search (execute) permission. + allowed for the process's effective uid, or one of the directories in``pathname`` did not allow search (execute) permission. *EPERM* The directory containing ``pathname`` has the stickybit (S_ISVTX) - set and the process’s effective uid is neither the uid of the file to + set and the process's effective uid is neither the uid of the file to be delected nor that of the director containing it. *ENAMETOOLONG* @@ -1096,7 +1096,7 @@ rename - Renames a file **STATUS CODES:** *EACCES* - Search permission is denied for a directory in a file’s path prefix. + Search permission is denied for a directory in a file's path prefix. *EBUSY* The directory is in use. @@ -1174,7 +1174,7 @@ stat - Gets information about a file **STATUS CODES:** *EACCES* - Search permission is denied for a directory in a file’s path prefix. + Search permission is denied for a directory in a file's path prefix. *EBADF* Invalid file descriptor. @@ -1343,7 +1343,7 @@ chmod - Changes file mode. **STATUS CODES:** *EACCES* - Search permission is denied for a directory in a file’s path prefix + Search permission is denied for a directory in a file's path prefix *ENAMETOOLONG* Length of a filename string exceeds PATH_MAX and _POSIX_NO_TRUNC is in @@ -1393,7 +1393,7 @@ fchmod - Changes permissions of a file **STATUS CODES:** *EACCES* - Search permission is denied for a directory in a file’s path prefix. + Search permission is denied for a directory in a file's path prefix. *EBADF* The descriptor is not valid. @@ -1464,7 +1464,7 @@ and ``errno`` is set appropriately. Invalid file descriptor ``fd``. *EFAULT* - Argument points outside the calling process’s address space. + Argument points outside the calling process's address space. *EINVAL* Result buffer is too small. @@ -1505,7 +1505,7 @@ chown - Changes the owner and/or group of a file. **STATUS CODES:** *EACCES* - Search permission is denied for a directory in a file’s path prefix + Search permission is denied for a directory in a file's path prefix *EINVAL* Invalid argument @@ -1634,7 +1634,7 @@ ftruncate - truncate a file to a specified length An I/O error occurred updating the inode. *EFAULT* - ``Path`` points outside the process’s allocated address space. + ``Path`` points outside the process's allocated address space. *EBADF* The ``fd`` is not a valid descriptor. @@ -1702,7 +1702,7 @@ truncate - truncate a file to a specified length An I/O error occurred updating the inode. *EFAULT* - ``Path`` points outside the process’s allocated address space. + ``Path`` points outside the process's allocated address space. *EBADF* The ``fd`` is not a valid descriptor. @@ -1919,7 +1919,7 @@ named pipe) named ``pathname``, specified by ``mode`` and ``dev``. It should be a combination (using bitwise OR) of one of the file types listed below and the permissions for the new node. -The permissions are modified by the process’s ``umask`` in the usual way: the +The permissions are modified by the process's ``umask`` in the usual way: the permissions of the created node are ``(mode & ~umask)``. The file type should be one of ``S_IFREG``, ``S_IFCHR``, ``S_IFBLK`` and``S_IFIFO`` to specify a normal file (which will be created empty), character diff --git a/posix_users/index.rst b/posix_users/index.rst index d375aaf..c75c6f7 100644 --- a/posix_users/index.rst +++ b/posix_users/index.rst @@ -1,8 +1,8 @@ ============================ -RTEMS POSIX API User’s Guide +RTEMS POSIX API User's Guide ============================ -COPYRIGHT © 1988 - 2015. +COPYRIGHT (c) 1988 - 2015. On-Line Applications Research Corporation (OAR). diff --git a/posix_users/input_and_output.rst b/posix_users/input_and_output.rst index 8acb053..4ecd4bc 100644 --- a/posix_users/input_and_output.rst +++ b/posix_users/input_and_output.rst @@ -67,8 +67,8 @@ There is currently no text in this section. Directives ========== -This section details the input and output primitives manager’s directives. -A subsection is dedicated to each of this manager’s directives +This section details the input and output primitives manager's directives. +A subsection is dedicated to each of this manager's directives and describes the calling sequence, related constants, usage, and status codes. @@ -359,7 +359,7 @@ fcntl - Manipulates an open file descriptor **STATUS CODES:** *EACCESS* - Search permission is denied for a direcotry in a file’s path + Search permission is denied for a direcotry in a file's path prefix. *EAGAIN* @@ -409,10 +409,10 @@ fcntl - Manipulates an open file descriptor significant bit is used). *F_GETFL* - Read the descriptor’s flags (all flags (as set by open()) are returned). + Read the descriptor's flags (all flags (as set by open()) are returned). *F_SETFL* - Set the descriptor’s flags to the value specified by ``arg``. Only``O_APPEND`` and ``O_NONBLOCK`` may be set. + Set the descriptor's flags to the value specified by ``arg``. Only``O_APPEND`` and ``O_NONBLOCK`` may be set. The flags are shared between copies (made with ``dup()`` etc.) of the same file descriptor. The flags and their semantics are described in ``open()``. diff --git a/posix_users/key.rst b/posix_users/key.rst index 1ce6c2a..71b04c7 100644 --- a/posix_users/key.rst +++ b/posix_users/key.rst @@ -30,8 +30,8 @@ There is currently no text in this section. Directives ========== -This section details the key manager’s directives. -A subsection is dedicated to each of this manager’s directives +This section details the key manager's directives. +A subsection is dedicated to each of this manager's directives and describes the calling sequence, related constants, usage, and status codes. diff --git a/posix_users/language_specific_services.rst b/posix_users/language_specific_services.rst index be8c276..5c08933 100644 --- a/posix_users/language_specific_services.rst +++ b/posix_users/language_specific_services.rst @@ -64,8 +64,8 @@ There is currently no text in this section. Directives ========== -This section details the language-specific services for the C programming language manager’s directives. -A subsection is dedicated to each of this manager’s directives +This section details the language-specific services for the C programming language manager's directives. +A subsection is dedicated to each of this manager's directives and describes the calling sequence, related constants, usage, and status codes. diff --git a/posix_users/memory_managment.rst b/posix_users/memory_managment.rst index 05bb99d..1095b39 100644 --- a/posix_users/memory_managment.rst +++ b/posix_users/memory_managment.rst @@ -42,8 +42,8 @@ There is currently no text in this section. Directives ========== -This section details the memory management manager’s directives. -A subsection is dedicated to each of this manager’s directives +This section details the memory management manager's directives. +A subsection is dedicated to each of this manager's directives and describes the calling sequence, related constants, usage, and status codes. diff --git a/posix_users/message_passing.rst b/posix_users/message_passing.rst index 6192587..2900ac6 100644 --- a/posix_users/message_passing.rst +++ b/posix_users/message_passing.rst @@ -103,7 +103,7 @@ Notification of a Message on the Queue -------------------------------------- Every message queue has the ability to notify one (and only one) process -whenever the queue’s state changes from empty (0 messages) to nonempty. +whenever the queue's state changes from empty (0 messages) to nonempty. This means that the process does not have to block or constantly poll while it waits for a message. By calling mq_notify, you can attach a notification request to a message queue. When a message is received by an @@ -194,7 +194,7 @@ Receiving a Message from a Message Queue The mq_receive() function is used to receive the oldest of the highest priority message(s) from the message queue specified by mqdes. The messages are received in FIFO order within the priorities. The received -message’s priority is stored in the location referenced by the msg_prio. +message's priority is stored in the location referenced by the msg_prio. If the msg_prio is a NULL, the priority is discarded. The message is removed and stored in an area pointed to by msg_ptr whose length is of msg_len. The msg_len must be at least equal to the mq_msgsize attribute @@ -212,7 +212,7 @@ Notification of Receipt of a Message on an Empty Queue The mq_notify() function registers the calling process to be notified of message arrival at an empty message queue. Every message queue has the -ability to notify one (and only one) process whenever the queue’s state +ability to notify one (and only one) process whenever the queue's state changes from empty (0 messages) to nonempty. This means that the process does not have to block or constantly poll while it waits for a message. By calling mq_notify, a notification request is attached to a message @@ -265,8 +265,8 @@ was called. Directives ========== -This section details the message passing manager’s directives. A -subsection is dedicated to each of this manager’s directives and describes +This section details the message passing manager's directives. A +subsection is dedicated to each of this manager's directives and describes the calling sequence, related constants, usage, and status codes. mq_open - Open a Message Queue @@ -317,7 +317,7 @@ message queue with a message queue descriptor. If the message queue already exists, mq_open opens it, if the message queue does not exist, mq_open creates it. Message queues can have multiple senders and receivers. If mq_open is successful, the function returns a message queue -descriptor. Otherwise, the function returns a -1 and sets ’errno’ to +descriptor. Otherwise, the function returns a -1 and sets 'errno' to indicate the error. The name of the message queue is used as an argument. For the best of @@ -500,7 +500,7 @@ mq_receive - Receive a Message from a Message Queue The mq_receive function is used to receive the oldest of the highest priority message(s) from the message queue specified by mqdes. The messages are received in FIFO order within the priorities. The received -message’s priority is stored in the location referenced by the msg_prio. +message's priority is stored in the location referenced by the msg_prio. If the msg_prio is a NULL, the priority is discarded. The message is removed and stored in an area pointed to by msg_ptr whose length is of msg_len. The msg_len must be at least equal to the mq_msgsize attribute @@ -548,7 +548,7 @@ calling process to be notified of message arrival at an empty message queue associated with the specified message queue descriptor, mqdes. Every message queue has the ability to notify one (and only one) process -whenever the queue’s state changes from empty (0 messages) to nonempty. +whenever the queue's state changes from empty (0 messages) to nonempty. This means that the process does not have to block or constantly poll while it waits for a message. By calling mq_notify, a notification request is attached to a message queue. When a message is received by an diff --git a/posix_users/mutex.rst b/posix_users/mutex.rst index 067f284..0198664 100644 --- a/posix_users/mutex.rst +++ b/posix_users/mutex.rst @@ -87,8 +87,8 @@ There is currently no text in this section. Services ======== -This section details the mutex manager’s services. -A subsection is dedicated to each of this manager’s services +This section details the mutex 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. diff --git a/posix_users/preface.rst b/posix_users/preface.rst index e8e71f3..d4065b5 100644 --- a/posix_users/preface.rst +++ b/posix_users/preface.rst @@ -1,7 +1,7 @@ Preface ####### -This is the User’s Guide for the POSIX API support +This is the User's Guide for the POSIX API support provided in RTEMS. The functionality described in this document is based @@ -52,8 +52,8 @@ Acknowledgements documentation. Portions of this text are reprinted and reproduced in electronic form from IEEE Std 1003.1, 2004 Edition, Standard for Information - Technology — Operating System Interface (POSIX), The Open - Group Base Specifications Issue 6, Copyright © 2001-2004 by the + Technology Operating System Interface (POSIX), The Open + Group Base Specifications Issue 6, Copyright (c) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between this version and the original IEEE and The Open Group Standard, the original diff --git a/posix_users/process_creation_and_execution.rst b/posix_users/process_creation_and_execution.rst index 38f1ce1..7ba4588 100644 --- a/posix_users/process_creation_and_execution.rst +++ b/posix_users/process_creation_and_execution.rst @@ -57,8 +57,8 @@ is equivalent to invoking either ``exit`` or``rtems_shutdown_executive``. Directives ========== -This section details the process creation and execution manager’s directives. -A subsection is dedicated to each of this manager’s directives +This section details the process creation and execution manager's directives. +A subsection is dedicated to each of this manager's directives and describes the calling sequence, related constants, usage, and status codes. diff --git a/posix_users/process_environment.rst b/posix_users/process_environment.rst index 0deee9d..50c89b0 100644 --- a/posix_users/process_environment.rst +++ b/posix_users/process_environment.rst @@ -103,7 +103,7 @@ POSIX allows for variables in the run-time environment. These are name/value pairs that make be dynamically set and obtained by programs. In a full POSIX environment with command line shell and multiple processes, environment variables may be set in -one process – such as the shell – and inherited by child +one process - such as the shell - and inherited by child processes. In RTEMS, there is only one process and thus only one set of environment variables across all processes. @@ -127,8 +127,8 @@ the ``putenv()`` service. Directives ========== -This section details the process environment manager’s directives. -A subsection is dedicated to each of this manager’s directives +This section details the process environment manager's directives. +A subsection is dedicated to each of this manager's directives and describes the calling sequence, related constants, usage, and status codes. diff --git a/posix_users/scheduler.rst b/posix_users/scheduler.rst index 6c115e4..9d249b0 100644 --- a/posix_users/scheduler.rst +++ b/posix_users/scheduler.rst @@ -60,8 +60,8 @@ There is currently no text in this section. Directives ========== -This section details the scheduler manager’s directives. -A subsection is dedicated to each of this manager’s directives +This section details the scheduler manager's directives. +A subsection is dedicated to each of this manager's directives and describes the calling sequence, related constants, usage, and status codes. diff --git a/posix_users/semaphore.rst b/posix_users/semaphore.rst index eda5bcd..47628df 100644 --- a/posix_users/semaphore.rst +++ b/posix_users/semaphore.rst @@ -78,8 +78,8 @@ There is currently no text in this section. Directives ========== -This section details the semaphore manager’s directives. -A subsection is dedicated to each of this manager’s directives +This section details the semaphore manager's directives. +A subsection is dedicated to each of this manager's directives and describes the calling sequence, related constants, usage, and status codes. diff --git a/posix_users/services_provided_by_c.rst b/posix_users/services_provided_by_c.rst index 2389609..e061d0b 100644 --- a/posix_users/services_provided_by_c.rst +++ b/posix_users/services_provided_by_c.rst @@ -165,7 +165,7 @@ Input and Output (stdio.h) - ``puts`` - Write a character string on standard output -- ``remove`` - Delete a file’s name +- ``remove`` - Delete a file's name - ``rename`` - Rename a file diff --git a/posix_users/signal.rst b/posix_users/signal.rst index 51b43ab..6ad79b1 100644 --- a/posix_users/signal.rst +++ b/posix_users/signal.rst @@ -115,7 +115,7 @@ Signal Set Management Each process and each thread within that process has a set of individual signals and handlers associated with it. Services are provided to construct signal sets for the purposes of building -signal sets – type ``sigset_t`` – that are used to +signal sets - type ``sigset_t`` - that are used to provide arguments to the services that mask, unmask, and check on pending signals. @@ -138,8 +138,8 @@ the service ``kill()`` or at a thread by the service``pthread_kill()`` Directives ========== -This section details the signal manager’s directives. -A subsection is dedicated to each of this manager’s directives +This section details the signal manager's directives. +A subsection is dedicated to each of this manager's directives and describes the calling sequence, related constants, usage, and status codes. diff --git a/posix_users/system_database.rst b/posix_users/system_database.rst index 56505a5..60d6e02 100644 --- a/posix_users/system_database.rst +++ b/posix_users/system_database.rst @@ -38,8 +38,8 @@ There is currently no text in this section. Directives ========== -This section details the system databases manager’s directives. -A subsection is dedicated to each of this manager’s directives +This section details the system databases manager's directives. +A subsection is dedicated to each of this manager's directives and describes the calling sequence, related constants, usage, and status codes. diff --git a/posix_users/thread.rst b/posix_users/thread.rst index 4bd80ed..b6a6fca 100644 --- a/posix_users/thread.rst +++ b/posix_users/thread.rst @@ -85,12 +85,12 @@ the ``pthread_create`` routine. is the address of the optionally user specified stack area for this thread. If this value is NULL, then RTEMS allocates the memory for the thread stack from the RTEMS Workspace Area. Otherwise, this is the user specified - address for the memory to be used for the thread’s stack. Each thread must + address for the memory to be used for the thread's stack. Each thread must have a distinct stack area. Each processor family has different alignment rules which should be followed. *stack size* - is the minimum desired size for this thread’s stack area. + is the minimum desired size for this thread's stack area. If the size of this area as specified by the stack size attribute is smaller than the minimum for this processor family and the stack is not user specified, then RTEMS will automatically allocate a @@ -120,8 +120,8 @@ There is currently no text in this section. Services ======== -This section details the thread manager’s services. -A subsection is dedicated to each of this manager’s services +This section details the thread 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. @@ -852,7 +852,7 @@ pthread_create - Create a Thread *EINVAL* The user specified a stack address and the size of the area was not - large enough to meet this processor’s minimum stack requirements. + large enough to meet this processor's minimum stack requirements. *EINVAL* The specified scheduler inheritance policy was invalid. diff --git a/posix_users/thread_cancellation.rst b/posix_users/thread_cancellation.rst index 5c8aac3..5a70c40 100644 --- a/posix_users/thread_cancellation.rst +++ b/posix_users/thread_cancellation.rst @@ -34,8 +34,8 @@ There is currently no text in this section. Directives ========== -This section details the thread cancellation manager’s directives. -A subsection is dedicated to each of this manager’s directives +This section details the thread cancellation manager's directives. +A subsection is dedicated to each of this manager's directives and describes the calling sequence, related constants, usage, and status codes. diff --git a/posix_users/timer.rst b/posix_users/timer.rst index 4adf320..36801d8 100644 --- a/posix_users/timer.rst +++ b/posix_users/timer.rst @@ -27,8 +27,8 @@ Operations System Calls ============ -This section details the timer manager’s services. -A subsection is dedicated to each of this manager’s services +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. -- cgit v1.2.3