www.digitalmars.com

D Programming Language 2.0


Last update Sun Dec 30 20:21:55 2012

DMD Compiler for OSX

Requirements and Downloads

  1. Download D Compiler
  2. 32 bit x86 Mac OSX operating system
  3. Gnu C compiler (gcc)

Files

dmd2/src/phobos/
D runtime library source
dmd2/src/dmd/
D compiler front end source under dual (GPL and Artistic) license
dmd2/html/d/
Documentation
dmd2/samples/d/
Sample D programs
dmd2/osx/bin/dmd
D compiler executable
dmd2/osx/bin/dumpobj
Mach-O file dumper
dmd2/osx/bin/obj2asm
Mach-O file disassembler
dmd2/osx/bin/shell
Simple command line shell
dmd2/osx/bin/dmd.conf
Global compiler settings (copy to /etc/dmd.conf)
dmd2/osx/lib/libphobos2.a
D runtime library (copy to /usr/lib/libphobos2.a)

Installation

  • Put the dmd zip file into your home directory, and unzip it:
    unzip dmd.VERSION.zip
    
    where VERSION is the particular version of the zip file.
  • It will create a ~/dmd2 directory with all the files in it. All the tools are command line tools, which means they are run from a console window.
  • Verify that this works by creating hello.d in your home directory with these contents:
    import std.stdio;
    
    void main() {
        writeln("hello world!");
    }
    
    and compile and run it with:
    dmd2/osx/bin/dmd hello
    ./hello
    
    and it should print:
    hello world!
    
  • To install a global copy:
  • Copy binaries to /usr/local/bin:
    sudo cp dmd2/osx/bin/{dmd,dumpobj,obj2asm,shell,rdmd} /usr/local/bin
    sudo cp dmd2/osx/bin/dmdx.conf /usr/local/bin/dmd.conf
    
  • Copy the library to /usr/lib:
    sudo cp dmd2/osx/lib/libphobos2.a /usr/lib
    
  • Compiler Arguments and Switches

    dmd files... -switches...
    files...
    File Extensions
    Extension File Type
    none D source files
    .d D source files
    .dd Ddoc source files
    .di D interface files
    .o Object files to link in
    .a Object code libraries to search
    @cmdfile
    If cmdfile is an environment variable, read the compiler arguments and switches from the value of that variable. Otherwise, read compiler arguments and switches from the text file cmdfile. The file may contain single-line comments starting with the hash symbol (#).
    -c
    compile only, do not link
    -cov
    instrument for code coverage analysis
    -D
    generate documentation from source
    -Dddocdir
    write documentation file to docdir directory. -op can be used if the original package hierarchy should be retained
    -Dffilename
    write documentation file to filename
    -d
    allow deprecated features
    -debug
    compile in debug code
    -debug=level
    compile in debug level <= level
    -debug=ident
    compile in debug identifier ident
    -debuglib=libname
    link in libname as the default library when compiling for symbolic debugging instead of libphobos2.a
    -defaultlib=libname
    link in libname as the default library when not compiling for symbolic debugging instead of libphobos2.a
    -deps=filename
    write module dependencies as text to filename
    -fPIC
    generate Position Independent Code (which is used for building shared libraries). This is always on for OSX.
    -g
    add Dwarf symbolic debug info with D extensions for debuggers
    -gc
    add Dwarf symbolic debug info in C format for debuggers such as gdb
    -gs
    always generate standard stack frame
    -H
    generate D interface file
    -Hddir
    write D interface file to dir directory. -op can be used if the original package hierarchy should be retained
    -Hffilename
    write D interface file to filename
    --help
    print brief help to console
    -Ipath
    where to look for imports. path is a ; separated list of paths. Multiple -I's can be used, and the paths are searched in the same order.
    -ignore
    ignore unsupported pragmas
    -inline
    inline expand functions at the discretion of the compiler. This can improve performance, at the expense of making it more difficult to use a debugger on it.
    -Jpath
    where to look for files for ImportExpressions. This switch is required in order to use ImportExpressions. path is a ; separated list of paths. Multiple -J's can be used, and the paths are searched in the same order.
    -Llinkerflag
    pass linkerflag to the linker, for example, -L-M
    -lib
    generate library file as output instead of object file(s). All compiled source files, as well as object files and library files specified on the command line, are inserted into the output library. Compiled source modules may be partitioned into several object modules to improve granularity. The name of the library is taken from the name of the first source module to be compiled. This can be overridden with the -of switch.
    -m32
    compile a 32 bit executable. This is the default for the 32 bit dmd.
    -m64
    compile a 64 bit executable. This is the default for the 64 bit dmd.
    -man
    open browser specified by the BROWSER environment variable on this page. If BROWSER is undefined, Safari is assumed.
    -map
    generate a .map file
    -noboundscheck
    turns off all array bounds checking, even for safe functions
    -O
    Optimize generated code. For fastest executables, compile with the -O -release -inline switches together.
    -o-
    Suppress generation of object file. Useful in conjuction with -D or -H flags.
    -odobjdir
    write object files relative to directory objdir instead of to the current directory. -op can be used if the original package hierarchy should be retained
    -offilename
    Set output file name to filename in the output directory. The output file can be an object file, executable file, or library file depending on the other switches.
    -op
    normally the path for .d source files is stripped off when generating an object, interface, or Ddoc file name. -op will leave it on.
    -profile
    profile the runtime performance of the generated code
    -property
    enforce use of @property on property functions
    -quiet
    suppress non-essential compiler messages
    -release
    compile release version, which means not generating code for contracts and asserts. Array bounds checking is not done for system and trusted functions.
    -run srcfile args... compile
    link, and run the program srcfile with the rest of the command line, args..., as the arguments to the program. No .o or executable file is left behind.
    -shared
    generate shared library
    -unittest
    compile in unittest code, turns on asserts, and sets the unittest version identifier
    -v
    verbose
    -version=level
    compile in version level >= level
    -version=ident
    compile in version identifier ident
    -vtls
    print informational messages identifying variables defaulting to thread local storage. Handy for migrating to shared model.
    -w
    enable warnings
    -wi
    enable informational warnings (i.e. compilation still proceeds normally)
    -X
    generate JSON file
    -Xffilename
    write JSON file to filename

    Linking

    Linking is done directly by the dmd compiler after a successful compile. To prevent dmd from running the linker, use the -c switch.

    The actual linking is done by running gcc. This ensures compatibility with modules compiled with gcc.

    Environment Variables

    The D compiler dmd uses the following environment variables:

    CC
    dmd normally runs the linker by looking for gcc along the PATH. To use a specific linker instead, set the CC environment variable to it. For example:
    set CC=gcc
    
    BROWSER
    This sets the browser used to open the manual page with the -man switch. It defaults to x-www-browser.
    DFLAGS
    The value of DFLAGS is treated as if it were appended to the command line to dmd.

    dmd.conf Initialization File

    The dmd file dmd.conf is the same as sc.ini for Windows, it's just that the file has a different name, enabling a setup common to both Windows and this system to be created without having to re-edit the file.

    dmd will look for the initialization file dmd.conf in the following sequence of directories:

    1. current working directory
    2. directory specified by the HOME environment variable
    3. directory dmd resides in
    4. /etc/

    If found, environment variable settings in the file will override any existing settings. This is handy to make dmd independent of programs with conflicting use of environment variables.

    Environment variables follow the [Environment] section heading, in NAME=value pairs. The NAMEs are treated as upper case. Comments are lines that start with ;. For example:

    ; dmd.conf file for dmd
    ; Names enclosed by %% are searched for in the existing environment
    ; and inserted. The special name %@P% is replaced with the path
    ; to this file.
    [Environment]
    
    DFLAGS=-I%@P%/../src/phobos -I%@P%/../src/druntime/import
    

    Differences between Windows and Linux versions


    D Interface Files

    When an import declaration is processed in a D source file, the compiler searches for the D source file corresponding to the import, and processes that source file to extract the information needed from it. Alternatively, the compiler can instead look for a corresponding D interface file. A D interface file contains only what an import of the module needs, rather than the whole implementation of that module.

    The advantages of using a D interface file for imports rather than a D source file are:

    D interface files can be created by the compiler from a D source file by using the -H switch to the compiler. D interface files have the .di file extension. When the compiler resolves an import declaration, it first looks for a .di D interface file, then it looks for a D source file.

    D interface files bear some analogous similarities to C++ header files. But they are not required in the way that C++ header files are, and they are not part of the D language. They are a feature of the compiler, and serve only as an optimization of the build process.

    Building Executables

    dmd can build an executable much faster if as many of the source files as possible are put on the command line.

    Another advantage to putting multiple source files on the same invocation of dmd is that dmd will be able to do some level of cross-module optimizations, such as function inlining across modules.

    Building Libraries

    There are three ways to build a library. For example, given foo.d and bar.d which are to be compiled, and existing object file bar.o and existing library def.a which are all to be combined into a library foo.a:

    1. Compile modules separately and then run the librarian on them:
      dmd -c foo.d
      dmd -c bar.d
      rm -f foo.a
      ar -r foo.a foo.o bar.o abc.o def.a
      rm foo.o bar.o
      
      This option is typical when using a makefile to avoid compiling modules that have already been compiled.
    2. Compile modules together and then run the librarian on them:
      dmd -c foo.d bar.d
      rm -f foo.a
      ar -r foo.a foo.o bar.o abc.o def.a
      rm foo.o bar.o
      
    3. Use dmd to compile and build library in one operation:
      dmd -lib foo.d bar.d abc.o def.a
      
      No object files are written to disk, it's all done in memory. Using -lib also has the advantage that modules may be compiled into multiple object files rather than exactly one per module. This improves granularity of the library without having to break up the modules.

    Compiling dmd

    Complete source code is provided to build the compiler. Follow these steps:

    cd ~/dmd2/src/dmd
    make -f osx.mak
    

    Compiling Phobos

    Complete source code is provided to build Phobos, the D runtime library. Follow these steps:

    cd ~/dmd2/src/druntime
    make -f posix.mak DMD=~/dmd2/osx/bin/dmd
    cd ../phobos
    make -f osx.mak DMD=~/dmd2/osx/bin/dmd
    




    Forums | Comments |  D  | Search | Downloads | Home