[Pkg-haskell-commits] darcs: threadscope: Initial packaging of threadscope
Ernesto Hernández-Novich (USB)
emhn at usb.ve
Tue Jun 29 00:09:54 UTC 2010
Tue Jun 29 00:04:20 UTC 2010 Ernesto Hern[_\c3_][_\a1_]ndez-Novich (USB) <emhn at usb.ve>
* Initial packaging of threadscope
Ignore-this: 8ceee7c75a8d1ec80e1212be80ea6e96
A ./README.Debian
A ./changelog
A ./compat
A ./control
A ./copyright
A ./rules
A ./source/
A ./source/format
A ./threadscope.desktop
A ./threadscope.install
A ./threadscope.menu
A ./watch
Tue Jun 29 00:04:20 UTC 2010 Ernesto Hernández-Novich (USB) <emhn at usb.ve>
* Initial packaging of threadscope
Ignore-this: 8ceee7c75a8d1ec80e1212be80ea6e96
diff -rN -u old-threadscope/changelog new-threadscope/changelog
--- old-threadscope/changelog 1970-01-01 00:00:00.000000000 +0000
+++ new-threadscope/changelog 2010-06-29 00:09:54.422998322 +0000
@@ -0,0 +1,7 @@
+threadscope (0.1.2-1) UNRELEASED; urgency=low
+
+ TODO: write man page based on README.Debian
+
+ * Initial release (Closes: 587483).
+
+ -- Ernesto Hernández-Novich (USB) <emhn at usb.ve> Mon, 28 Jun 2010 19:08:46 -0430
diff -rN -u old-threadscope/compat new-threadscope/compat
--- old-threadscope/compat 1970-01-01 00:00:00.000000000 +0000
+++ new-threadscope/compat 2010-06-29 00:09:54.422998322 +0000
@@ -0,0 +1 @@
+7
diff -rN -u old-threadscope/control new-threadscope/control
--- old-threadscope/control 1970-01-01 00:00:00.000000000 +0000
+++ new-threadscope/control 2010-06-29 00:09:54.422998322 +0000
@@ -0,0 +1,33 @@
+Source: threadscope
+Section: haskell
+Priority: extra
+Maintainer: Debian Haskell Group <pkg-haskell-maintainers at lists.alioth.debian.org>
+Uploaders: Ernesto Hernández-Novich (USB) <emhn at usb.ve>
+Build-Depends: debhelper (>= 7), cdbs, haskell-devscripts (>= 0.7),
+ ghc6,
+ libghc6-mtl-dev,
+ libghc6-binary-dev,
+ libghc6-ghc-events-dev,
+ libghc6-cairo-dev,
+ libghc6-gtk-dev,
+ libghc6-glade-dev
+Build-Depends-Indep: ghc6-doc
+Standards-Version: 3.8.4
+Homepage: http://hackage.haskell.org/package/threadscope
+Vcs-Darcs: http://darcs.debian.org/pkg-haskell/haskell-threadscope
+Vcs-Browser: http://darcs.debian.org/cgi-bin/darcsweb.cgi?r=haskell/haskell-threadscope
+
+Package: threadscope
+Architecture: any
+Depends: ${shlibs:Depends}, ${misc:Depends}
+Provides: ${haskell:Provides}
+Description: a graphical thread profiler for Haskell programs
+ Threadscope is a graphical thread profiler for Haskell programs.
+ It parses and displays the content of .eventlog files emitted by the
+ GHC 6.12.1 and later runtimes, showing a timeline of spark creation,
+ spark-to-thread promotions and garbage collections.
+ .
+ This helps debugging the parallel performance of Haskell programs,
+ making easier to check that work is well balanced across the available
+ processors and spot performance issues relating to garbage collection
+ or poor load balancing.
diff -rN -u old-threadscope/copyright new-threadscope/copyright
--- old-threadscope/copyright 1970-01-01 00:00:00.000000000 +0000
+++ new-threadscope/copyright 2010-06-29 00:09:54.422998322 +0000
@@ -0,0 +1,57 @@
+Format-Specification: http://svn.debian.org/wsvn/dep/web/deps/dep5.mdwn?op=file&rev=135
+Name: threadscope
+Maintainer: Satnam Singh <s.singh at ieee.org>
+Source: http://hackage.haskell.org/packages/archive/threadscope
+
+Files: *
+Copyright: 2009-2010, Simon Marlow <marlowsd at gmail.com>,
+ Donnie Jones <donnie at darthik.com>,
+ Satnam Singh <s.singh at ieee.org>
+License: Glasgow Haskell Compiler License
+
+Files: debian/*
+Copyright: 2010, Ernesto Hernández-Novich (USB) <emhn at usb.ve>
+License: GPL-3+
+
+License: Glasgow Haskell Compiler License
+ The Glasgow Haskell Compiler License
+ .
+ Copyright 2002, The University Court of the University of Glasgow.
+ All rights reserved.
+ .
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ .
+ Redistributions of source code must retain the above copyright notice,
+ this list of conditions and the following disclaimer.
+ .
+ Redistributions in binary form must reproduce the above copyright notice,
+ this list of conditions and the following disclaimer in the documentation
+ and/or other materials provided with the distribution.
+ .
+ Neither name of the University nor the names of its contributors may be
+ used to endorse or promote products derived from this software without
+ specific prior written permission.
+ .
+ THIS SOFTWARE IS PROVIDED BY THE UNIVERSITY COURT OF THE UNIVERSITY OF
+ GLASGOW AND THE CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
+ INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
+ FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
+ UNIVERSITY COURT OF THE UNIVERSITY OF GLASGOW OR THE CONTRIBUTORS BE LIABLE
+ FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+ SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+ CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+ LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+ OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
+ DAMAGE.
+
+License: GPL-3+
+ This program is free software; you can redistribute it and/or modify
+ it under the terms of the GNU General Public License as published by
+ the Free Software Foundation; either version 3 of the License, or
+ (at your option) any later version.
+ .
+ On Debian GNU/Linux systems, the complete text of the GNU General
+ Public License can be found in `/usr/share/common-licenses/GPL-3'
diff -rN -u old-threadscope/README.Debian new-threadscope/README.Debian
--- old-threadscope/README.Debian 1970-01-01 00:00:00.000000000 +0000
+++ new-threadscope/README.Debian 2010-06-29 00:09:54.422998322 +0000
@@ -0,0 +1,56 @@
+Using Threadscope
+-----------------
+
+In order for threadscope to be useful, you have to compile your
+Haskell program to use the threaded run-time and also to create
+runtime profile logs, e.g.
+
+$ ghc -threaded -eventlog --make Foo.hs -o foo
+
+Once the program is built, execute it using the multithreaded
+run-time, specifying the number of cores to use in the usual
+manner, but also requesting the creation of an event log, e.g.
+for two cores (actually Haskell Execution Contexts, or HEC)
+and event log creation you'd use
+
+$ foo +RTS -N2 -ls -RTS ...
+
+Once the program runs to completion, a file named foo.eventlog
+is produced.
+
+You can start threadscope from the command line, using the
+aforementioned .eventlog file as the sole argument, e.g.
+
+$ threadscope foo.eventlog
+
+or you can start threadscope from the desktop menus and use its
+file browsing capabilites to find and open foo.eventlog.
+
+Once opened, you'll see that threadscope:
+
+* Displays the activity on each Haskell Execution Context (HEC)
+ which roughly corresponds to an operating system thread. For
+ each thread you can see whether it is running a Haskell thread
+ or performing garbage collection.
+
+* You can find out information about when Haskell threads are
+ ready to run and information about why a Haskell thread was
+ suspended.
+
+* You can observe how threads migrate between HECs and you can
+ observe sparks being picked up for speculative execution.
+
+* An activity profile indicates the rough utilization of the HECs
+ and when the number of HECs are greater than the number of
+ processing cores this gives a rough guide to the overall
+ utilization.
+
+* You can place bookmarks at various points in the time profile
+ to help with navigation.
+
+* You can save the graphical reports to PNG or PDF files.
+
+Have fun!
+--
+Ernesto Hernández-Novich (USB) <emhn at usb.ve>
+Mon, 28 Jun 2010 19:26:47 -0430
diff -rN -u old-threadscope/rules new-threadscope/rules
--- old-threadscope/rules 1970-01-01 00:00:00.000000000 +0000
+++ new-threadscope/rules 2010-06-29 00:09:54.418998107 +0000
@@ -0,0 +1,7 @@
+#!/usr/bin/make -f
+
+include /usr/share/cdbs/1/rules/debhelper.mk
+include /usr/share/cdbs/1/class/hlibrary.mk
+
+build/$(CABAL_PACKAGE) :: build-ghc6-stamp
+
diff -rN -u old-threadscope/source/format new-threadscope/source/format
--- old-threadscope/source/format 1970-01-01 00:00:00.000000000 +0000
+++ new-threadscope/source/format 2010-06-29 00:09:54.418998107 +0000
@@ -0,0 +1 @@
+3.0 (quilt)
diff -rN -u old-threadscope/threadscope.desktop new-threadscope/threadscope.desktop
--- old-threadscope/threadscope.desktop 1970-01-01 00:00:00.000000000 +0000
+++ new-threadscope/threadscope.desktop 2010-06-29 00:09:54.418998107 +0000
@@ -0,0 +1,13 @@
+[Desktop Entry]
+Version=1.0
+Encoding=UTF-8
+Name=threadscope
+Icon=/usr/share/threadscope-0.1.2/threadscope.png
+Comment=Haskell GHC thread profiler
+Exec=/usr/bin/threadscope
+Terminal=false
+Type=Application
+Categories=Application;Development;
+MimeType=application/x-threadscope;
+Name[es]=threadscope
+Comment[es]=Perfilador de hilos para Haskell GHC
diff -rN -u old-threadscope/threadscope.install new-threadscope/threadscope.install
--- old-threadscope/threadscope.install 1970-01-01 00:00:00.000000000 +0000
+++ new-threadscope/threadscope.install 2010-06-29 00:09:54.418998107 +0000
@@ -0,0 +1,4 @@
+dist-ghc6/build/threadscope/threadscope usr/bin/
+threadscope.glade usr/share/threadscope-0.1.2/
+threadscope.png usr/share/threadscope-0.1.2/
+debian/threadscope.desktop usr/share/applications/
diff -rN -u old-threadscope/threadscope.menu new-threadscope/threadscope.menu
--- old-threadscope/threadscope.menu 1970-01-01 00:00:00.000000000 +0000
+++ new-threadscope/threadscope.menu 2010-06-29 00:09:54.418998107 +0000
@@ -0,0 +1,6 @@
+?package(threadscope): needs="X11" section="Applications/Programming" \
+ title="Threadscope" \
+ longtitle="Haskell GHC thread profiler" \
+ description="Haskell GHC thread profiler tool." \
+ command="/usr/bin/threadscope" \
+ icon="/usr/share/threadscope-0.1.2/threadscope.png"
diff -rN -u old-threadscope/watch new-threadscope/watch
--- old-threadscope/watch 1970-01-01 00:00:00.000000000 +0000
+++ new-threadscope/watch 2010-06-29 00:09:54.418998107 +0000
@@ -0,0 +1,7 @@
+# See uscan(1) for format
+
+version=3
+opts="downloadurlmangle=s|archive/([\w\d_-]+)/([\d\.]+)/|archive/$1/$2/$1-$2.tar.gz|,\
+filenamemangle=s|(.*)/$|threadscope-$1.tar.gz|" \
+ http://hackage.haskell.org/packages/archive/threadscope \
+ ([\d\.]*\d)/
More information about the Pkg-haskell-commits
mailing list