net: Deprecate the "name" parameter of -net
commit101625a4d4ac7e96227a156bc5f6d21a9cc383cd
authorThomas Huth <thuth@redhat.com>
Thu, 20 Sep 2018 08:14:08 +0000 (20 10:14 +0200)
committerThomas Huth <thuth@redhat.com>
Tue, 25 Sep 2018 15:26:17 +0000 (25 17:26 +0200)
tree5055d974e9b5b0e670408f4b1ccbe51056a1633d
parent681a1eafe27d7520818e3827ef87e093fb2387e0
net: Deprecate the "name" parameter of -net

In early times, network backends were specified by a "vlan" and "name"
tuple. With the introduction of netdevs, the "name" was replaced by an
"id" (which is supposed to be unique), but the "name" parameter stayed
as an alias which could be used instead of "id". Unfortunately, we miss
the duplication check for "name":

 $ qemu-system-x86_64 -net user,name=n1 -net user,name=n1

... starts without an error, while "id" correctly complains:

 $ qemu-system-x86_64 -net user,id=n1 -net user,id=n1
 qemu-system-x86_64: -net user,id=n1: Duplicate ID 'n1' for net

Instead of trying to fix the code for the legacy "name" parameter, let's
rather get rid of this old interface and deprecate the "name" parameter
now - this will also be less confusing for the users in the long run.

Reviewed-by: Philippe Mathieu-Daudé <f4bug@amsat.org>
Reviewed-by: Markus Armbruster <armbru@redhat.com>
Signed-off-by: Thomas Huth <thuth@redhat.com>
net/net.c
qemu-deprecated.texi