summaryrefslogtreecommitdiff
path: root/nuttx/Documentation
diff options
context:
space:
mode:
authorGregory Nutt <gnutt@nuttx.org>2014-09-23 11:41:05 -0600
committerGregory Nutt <gnutt@nuttx.org>2014-09-23 11:41:05 -0600
commit3edb44ada71e6cba49a0b4d4dfa67fce4756c0f9 (patch)
tree68864d3643303dea0ad83a1f54658f24e83b19d4 /nuttx/Documentation
parentc163691f9446061dbab259c62fb86b8c0ced0cff (diff)
downloadnuttx-3edb44ada71e6cba49a0b4d4dfa67fce4756c0f9.tar.gz
nuttx-3edb44ada71e6cba49a0b4d4dfa67fce4756c0f9.tar.bz2
nuttx-3edb44ada71e6cba49a0b4d4dfa67fce4756c0f9.zip
Flesh out shmctl() logic
Diffstat (limited to 'nuttx/Documentation')
-rw-r--r--nuttx/Documentation/NuttxUserGuide.html29
1 files changed, 19 insertions, 10 deletions
diff --git a/nuttx/Documentation/NuttxUserGuide.html b/nuttx/Documentation/NuttxUserGuide.html
index ee5d45ae1..68a191917 100644
--- a/nuttx/Documentation/NuttxUserGuide.html
+++ b/nuttx/Documentation/NuttxUserGuide.html
@@ -9259,21 +9259,13 @@ int shmctl(int shmid, int cmd, FAR struct shmid_ds *buf);
<li>
<p>
<code>IPC_SET</code>.
- Set the value of the following members of the <code>shmid_ds</code> data structure associated with <code>shmid</code> to the corresponding value found in the structure pointed to by <code>buf</code>:
- </p>
- <ul>
- <code>shm_perm.uid</code><br>
- <code>shm_perm.gid</code><br>
- <code>shm_perm.mode</code> (Low-order nine bits).
- </ul>
- <p>
- <code>IPC_SET</code> can only be executed by a process that has an effective user ID equal to either that of a process with appropriate privileges or to the value of <code>shm_perm.cuid</code> or <code>shm_perm.uid</code> in the <code>shmid_ds</code> data structure associated with <code>shmid</code>.
+ Set the value of the <code>shm_perm.mode</code> member of the <code>shmid_ds</code> data structure associated with <code>shmid</code> to the corresponding value found in the structure pointed to by <code>buf</code>.
</p>
</li>
<li>
<p>
<code>IPC_RMID</code>.
- Remove the shared memory identifier specified by <code>shmid</code> from the system and destroy the shared memory segment and <code>shmid_ds</code> data structure associated with it. <code>IPC_RMID</code> can only be executed by a process that has an effective user ID equal to either that of a process with appropriate privileges or to the value of <code>shm_perm.cuid</code> or <code>shm_perm.uid</code> in the <code>shmid_ds</code> data structure associated with <code>shmid</code>.
+ Remove the shared memory identifier specified by <code>shmid</code> from the system and destroy the shared memory segment and <code>shmid_ds</code> data structure associated with it.
</p>
</li>
</ul>
@@ -9307,6 +9299,23 @@ int shmctl(int shmid, int cmd, FAR struct shmid_ds *buf);
The <code>cmd</code> argument is <code>IPC_STAT</code> and the <code>gid</code> or <code>uid</code> value is too large to be stored in the structure pointed to by the <code>buf</code> argument.
</li>
</ul>
+<p>
+ <b>POSIX Deviations</b>
+<p>
+<ul>
+ <li>
+ <code>IPC_SET</code>.
+ Does not set the the <code>shm_perm.uid</code> or <code>shm_perm.gid</code>members of the <code>shmid_ds</code> data structure associated with <code>shmid</code> because user and group IDs are not yet supported by NuttX
+ </li>
+ <li>
+ <code>IPC_SET</code>.
+ Does not restrict the operation to processes with appropriate privileges or matching user IDs in <code>shmid_ds</code> data structure associated with <code>shmid</code>. Again because user IDs and user/group privileges are are not yet supported by NuttX
+ </li>
+ <li>
+ <code>IPC_RMID</code>.
+ Does not restrict the operation to processes with appropriate privileges or matching user IDs in <code>shmid_ds</code> data structure associated with <code>shmid</code>. Again because user IDs and user/group privileges are are not yet supported by NuttX
+ </li>
+</ul>
<h3><a name="shmdt">2.12.4 <code>shmdt</code></a></h3>
<p>