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

Re: [Nbd] [PATCHv5] docs/proto.md: Clarify SHOULD / MUST / MAY etc



Wouter,

Looks like Eric and I are both OK with this one (though Eric wants
a follow-up patch which I think he has done elsewhere).

Is this OK by you?

Alex


On 7 Apr 2016, at 08:35, Alex Bligh <alex@...872...> wrote:

> Eric,
> 
>>> -    The server MUST NOT fail an NDB_OPT_GO sent with the same parameters
>>> -    as a previous NBD_OPT_INFO which returned successfully (i.e. with
>>> +    The server MUST NOT fail an `NDB_OPT_GO` sent with the same parameters
>>> +    as a previous `NBD_OPT_INFO` which returned successfully (i.e. with
>>>    `NBD_REP_SERVER`) unless in the intervening time the client has
>>>    negotiated other options. The server MUST return the same transmission
>>> -    flags with NDB_OPT_GO as a previous NDB_OPT_INFO unless in the
>>> +    flags with `NDB_OPT_GO` as a previous `NDB_OPT_INFO` unless in the
>>>    intervening time the client has negotiated other options.
>> 
>> I failed to notice this earlier, but a server MAY send different
>> transmission flags if NBD_OPT_INFO(name1) is immediately followed by
>> NBD_OPT_GO(name2), with no intervening client options (because some of
>> the transmission flags, like read-only, are determined by the choice of
>> export name). The first sentence gets this right ("with the same
>> parameters"), the second does not (missing that phrase).
>> 
>>>    The values of the transmission flags MAY differ from what was sent
>>>    earlier in response to an earlier `NBD_OPT_INFO` (if any), and/or
>>>    the server MAY fail the request, based on other options that were
>>>    negotiated in the meantime.
>> 
>> And if we reword the second sentence, the third sentence may also need a
>> tweak.
>> 
>> However, it may be worth fixing that as a followup patch, and letting
>> this one through.
>> 
>> Everything else is looking good from my perspective.
>> 
> 
> I don't think I changed the meaning here (merely added backticks)
> so I think this should be addressed separately.
> 
> I agree with the change though.
> 
> --
> Alex Bligh
> 
> 
> 
> 

--
Alex Bligh




Attachment: signature.asc
Description: Message signed with OpenPGP using GPGMail


Reply to: