Olpc-utils: Difference between revisions

Latest revision as of 02:37, 21 October 2014

olpc-utils is a collection of OLPC-specific utilities and configurations.

Source:

Current maintainer: James Cameron

Questions and contributions should be sent to the devel mailing list.

@@ Line 1: / Line 1: @@
+'''olpc-utils''' is a collection of OLPC-specific utilities and configurations.
-== olpc-utils localization and configuration subsystem ==
+Source:
-The current configuration scheme is implemented in olpc-utils
+* git://dev.laptop.org/projects/olpc-utils
-(before, it was scattered through initscripts, sugar and pilgrim).
+* http://dev.laptop.org/git/projects/olpc-utils
+* http://dev.laptop.org/pub/source/olpc-utils/
+Current maintainer: [[User:Quozl|James Cameron]]
-We strive to minimize the number of system files we write to,
-and keep our deviations from Linux as backwards compatible
-as possible.  User controlled files are kept in /home/olpc, so
-they get automatically preserved on updates.
+Questions and contributions should be sent to the devel [[Mailing lists|mailing list]].
-=== Configuration files ===
+== Contents ==
+=== olpc-configure ===
-; <tt>/home/olpc/.i18n</tt>: Contains the LANG tag for the olpc user session
+Runs early at system boot to do some OLPC-specific initializations and the first-boot configuration.
-; <tt>/etc/sysconfig/i18n</tt>: Used only for the system startup scripts and daemons. Should always contain <tt>LANG=C</tt> for performance reasons.
-; <tt>/etc/sysconfig/keyboard</tt>: Contains the keyboard configuration for X11 (XKB) and for the Linux console.  Can be overridden per-user by creating a file named <tt>/home/olpc/.kbd</tt>.
-=== /etc/init.d/olpc-configure ===
-Runs early at system boot to do some OLPC-specific
-initializations and the first-boot configuration.
 The first-boot configuration is conditionalized on the <tt>/home/olpc/.olpc-configured</tt> flag.
@@ Line 28: / Line 20: @@
 olpc-configure writes language and keyboard settings to <tt>/home/olpc/.i18n</tt>, overridable by users.
+<tt>/etc/sysconfig/keyboard</tt> is programmed with keyboard information from the manufacturing data. We preferably specify XKB keyboards with the <tt>layout(variant)</tt> syntax because it's more intuitive when you have two or multiple layouts.  The separate layout and variant syntax is still supported.
-<tt>/etc/sysconfig/i18n</tt> is only used by initscripts, and
-should contain LANG=C for improved performance (cuts 5-6 seconds from the boot).
+=== /usr/share/olpc-utils/xorg.conf.d ===
-We preferably specify XKB keyboards with the <tt>layout(variant)</tt>
-syntax because it's more intuitive when you have two or multiple
-layouts.  The separate layout and variant syntax is still supported.
+This directory contains X configuration files for the various XO laptop models, and sisusbvga output.
-For MP machines, we set the keyboard directly from mfg data,
-without a hardcoded table to map mfg tags to XKB layout names.
+olpc-configure maintains hardlinks to these files in /etc/xorg.conf.d, dynamically configured on each boot.
-The Linux console keyboard is still not being set accordingly.
-Not sure if we really want to do it.  Power users can run loadkeys
-themselves if they really want to.
+It is our hope that these configurations shrink with time to the point where they can just exist as one static file.
-=== /etc/X11/xorg.conf ===
+=== /usr/sbin/olpc-dm ===
-xorg.conf is now a symlink created by olpc-configure,
-pointing to one of two possible fixed configuration files,
-that don't need exceptional handling for the update process.
-We still handle some differences between Geode+DCON and
-emulators.  I'd like to get X to autodetect these things
-better so we could kill off the configuration files altogether.
-We're currently missing a way to allow user customizations in
-xorg.conf.  In the future, we could make olpc-dm check for
-<tt>/home/olpc/.xorg.conf</tt> and use it if present.
-On the other hand, customizing xorg.conf is for power users
-who may also want to customize other <tt>/etc</tt> entries.
-So if we really want to support these use cases, we'd be better
-off finding a generic way to preserve user customizations.
-=== /usr/bin/olpc-dm ===
-This is our ''display manager'', a streamlined equivalent of
-GDM or KDM.  So streamlined that it doesn't even have a UI.
-It could be extented to support multiple users, XDMCP and other
-fancy things.
-olpc-dm currently spawns the X server and the session through
-startx and xinit, but there are plans to make it do it directly.
-This will also allow us to do something smarter than SysVinit's
-once/respawn modes for restarting X.
-'''BUG''': olpc-dm still hogs the console and dies when you hit <tt>^C</tt>.
-The fix is not a one-liner, and it's not a critical bug, but
-we're planning to fix it some day.
+This is our ''display manager'', a streamlined equivalent of GDM or KDM.
 === /usr/bin/olpc-session ===
+This is responsible for launching the configured shell (Sugar/GNOME).
-This script replaces <tt>/home/olpc/.xinitrc</tt>.  It sources
-<tt>/home/olpc/.i18n</tt> for $LANG, $XKB_LAYOUT and, optionally,
-$XKB_VARIANT.
-The last action olpc-session does is spawning the Sugar shell.
-=== /home/olpc/.xsession ===
-This is an "extensibility hook" for customizing your session.
-It gets sourced near the end of <tt>/usr/bin/olpc-session</tt>.
-A default is provided as .xsession-example, with some tips
-you may want to review.
-This file also replaces the old <tt>/home/olpc/.sugar.debug</tt>
-== Related pages ==
-* [[Localization]]
-* [[XO_l10n]]
-[[Category:XO localization]]
+[[Category:XO startup]]

Olpc-utils: Difference between revisions

Latest revision as of 02:37, 21 October 2014

Contents

olpc-configure

/usr/share/olpc-utils/xorg.conf.d

/usr/sbin/olpc-dm

/usr/bin/olpc-session

Navigation menu

Search