Warning: main(/www/www/htdocs/style/globals.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/neutrino/lib_ref/s/shm_ctl_special.html on line 1

Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/globals.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/neutrino/lib_ref/s/shm_ctl_special.html on line 1

Warning: main(/www/www/htdocs/style/header.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/neutrino/lib_ref/s/shm_ctl_special.html on line 8

Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/header.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/neutrino/lib_ref/s/shm_ctl_special.html on line 8

shm_ctl_special()

Give special attributes to a shared memory object

Synopsis:

#include <sys/mman.h>

int shm_ctl_special( int fd,
             int flags,
             _uint64 paddr,
             _uint64 size,
             unsigned special );

Arguments:

fd

The file descriptor that's associated with the shared memory object, as returned by shm_open().

flags

One or more of the following bits, defined in <sys/mman.h>:

SHMCTL_ANON — allocate anonymous memory.
SHMCTL_PHYS — use physical address, or allocate physically contiguous memory if used with SHMCTL_ANON.
SHMCTL_GLOBAL — a hint that any mapping to the object could be global across all processes.
SHMCTL_PRIV — a hint that a mapping of this object may require privileged access.
SHMCTL_LOWERPROT — a hint that the system may map this object in such a way that it trades lower memory protection for better performance.
SHMCTL_LAZY — delay allocating the memory until it's referenced.
If you create anonymous shared memory objects by calling mmap() with MAP_ANON | MAP_SHARED and a file descriptor of -1), a MAP_LAZY flag implicitly sets the SHMCTL_LAZY flag on the object.
SHMCTL_LAZYWRITE — a hint that a mapping of this object could use lazy-writing mechanisms.

Some of the above bits have specific meanings for different processors. For more information, see the documentation for shm_ctl().

paddr

A physical address to assign to the object, if you set SHMCTL_PHYS in flags.

size

The new size of the object, in bytes, regardless of ANON/PHYS flag.

special

Processor-specific flags; see the following sections below:

ARM-specific flags
PPC-specific flags
SH4-specific flags

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The shm_ctl_special() function modifies the attributes of the shared memory object identified by the handle, fd. This handle is the value returned by shm_open().

The shm_ctl_special() function is similar to shm_ctl(), but has an additional processor-specific argument, special. Calling shm_ctl_special() with a value of 0 for special is equivalent to calling shm_ctl().

ARM-specific flags

For ARM platforms, the special argument specifies the page table entry (PTE) bits to be set when the object is mapped. These bits and their meaning are generally processor-specific:

For ARMv4 processors (e.g. ARM926-based SoCs), you can specify the following:

cacheable (ARM_PTE_C)
bufferable (ARM_PTE_B)

For ARMv5 processors using extended small pages (e.g. xscale-based SoCs), you can specify the following:

cacheable (ARM_PTE_C)
bufferable (ARM_PTE_B)
TEX encoding (ARM_PTE_V5_SP_TEX(x))

For ARMv6 processors (e.g. ARM11-based SoCs), you can specify the following:

cacheable (ARM_PTE_C)
bufferable (ARM_PTE_B)
execute-never (ARM_PTE_V6_SP_XN)
TEX encoding (ARM_PTE_V5_SP_TEX(x))
sharable (ARM_PTE_V6_S)

PPC-specific flags

These special PPC flags refer to the bits in the page table entries that map the object:

Flag	Definition	If the bit is 0:	If the bit is 1:
PPC_SPECIAL_E (endian-ness, which is available only on some chips)	Refers to the bit ordering used to represent data.	The page is accessed in big-endian byte order.	Not accessed in big-endian byte order.
PPC_SPECIAL_G (guarded memory)	Prevents speculative, out of sequence accesses from being performed on a region (i.e. instruction prefetches for speculative accesses).	Access to the page isn't guarded and can be done before it's known if required by sequential execution.	All loads and stores to the page are performed without speculation (they are known to be required).
PPC_SPECIAL_I (cache inhibit)	Marks the page as uncacheable, meaning that the cache is always bypassed, and that all loads and stores access main memory.	The page is cacheable.	The page is cache-inhibited, and the data should not be cached downstream from the processor.
PPC_SPECIAL_M (memory coherence required)	Refers to system memory coherence.	The transaction is ignored, meaning that memory is not coherent or that this is a transaction that doesn't need to be looked at; memory coherence is not required.	Memory coherence is required.
PPC_SPECIAL_W (write through cache)	Operations update the main memory as well as the cache.	The page is a write-back (for coherency) in the system, and the data must be forwarded at least one cache level toward memory.	All stores performed to this page are written to main memory, meaning that the data for a write transaction is forwarded to system memory, or to a memory-mapped device.

For additional information about these bits, see a PPC architecture guide.

SH4-specific flags

On SH4 7760, the special argument controls the space attribute bits of the UTLB (see section 6.3.1 of 7760 hardware manual).

Returns:

0: Success.
-1: An error occurred (errno is set).

Errors:

EINVAL: An invalid combination of flags was specified, or the shared memory object is already “special.”

Classification:

QNX Neutrino

Safety:
Cancellation point	Yes
Interrupt handler	No
Signal handler	Yes
Thread	Yes