FAUM-NODE-PC(1) 					       Reference Information						   FAUM-NODE-PC(1)

NAME

       faum-node-pc - Start a virtual machine

SYNOPSIS

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

DESCRIPTION

       faum-node-pc starts a virtual machine.

OPTIONS

       -h
	   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

       -d
	   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.

       --sparse
	   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.

EXAMPLES

       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.

ENVIRONMENT

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

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

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

BUGS

       Please report all bugs to info@faumachine.org[1].

SEE ALSO

       fauhdlc(1)

AUTHOR

       This manual page was written by the FAUmachine Team[1].

CONTACT

       Webpage[2]

       Project Team[1]

AUTHOR

       FAUmachine team

COPYRIGHT

       Copyright (C) 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.

NOTES

	1. info@faumachine.org
	   mailto:info@faumachine.org

	2. Webpage
	   http://www.faumachine.org/

FAUmachine							    06/21/2012							   FAUM-NODE-PC(1)