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.

---

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.

---

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