qemu-devel
[Top][All Lists]
Advanced

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

Re: [Qemu-devel] [PATCH 01/12] nbd: rename read_sync and friends


From: Vladimir Sementsov-Ogievskiy
Subject: Re: [Qemu-devel] [PATCH 01/12] nbd: rename read_sync and friends
Date: Wed, 31 May 2017 20:03:52 +0300
User-agent: Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101 Thunderbird/52.1.1

31.05.2017 19:55, Vladimir Sementsov-Ogievskiy wrote:
Rename
   nbd_wr_syncv -> nbd_rwv
   read_sync -> nbd_read
   read_sync_eof -> nbd_read_eof
   write_sync -> nbd_write
   drop_sync -> nbd_drop

1. nbd_ prefix
    read_sync and write_sync are already shared, so it is good to have a
    namespace prefix. drop_sync will be shared, and read_sync_eof is
    related to read_sync, so let's rename them all.

2. _sync suffix
    _sync is related to the fact, that nbd_wr_syncv doesn't return if
    write to socket returns EAGAIN. In first implementation nbd_wr_syncv

not bad to add here the following note in parentheses. Please add it in flight, if no more updates required for the series.
(was wr_sync in 7a5ca8648b)

    just loops while getting EAGAIN, current implementation yields in
    this case.
    Why to get rid of it:
    - it is normal for r/w functions to be synchronous, so having
      additional suffix for it looks redundant (contrariwise, we have
      _aio suffix for async functions)
    - _sync suffix in block layer is used when function does flush (so
      using it for other thing is confusing a bit)
    - keep function names short after adding nbd_ prefix

3. for nbd_wr_syncv let's use more common notation 'rw'

Signed-off-by: Vladimir Sementsov-Ogievskiy <address@hidden>
---

--
Best regards,
Vladimir



reply via email to

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