DOCSLIB.ORG

The Glasgow Haskell Compiler User's Guide, Version 4.08

Total Page：16

File Type：pdf, Size：1020Kb

Download full-text PDF Read full-text
The Glasgow Haskell Compiler User's Guide, Version 4.08 The Glasgow Haskell Compiler User's Guide, Version 4.08 The GHC Team The Glasgow Haskell Compiler User's Guide, Version 4.08 by The GHC Team Table of Contents The Glasgow Haskell Compiler License ......................................................................................-999 1. Introduction to GHC .................................................................................................................-999 1.1. The (batch) compilation system components..................................................................-999 1.2. What really happens when I “compile” a Haskell program? ..........................................-999 1.3. Meta-information: Web sites, mailing lists, etc. .............................................................-999 1.4. GHC version numbering policy ......................................................................................-999 1.5. Release notes for version 4.08 (July 2000) ........................................................................13 1.5.1. User-visible compiler changes...............................................................................13 1.5.2. User-visible library changes ..................................................................................14 1.5.3. Internal changes.....................................................................................................14 2. Installing GHC..............................................................................................................................16 2.1. Installing on Unix-a-likes...................................................................................................16 2.1.1. When a platform-specific package is available .....................................................16 2.1.2. GHC binary distributions.......................................................................................16 2.1.2.1. Installing ...................................................................................................18 2.1.2.2. What bundles there are..............................................................................19 2.1.2.3. Testing that GHC seems to be working ....................................................20 2.2. Installing on Windows........................................................................................................20 2.2.1. Installing GHC.......................................................................................................21 2.2.2. Installing ghc-win32 FAQ .....................................................................................21 2.3. Building the documentation ...............................................................................................22 2.3.1. Installing the DocBook tools from RPMs .............................................................22 2.3.2. Installing DocBook on FreeBSD...........................................................................22 2.3.3. Installing from binaries on Windows ....................................................................22 2.3.4. Installing the DocBook tools from source.............................................................23 2.3.4.1. Jade ...........................................................................................................23 2.3.4.2. DocBook and the DocBook stylesheets....................................................23 2.3.5. Configuring the DocBook tools.............................................................................23 2.3.6. Remaining problems..............................................................................................23 3. Using GHC ....................................................................................................................................25 3.1. Overall command-line structure.........................................................................................25 3.2. Meaningful file suffixes......................................................................................................25 3.3. Help and verbosity options.................................................................................................26 3.4. Running the right phases in the right order........................................................................26 3.5. Re-directing the compilation output(s) ..............................................................................27 3.5.1. Saving GHC’s standard error output .....................................................................27 3.5.2. Redirecting temporary files ...................................................................................28 3.6. Warnings and sanity-checking ...........................................................................................28 3.7. Separate compilation..........................................................................................................30 3.7.1. Interface files .........................................................................................................30 3.7.2. Finding interface files ............................................................................................31 3 3.7.3. Other options related to interface files...................................................................32 3.7.4. The recompilation checker ....................................................................................32 3.7.4.1. Packages....................................................................................................33 3.7.5. Using make ...........................................................................................................34 3.7.6. Dependency generation .........................................................................................35 3.7.7. How to compile mutually recursive modules ........................................................37 3.8. Optimisation (code improvement) .....................................................................................38 3.8.1. -O*: convenient “packages” of optimisation flags. ...............................................38 3.8.2. -f*: platform-independent flags ...........................................................................39 3.8.3. -m*: platform-specific flags...................................................................................42 3.8.4. Code improvement by the C compiler...................................................................42 3.9. Options related to a particular phase..................................................................................42 3.9.1. The C pre-processor ..............................................................................................43 3.9.2. Options affecting the C compiler (if applicable)...................................................44 3.9.3. Linking and consistency-checking ........................................................................44 3.10. Using Concurrent Haskell................................................................................................46 3.11. Using Parallel Haskell......................................................................................................46 3.11.1. Dummy’s guide to using PVM............................................................................46 3.11.2. Parallelism profiles ..............................................................................................47 3.11.3. Other useful info about running parallel programs .............................................47 3.11.4. RTS options for Concurrent/Parallel Haskell ......................................................47 3.12. Running a compiled program...........................................................................................49 3.12.1. RTS options to control the garbage-collector......................................................49 3.12.2. RTS options for profiling and Concurrent/Parallel Haskell.................................51 3.12.3. RTS options for hackers, debuggers, and over-interested souls ..........................52 3.12.4. “Hooks” to change RTS behaviour......................................................................52 3.13. Debugging the compiler...................................................................................................55 3.13.1. Replacing the program for one or more phases...................................................55 3.13.2. Forcing options to a particular phase...................................................................55 3.13.3. Dumping out compiler intermediate structures ...................................................56 3.13.4. Checking for consistency.....................................................................................59 3.13.5. How to read Core syntax (from some -ddump-* flags) .....................................59 3.13.6. Command line options in source files .................................................................61 4. Profiling .........................................................................................................................................62 4.1. Cost centres and cost-centre stacks....................................................................................62 4.1.1. Inserting cost centres by hand ...............................................................................64 4.1.2. Rules for attributing costs......................................................................................65 4.2. Profiling memory usage .....................................................................................................65
Load more

Recommended publications
  • GHC Reading Guide
    GHC Reading Guide - Exploring entrances and mental models to the source code - Takenobu T. Rev. 0.01.1 WIP NOTE: - This is not an official document by the ghc development team. - Please refer to the official documents in detail. - Don't forget “semantics”. It's very important. - This is written for ghc 9.0. Contents Introduction 1. Compiler - Compilation pipeline - Each pipeline stages - Intermediate language syntax - Call graph 2. Runtime system 3. Core libraries Appendix References Introduction Introduction Official resources are here GHC source repository : The GHC Commentary (for developers) : https://gitlab.haskell.org/ghc/ghc https://gitlab.haskell.org/ghc/ghc/-/wikis/commentary GHC Documentation (for users) : * master HEAD https://ghc.gitlab.haskell.org/ghc/doc/ * latest major release https://downloads.haskell.org/~ghc/latest/docs/html/ * version specified https://downloads.haskell.org/~ghc/9.0.1/docs/html/ The User's Guide Core Libraries GHC API Introduction The GHC = Compiler + Runtime System (RTS) + Core Libraries Haskell source (.hs) GHC compiler RuntimeSystem Core Libraries object (.o) (libHsRts.o) (GHC.Base, ...) Linker Executable binary including the RTS (* static link case) Introduction Each division is located in the GHC source tree GHC source repository : https://gitlab.haskell.org/ghc/ghc compiler/ ... compiler sources rts/ ... runtime system sources libraries/ ... core library sources ghc/ ... compiler main includes/ ... include files testsuite/ ... test suites nofib/ ... performance tests mk/ ... build system hadrian/ ... hadrian build system docs/ ... documents : : 1. Compiler 1. Compiler Compilation pipeline 1. compiler The GHC compiler Haskell language GHC compiler Assembly language (native or llvm) 1. compiler GHC compiler comprises pipeline stages GHC compiler Haskell language Parser Renamer Type checker Desugarer Core to Core Core to STG STG to Cmm Assembly language Cmm to Asm (native or llvm) 1.
    [Show full text]
  • Dynamic Extension of Typed Functional Languages
    Dynamic Extension of Typed Functional Languages Don Stewart PhD Dissertation School of Computer Science and Engineering University of New South Wales 2010 Supervisor: Assoc. Prof. Manuel M. T. Chakravarty Co-supervisor: Dr. Gabriele Keller Abstract We present a solution to the problem of dynamic extension in statically typed functional languages with type erasure. The presented solution re- tains the benefits of static checking, including type safety, aggressive op- timizations, and native code compilation of components, while allowing extensibility of programs at runtime. Our approach is based on a framework for dynamic extension in a stat- ically typed setting, combining dynamic linking, runtime type checking, first class modules and code hot swapping. We show that this framework is sufficient to allow a broad class of dynamic extension capabilities in any statically typed functional language with type erasure semantics. Uniquely, we employ the full compile-time type system to perform run- time type checking of dynamic components, and emphasize the use of na- tive code extension to ensure that the performance benefits of static typing are retained in a dynamic environment. We also develop the concept of fully dynamic software architectures, where the static core is minimal and all code is hot swappable. Benefits of the approach include hot swappable code and sophisticated application extension via embedded domain specific languages. We instantiate the concepts of the framework via a full implementation in the Haskell programming language: providing rich mechanisms for dy- namic linking, loading, hot swapping, and runtime type checking in Haskell for the first time. We demonstrate the feasibility of this architecture through a number of novel applications: an extensible text editor; a plugin-based network chat bot; a simulator for polymer chemistry; and xmonad, an ex- tensible window manager.
    [Show full text]
  • What I Wish I Knew When Learning Haskell
    What I Wish I Knew When Learning Haskell Stephen Diehl 2 Version This is the fifth major draft of this document since 2009. All versions of this text are freely available onmywebsite: 1. HTML Version ­ http://dev.stephendiehl.com/hask/index.html 2. PDF Version ­ http://dev.stephendiehl.com/hask/tutorial.pdf 3. EPUB Version ­ http://dev.stephendiehl.com/hask/tutorial.epub 4. Kindle Version ­ http://dev.stephendiehl.com/hask/tutorial.mobi Pull requests are always accepted for fixes and additional content. The only way this document will stayupto date and accurate through the kindness of readers like you and community patches and pull requests on Github. https://github.com/sdiehl/wiwinwlh Publish Date: March 3, 2020 Git Commit: 77482103ff953a8f189a050c4271919846a56612 Author This text is authored by Stephen Diehl. 1. Web: www.stephendiehl.com 2. Twitter: https://twitter.com/smdiehl 3. Github: https://github.com/sdiehl Special thanks to Erik Aker for copyediting assistance. Copyright © 2009­2020 Stephen Diehl This code included in the text is dedicated to the public domain. You can copy, modify, distribute and perform thecode, even for commercial purposes, all without asking permission. You may distribute this text in its full form freely, but may not reauthor or sublicense this work. Any reproductions of major portions of the text must include attribution. The software is provided ”as is”, without warranty of any kind, express or implied, including But not limitedtothe warranties of merchantability, fitness for a particular purpose and noninfringement. In no event shall the authorsor copyright holders be liable for any claim, damages or other liability, whether in an action of contract, tort or otherwise, Arising from, out of or in connection with the software or the use or other dealings in the software.
    [Show full text]
  • The Glasgow Haskell Compiler User's Guide, Version 4.08
    The Glasgow Haskell Compiler User's Guide, Version 4.08 The GHC Team The Glasgow Haskell Compiler User's Guide, Version 4.08 by The GHC Team Table of Contents The Glasgow Haskell Compiler License ........................................................................................... 9 1. Introduction to GHC ....................................................................................................................10 1.1. The (batch) compilation system components.....................................................................10 1.2. What really happens when I “compile” a Haskell program? .............................................11 1.3. Meta-information: Web sites, mailing lists, etc. ................................................................11 1.4. GHC version numbering policy .........................................................................................12 1.5. Release notes for version 4.08 (July 2000) ........................................................................13 1.5.1. User-visible compiler changes...............................................................................13 1.5.2. User-visible library changes ..................................................................................14 1.5.3. Internal changes.....................................................................................................14 2. Installing from binary distributions............................................................................................16 2.1. Installing on Unix-a-likes...................................................................................................16
    [Show full text]
  • The Glorious Glasgow Haskell Compilation System User's Guide
    The Glorious Glasgow Haskell Compilation System User’s Guide, Version 7.8.2 i The Glorious Glasgow Haskell Compilation System User’s Guide, Version 7.8.2 The Glorious Glasgow Haskell Compilation System User’s Guide, Version 7.8.2 ii COLLABORATORS TITLE : The Glorious Glasgow Haskell Compilation System User’s Guide, Version 7.8.2 ACTION NAME DATE SIGNATURE WRITTEN BY The GHC Team April 11, 2014 REVISION HISTORY NUMBER DATE DESCRIPTION NAME The Glorious Glasgow Haskell Compilation System User’s Guide, Version 7.8.2 iii Contents 1 Introduction to GHC 1 1.1 Obtaining GHC . .1 1.2 Meta-information: Web sites, mailing lists, etc. .1 1.3 Reporting bugs in GHC . .2 1.4 GHC version numbering policy . .2 1.5 Release notes for version 7.8.1 . .3 1.5.1 Highlights . .3 1.5.2 Full details . .5 1.5.2.1 Language . .5 1.5.2.2 Compiler . .5 1.5.2.3 GHCi . .6 1.5.2.4 Template Haskell . .6 1.5.2.5 Runtime system . .6 1.5.2.6 Build system . .6 1.5.3 Libraries . .6 1.5.3.1 array . .6 1.5.3.2 base . .7 1.5.3.3 bin-package-db . .7 1.5.3.4 binary . .7 1.5.3.5 bytestring . .7 1.5.3.6 Cabal . .8 1.5.3.7 containers . .8 1.5.3.8 deepseq . .8 1.5.3.9 directory . .8 1.5.3.10 filepath . .8 1.5.3.11 ghc-prim . .8 1.5.3.12 haskell98 .
    [Show full text]
  • Freebsd Foundation February 2018 Update
    FreeBSD Foundation February 2018 Update Upcoming Events Message from the Executive Director Dear FreeBSD Community Member, AsiaBSDCon 2018 Welcome to our February Newsletter! In this newsletter you’ll read about FreeBSD Developers Summit conferences we participated in to promote and teach about FreeBSD, March 8-9, 2018 software development projects we are working on, why we need Tokyo, Japan funding, upcoming events, a release engineering update, and more. AsiaBSDCon 2018 Enjoy! March 8-11, 2018 Tokyo, Japan Deb SCALE 16x March 8-11, 2018 Pasadena, CA February 2018 Development Projects FOSSASIA 2018 March 22-25, 2018 Update: The Modern FreeBSD Tool Chain: Singapore, Singapore LLVM's LLD Linker As with other BSD distributions, FreeBSD has a base system that FreeBSD Journal is developed, tested and released by a single team. Included in the base system is the tool chain, the set of programs used to build, debug and test software. FreeBSD has relied on the GNU tool chain suite for most of its history. This includes the GNU Compiler Collection (GCC) compiler, and GNU binutils which include the GNU "bfd" linker. These tools served the FreeBSD project well from 1993 until 2007, when the GNU project migrated to releasing its software under the General Public License, version 3 (GPLv3). A number of FreeBSD developers and users objected to new restrictions included in GPLv3, and the GNU tool chain became increasingly outdated. The January/February issue of the FreeBSD Journal is now available. Don't miss articles on The FreeBSD project migrated to Clang/LLVM for the compiler in Tracing ifconfig Commands, Storage FreeBSD 10, and most of GNU binutils were replaced with the ELF Tool Multipathing, and more.
    [Show full text]
  • Hassling with the IDE - for Haskell
    Hassling with the IDE - for Haskell This guide is for students that are new to the Haskell language and are in need for a proper I​ntegrated ​D​evelopment ​E​nvironment (IDE) to work on the projects of the course. This guide is intended for Windows users. It may work similarly on Linux and iOS. For more information, see: - https://www.haskell.org/platform/mac.html​ for iOS - https://www.haskell.org/downloads/linux/​ for Linux For any errors, please contact me at ​[email protected]​. Changelog 04/09/2019 Initial version 24/08/2020 Updated contents for the year 2020 / 2021, thanks to Bernadet for pointing it out 1. Installing Visual Studio Code Visual Studio Code (VSC) is a lightweight, but rather extensive, code editor. We’ll talk about its features throughout this guide. You can download VSC at: https://code.visualstudio.com/download Once installed, take note of the sidebar on the left. From top to bottom, it contains: - Explorer (Ctrl + Shift + E) - Search (Ctrl + Shift + F) - Source control (Ctrl + Shift + G) - Debug (Ctrl + Shift + D) - Extensions (Ctrl + Shift + X) The ​bold​ options are important to remember. They will be mentioned throughout this document. 2. Installing GHC (and stack / cabal) on Windows Download the Glasgow Haskell Compiler (GHC). This compiler is used throughout this course and any other course that uses Haskell. You can find its download instructions at: https://www.haskell.org/platform/windows.html The download link recommends you to use Chocolatey. ​Chocolatey is an open source project that provides developers and admins alike a better way to manage Windows software.
    [Show full text]
  • Installing Haskell
    Installing Haskell 0.1 Learning programming Throughout this course you’ll be learning to program in Haskell. One way of learning a programming language is to start with formal syntax and semantics (although very few programming languages have formal semantics). This is very different from how most people learn languages, be it natural or computer languages. A child learns the meaning of words and sentences not by analyzing their structure and looking up the definitions in Wikipedia. In fact, a child’s understanding of language is very similar to how we work in category theory. We derive the meaning of objects from the network of interactions with other objects. This is easy in mathematics, where we can say that an object is defined by the totality of its interactions with possibly infinite set of other objects (we’ll see that when we talk about the Yoneda lemma). In real life we don’t have the time to explore the infinity, so we can only approximate this process. We do this by living on credit. This is how we are going to learn Haskell. We’ll be using things, from day one, without fully understanding their meaning, thus constantly incurring a conceptual debt. Some of this debt will be paid later. Some of it will stay with us forever. The alternative would be to first learn about cartesian closed categories and domain theory, formally define simply typed lambda calculus, build its categorical model, and only then wave our hands a bit and claim that at its core Haskell approximates this model.
    [Show full text]
  • Secrets of the Glasgow Haskell Compiler Inliner
    Secrets of the Glasgow Haskell Compiler inliner Simon Marlow Simon Peyton Jones Microsoft Research Ltd, Cambridge Microsoft Research Ltd, Cambridge [email protected] [email protected] Septemb er 1, 1999 A ma jor issue for any compiler, esp ecially for one that Abstract inlines heavily,is name capture. Our initial brute-force solution involved inconvenient plumbing, and wehave Higher-order languages, such as Haskell, encourage the pro- now evolved a simple and e ective alternative Sec- grammer to build abstractions by comp osing functions. A tion 3. go o d compiler must inline many of these calls to recover an eciently executable program. At rst wewere very conservative ab out inlining recur- sive de nitions; that is, we did not inline them at all. In principle, inlining is dead simple: just replace the call But we found that this strategy o ccasionally b ehaved of a function by an instance of its b o dy. But any compiler- very badly. After a series of failed hacks we develop ed writer will tell you that inlining is a black art, full of delicate a simple, obviously-correct algorithm that do es the job compromises that work together to give go o d p erformance b eautifully Section 4. without unnecessary co de bloat. Because the compiler do es so much inlining, it is im- The purp ose of this pap er is, therefore, to articulate the p ortant to get as much as p ossible done in each pass key lessons we learned from a full-scale \pro duction" inliner, over the program.
    [Show full text]
  • Used Tools and Mechanisms in Open Source Projects (A School Seminar Work)
    Used tools and mechanisms in Open Source projects (a school seminar work) Heikki Orsila <heikki.orsila@iki.fi> 2007-03-08 This document may be used and distributed under GNU Free Documen- tation (http://www.gnu.org/copyleft/fdl.html) and/or Commons Attribution- Share Alike 2.5 (http://creativecommons.org/licenses/by-sa/2.5/) license con- ditions. 0-0 1 Outline • Present some common tools and mechanisms used in developing Open Source projects • Focuses on GNU/Linux and UNIX-like operating systems, other oper- ating systems are ignored • Focuses on C language tools, since C is the dominant language used in Open Source operating systems • Presents only Open Source tools • The purpose is to only present most popular tools and most common mechanisms in development • This document was created from following information sources: – Freshmeat: http://freahmeat.net is an excellent source for finding UNIX programs by category, see http://freshmeat.net/browse/18/ 0-1 – Wikipedia – Google – Personal experience ;) – Acquaints from IRCNet ;) 0-2 • Topics of this presentation are: – Section 2: Compilers and linkers – Section 3: Interpreted languages – Section 4: Source code tools – Section 5: Debugging tools – Section 6: Documentation tools – Section 7: Version control tools – Section 8: Text editors – Section 9: Building tools – Section 10: Integrated development environments (IDEs) – Section 11: Reverse engineering tools – Section 12: Compression, cryptography and packaging tools – Section 13: Network tools – Section 14: Emulators 0-3 2 Compilers and linkers • A compiler is the main tool for programming • A compiler translates source code into executable format, possibly opti- mising and verifying the code for correctness • C is the most widely used programming language on UNIX systems and GNU C compiler is the most popular compiler • GNU Compiler Collection (GCC ) provides compilers for Ada, C, C++, Objective-C, Fortran and Java.
    [Show full text]
  • The Glorious Glasgow Haskell Compilation System User's Guide
    The Glorious Glasgow Haskell Compilation System User’s Guide, Version 7.0.3 i The Glorious Glasgow Haskell Compilation System User’s Guide, Version 7.0.3 The Glorious Glasgow Haskell Compilation System User’s Guide, Version 7.0.3 ii COLLABORATORS TITLE : The Glorious Glasgow Haskell Compilation System User’s Guide, Version 7.0.3 ACTION NAME DATE SIGNATURE WRITTEN BY The GHC Team March 27, 2011 REVISION HISTORY NUMBER DATE DESCRIPTION NAME The Glorious Glasgow Haskell Compilation System User’s Guide, Version 7.0.3 iii Contents 1 Introduction to GHC 1 1.1 Obtaining GHC . .1 1.2 Meta-information: Web sites, mailing lists, etc. .1 1.3 Reporting bugs in GHC . .2 1.4 GHC version numbering policy . .2 1.5 Release notes for version 7.0.3 . .3 1.6 Release notes for version 7.0.2 . .3 1.6.1 Compiler . .3 1.6.2 GHCi . .3 1.6.3 Runtime system . .4 1.6.4 Build system . .4 1.6.5 Haddock . .4 1.6.6 Libraries . .4 1.6.6.1 array . .4 1.6.6.2 base . .4 1.6.6.3 bin-package-db . .4 1.6.6.4 bytestring . .4 1.6.6.5 Cabal . .4 1.6.6.6 containers . .4 1.6.6.7 directory . .5 1.6.6.8 extensible-exceptions . .5 1.6.6.9 filepath . .5 1.6.6.10 ghc-binary . .5 1.6.6.11 ghc-prim . .5 1.6.6.12 haskell98 . .5 1.6.6.13 haskell2010 . .5 1.6.6.14 hpc .
    [Show full text]
  • Benchmarking Implementations of Functional Languages With
    c J Functional Programming 1 January Cambridge University Press Benchmarking Implementations of Functional Languages with Pseudoknot a FloatIntensive Benchmark Pieter H Hartel Marc Feeley Martin Alt Lennart Augustsson Peter Baumann Marcel Beemster Emmanuel Chailloux Christine H Flo o d Wolfgang Grieskamp John H G van Groningen Kevin Hammond Bogumil Hausman Melo dy Y Ivory Richard E Jones Jasp er Kamp erman Peter Lee Xavier Leroy Rafael D Lins Sandra Lo osemore Niklas Rojemo Manuel Serrano JeanPierre Talpin Jon Thackray Stephen Thomas Pum Walters Pierre Weis Peter Wentworth Abstract Over implementation s of dierent functional languages are b enchmarked using the same program a oating p oint intensive application taken from molecular biology The principal asp ects studied are compile time and Dept of Computer Systems Univ of Amsterdam Kruislaan SJ Amsterdam The Netherlands email pieterfwiuvanl Depart dinformatique et ro Univ de Montreal succursale centreville Montreal HC J Canada email feeleyiroumontrealca Informatik Universitat des Saarlandes Saarbruc ken Germany email altcsunisbde Dept of Computer Systems Chalmers Univ of Technology Goteb org Sweden email augustsscschalmersse Dept of Computer Science Univ of Zurich Winterthurerstr Zurich Switzerland email baumanniunizh ch Dept of Computer Systems Univ of Amsterdam Kruislaan SJ Amsterdam The Netherlands email b eemsterfwiuvanl LIENS URA du CNRS Ecole Normale Superieure rue dUlm PARIS Cedex France email EmmanuelChaillou xensfr Lab
    [Show full text]