About This Guide

The QNX PPS Developer's Guide includes:

QNX PPS Service — an introduction to the QNX Persistent Publish/Subscribe service, and how to run it
Objects and their Attributes — a description of the PPS service's objects and their attributes
Persistence — How PPS manages persistence
Publishing — how to publish to PPS
Subscribing — how to subscribe to PPS
Options and Qualifiers — pathname open options, and object and attribute qualifiers
ppsparse() — a PPS API function that parses an object read from PPS

Typographical conventions

Throughout this manual, we use certain typographical conventions todistinguish technical terms. In general, the conventions we useconform to those found in IEEE POSIX publications. The following tablesummarizes our conventions:

Reference	Example
Code examples	`if( stream == NULL )`
Command options	`-lR`
Commands	`make`
Environment variables	PATH
File and pathnames	`/dev/null`
Function names	exit()
Keyboard chords	Ctrl-Alt-Delete
Keyboard input	`something you type`
Keyboard keys	Enter
Program output	`login:`
Programming constants	NULL
Programming data types	`unsigned short`
Programming literals	`0xFF`, `"message string"`
Variable names	stdin
User-interface components	Cancel

We use an arrow (→) in directions for accessing menuitems, like this:

You'll find the Other... menu item underPerspective-->Show View.

We use notes, cautions, and warnings to highlight importantmessages:

Notes point out something important or useful.

Cautions tell you about commands or procedures that may haveunwanted or undesirable side effects.

Warnings tell you about commands or procedures that could bedangerous to your files, your hardware, or even yourself.

Note to Windows users

In our documentation, we use a forward slash(/) as a delimiter in all pathnames,including those pointing to Windows files.

We also generally follow POSIX/UNIX filesystem conventions.

Navigation buttons

At the top and bottom of our HTML docs, you'll see some or all of thesebuttons:

Use this button:	To move:
	To the previous part of the document.
	“Up” in the document: In a prose book, this typically takes you to About This Guide. In a reference book, it takes you to the listing of items that start with a given letter. For example, if you're looking at the docs for abs(), this button takes you to the listing of the functions that start with `A`.
	To the keyword index.
	To the next part of the document.

Technical support options

To obtain technical support for any QNX product, visit theSupport areaon our website (www.qnx.com).You'll find a wide range of support options, including community forums.