run-with-startup-time

Manual Reference Pages - RUN-WITH-STARTUP-TIME (1)


NAME

run-with-startup-time - run Maemo applications under libstartup

CONTENTS

Synopsis
Description
Examples
Files
See Also
Copyright

SYNOPSIS

run-with-startup-time binary arguments

DESCRIPTION

run-with-startup-time is a helper script for the libstartup wrapper library, which can be used to track GTK application startup time. The script runs given binary (with its arguments) under libstartup using suitable options for the Maemo environment. For example maemo-launched applications are run with maemo-summoner.

Normally script uses just LD_PRELOAD to run the application under libstartup, but that doesn't work with Scratchbox. Inside Scratchbox the script needs to temporarily modify /etc/ld.so.preload file instead when starting the application.

EXAMPLES

There are a few ways to use this script:

o If the binary is using "maemo-launcher", this script can be linked to the binary name instead of the "maemo-invoker" and the script will automatically call "maemo-summoner" as needed.

o Call the binary directly with this script, e.g. like this:
DISPLAY=:1 run-standalone.sh run-with-startup-time <binary> <arguments>

o Rename the original binary to <name>.real and put/link this script in place of the original binary.

Some environmental variables can be also be set before calling the script to tweak the behaviour of the libstartup. They are supported by libstartup itself, so they can also be used without the helper script. The following variables are supported:

STARTUP_LOG_DIR
  When set, defines the directory where logs are written. Otherwise working directory is used.
STARTUP_LOG_FILE
  When set, defines an explicit path for logs (including the filename). When not set, the log path will be <$STARTUP_LOG_DIR>/<appname>--<pid>.startup
STARTUP_WRITE_LOG
  If set to 'yes' and the program reaches gtk idle state, the full startup log will be written. When set to 'force', the startup log will be written also for non-GTK applications.
STARTUP_IDLE_QUIT
  When set, gtk_main_quit() will be called when idle state is reached by the application. Useful for batch testing several runs / applications.

These environmental variables and other libstartup details not unique to this helper script are explained in greater detail at the provided README.

FILES

/etc/ld.so.preload
 

/src/libstartup.conf If this file exists, it is checked for assigned values to the aforementioned environmental variables

SEE ALSO

maemo-summoner(1), ld.so(8)

COPYRIGHT

Copyright (C) 2007 Nokia Corporation.

This is free software. You may redistribute copies of it under the terms of the GNU General Public License v2 included with the software. There is NO WARRANTY, to the extent permitted by law.



Improve this page