QNX Neutrino 6.6 documentation online

New entries

_cred_info

Structure that describes user and group credentials

fsev_t, FSE_*()

Structure and macros for filesystem events

hwi_find()

Find a specific item instance owned by a specific parent, resolving all synonym names

hwi_find_bus()

Find the offset of the section in the system page for a bus

hwi_find_device()

Find the offset in the system page of a device

hwi_find_devicebus()

Find the bus that a device belongs to

hwi_find_num_units()

Count the instances of a unit in the system page

hwi_find_unit()

Determine which instance of a device an offset corresponds to

hwi_tag_find()

Locate a specific instance of the named tag for a device

hwiattr_get(), hwiattr_get_*()

Get attributes of a bus or device

hwitag_find_busattr()

Find a bus attribute tag associated with a bus

hwitag_find_clkfreq()

Find the clock source for a device

hwitag_find_errata()

Find an erratum for a device

hwitag_find_ivec()

Find the interrupt vector associated with a device

hwitag_find_nicaddr()

Get the NIC address of a device

hwitag_find_phyaddr()

Find the PHY address associated with a device

InterruptHookIdle2()

Attach an “idle” interrupt handler. This kernel call replaces InterruptHookIdle() and attaches a handler that's suitable for a multiprocessor system.

iofunc_ability_check()

Verify that the client has a given resource manager ability

iofunc_notify_remove_strict()

Remove a specified number of notification entries from a list

iofunc_notify_trigger_strict()

Send notifications to queued clients

MsgPause()

Pause the processing of a message

pathmgr_link()

Create a link

procmgr_event_trigger_updateable()

Trigger a system-wide event, specifying a value for sigev_value

_readdir_r()

Read a directory and get stat information

set_ids_from_arg()

Change the caller's identifiers, based on a given string

siginfo_t

Information about a signal

slog2_close_log()

Close a system logger file

slog2_dump_logs_to_file()

Write a snapshot of slog2 logs to a file

slog2_get_buffer_info()

Get information about a slogger2 buffer

slog2_get_log_info()

Get information about a log file

slog2_open_log()

Open a system log for parsing

slog2_packet_cmp()

Compare two slogger2 packets

slog2_packet_info_t

Structure containing information about a packet

slog2_parse_all()

Parse all slogger2 files

slog2_parse_dynamic_buffer(), slog2_parse_static_buffer()

Parse a slogger2 buffer

sysctlbyname()

Get or set information about the socket manager, specifying the name of the variable as a string.

Discontinued

• brk(), sbrk — use malloc() instead
• InterruptHookIdle() — use InterruptHookIdle2() instead. Note that the arguments are different for the handler function.
• ChannelCreateExt() — not used

Changed content

*64()

The large-file support functions and data types now appear in the name space only if you define _LARGEFILE64_SOURCE when you compile your code. For more information, see “Classification” in What's in a Function Description?

bt_sprn_memmap()

Note that the out string might not be null-terminated.

chown()

You can pass -1 for the user ID or group ID (or both) if you don't want to change them.

ConnectServerInfo()

Note that if the pid argument is 0, the function searches for the connection in the current process.

daemon()

You can now use this function in multithreaded programs.

devctl(), devctlv()

We've added EFAULT to the list of errors.

dhcpctl*()

These functions can return ISC_R_SUCCESS, and some of the OMAPI code uses an MDL macro. Neither of these is defined in a public header, but you can define them in your code if you wish.

dispatch_create(), dispatch_create_channel()

In order to create a public channel (i.e., without _NTO_CHF_PRIVATE set), your process must have the PROCMGR_AID_PUBLIC_CHANNEL ability enabled.

encrypt()

We've added an example, but for more secure encryption, use OpenSSL instead of this function.

fcntl()

We've documented the F_GETOWN and F_SETOWN commands.

getitimer(), setitimer()

POSIX has marked these functions as obsolescent; you should use timer_gettime() and timer_settime() instead. Nevertheless, we've corrected the descriptions.

getsockopt(), setsockopt()

• Options that can be enabled or disabled have a value of zero if disabled, or a nonzero value if enabled. We've described the SO_ACCEPTCONN option.
• We've described the SO_OVERFLOWED option.

InterruptAttach(), InterruptAttachEvent()

• You can now specify _NTO_INTR_FLAGS_NO_UNMASK to leave the interrupt masked.
• We've added more details about choosing the event type for the sigevent.

_io_connect

We've documented the _IO_CONNECT_EFLAG_DOTDOT extended flag.

_io_devctl, _io_devctl_reply, _io_lock, _io_read, _io_write

The nbytes members of these structures are now of type uint32_t.

_io_fdinfo

The path_len member of this structure is now of type uint32_t.

iofunc_mknod()

We've added EACCES to the list of errors for this function.

iofunc_notify()

We've documented _NOTIFY_ACTION_CONDARM and updated the list of errors for this function.

iofunc_notify_trigger(), iofunc_notify_trigger_strict()

• A resource manager generally calls iofunc_notify_trigger_strict() in a close_dup callout to unblock any client select() calls that are waiting on a file descriptor that's been closed. You should call it three times with a count value of INT_MAX, the ctp passed to the close_dup callout, and an index of IOFUNC_NOTIFY_INPUT, IOFUNC_NOTIFY_OUTPUT, and IOFUNC_NOTIFY_OBAND.
• To ensure thread safety, lock the underlying object before calling this function.

iofunc_notify_remove(), iofunc_notify_remove_strict()

A resource manager typically calls one of these functions in its close_dup handler.

iofunc_ocb_t

We've documented the IOFUNC_OCB_MMAP bit for the flags member.

iofunc_openfd(), iofunc_read_verify(), iofunc_write_verify()

We've removed the xtype types and flags that aren't relevant to these functions.

ionotify()

We've documented _NOTIFY_ACTION_CONDARM and updated the list of errors for this function.

lchown()

You can pass -1 for the user ID or group ID (or both) if you don't want to change them.

mallopt()

This entry now describes the libc and librcheck versions of this function.

memchr(), memcpy(), memset(), strchr(), strcpy(), strlen()

On ARM v7 targets, you can use the LIBC_STRINGS environment variable to select the memory implementation to use for these functions.

message_attach()

In order to create a public channel (i.e., without _NTO_CHF_PRIVATE set), your process must have the PROCMGR_AID_PUBLIC_CHANNEL ability enabled.

mq_notify()

This function sets errno to EINVAL if the notification argument is NULL but the process isn't currently registered.

MsgDeliverEvent()

We've described how the priority of a pulse is checked and provided more details about the possible meanings of the error codes.

name_attach()

• This function gives an error of ENOENT if you attempt to attach a global name, but gns isn't running.
• In order to create a public channel (i.e., without _NTO_CHF_PRIVATE set), your process must have the PROCMGR_AID_PUBLIC_CHANNEL ability enabled.

posix_spawnp()

Note that in QNX Neutrino, if the file argument doesn't contain a slash, and the PATH environment variable isn't defined, then the OS searches for the executable in the current working directory.

procmgr_ability()

This function gives an error of EPERM if a non-root process tries to change the abilities for another process.

procmgr_event_notify(), procmgr_event_notify_add()

• There's a new PROCMGR_EVENT_CONTIG_ALLOC_FAIL flag that you can use if you want a pulse to be delivered if an attempt to allocate contiguous memory failed.
• If you set SIGEV_FLAG_UPDATEABLE in the hidden bits in the sigevent structure, the kernel provides some additional information in the sigev_value member when it notifies your process of the event.

pthread_cond_init(), pthread_mutex_init()

These functions now return ENOMEM instead of EAGAIN if all kernel synchronization objects are in use.

pulse_attach()

In order to create a public channel (i.e., without _NTO_CHF_PRIVATE set), your process must have the PROCMGR_AID_PUBLIC_CHANNEL ability enabled.

resmgr_attach()

In order to create a public channel (i.e., without _NTO_CHF_PRIVATE set), your process must have the PROCMGR_AID_PUBLIC_CHANNEL ability enabled.

resmgr_handle_tune()

To avoid allocator thrashing, the resource manager framework always keeps at least eight handles and hash buckets, no matter what minimum values you specify. It also uses a minimum bucket size of 16.

ROUTE protocol

You can now have multiple routes to the same destination; we've updated the example.

rsrcdbmgr_devno_attach(), rsrcdbmgr_devno_detach()

In order to use these functions, your process must have the PROCMGR_AID_RSRCDBMGR ability enabled.

sched_getparam(), sched_getscheduler(),

In order to get the scheduling policy and parameters for a thread whose real or saved user ID is different from the calling process's real or effective user ID, your process must have the PROCMGR_AID_SCHEDULE ability enabled.

sched_rr_get_interval()

In QNX Neutrino, this interval is the timeslice for the SCHED_RR scheduling policy.

SchedCtl()

• There are new members in the sched_aps_create_parms, sched_aps_partition_info, sched_aps_join_parms, and sched_aps_modify_parms structures.
• There are new SCHED_APS_SCHEDPOL_PARTITION_LOCAL_PRIORITIES, SCHED_APS_SCHEDPOL_LIMIT_CPU_USAGE, and SCHED_APS_SCHEDPOL_NO_LONG_REPORTING scheduling policies. The SCHED_APS_SCHEDPOL_DEFAULT policy now means that SCHED_APS_SCHEDPOL_FREETIME_BY_RATIO isn't set, long-window reporting is enabled, and all maximum budgets are 100%.

SchedInfo()

For the SCHED_RR and SCHED_OTHER scheduling policies, the interval is the timeslice in nanoseconds; for SCHED_FIFO and SCHED_SPORADIC, it's 0.

sched_setparam(), sched_setscheduler()

In order to set the scheduling policy and parameters for a thread whose real or saved user ID is different from the calling process's real or effective user ID, your process must have the PROCMGR_AID_SCHEDULE ability enabled.

select_attach()

In order to create a public channel (i.e., without _NTO_CHF_PRIVATE set), your process must have the PROCMGR_AID_PUBLIC_CHANNEL ability enabled.

sem_init()

It's always safe, and typically faster, to assure that sem is 32-bit aligned.

sem_post()

We've added EINTR to the list of error codes for this function.

shm_open()

The location in the pathname space where shared objects appear has changed:

name	Pathname space entry
entry	/dev/shmem/CWD/entry
/entry	/dev/shmem/entry

where CWD is the current working directory for the program at the point that it calls shm_open().

shutdown_system()

The shutdown type now includes:

• SHUTDOWN_KILLSWITCH
• SHUTDOWN_WARMREBOOT

Note that when the shutdown_classify() callout is invoked, only the pid and name members of the ProcessInfo_t structure have been initialized. Don't modify any of the members of this structure.

The shutdown_classify() callout can now classify a process as CLASS_GRAPHICAL_APP or CLASS_NR.

sigevent

We've described the SIGEV_MEMORY event and the SIGEV_FLAG_UPDATEABLE flag.

slog2_register()

• We've documented the SLOG2_ALLOC_TYPE_SHMEM, SLOG2_DISCARD_NEWLINE, and SLOG2_TRY_REUSE_BUFFER_SET flags.
• Use slog2_reset() to unregister the buffer set.

slogb(), slogf(), slogi(), vslogf()

If you want the data in the log message to be interpreted as text, use a bitwise OR to add _SLOG_TEXTBIT to the severity. If this bit is set, slogf() and vslogf() also write the log message on stderr.

snprintf(), vsnprintf()

The Caveats section now suggests a way to avoid the problem with calculating the length when you're building a string one piece at a time.

spawn()

There's a new SPAWN_ASLR_INVERT flag that you can use to toggle the Address Space Layout Randomization bit for the child process.

stat

The st_mode member includes the _S_ACL_EXT bit if the file has an extended Access Control List.

strtoimax(), strtoumax(), strtol(), strtoll(), strtoul(), strtoull()

If the conversion couldn't be performed, these functions return 0 and set errno to EINVAL.

SyncCondvarWait(), SyncCondvarWait_r()

These functions indicate an error of EINTR if they're interrupted by a signal.

tempnam(), tmpnam()

POSIX has marked these functions as obsolescent; use mkstemp() or tmpfile() instead.

thread_pool_create()

Note that this function does a shallow copy of the thread_pool_attr_t structure; it doesn't make copies of anything that the structure points to.

ThreadCtl()

Note that if you set a thread's runmask, it takes effect immediately.

timer_settime()

If you want infinite timer tolerance, call TimerSettime() instead of timer_settime().

TimerAlarm()

We've explained how to make the timer repeat.

TimerInfo()

We've documented the _NTO_TI_PROCESS_TOLERANT, _NTO_TI_TARGET_PROCESS, _NTO_TI_TOD_BASED, and _NTO_TI_TOLERANT bits that are used in the flags member of the _timer_info structure.

TimerSettime()

If you specify the TIMER_TOLERANCE flag and you want infinite timer tolerance, you can specify a large value (e.g., ~0ULL) for the nsec member of the itime argument.

TimerTimeout(), timer_timeout()

We've clarified how to use these functions.

TraceEvent()

• We've documented the _NTO_TRACE_INSERTCCLASSEVENT, _NTO_TRACE_INSERTSCLASSEVENT, _NTO_TRACE_OVERWRITEBUFFER, _NTO_TRACE_QUERYSUPPORT, _NTO_TRACE_QUERYVERSION, and _NTO_TRACE_SKIPBUFFER commands.
• Note that the only library functions that you can call in your event handler are those that are safe to call from an interrupt handler. Your event handler must also be reentrant.

waitid()

We've described the WTRAPPED flag.

We've updated the classifications of the following, to conform to POSIX.1-2008, 2013 Edition:

Errata

acl_calc_mask()

We've corrected the description of the acl_p argument.

acl_create_entry()

We've corrected the meaning of EINVAL.

acl_set_permset()

We've corrected the description of the entry_d argument.

alloca()

This function doesn't set errno; if there isn't enough memory, it simply returns NULL.

alphasort()

We've corrected the synopsis.

atexit()

We've corrected the synopsis.

bindresvport()

You need to include <rpc/rpc.h>.

calloc(), malloc(), realloc()

These functions set errno only if an error occurred.

ConnectClientInfoAble()

This function sets the flags member of the _client_able structure for an ability to 1 if the client has the ability, or 0 if it doesn't. If the client doesn't have all the indicated abilities, this function sets the _NTO_CI_UNABLE bit in the flags member of the _client_info structure.

delay()

This function doesn't set errno.

_exit(), exit()

We corrected the name of EXIT_SUCCESS.

fcloseall()

This function closes all open streams, including stdin, stdout, and stderr.

fflush()

This function ignores streams that aren't writeable.

fgets()

The second argument is of type int.

fork()

We've corrected the list of what the child process inherits from its parent.

fs_crypto_domain_remove()

The domain doesn't need to be unlocked for you to remove it.

getnameinfo()

NI_WITHSCOPEID is no longer used by this function.

getpagesizes()

We've corrected the example.

getpwnam_r()

We've corrected the synopsis.

inet_lnaof(), inet_makeaddr(), inet_netof(), inet_network()

We've corrected the synopsis of these functions.

INET6

You can't specify an address of :: in a call to connect() or sendto() to mean the local host.

InterruptAttach()

We've corrected the caveat about multithreaded resource managers.

InterruptHookTrace()

There are currently no flags that apply to this function.

ioctl()

• The SIOCDARP, SIOCGARP, and SIOCSARP commands aren't implemented.
• We've removed the obsolete OSIOCGIFADDR, OSIOCGIFBRDADDR, OSIOCGIFCONF, OSIOCGIFDSTADDR, and OSIOCGIFNETMASK commands. Use the commands without the leading O instead.

iofunc_acl()

We corrected the name of _IO_ACL.

iofunc_client_info_able()

This function sets the flags member of the _client_able structure for an ability to 1 if the client has the ability, or 0 if it doesn't. If the client doesn't have all the indicated abilities, this function sets the _NTO_CI_UNABLE bit in the flags member of the _client_info structure.

iofunc_devctl(), iofunc_devctl_default()

These functions return _RESMGR_DEFAULT if they don't recognize the given command, so that your resource manager can then handle the command. If you don't process the command, the client library's devctl() routine returns ENOTTY.

iofunc_mmap()

We've corrected the method to use to determine whether or not the version of procnto you're talking to supports the required_prot member of the io_mmap_t structure.

iofunc_space_verify()

We corrected the list of errors.

iofunc_write_default()

This function indicates that it wrote the requested number of bytes, not zero bytes.

IPv6

Use the IPV6_V6ONLY socket option to make AF_INET6 wildcard listening sockets accept IP6 traffic only.

lfind(), lsearch()

We've corrected the synopsis.

lstat(), lstat64()

You can safely call these functions in a multithreaded process.

mallopt()

The nondebug version of this function is now declared in <malloc.h>. The <rcheck/malloc.h> file includes additional commands and settings for the debug version.

mbrlen(), mbrtowc(), mbsrtowcs()

These functions are to use in a multithreaded program if the ps argument isn't NULL.

mbrtowc(), mbsrtowcs(), mbstowcs(), mbtowc()

This functions are affected by LC_CTYPE.

mmap()

• We've corrected the flags in the example of allocating a physically contiguous DMA buffer for a bus-mastering PCI network card. They should be MAP_SHARED | MAP_PHYS | MAP_ANON.
• If you set MAP_LAZY, and there's no system memory at the time of the access, the thread gets a SIGBUS with a code of BUS_OBJERR, not BUS_ADRERR.

modem_read()

This function returns 0 if successful, or -1 if an error occurred. If the buffer isn't large enough, modem_read() discards any incoming characters that won't fit in it. It terminates the string in buf with a null character.

MsgCurrent_r()

This function returns 0 on success; if an error occurs, it returns a value from the Errors section.

MsgSend*()

We've corrected the description of the coid argument.

MsgSendPulse()

You can send a pulse to a process if the sending process's real or effective user ID matches the real or effective user ID of the receiving process, or if the calling process has the PROCMGR_AID_CONNECTION ability enabled.

posix_fadvise(), posix_fallocate()

These functions give an error of EINVAL if the len argument is less than zero; they succeed if len is zero.

posix_spawn()

We've corrected the description of SPAWN_CHECK_SCRIPT.

procmgr_daemon()

This function sets errno if an error occurs.

procmgr_timer_tolerance()

A process's default tolerance is used when calculating timer tolerance if the timer has neither a specific tolerance nor the TIMER_PRECISE flag set.

pthread_join(), pthread_timedjoin(), pthread_timedjoin_monotonic()

We've corrected the list of error codes that these functions return.

pthread_mutexattr_settype()

In QNX Neutrino, PTHREAD_MUTEX_DEFAULT mutexes are treated in the same way as PTHREAD_MUTEX_ERRORCHECK.

readblock()

• Zero is a valid value for the block argument; we've corrected the description for EINVAL.
• We've corrected the list of error values.

resmgr_attach()

We corrected the name of _FTYPE_ALL.

rsrcdbmgr_create()

RSRCMGR_IRQ isn't supported as an alternative to RSRCDBMGR_IRQ.

scandir()

We've corrected the synopsis and description.

sigaction(), signal()

These functions don't rely on any process manager abilities.

slogb(), slogf()

These functions don't associate a special meaning with EINVAL.

spawn()

• We've corrected the name of SPAWN_FDCLOSED.
• We've corrected the description of SPAWN_CHECK_SCRIPT.

sysmgr_reboot()

If an error occurs, this function returns -1 and sets errno.

telldir()

You can safely call this function in a multithreaded process.

timer_getexpstatus(), timer_getoverrun(), timer_gettime()

Your program doesn't need any process manager abilities in order to use these functions.

TimerInfo()

• We corrected the name of _NTO_TIMER_RESET_OVERRUNS.
• Your process must have the PROCMGR_AID_TIMER ability enabled only if you're trying to get information about the timers for a process belonging to a different user and you're using the _NTO_TIMER_RESET_OVERRUNS flag.
• The itime and otime members of the _timer_info structure are of type struct _itimer, not struct itimerspec.

trace_logf(), trace_nlogf(), trace_vnlogf()

These functions return the number of bytes written in the log, including the terminating null character, or -1 if an error occurred.

TraceEvent()

The addr argument for _NTO_TRACE_SETBUFFER is of type paddr64_t *, not paddr64_t. The type of the tid argument for _NTO_TRACE_SETCLASSTID and _NTO_TRACE_SETEVENTTID is uint32_t.

traceparser_cs()

We've corrected the description of the arguments to the callback function.

traceparser_get_info()

We corrected the name of _TRACE_HEADER_KEYWORDS.

ualarm()

If the interval argument is nonzero, the alarm is repeated every interval microseconds.

wait3(), wait4()

You need to include <sys/resource.h> in your source.

wcrtomb(), wcsrtombs()

These functions are safe to use in a multithreaded program if the ps argument isn't NULL.

wcstoimax(), wcstoumax(), wcstol(), wcstoll(), wcstoul(), wcstoull()

We've corrected the description of what these functions return.

wctomb()

This function isn't safe for you to use in a multithreaded program.

writeblock()

• Zero is a valid value for the block argument; we've corrected the description for EINVAL.
• We've corrected the list of error values.