Update generated docs

This commit is contained in:
Wilken Rivera 2020-10-13 10:33:59 -04:00
parent b05fd9303e
commit 3abae29752
1 changed files with 16 additions and 8 deletions

View File

@ -136,19 +136,27 @@
the builder. By default this is output-BUILDNAME where "BUILDNAME" is the the builder. By default this is output-BUILDNAME where "BUILDNAME" is the
name of the build. name of the build.
- `qemuargs` ([][]string) - Allows complete control over the qemu command line (though not, at this - `qemuargs` ([][]string) - Allows complete control over the qemu command line (though not qemu-img).
time, qemu-img). Each array of strings makes up a command line switch Each array of strings makes up a command line switch
that overrides matching default switch/value pairs. Any value specified that overrides matching default switch/value pairs. Any value specified
as an empty string is ignored. All values after the switch are as an empty string is ignored. All values after the switch are
concatenated with no separator. concatenated with no separator.
~> **Warning:** The qemu command line allows extreme flexibility, so ~> **Warning:** The qemu command line allows extreme flexibility, so
beware of conflicting arguments causing failures of your run. For beware of conflicting arguments causing failures of your run.
instance, using --no-acpi could break the ability to send power signal For instance adding a "--drive" or "--device" override will mean that
type commands (e.g., shutdown -P now) to the virtual machine, thus none of the default configuration Packer sets will be used. To see the
preventing proper shutdown. To see the defaults, look in the packer.log defaults that Packer sets, look in your packer.log
file and search for the qemu-system-x86 command. The arguments are all file (set PACKER_LOG=1 to get verbose logging) and search for the
printed for review. qemu-system-x86 command. The arguments are all printed for review, and
you can use those arguments along with the template engines allowed
by qemu-args to set up a working configuration that includes both the
Packer defaults and your extra arguments.
Another pitfall could be setting arguments like --no-acpi, which could
break the ability to send power signal type commands
(e.g., shutdown -P now) to the virtual machine, thus preventing proper
shutdown.
The following shows a sample usage: The following shows a sample usage: