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.

---

Photon must be running for this utility to work.

---

---

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:

The window looks like this:

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:

• /usr/photon/keyboard/uc_keyboard_t
• /usr/photon/translations/uc_language_t
• /etc/timezone/uc_tz_t

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

The country you're in, based on your selection of the time zone.

/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