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.

Note: You must be logged in as root in order to set a value.

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).

See also:

getconf, setconf

confstr(), pathconf(), sysconf() in the Library Reference

“Configuration strings” in the Configuring Your Environment chapter of the Neutrino User's Guide