Caution: This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

phlocale

Localization utility (timezone, language, keyboard)

Syntax:

phlocale [options]

Runs on:

Neutrino

Options:

-h height[%]
The height of the window, in pixels, or as a percentage of the screen height if % is specified.
-S i|m|n
The initial state of the User's Configuration window (iconified, maximized, or normal).
-s server_name
The name of the Photon server:
If server_name is: This server is used:
node_path node_path/dev/photon
fullpath fullpath
relative_path /dev/relative_path
-t
Start on Time & Date tab window.
-w width[%]
The width of the window, in pixels, or as a percentage of the screen width if % is specified.
-x position[%][r]
The x coordinate of the upper-left corner of the window, in pixels, or as a percentage of screen width if % is specified. If r is specified, the coordinate is relative to the current console.
-y position[%][r]
The y coordinate of the upper-left corner of the window, in pixels, or as a percentage of screen height if % is specified. If r is specified, the coordinate is relative to the current console.

Description:

This application is used to set/modify the user localization information such as the timezone, language and keyboard.


Note: Photon must be running for this utility to work.


Note: This utility needs to have the setuid ("set user ID") bit set in its permissions. If you use mkefs, mketfs, or mkifs on a Windows host to include this utility in an image, use the perms attribute to specify its permissions explicitly, and the uid and gid attributes to set the ownership correctly.

You can start phlocale from the command line, or by clicking on the Localization icon in the shelf:

Localization icon

The window looks like this:


Localization utility


Localizing your configuration with phlocale.

The changes (except for the language selection) go into effect when you click on the Apply or OK button. Any language change takes effect the next time the user logs into the system.

Files:

The following files are databases of the choices for keyboards, timezones, and languages:

The phlocale utility creates (if the file doesn't exist yet) and modifies the following files:

${HOME}/.ph/uc_local_t
The main user configuration file.
/etc/TIMEZONE
Timezone (TZ) information.
${HOME}/.ph/.ABLANG
The selected PhAB language identifier.
/etc/system/trap/.KEYBOARD.host_name
The keyboard file_name is inserted, so that the correct keyboard definition file is used.

See also:

date, rtc

Using the Photon microGUI and Configuring Your Environment in the Neutrino User's Guide