From nobody Thu May 2 15:26:35 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of lists.xenproject.org designates 192.237.175.120 as permitted sender) client-ip=192.237.175.120; envelope-from=xen-devel-bounces@lists.xenproject.org; helo=lists.xenproject.org; Authentication-Results: mx.zohomail.com; dkim=fail; spf=pass (zohomail.com: domain of lists.xenproject.org designates 192.237.175.120 as permitted sender) smtp.mailfrom=xen-devel-bounces@lists.xenproject.org ARC-Seal: i=1; a=rsa-sha256; t=1588002674; cv=none; d=zohomail.com; s=zohoarc; b=jYWKwnL8dmgMr/UZe49KdDzXHkPZWTqUkTPxf39fWP8D/MT3nRIsff/f67pkPwDSkTs9YGyM90hgorHYrMOXlYrxHdwqAIVbFbb9JGgqPaUSrs841qJisD6pHDnRb8xIvmHQpENlor+aoqCSUMp5sDSYt6pHfnvxLG90sj/uJh0= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1588002674; h=Cc:Date:From:List-Subscribe:List-Post:List-Id:List-Help:List-Unsubscribe:Message-ID:Sender:Subject:To; bh=vAwTngtf3oFnJq6Lj++fHwLp7IY5766d1HTWb5OIy3g=; b=IS6JhhDNXAmddbYa3MVLVHyeO+oZ/3SH3y+bchlrOWE/gPdNhaKxpIdZwF/e0L8uHZjrwbwOxOjAiEr40zzhVY6HnCzmghYActYNJvdnOIbx/8CyseM6s9hObxTkg0i45XXcohpBGYRP+eJ5NdEQaYx28Hwh9Q8LToRJHXUhqsg= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=fail; spf=pass (zohomail.com: domain of lists.xenproject.org designates 192.237.175.120 as permitted sender) smtp.mailfrom=xen-devel-bounces@lists.xenproject.org Return-Path: Received: from lists.xenproject.org (lists.xenproject.org [192.237.175.120]) by mx.zohomail.com with SMTPS id 1588002674798464.9530747240474; Mon, 27 Apr 2020 08:51:14 -0700 (PDT) Received: from localhost ([127.0.0.1] helo=lists.xenproject.org) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1jT61q-00007l-HY; Mon, 27 Apr 2020 15:50:42 +0000 Received: from us1-rack-iad1.inumbo.com ([172.99.69.81]) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1jT61p-00007g-LG for xen-devel@lists.xenproject.org; Mon, 27 Apr 2020 15:50:41 +0000 Received: from mail.xenproject.org (unknown [104.130.215.37]) by us1-rack-iad1.inumbo.com (Halon) with ESMTPS id d8061de6-889e-11ea-b07b-bc764e2007e4; Mon, 27 Apr 2020 15:50:40 +0000 (UTC) Received: from xenbits.xenproject.org ([104.239.192.120]) by mail.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1jT61n-0002TQ-4C; Mon, 27 Apr 2020 15:50:39 +0000 Received: from [54.239.6.186] (helo=CBG-R90WXYV0.amazon.com) by xenbits.xenproject.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.89) (envelope-from ) id 1jT61m-0001nF-JE; Mon, 27 Apr 2020 15:50:38 +0000 X-Inumbo-ID: d8061de6-889e-11ea-b07b-bc764e2007e4 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=xen.org; s=20200302mail; h=Message-Id:Date:Subject:Cc:To:From:Sender:Reply-To: MIME-Version:Content-Type:Content-Transfer-Encoding:Content-ID: Content-Description:Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc :Resent-Message-ID:In-Reply-To:References:List-Id:List-Help:List-Unsubscribe: List-Subscribe:List-Post:List-Owner:List-Archive; bh=vAwTngtf3oFnJq6Lj++fHwLp7IY5766d1HTWb5OIy3g=; b=Cu1qJdQE8IXaH0aGo7GRjRgicb h7qLqnB8VdLT5zuQAoDKkU8AiaN8nx7TiOlSNLbYy0COjOqHy3+uQDjxZC7uw9y/wknRi0n9Cp0X9 okDqh7X24+LUazjpXajZo0tSFY3IAHIMwnT1eNtDUsAQ0x9Tbg1eyKBC/CCExjKo9xS0=; From: Paul Durrant To: xen-devel@lists.xenproject.org Subject: [PATCH v4] docs/designs: re-work the xenstore migration document... Date: Mon, 27 Apr 2020 16:50:35 +0100 Message-Id: <20200427155035.668-1-paul@xen.org> X-Mailer: git-send-email 2.17.1 X-BeenThere: xen-devel@lists.xenproject.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Xen developer discussion List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , Cc: Juergen Gross , Stefano Stabellini , Julien Grall , Wei Liu , Andrew Cooper , Paul Durrant , Ian Jackson , George Dunlap , Jan Beulich Errors-To: xen-devel-bounces@lists.xenproject.org Sender: "Xen-devel" X-ZohoMail-DKIM: fail (Header signature does not verify) Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" From: Paul Durrant ... to specify a separate migration stream that will also be suitable for live update. The original scope of the document was to support non-cooperative migration of guests [1] but, since then, live update of xenstored has been brought in= to scope. Thus it makes more sense to define a separate image format for serializing xenstore state that is suitable for both purposes. The document has been limited to specifying a new image format. The mechani= sm for acquiring the image for live update or migration is not covered as that is more appropriately dealt with by a patch to docs/misc/xenstore.txt. It is also expected that, when the first implementation of live update or migrati= on making use of this specification is committed, that the document is moved f= rom docs/designs into docs/specs. NOTE: It will only be necessary to save and restore state for active xensto= re connections, but the documentation for 'RESUME' in xenstore.txt impli= es otherwise. That command is unused so this patch deletes it from the specification. [1] See https://xenbits.xen.org/gitweb/?p=3Dxen.git;a=3Dblob;f=3Ddocs/desig= ns/non-cooperative-migration.md Signed-off-by: Paul Durrant Reviewed-by: Juergen Gross --- Cc: Juergen Gross Cc: Andrew Cooper Cc: George Dunlap Cc: Ian Jackson Cc: Jan Beulich Cc: Julien Grall Cc: Stefano Stabellini Cc: Wei Liu v4: - move path-len and value-len earlier in NODE_DATA v3: - Address missed comments from Juergen v2: - Address comments from Juergen --- docs/designs/xenstore-migration.md | 470 +++++++++++++++++++---------- docs/misc/xenstore.txt | 17 -- 2 files changed, 308 insertions(+), 179 deletions(-) diff --git a/docs/designs/xenstore-migration.md b/docs/designs/xenstore-mig= ration.md index 6ab351e8fe..51d8b85171 100644 --- a/docs/designs/xenstore-migration.md +++ b/docs/designs/xenstore-migration.md @@ -3,254 +3,400 @@ ## Background =20 The design for *Non-Cooperative Migration of Guests*[1] explains that extra -save records are required in the migrations stream to allow a guest running -PV drivers to be migrated without its co-operation. Moreover the save -records must include details of registered xenstore watches as well as -content; information that cannot currently be recovered from `xenstored`, -and hence some extension to the xenstore protocol[2] will also be required. - -The *libxenlight Domain Image Format* specification[3] already defines a -record type `EMULATOR_XENSTORE_DATA` but this is not suitable for -transferring xenstore data pertaining to the domain directly as it is -specified such that keys are relative to the path -`/local/domain/$dm_domid/device-model/$domid`. Thus it is necessary to -define at least one new save record type. +save records are required in the migrations stream to allow a guest runnin= g PV +drivers to be migrated without its co-operation. Moreover the save records= must +include details of registered xenstore watches as well ascontent; informat= ion +that cannot currently be recovered from `xenstored`, and hence some extens= ion +to the xenstored implementations will also be required. + +As a similar set of data is needed for transferring xenstore data from one +instance to another when live updating xenstored this document proposes an +image format for a 'migration stream' suitable for both purposes. =20 ## Proposal =20 -### New Save Record +The image format consists of a _header_ followed by 1 or more _records_. E= ach +record consists of a type and length field, followed by any data mandated = by +the record type. At minimum there will be a single record of type `END` +(defined below). =20 -A new mandatory record type should be defined within the libxenlight Domain -Image Format: +### Header =20 -`0x00000007: DOMAIN_XENSTORE_DATA` +The header identifies the stream as a `xenstore` stream, including the ver= sion +of the specification that it complies with. =20 -An arbitrary number of these records may be present in the migration -stream and may appear in any order. The format of each record should be as -follows: +All fields in this header must be in _big-endian_ byte order, regardless of +the setting of the endianness bit. =20 =20 ``` 0 1 2 3 4 5 6 7 octet +-------+-------+-------+-------+-------+-------+-------+-------+ -| type | record specific data | -+-------------------------------+ | -... -+---------------------------------------------------------------+ +| ident | ++-------------------------------+-------------------------------| +| version | flags | ++-------------------------------+-------------------------------+ ``` =20 -where type is one of the following values =20 +| Field | Description | +|-----------|---------------------------------------------------| +| `ident` | 0x78656e73746f7265 ('xenstore' in ASCII) | +| | | +| `version` | 0x00000001 (the version of the specification) | +| | | +| `flags` | 0 (LSB): Endianness: 0 =3D little, 1 =3D big | +| | | +| | 1-31: Reserved (must be zero) | =20 -| Field | Description | -|--------|--------------------------------------------------| -| `type` | 0x00000000: invalid | -| | 0x00000001: NODE_DATA | -| | 0x00000002: WATCH_DATA | -| | 0x00000003: TRANSACTION_DATA | -| | 0x00000004 - 0xFFFFFFFF: reserved for future use | +### Records =20 +Records immediately follow the header and have the following format: =20 -and data is one of the record data formats described in the following -sections. =20 +``` + 0 1 2 3 4 5 6 7 octet ++-------+-------+-------+-------+-------+-------+-------+-------+ +| type | len | ++-------------------------------+-------------------------------+ +| body +... +| | padding (0 to 7 octets) | ++-------+-------------------------------------------------------+ +``` + +NOTE: padding octets here and in all subsequent format specifications must= be + written as zero and should be ignored when the stream is read. =20 -NOTE: The record data does not contain an overall length because the -libxenlight record header specifies the length. =20 +| Field | Description | +|--------|------------------------------------------------------| +| `type` | 0x00000000: END | +| | 0x00000001: GLOBAL_DATA | +| | 0x00000002: CONNECTION_DATA | +| | 0x00000003: WATCH_DATA | +| | 0x00000004: TRANSACTION_DATA | +| | 0x00000005: NODE_DATA | +| | 0x00000006 - 0xFFFFFFFF: reserved for future use | +| | | +| `len` | The length (in octets) of `body` | +| | | +| `body` | The type-specific record data | =20 -**NODE_DATA** +Some records will depend on other records in the migration stream. Records +upon which other records depend must always appear earlier in the stream. =20 +The various formats of the type-specific data are described in the followi= ng +sections: =20 -Each NODE_DATA record specifies a single node in xenstore and is formatted -as follows: +\pagebreak =20 +### END + +The end record marks the end of the image, and is the final record +in the stream. =20 ``` - 0 1 2 3 octet -+-------+-------+-------+-------+ -| NODE_DATA | -+-------------------------------+ -| path length | -+-------------------------------+ -| path data | -... -| pad (0 to 3 octets) | -+-------------------------------+ -| perm count (N) | -+-------------------------------+ -| perm0 | -+-------------------------------+ -... -+-------------------------------+ -| permN | -+-------------------------------+ -| value length | -+-------------------------------+ -| value data | -... -| pad (0 to 3 octets) | -+-------------------------------+ + 0 1 2 3 4 5 6 7 octet ++-------+-------+-------+-------+-------+-------+-------+-------+ ``` =20 -where perm0..N are formatted as follows: =20 +The end record contains no fields; its body length is 0. + +\pagebreak + +### GLOBAL_DATA + +This record is only relevant for live update. It contains details of global +xenstored state that needs to be restored. =20 ``` - 0 1 2 3 octet + 0 1 2 3 octet +-------+-------+-------+-------+ -| perm | pad | domid | +| rw-socket-fd | ++-------------------------------+ +| ro-socket-fd | +-------------------------------+ ``` =20 =20 -path length and value length are specified in octets (excluding the NUL -terminator of the path). perm should be one of the ASCII values `w`, `r`, -`b` or `n` as described in [2]. All pad values should be 0. -All paths should be absolute (i.e. start with `/`) and as described in -[2]. +| Field | Description | +|----------------|----------------------------------------------| +| `rw-socket-fd` | The file descriptor of the socket accepting | +| | read-write connections | +| | | +| `ro-socket-fd` | The file descriptor of the socket accepting | +| | read-only connections | =20 +xenstored will resume in the original process context. Hence `rw-socket-fd= ` and +`ro-socket-fd` simply specify the file descriptors of the sockets. =20 -**WATCH_DATA** =20 +\pagebreak =20 -Each WATCH_DATA record specifies a registered watch and is formatted as -follows: +### CONNECTION_DATA + +For live update the image format will contain a `CONNECTION_DATA` record f= or +each connection to xenstore. For migration it will only contain a record f= or +the domain being migrated. =20 =20 ``` - 0 1 2 3 octet -+-------+-------+-------+-------+ -| WATCH_DATA | -+-------------------------------+ -| wpath length | -+-------------------------------+ -| wpath data | -... -| pad (0 to 3 octets) | -+-------------------------------+ + 0 1 2 3 4 5 6 7 octet ++-------+-------+-------+-------+-------+-------+-------+-------+ +| conn-id | conn-type | conn-spec ... ++-------------------------------+-------------------------------+ +| data-len | data +-------------------------------+ -| token length | -+-------------------------------+ -| token data | ... -| pad (0 to 3 octets) | -+-------------------------------+ ``` =20 -wpath length and token length are specified in octets (excluding the NUL -terminator). The wpath should be as described for the `WATCH` operation in -[2]. The token is an arbitrary string of octets not containing any NUL -values. =20 +| Field | Description | +|-------------|-------------------------------------------------| +| `conn-id` | A non-zero number used to identify this | +| | connection in subsequent connection-specific | +| | records | +| | | +| `conn-type` | 0x0000: shared ring | +| | 0x0001: socket | +| | | +| `conn-spec` | See below | +| | | +| `data-len` | The length (in octets) of any pending data not | +| | yet written to the connection | +| | | +| `data` | Pending data (may be empty) | =20 -**TRANSACTION_DATA** +The format of `conn-spec` is dependent upon `conn-type`. =20 +\pagebreak =20 -Each TRANSACTION_DATA record specifies an open transaction and is formatted -as follows: +For `shared ring` connections it is as follows: =20 =20 ``` - 0 1 2 3 octet -+-------+-------+-------+-------+ -| TRANSACTION_DATA | -+-------------------------------+ -| tx_id | -+-------------------------------+ + 0 1 2 3 4 5 6 7 octet + +-------+-------+ + | flags | ++---------------+---------------+---------------+---------------+ +| domid | tdomid | evtchn | ++-------------------------------+-------------------------------+ +| mfn | ++---------------------------------------------------------------+ ``` =20 -where tx_id is the non-zero identifier values of an open transaction. =20 +| Field | Description | +|-----------|---------------------------------------------------| +| `domid` | The domain-id that owns the shared page | +| | | +| `tdomid` | The domain-id that `domid` acts on behalf of if | +| | it has been subject to an SET_TARGET | +| | operation [2] or DOMID_INVALID [3] otherwise | +| | | +| `flags` | Must be zero | +| | | +| `evtchn` | The port number of the interdomain channel used | +| | by `domid` to communicate with xenstored | +| | | +| `mfn` | The MFN of the shared page for a live update or | +| | ~0 (i.e. all bits set) otherwise | =20 -### Protocol Extension +Since the ABI guarantees that entry 1 in `domid`'s grant table will always +contain the GFN of the shared page, so for a live update `mfn` can be used= to +give confidence that `domid` has not been re-cycled during the update. =20 -Before xenstore state is migrated it is necessary to wait for any pending -reads, writes, watch registrations etc. to complete, and also to make sure -that xenstored does not start processing any new requests (so that new -requests remain pending on the shared ring for subsequent processing on the -new host). Hence the following operation is needed: =20 -``` -QUIESCE | +For `socket` connections it is as follows: + =20 -Complete processing of any request issued by the specified domain, and -do not process any further requests from the shared ring. +``` + +-------+-------+ + | flags | ++---------------+---------------+---------------+---------------+ +| socket-fd | pad | ++-------------------------------+-------------------------------+ +| pad | ++---------------------------------------------------------------+ ``` =20 -The `WATCH` operation does not allow specification of a ``; it is -assumed that the watch pertains to the domain that owns the shared ring -over which the operation is passed. Hence, for the tool-stack to be able -to register a watch on behalf of a domain a new operation is needed: =20 -``` -ADD_DOMAIN_WATCHES ||+ +| Field | Description | +|-------------|-------------------------------------------------| +| `flags` | A bit-wise OR of: | +| | 0001: read-only | +| | | +| `socket-fd` | The file descriptor of the connected socket | =20 -Adds watches on behalf of the specified domain. +This type of connection is only relevant for live update, where the xensto= red +resumes in the original process context. Hence `socket-fd` simply specify +the file descriptor of the socket connection. =20 - is a NUL separated tuple of |. The semantics of this -operation are identical to the domain issuing WATCH || for -each . -``` +\pagebreak + +### WATCH_DATA + +The image format will contain a `WATCH_DATA` record for each watch registe= red +by a connection for which there is `CONNECTION_DATA` record previously pre= sent. =20 -The watch information for a domain also needs to be extracted from the -sending xenstored so the following operation is also needed: =20 ``` -GET_DOMAIN_WATCHES | ||* + 0 1 2 3 octet ++-------+-------+-------+-------+ +| conn-id | ++---------------+---------------+ +| wpath-len | token-len | ++---------------+---------------+ +| wpath +... +| token +... +``` + =20 -Gets the list of watches that are currently registered for the domain. +| Field | Description | +|-------------|-------------------------------------------------| +| `conn-id` | The connection that issued the `WATCH` | +| | operation [2] | +| | | +| `wpath-len` | The length (in octets) of `wpath` including the | +| | NUL terminator | +| | | +| `token-len` | The length (in octets) of `token` including the | +| | NUL terminator | +| | | +| `wpath` | The watch path, as specified in the `WATCH` | +| | operation | +| | | +| `token` | The watch identifier token, as specified in the | +| | `WATCH` operation | =20 - is a NUL separated tuple of |. The sub-list returned -will start at items into the the overall list of watches and may -be truncated (at a boundary) such that the returned data fits -within XENSTORE_PAYLOAD_MAX. +\pagebreak =20 -If is beyond the end of the overall list then the returned sub- -list will be empty. If the value of changes then it indicates -that the overall watch list has changed and thus it may be necessary -to re-issue the operation for previous values of . +### TRANSACTION_DATA + +The image format will contain a `TRANSACTION_DATA` record for each transac= tion +that is pending on a connection for which there is `CONNECTION_DATA` record +previously present. + + +``` + 0 1 2 3 octet ++-------+-------+-------+-------+ +| conn-id | ++-------------------------------+ +| tx-id | ++-------------------------------+ ``` =20 -To deal with transactions that were pending when the domain is migrated -it is necessary to start transactions with the same tx_id on behalf of the -domain in the receiving xenstored. =20 -NOTE: For safety each such transaction should result in an `EAGAIN` when -the `TRANSACTION_END` operation is performed, as modifications made under -the tx_id will not be part of the migration stream. +| Field | Description | +|----------------|----------------------------------------------| +| `conn-id` | The connection that issued the | +| | `TRANSACTION_START` operation [2] | +| | | +| `tx-id` | The transaction id passed back to the domain | +| | by the `TRANSACTION_START` operation | + +\pagebreak + +### NODE_DATA + +For live update the image format will contain a `NODE_DATA` record for each +node in xenstore. For migration it will only contain a record for the nodes +relating to the domain being migrated. The `NODE_DATA` may be related to +a _committed_ node (globally visible in xenstored) or a _pending_ node (cr= eated +or modified by a transaction for which there is also a `TRANSACTION_DATA` +record previously present). =20 -The `TRANSACTION_START` operation does not allow specification of a -``; it is assumed that the transaction pertains to the domain that -owns the shared ring over which the operation is passed. Neither does it -allow a `` to be specified; it is always chosen by xenstored. -Hence, for the tool-stack to be able to open a transaction on behalf of a -domain a new operation is needed: =20 ``` -START_DOMAIN_TRANSACTION || + 0 1 2 3 octet ++-------+-------+-------+-------+ +| conn-id | ++-------------------------------+ +| tx-id | ++---------------+---------------+ +| path-len | value-len | ++---------------+---------------+ +| access | perm-count | ++---------------+---------------+ +| perm1 | ++-------------------------------+ +... ++-------------------------------+ +| permN | ++---------------+---------------+ +| path +... +| value +... +``` + + +| Field | Description | +|--------------|------------------------------------------------| +| `conn-id` | If this value is non-zero then this record | +| | related to a pending transaction | +| | | +| `tx-id` | This value should be ignored if `conn-id` is | +| | zero. Otherwise it specifies the id of the | +| | pending transaction | +| | | +| `path-len` | The length (in octets) of `path` including the | +| | NUL terminator | +| | | +| `value-len` | The length (in octets) of `value` (which will | +| | be zero for a deleted node) | +| | | +| `access` | This value should be ignored if this record | +| | does not relate to a pending transaction, | +| | otherwise it specifies the accesses made to | +| | the node and hence is a bitwise OR of: | +| | | +| | 0x0001: read | +| | 0x0002: written | +| | | +| | The value will be zero for a deleted node | +| | | +| `perm-count` | The number (N) of node permission specifiers | +| | (which will be 0 for a node deleted in a | +| | pending transaction) | +| | | +| `perm1..N` | A list of zero or more node permission | +| | specifiers (see below) | +| | | +| `path` | The absolute path of the node | +| | | +| `value` | The node value (which may be empty or contain | +| | NUL octets) | + + +A node permission specifier has the following format: =20 -Starts a transaction on behalf of a domain. =20 -The semantics of this are similar to the domain issuing -TRANSACTION_START and receiving the specified as the response. -The main difference is that the transaction will be immediately marked as -'conflicting' such that when the domain issues TRANSACTION_END T|, it will -result in EAGAIN. +``` + 0 1 2 3 octet ++-------+-------+-------+-------+ +| perm | pad | domid | ++-------+-------+---------------+ ``` =20 -It may also be desirable to state in the protocol specification that -the `INTRODUCE` operation should not clear the `` specified such that -a `RELEASE` operation followed by an `INTRODUCE` operation form an -idempotent pair. The current implementation of *C xentored* does this -(in the `domain_conn_reset()` function) but this could be dropped as this -behaviour is not currently specified and the page will always be zeroed -for a newly created domain. +| Field | Description | +|---------|-----------------------------------------------------| +| `perm` | One of the ASCII values `w`, `r`, `b` or `n` as | +| | specified for the `SET_PERMS` operation [2] | +| | | +| `domid` | The domain-id to which the permission relates | =20 =20 * * * =20 [1] See https://xenbits.xen.org/gitweb/?p=3Dxen.git;a=3Dblob;f=3Ddocs/desi= gns/non-cooperative-migration.md + [2] See https://xenbits.xen.org/gitweb/?p=3Dxen.git;a=3Dblob;f=3Ddocs/misc= /xenstore.txt -[3] See https://xenbits.xen.org/gitweb/?p=3Dxen.git;a=3Dblob;f=3Ddocs/spec= s/libxl-migration-stream.pandoc + +[3] See https://xenbits.xen.org/gitweb/?p=3Dxen.git;a=3Dblob;f=3Dxen/inclu= de/public/xen.h;hb=3DHEAD#l612 diff --git a/docs/misc/xenstore.txt b/docs/misc/xenstore.txt index 04ce0ba607..cb8009cb68 100644 --- a/docs/misc/xenstore.txt +++ b/docs/misc/xenstore.txt @@ -289,23 +289,6 @@ IS_DOMAIN_INTRODUCED | T| or F| ie, if INTRODUCE for the domain has not yet been followed by domain destruction or explicit RELEASE. =20 -RESUME | - - Arranges that @releaseDomain events will once more be - generated when the domain becomes shut down. This might have - to be used if a domain were to be shut down (generating one - @releaseDomain) and then subsequently restarted, since the - state-sensitive algorithm in xenstored will not otherwise send - further watch event notifications if the domain were to be - shut down again. - - It is not clear whether this is possible since one would - normally expect a domain not to be restarted after being shut - down without being destroyed in the meantime. There are - currently no users of this request in xen-unstable. - - xenstored prevents the use of RESUME other than by dom0. - SET_TARGET || Notifies xenstored that domain is targeting domain . This grants domain full access to paths --=20 2.17.1