Re: [Qemu-devel] Block format 'raw' does not support the option 'serial'

[Daniel P . Berrangé]

On Mon, Nov 19, 2018 at 04:55:16PM +0100, Michal Suchánek wrote:
> On Mon, 19 Nov 2018 14:20:59 +0000
> Daniel P. Berrangé <address@hidden> wrote:
> 
> > On Mon, Nov 19, 2018 at 03:15:27PM +0100, Michal Suchánek wrote:
> > > Hello,
> > > 
> > > I tried to run my VM with qemu git and I am greeted with:
> > > 
> > > Block format 'raw' does not support the option 'serial'
> > > 
> > > Is there any sensible reason to *not^ support disk serial number?  
> > 
> > The 'serial' property on -drive was deprecated in QEMU 2.10, and deleted
> > in 3.1, as it is not a property that makes sense for the backend.
> > 
> > It should be set on the virtual device instead via the -device arg
> 
> Is this documented anywhere?
> 
> Looking at the man page I only see serial property on smbios.

The original deprecation was listed in the qemu man page / online user
guide, but this documentation gets deleted once the feature is actually
removed.

This wouldn't be so bad if we actually published versioned copies of
the qemu manual online, but we just overwrite the manual each time there
is a new release, so we've no historical record of deprecations.

Thirdly the -device properties are not documented at all - you just
have to look for them live with eg '$QEMU -device virtio-blk,help'

Regards,
Daniel
-- 
|: https://berrange.com      -o-    https://www.flickr.com/photos/dberrange :|
|: https://libvirt.org         -o-            https://fstop138.berrange.com :|
|: https://entangle-photo.org    -o-    https://www.instagram.com/dberrange :|