Network Manager (net_pps)

Updated: April 19, 2023

PPS interface to QNX network manager

Syntax:

net_pps [-a] [-c file] [-n] [-S uid] [-u] if0 [...ifN]
        [-r domain if0 [...ifN]]* &

Runs on:

QNX Neutrino

Options:

-a
Automatically configure any discovered interfaces when the link state indicates that the interfaces are connected.
-c file
Specify the configuration file to use (default: /etc/net_pps.conf). This file stores persistent net_pps settings so the service can be configured identically whenever it's launched at startup, which ensures that the QNX network manager behavior stays the same. Generally, you don't need to modify the default Networking Middleware configuration file or use this option to name another file unless you really need to customize networking behavior.
-n
Set dhclient options based on version 4.1-ESV-R13 or later. If used, this argument must be first in the options list.
-r domain if0 [...ifN]
Create a routing domain called domain that contains the interfaces listed just after this option. You must specify at least one interface. The interface list is specified the same way and has the same meaning (except that it applies to the specified domain instead of the default one) as the if0 [...ifN] option described below.

You can specify multiple -r options. The allowed domain names are tethering and cellular.

-S uid
Run subprocesses as this uid.
-u
Assume the interface is connected based on its up state. This allows shim drivers and drivers that don't issue link state changes to work.
if0 [...ifN]
Specify the prioritized list of interfaces to be placed in the default routing domain. These will be considered for multihomed operation, preference of default routes, confstr resolver configuration, etc.
Note: This list is mandatory and must be provided before any -r options.

Description:

The net_pps service offers a PPS interface for communicating with the QNX network manager service, which implements the TCP/IP stack. The Network Manager component in the Networking Middleware C API interacts with this service through numerous PPS objects. Because client applications are meant to use the C API and no longer talk directly to net_pps through the PPS objects, these objects aren't documented. However, for the C API calls to have any effect, you must launch this service during system startup.

The net_pps service launches the DHCP client, dhclient, and uses it to request IP addresses from the Wi-Fi access point (server) when configuring station (i.e., client) interfaces.

For information about QNX support for networking, see Networking Architecture in the System Architecture guide.