---
name: "faum-node-pc"
section: "1"
platform: "linux"
package: "faumachine"
version: "20180503-4"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/faum-node-pc"
---

# faum-node-pc(1)

Start a virtual machine

## 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)](/fauhdlc/1.md)

## AUTHOR

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

## CONTACT

**Webpage**\[2\]

**Project Team**\[1\]

## AUTHOR

**FAUmachine team**

## COPYRIGHT

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.

## NOTES

- 1\.

  info@faumachine.org

  mailto:info@faumachine.org

- 2\.

  Webpage

  http://www.faumachine.org/