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