• S
    Btrfs: allow omitting stream header and end-cmd for btrfs send · c2c71324
    Stefan Behrens 提交于
    Two new flags are added to allow omitting the stream header and the
    end command for btrfs send streams. This is used in cases where you
    send multiple snapshots back-to-back in one stream.
    
    This used to be encoded like this (with 2 snapshots in this example):
    <stream header> + <sequence of commands> + <end cmd> +
    <stream header> + <sequence of commands> + <end cmd> + EOF
    
    The new format (if the two new flags are used) is this one:
    <stream header> + <sequence of commands> +
                      <sequence of commands> + <end cmd>
    
    Note that the currently existing receivers treat <end cmd> only as
    an indication that a new <stream header> is following. This means,
    you can just skip the sequence <end cmd> <stream header> without
    loosing compatibility. As long as an EOF is following, the currently
    existing receivers handle the new format (if the two new flags are
    used) exactly as the old one.
    
    So what is the benefit of this change? The goal is to be able to use
    a single stream (one TCP connection) to multiplex a request/response
    handshake plus Btrfs send streams, all in the same stream. In this
    case you cannot evaluate an EOF condition as an end of the Btrfs send
    stream. You need something else, and the <end cmd> is just perfect
    for this purpose.
    
    The summary is:
    The format change is driven by the need to send several Btrfs send
    streams over a single TCP connections, with the ability for a repeated
    request/response handshake in the middle. And this format change does
    not break any existing tool, it is completely compatible.
    
    You could compare the old behaviour of the Btrfs send stream to the
    one of ftp where you need a seperate request/response channel and
    newly opened data transfer channels for each file, while the new
    behaviour is more like http using a single stream for everything.
    Signed-off-by: NStefan Behrens <sbehrens@giantdisaster.de>
    Signed-off-by: NJosef Bacik <jbacik@fusionio.com>
    c2c71324
send.c 105.8 KB