Re: [PATCH v2 8/9] docs: Document block-script protocol

["Roger Pau Monné" <roger.pau@citrix.com>]

On Mon, 21 Mar 2016, George Dunlap wrote:
> Signed-off-by: George Dunlap <george.dunlap@citrix.com>
> ---
> Changes since v1:
> - Attempt to make a clear distinction between custom hotplug scripts
> and the script called for raw physical devices and files
> 
> CC: Ian Jackson <ian.jackson@citrix.com>
> CC: Wei Liu <wei.liu2@citrix.com>
> CC: Roger Pau Monne <roger.pau@citrix.com>
> ---
>  docs/misc/block-scripts.txt | 101 ++++++++++++++++++++++++++++++++++++++++++++
>  1 file changed, 101 insertions(+)
> 
> diff --git a/docs/misc/block-scripts.txt b/docs/misc/block-scripts.txt
> new file mode 100644
> index 0000000..6dd5d48
> --- /dev/null
> +++ b/docs/misc/block-scripts.txt
> @@ -0,0 +1,101 @@
[...]
> +Inputs
> +------
> +
> +In all cases, the scripts are called with either "add" or "remove" as
> +the command.  For custom scripts, the command will be the first
> +argument of the script (i.e. $1).
> +
> +The environment variable XENBUS_PATH will be set to the
> +path for the block device to be created.

This is true for Linux, but not for NetBSD. On NetBSD no env variables are 
needed, and everything is passed as arguments using the following format:

./<script> <backend_path> <xenbus state>

Where xenbus state is either 2 or 6.

On FreeBSD I'm aiming of using the same input interface for both block and 
network scripts, and it is the following:

./<script> {add/remove} <backend path>

With no env variables provided at all. So either this section is expanded, 
or it is labelled as "Linux Inputs".

Roger.

_______________________________________________
Xen-devel mailing list
Xen-devel@lists.xen.org
http://lists.xen.org/xen-devel