confstr

Get or set a configuration string

Syntax:

confstr [name [value]]

Runs on:

QNX Neutrino

Options:

None.

Description:

This utility gets or sets the value of a configuration string. If given, the name must be one of the following (in lower- or uppercase):

architecture
The name of the instruction set architecture for this node's CPU(s).
domain
The domain name.
hostname
The name of this node in the network.
Note: A hostname can consist only of letters, numbers, and hyphens, and must not start or end with a hyphen. For more information, see RFC 952.
hwprovider
The name of the hardware manufacturer.
hwserial
Serial number associated with the hardware.
libpath
A value similar to the LD_LIBRARY_PATH environment variable that finds all standard libraries.
machine
This node's hardware type.
path
A value similar to the PATH environment variable that finds all standard utilities.
release
The current OS release level.
resolve
The contents of the resolv.conf file, excluding the domain name.
srpc_domain
The secure RPC domain.
sysname
The operating system name.
version
The current OS version number.
Note: Although these names are similar to the _CS_* names accepted by confstr(), getconf, and setconf, this utility requires that you specify the names as given above.

If you don't specify a name, confstr displays the current value of all configuration strings.

To set the value of the configuration string, specify a value on the command line.

You can create a symbolic link to confstr that corresponds to one of the possible names (e.g., in the /bin directory, run ln -s confstr domain), and you can then use the symlink to set or get that name value (e.g., domain to get the domain, or domain mydomain to set the domain).

Abilities:

When you use the confstr utility to set the value of the configuration string, it may require the PROCMGR_AID_CONFSET ability.

Use secpolmonitor to determine which abilities confstr is using on your specific system.

For more information on abilities, see procmgr_ability() in the C Library Reference.