run-with-mallinfo

Manual Reference Pages - RUN-WITH-MALLINFO (1)


NAME

run-with-mallinfo - run Maemo applications under mallinfo

CONTENTS

Synopsis
Description
Examples
Files
See Also
Copyright

SYNOPSIS

run-with-mallinfo binary arguments

DESCRIPTION

run-with-mallinfo is a helper script for the mallinfo wrapper library. Mallinfo reports application memory usage (according to Glibc mallopt()) at given intervals or when requested with SIGUSR1.

The script runs given binary (with its arguments) under mallinfo 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 mallinfo, 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.

The produced mallinfo reports will appear at $HOME/mallinfo-PID.trace.

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:
export MALLINFO= yes DISPLAY=:1
run-standalone.sh run-with-mallinfo <binary> <arguments>

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

FILES

/etc/ld.so.preload

SEE ALSO

maemo-summoner(1)

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