faum-node-pc(1) Start a virtual machine


faum-node-pc [-h] [-B dirname] [-D n] [-d] [-k keymap] [-g guitype] [-a audio_module] [--sparse]



starts a virtual machine.



print short explanation

-B dirname

Use directory dirname to creating temporary files and disk image files. As a default node.def in the will get used.

-D n

set debug level to n


turn on debugging (short for -D 1)

-k keymap

set the key translation map to keymap

-g guitype

Use guitype, where guitype is one of gtk or null. null disables the GUI entirely, useful for running automated experiments. gtk is the default.

-a audio_module

Use audio_module, where audio_module is one of alsa1x, esd, file, macosx, oss, pulse or null. Not all modules may be available for your system. By default, the best available audio module is chosen.


Enable usage of sparse files for all generated media images, like hard disc images. Please use this option only, if you know that you've got sufficient disk space.


To run faum-node-pc, you must have a precompiled system.ic that specifies the setup of the simulated PC as well as a simulation.setup that determines simulation specific parameters in your working directory. You can use fauhdlc to compile a structural VHDL setup into a system.ic file.

FAUmachine comes with a number of example experiments in /usr/share/faumachine/experiments.

To run such an experiment, you can use make -f /usr/share/faumachine/experiments/<experiment>/Makefile experiment.



Specifies the desired audio module to use. Same as the -a option.


Set to 1 to use sparse files for all media files.


Specifies which gui to use. Same as the -g option.


Please report all bugs to m[blue][email protected]m[][1].


This manual page was written by the m[blue]FAUmachine Teamm[][1].



m[blue]Project Teamm[][1]


FAUmachine team


Copyright © 2000-2009 FAUmachine team. Developed at Friedrich Alexander University Erlangen-Nuremberg.

FAUmachine comes with ABSOLUTELY NO WARRANTY. FAUmachine 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 2 of the License, or (at your option) any later version. See COPYING for details.