Running PPS

Updated: May 06, 2022

The PPS service can be run from the command line with the options listed below.

Syntax:

pps [options]

Options:

-A path
(QNX Neutrino 6.6 or later) Set the path to an Access Control List (ACL) configuration file. You can use more than one instance of this option. In the event of contradictory permissions, the permissions in the last configuration file listed take precedence. See Access Control List configuration file.”
-a num
(QNX Neutrino 7.0 or later) The maximum number of open file handles allowed for the .all objects. The default and minimum value is 32.
-b
Don't run in the background. Useful for debugging.
-C
(QNX Neutrino 6.6 or later) Convert between root and non-root persistence formats, to correspond to the -U option.
-D dir
(QNX Neutrino 7.0 or later) Specify the directory to put core files in. The default is none.
-d backlog
Specify the default delta backlog, in kilobytes. The default is 256 bytes.
-g
(QNX Neutrino 7.0 or later) Enable debugging output. Additional -g options increase the level of the output.
-l argument
(“el”) Set the object load behavior, as follows:
  • 0 — load directory names and objects on demand. Default.
  • 1 — load all directory and object names on startup, but don't load the object contents. Load the object contents on demand.
  • 2 — load directories, objects, and object contents on startup.
-m mount
Specify the mountpath for PPS. The default is /pps/.
-P priority
(QNX Neutrino 6.6 or later) Specify the priority of the persistence thread. The default is 10.
-p path
Set the path for backing up the persistent storage. The default is /var/pps.
-T tolerance
(QNX Neutrino 6.6 or later) The periodic persistence flush interval tolerance, in milliseconds. The default is off.
-t period
Specify the periodicity of the forced persistence, in milliseconds. For example, -t 5000 forces the PPS service to write to persistent storage every five seconds. The default is no forced persistence.
-U uid[:gid[,sup_gid]*]
(QNX Neutrino 6.6 or later) Once running, run as the specified user (and optionally groups), so that the program doesn't need to run as root.
-v
Enable verbose mode. Increase the number of “v”s to increase verbosity.