Compilers, Tools, Dev Environments, etc.

1. As a prerequisite, download and install Virtualbox (on macOS with homebrew: brew cask install vagrant)
2. Download Vagrant and run the downloaded file (Windows) or install it with your package manager (Linux), (on macOS with homebrew: brew cask install vagrant)
3. Open a terminal, navigate to your IOOPM GitHub repository
4. Create a directory for Vagrant with mkdir vagrant
5. Tell git to ignore this directory with git-ignore vagrant (see below if you have problems with this)
6. Go into that directory with cd vagrant
7. Download this Vagrantfile into the vagrant directory and rename it Vagrantfile without any .txt ending (e.g., curl http://wrigstad.com/ioopm18/misc/Vagrantfile.txt -o Vagrantfile)
8. Run the command vagrant up – this will (only the first time, unless you destroy your virtual machine) download the vitual machine according to the specification in Vagrantfile and install the necessary packages

1. Open a terminal, navigate to your IOOPM GitHub repository
2. Run vagrant ssh to move inside the running virtual machine – now all commands you type run on the virtual machine instead
3. To find the files in your repo, navigate to cd /ioopm – typing e.g. clang -c assignment1/hash_table.c will compile the file in the virtual machine
4. To disconnect from the virtual machine, simply use C-d
5. To pause the virtual machine (e.g., to reserve battery power and memory), do vagrant suspend
6. To shutdown the virtual machine (e.g., to reserve battery power and memory, and some hard drive space), do vagrant halt
7. To resume a paused (suspended) vagrant box, do vagrant resume before vagrant ssh
8. To restart a stopped (halted) vagrant box, do vagrant up before vagrant ssh

The following is installed (with the exception of to-be-added):

• C compilers: gcc, clang
• C debuggers: gdb, lldb
• Java: openjdk 8
• Editors: Emacs 25, Vim 8 (note: both are text-only – no graphical components)
• valgrind for debugging memory errors, finding memory leaks, and more!
• gcov and gcovr for code coverage
• gprof and perf for profiling etc.
• cproto extract function prototypes from C code
• GNU global and cscope code navigation tools
• git and tig version control
• cunit and junit unit testing frameworks for C and Java
• make and cmake build management
• doxygen generate documentation extracted from comments in source files
• ssh and tmux love tmux!
• curl get files, interact with web APIs etc.
• astyle, indent automatic code formatting
• htop check the processes running on the machine
• gnuplot and graphviz to draw diagrams – used by doxygen (and you?)
• terminal emulators: bash, zsh
• convenience: oh-my-zsh, zip, unzip
• to-be-added: tag, some aliases

Feel free to look up all of these programs and learn about them.

$ sudo apt-get install -y gcc clang libclang-dev lldb emacs25 vim tree make \
       tmux curl astyle zsh linux-tools-common valgrind git libcunit1-dev doxygen \ 
       xclip global zip unzip openjdk-8-jdk linux-tools-generic \
       cscope cproto gcovr tig htop junit gnuplot graphviz cmake indent

where \ is a line break in the terminal and completely optional – used here for formatting.

1. Open https://brew.sh/ in a browser, and copy-and-paste the installation command into a terminal and execute it
2. Install the individual components in the list of software above, e.g., through brew install gcc, etc. – use this search index for finding brew packages