qemu-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [Qemu-devel] [PATCH] qemu-doc: Rework the network options chapter to


From: Paolo Bonzini
Subject: Re: [Qemu-devel] [PATCH] qemu-doc: Rework the network options chapter to make "-net" less prominent
Date: Fri, 9 Mar 2018 15:41:21 +0100
User-agent: Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101 Thunderbird/52.6.0

On 09/03/2018 07:13, Thomas Huth wrote:
> +
> address@hidden --nic none
> +Indicate that no network devices should be configured. It is used to override
> +the default configuration (default NIC with @option{--net user} backend) 
> which

the default @option{--nic user} configuration (default model and
user-mode networking backend), which...

> +is activated if no other networking options are provided.
> +

> -qemu-system-i386 -net user,hostfwd=tcp::5555-:23 [...]
> +qemu-system-i386 --device e1000,netdev=n1 --netdev 
> user,id=n1,hostfwd=tcp::5555-:23

I would use --nic here.  --device/--netdev is covered by
docs/qdev-device-use.txt, which should be updated separately (it even
has -usbdevice still).

> -qemu -net 'user,guestfwd=tcp:10.0.2.100:1234-cmd:netcat 10.10.1.1 4321'
> +qemu-system-i386 --device e1000,netdev=n1 \
> +  --netdev 'user,id=n1,guestfwd=tcp:10.0.2.100:1234-cmd:netcat 10.10.1.1 
> 4321'

Same here.

Single vs. double-dash options is a confusing one and I'm not sure how
to proceed.  On one hand single-dash is what everyone uses, on the other
double-dash is a bit more consistent with e.g. qemu-img.  But:

1) the command-line of qemu-img is anyway completely different from QEMU's

2) mixing them is the worst of both worlds.

I honestly would use single-dashes, and add a note that double-dash
options are supported as well.

Paolo



reply via email to

[Prev in Thread] Current Thread [Next in Thread]