Home
QNX Software Development Platform
QNX SDP is a cross-compiling and debugging environment, including an IDE and command-line tools, for building binary images and programs for target boards running the QNX OS 8.0.
Utilities & Libraries
C Library Reference
M
memset_s()
Securely set memory to a given value

QNX Momentics IDE User's Guide
This User's Guide describes version 8.0 of the Integrated Development Environment (IDE) that's part of the QNX Tool Suite.
QNX Software Development Platform
QNX SDP is a cross-compiling and debugging environment, including an IDE and command-line tools, for building binary images and programs for target boards running the QNX OS 8.0.
- Quickstart Guide
- System Architecture
  The System Architecture guide accompanies the QNX OS and is intended for both application developers and end-users.
- OS Components & Operations
- Graphics
- Programming
- System Security Guide
  The QNX System Security Guide is intended for both system integrators who are responsible for the security of a QNX OS system and developers who want to create a QNX OS resource manager free from vulnerabilities.
- Utilities & Libraries
  - C Library Reference
    - What's in a Function Description?
    - Manifests
    - Character Sets
    - A
    - B
    - C
    - D
    - E
    - F
    - G
    - H
    - I
    - J
    - K
    - L
    - M
      - main()
        Program entry function
      - mallinfo()
        Get memory allocation information
      - malloc()
        Allocate memory
      - mallopt()
        Control memory allocation and the extra checking for it
      - max()
        Return the greater of two numbers
      - max_align_t
        A type whose alignment requirement is at least as strict as that of every scalar type
      - mblen()
        Count the bytes in a multibyte character
      - mbrlen()
        Count the bytes in a multibyte character (restartable)
      - mbrtoc16(), mbrtoc32()
        Convert a multibyte character (UTF-8) into a wide character (UTF-16 or UTF-32)
      - mbrtowc()
        Convert a multibyte character into a wide character (restartable)
      - mbsinit()
        Determine the status of the conversion object used for restartable mb*() functions
      - mbsrtowcs()
        Convert a multibyte-character string into a wide-character string (restartable)
      - mbstowcs()
        Convert a multibyte-character string into a wide-character string
      - mbtowc()
        Convert a multibyte character into a wide character
      - mem_offset(), mem_offset64()
        Get the physical address and length of a virtually mapped memory block
      - memalign()
        Allocate aligned memory
      - memccpy()
        Copy bytes between buffers until a given byte is found
      - memchr()
        Find the first occurrence of a character in a buffer
      - memcmp()
        Compare the bytes in two buffers
      - memcpy()
        Copy bytes from one buffer to another
      - memcpyv()
        Copy data from one I/O vector to another
      - memicmp()
        Compare two buffers, ignoring case
      - memmove()
        Copy bytes from one buffer to another, handling overlapping memory correctly
      - memory_order
        Enumerated type for how regular non-atomic memory accesses are to be ordered around an atomic operation
      - memset()
        Set memory to a given value
      - memset_s()
        Securely set memory to a given value
      - message_attach()
        Attach a message range
      - message_connect()
        Create a connection to a channel
      - message_detach()
        Detach a message range
      - min()
        Return the lesser of two numbers
      - mkdir()
        Create a directory
      - mkdirat()
        Create a directory at a given location
      - mkdtemp()
        Make a unique temporary directory name
      - mkfifo()
        Create a FIFO special file
      - mkfifoat()
        Create a FIFO special file at a given location
      - mknod()
        Make a new filesystem entry
      - mknodat()
        Make a new filesystem entry at a given location
      - mkostemp(), mkostemps()
        Make a unique temporary filename and open the file, specifying some flags
      - mkstemp(), mkstemps()
        Make a unique temporary filename and open the file
      - mktemp()
        Make a unique temporary filename
      - mktime()
        Convert local time to calendar time
      - mlock()
        Lock a range of process address space in physical memory
      - mlockall()
        Lock all of a process's address space
      - mmap(), mmap64(), mmap_handle(), mmap_handle_pid()
        Map a memory region into a process's address space
      - mmap_device_io()
        Gain access to a device's registers
      - mmap_device_memory()
        Map a device's physical memory into a process's address space
      - mmap_peer(), mmap64_peer()
        Create a virtual mapping in the address space of another process
      - modf(), modff(), modfl()
        Break a number into integral and fractional parts
      - mount()
        Mount a filesystem
      - mount_parse_generic_args()
        Strip off common mount arguments
      - mprotect()
        Change memory protection
      - mq_clockreceive()
        Receive a message from a message queue with a timeout measured against a specific clock
      - mq_clocksend()
        Send a message to a message queue with a timeout measured against a specific clock
      - mq_close()
        Close a message queue
      - mq_getattr()
        Get a message queue's attributes
      - mq_notify()
        Ask to be notified when there's a message in the queue
      - mq_open()
        Open a message queue
      - mq_receive()
        Receive a message from a queue
      - mq_send()
        Send a message to a queue
      - mq_setattr()
        Set a queue's attributes
      - mq_timedreceive(), mq_timedreceive_monotonic()
        Receive a message from a message queue
      - mq_timedsend(), mq_timedsend_monotonic()
        Send a message to a message queue
      - mq_unlink()
        Remove a queue
      - mrand48()
        Generate a pseudo-random signed long integer
      - _msg_info
        Information about a message
      - MsgCurrent(), MsgCurrent_r()
        Resume processing of a message
      - MsgDeliverEvent(), MsgDeliverEvent_r()
        Deliver an event through a channel
      - MsgError(), MsgError_r()
        Unblock a client and set its error code
      - MsgInfo(), MsgInfo_r()
        Get additional information about a message
      - MsgPause(), MsgPause_r()
        Pause the processing of a message
      - MsgQueueClose()
        Close a message queue connection
      - MsgQueueCtl()
        Perform message queue operations
      - MsgQueueOpen()
        Associate a client with a kernel message queue
      - MsgQueueReceive()
        Receive a message on an open queue
      - MsgQueueSend()
        Send a message on an open queue
      - MsgRead(), MsgRead_r()
        Read data from a message
      - MsgReadv(), MsgReadv_r()
        Read data from a message
      - MsgReceive(), MsgReceive_r()
        Wait for a message or pulse on a channel
      - MsgReceivePulse(), MsgReceivePulse_r()
        Receive a pulse on a channel
      - MsgReceivev(), MsgReceivev_r()
        Wait for a message or pulse on a channel
      - MsgRegisterEvent(), MsgRegisterEvent_r()
        Register a secure event
      - MsgReply(), MsgReply_r()
        Reply with a message
      - MsgReplyv(), MsgReplyv_r()
        Reply with a message
      - MsgSend(), MsgSend_r()
        Send a message to a channel
      - MsgSendnc(), MsgSendnc_r()
        Send a message to a channel (non-cancellation point)
      - MsgSendPulse(), MsgSendPulse_r()
        Send a pulse to a process
      - MsgSendPulsePtr(), MsgSendPulsePtr_r()
        Send a pulse (containing a pointer) to a process
      - MsgSendsv(), MsgSendsv_r()
        Send a message to a channel
      - MsgSendsvnc(), MsgSendsvnc_r()
        Send a message to a channel (non-cancellation point)
      - MsgSendv(), MsgSendv_r()
        Send a message to a channel
      - MsgSendvnc(), MsgSendvnc_r()
        Send a message to a channel (non-cancellation point)
      - MsgSendvs(), MsgSendvs_r()
        Send a message to a channel
      - MsgSendvsnc(), MsgSendvsnc_r()
        Send a message to a channel (non-cancellation point)
      - MsgUnregisterEvent(), MsgUnregisterEvent_r()
        Unregister a secure event
      - MsgVerifyEvent(), MsgVerifyEvent_r()
        Check the validity of a receive ID and an event configuration
      - MsgWrite(), MsgWrite_r()
        Write a reply
      - MsgWritev(), MsgWritev_r()
        Write a reply
      - msync()
        Synchronize memory with physical storage
      - mtx_destroy()
        Destroy a mutex
      - mtx_init()
        Initialize a mutex
      - mtx_lock()
        Lock a mutex
      - mtx_timedlock()
        Lock a mutex, with a time limit
      - mtx_trylock()
        Attempt to lock a mutex
      - mtx_unlock()
        Unlock a mutex
      - munlock()
        Unlock the address space of a process
      - munlockall()
        Unlock a process's address space
      - munmap()
        Unmap previously mapped addresses
      - munmap_device_io()
        Free access to a device's registers
      - munmap_device_memory()
        Unmap previously mapped addresses
      - munmap_flags()
        Unmap previously mapped addresses, exercising more control than possible with munmap()
      - munmap_peer()
        Unmap a part of the virtual address space in another process
    - N
    - O
    - P
    - Q
    - R
    - S
    - T
    - U
    - V
    - W
    - X
    - Y
    - Z
    - Full Safety Information
    - Glossary
  - Devctl and Ioctl Commands
  - JSON Library Reference
  - PAM Reference
  - QNX Helpers Developer's Guide
    These libraries provide QNX helpers, including helpers that assist with logging, string conversion, and number and type sizes.
  - SPI Framework Technote
  - Utilities Reference
  - WPA Control Interface Reference
    This document provides a reference for the Wi-Fi Protected Access (WPA) control interface, which provides a C API for the WPA/IEEE 802.11i protocols in Wi-Fi client stations. Application developers who want to control WPA operations and get associated status and event data should read this reference.
- Migrating to QNX OS 8.0
QNX Software in the Cloud
QNX Toolkit for Visual Studio Code
This User's Guide describes the QNX^® Toolkit for Visual Studio Code. The guide introduces you to the QNX Toolkit by explaining the QNX development environment and how to build, run, and debug your QNX^® Operating System (OS) applications and systems.
Typographical Conventions, Support, and Licensing
This section describes the typographical conventions used throughout the documentation, explains how to obtain technical support, and provides some information about licensing.

memset_s()

QNX SDP8.0C Library ReferenceAPIDeveloper

Securely set memory to a given value

Synopsis:

#include <string.h>

errno_t memset_s( void *s,
                  rsize_t smax,
                  int c,
                  rsize_t n );

Arguments:

s: A pointer to the memory that you want to set. This must not be NULL.
smax: The maximum size of the block of memory.
c: The value that you want to store in each byte.
n: The number of bytes to set. This value must not be greater than the value of smax.

Library:

libc

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

Description:

The memset_s() function is a secure version of memset():

If the arguments are all valid, memset_s() copies the value of c (converted to an unsigned char) into each of the first n characters of the object pointed to by s.
If there's a runtime-constraint violation, then if s isn't NULL, memset_s() stores the value of c (converted to an unsigned char) into each of the first smax characters of the object pointed to by s.
Unlike memset(), any call to memset_s() assumes that the memory indicated by s may be accessible in the future and thus must contain the values indicated by c.

Returns:

EOK: Success.
EINVAL: The s argument is NULL, or n is greater than smax.

Classification:


Safety:
Cancellation point	No
Signal handler	Yes
Thread	Yes

Page updated: August 09, 2024