WARNING - OLD ARCHIVES

This is an archived copy of the Xen.org mailing list, which we have preserved to ensure that existing links to archives are not broken. The live archive, which contains the latest emails, can be found at http://lists.xen.org/
   
 
 
Xen 
 
Home Products Support Community News
 
   
 

xen-changelog

[Xen-changelog] [xen-unstable] Fix network model by moving Network.NIC a

To: xen-changelog@xxxxxxxxxxxxxxxxxxx
Subject: [Xen-changelog] [xen-unstable] Fix network model by moving Network.NIC and Network.VLAN onto a new PIF class.
From: Xen patchbot-unstable <patchbot-unstable@xxxxxxxxxxxxxxxxxxx>
Date: Thu, 02 Nov 2006 22:09:26 +0000
Delivery-date: Thu, 02 Nov 2006 21:42:30 -0800
Envelope-to: www-data@xxxxxxxxxxxxxxxxxx
List-help: <mailto:xen-changelog-request@lists.xensource.com?subject=help>
List-id: BK change log <xen-changelog.lists.xensource.com>
List-post: <mailto:xen-changelog@lists.xensource.com>
List-subscribe: <http://lists.xensource.com/cgi-bin/mailman/listinfo/xen-changelog>, <mailto:xen-changelog-request@lists.xensource.com?subject=subscribe>
List-unsubscribe: <http://lists.xensource.com/cgi-bin/mailman/listinfo/xen-changelog>, <mailto:xen-changelog-request@lists.xensource.com?subject=unsubscribe>
Reply-to: xen-devel@xxxxxxxxxxxxxxxxxxx
Sender: xen-changelog-bounces@xxxxxxxxxxxxxxxxxxx
# HG changeset patch
# User Ewan Mellor <ewan@xxxxxxxxxxxxx>
# Node ID d94dec09558aea721e82caff67b35ee1093bfc6a
# Parent  d1b8acfaf9bef346f4556469c8867854d985e283
Fix network model by moving Network.NIC and Network.VLAN onto a new PIF class.
Also, merge network and disk bandwidth into a single io/ namespace.

Signed-off-by: Ewan Mellor <ewan@xxxxxxxxxxxxx>
---
 docs/xen-api/xenapi-datamodel.tex |  298 ++++++++------------------------------
 1 files changed, 66 insertions(+), 232 deletions(-)

diff -r d1b8acfaf9be -r d94dec09558a docs/xen-api/xenapi-datamodel.tex
--- a/docs/xen-api/xenapi-datamodel.tex Thu Oct 26 15:03:47 2006 +0100
+++ b/docs/xen-api/xenapi-datamodel.tex Thu Oct 26 15:35:18 2006 +0100
@@ -5020,8 +5020,6 @@ Quals & Field & Type & Description \\
 $\mathit{RW}$ &  {\tt name/label} & string & a human-readable name \\
 $\mathit{RW}$ &  {\tt name/description} & string & a notes field containg 
human-readable description \\
 $\mathit{RO}_\mathit{run}$ &  {\tt VIFs} & (VIF ref) Set & list of connected 
vifs \\
-$\mathit{RW}$ &  {\tt NIC} & string & ethernet device to use to access this 
network. Note: in this revision of the API all hosts will use the specified NIC 
to access this network \\
-$\mathit{RW}$ &  {\tt VLAN} & string & VLAN tag to use to access this network. 
Note: in this revision of the API all hosts will use the specified VLAN tag to 
access this network \\
 $\mathit{RW}$ &  {\tt default\_gateway} & string & default gateway IP address. 
Used for auto-configuring guests with fixed IP setting \\
 $\mathit{RW}$ &  {\tt default\_netmask} & string & default netmask. Used for 
auto-configuring guests with fixed IP setting \\
 \hline
@@ -5241,138 +5239,6 @@ get accessor message derived from field 
 
 
 value of the field
-\vspace{0.3cm}
-\vspace{0.3cm}
-\vspace{0.3cm}
-\subsubsection{RPC name:~get\_NIC}
-
-{\bf Overview:} 
-get accessor message derived from field NIC of object network
-
- \noindent {\bf Signature:} 
-\begin{verbatim} string get_NIC (session_id s, network ref self)\end{verbatim}
-
-
-\noindent{\bf Arguments:}
-
- 
-\vspace{0.3cm}
-\begin{tabular}{|c|c|p{7cm}|}
- \hline
-{\bf type} & {\bf name} & {\bf description} \\ \hline
-{\tt network ref } & self & object instance \\ \hline 
-
-\end{tabular}
-
-\vspace{0.3cm}
-
- \noindent {\bf Return Type:} 
-{\tt 
-string
-}
-
-
-value of the field
-\vspace{0.3cm}
-\vspace{0.3cm}
-\vspace{0.3cm}
-\subsubsection{RPC name:~set\_NIC}
-
-{\bf Overview:} 
-set accessor message derived from field NIC of object network
-
- \noindent {\bf Signature:} 
-\begin{verbatim} void set_NIC (session_id s, network ref self, string 
value)\end{verbatim}
-
-
-\noindent{\bf Arguments:}
-
- 
-\vspace{0.3cm}
-\begin{tabular}{|c|c|p{7cm}|}
- \hline
-{\bf type} & {\bf name} & {\bf description} \\ \hline
-{\tt network ref } & self & object instance \\ \hline 
-
-{\tt string } & value & New value to set \\ \hline 
-
-\end{tabular}
-
-\vspace{0.3cm}
-
- \noindent {\bf Return Type:} 
-{\tt 
-void
-}
-
-
-
-\vspace{0.3cm}
-\vspace{0.3cm}
-\vspace{0.3cm}
-\subsubsection{RPC name:~get\_VLAN}
-
-{\bf Overview:} 
-get accessor message derived from field VLAN of object network
-
- \noindent {\bf Signature:} 
-\begin{verbatim} string get_VLAN (session_id s, network ref self)\end{verbatim}
-
-
-\noindent{\bf Arguments:}
-
- 
-\vspace{0.3cm}
-\begin{tabular}{|c|c|p{7cm}|}
- \hline
-{\bf type} & {\bf name} & {\bf description} \\ \hline
-{\tt network ref } & self & object instance \\ \hline 
-
-\end{tabular}
-
-\vspace{0.3cm}
-
- \noindent {\bf Return Type:} 
-{\tt 
-string
-}
-
-
-value of the field
-\vspace{0.3cm}
-\vspace{0.3cm}
-\vspace{0.3cm}
-\subsubsection{RPC name:~set\_VLAN}
-
-{\bf Overview:} 
-set accessor message derived from field VLAN of object network
-
- \noindent {\bf Signature:} 
-\begin{verbatim} void set_VLAN (session_id s, network ref self, string 
value)\end{verbatim}
-
-
-\noindent{\bf Arguments:}
-
- 
-\vspace{0.3cm}
-\begin{tabular}{|c|c|p{7cm}|}
- \hline
-{\bf type} & {\bf name} & {\bf description} \\ \hline
-{\tt network ref } & self & object instance \\ \hline 
-
-{\tt string } & value & New value to set \\ \hline 
-
-\end{tabular}
-
-\vspace{0.3cm}
-
- \noindent {\bf Return Type:} 
-{\tt 
-void
-}
-
-
-
 \vspace{0.3cm}
 \vspace{0.3cm}
 \vspace{0.3cm}
@@ -5741,10 +5607,8 @@ Quals & Field & Type & Description \\
 $\mathit{RW}$ &  {\tt VM} & VM ref & virtual machine to which this vif is 
connected \\
 $\mathit{RW}$ &  {\tt MAC} & string & ethernet MAC address of virtual 
interface, as exposed to guest \\
 $\mathit{RW}$ &  {\tt MTU} & int & MTU in octets \\
-$\mathit{RO}_\mathit{run}$ &  {\tt network\_read\_kbs} & float & Incoming 
network bandwidth \\
-$\mathit{RO}_\mathit{run}$ &  {\tt network\_write\_kbs} & float & Outgoing 
network bandwidth \\
-$\mathit{RO}_\mathit{run}$ &  {\tt IO\_bandwidth/incoming\_kbs} & float & Read 
bandwidth (Kb/s) \\
-$\mathit{RO}_\mathit{run}$ &  {\tt IO\_bandwidth/outgoing\_kbs} & float & 
Write bandwidth (Kb/s) \\
+$\mathit{RO}_\mathit{run}$ &  {\tt io/read\_kbs} & float & Read bandwidth 
(KiB/s) \\
+$\mathit{RO}_\mathit{run}$ &  {\tt io/write\_kbs} & float & Write bandwidth 
(KiB/s) \\
 \hline
 \end{longtable}
 \subsection{Additional RPCs associated with class: VIF}
@@ -6242,13 +6106,13 @@ void
 \vspace{0.3cm}
 \vspace{0.3cm}
 \vspace{0.3cm}
-\subsubsection{RPC name:~get\_network\_read\_kbs}
-
-{\bf Overview:} 
-get accessor message derived from field network\_read\_kbs of object VIF
-
- \noindent {\bf Signature:} 
-\begin{verbatim} float get_network_read_kbs (session_id s, VIF ref 
self)\end{verbatim}
+\subsubsection{RPC name:~get\_io\_read\_kbs}
+
+{\bf Overview:} 
+get accessor message derived from field io/read\_kbs of object VIF
+
+ \noindent {\bf Signature:} 
+\begin{verbatim} float get_io_read_kbs (session_id s, VIF ref 
self)\end{verbatim}
 
 
 \noindent{\bf Arguments:}
@@ -6274,77 +6138,13 @@ value of the field
 \vspace{0.3cm}
 \vspace{0.3cm}
 \vspace{0.3cm}
-\subsubsection{RPC name:~get\_network\_write\_kbs}
-
-{\bf Overview:} 
-get accessor message derived from field network\_write\_kbs of object VIF
-
- \noindent {\bf Signature:} 
-\begin{verbatim} float get_network_write_kbs (session_id s, VIF ref 
self)\end{verbatim}
-
-
-\noindent{\bf Arguments:}
-
- 
-\vspace{0.3cm}
-\begin{tabular}{|c|c|p{7cm}|}
- \hline
-{\bf type} & {\bf name} & {\bf description} \\ \hline
-{\tt VIF ref } & self & object instance \\ \hline 
-
-\end{tabular}
-
-\vspace{0.3cm}
-
- \noindent {\bf Return Type:} 
-{\tt 
-float
-}
-
-
-value of the field
-\vspace{0.3cm}
-\vspace{0.3cm}
-\vspace{0.3cm}
-\subsubsection{RPC name:~get\_IO\_bandwidth\_incoming\_kbs}
-
-{\bf Overview:} 
-get accessor message derived from field IO\_bandwidth/incoming\_kbs of object 
VIF
-
- \noindent {\bf Signature:} 
-\begin{verbatim} float get_IO_bandwidth_incoming_kbs (session_id s, VIF ref 
self)\end{verbatim}
-
-
-\noindent{\bf Arguments:}
-
- 
-\vspace{0.3cm}
-\begin{tabular}{|c|c|p{7cm}|}
- \hline
-{\bf type} & {\bf name} & {\bf description} \\ \hline
-{\tt VIF ref } & self & object instance \\ \hline 
-
-\end{tabular}
-
-\vspace{0.3cm}
-
- \noindent {\bf Return Type:} 
-{\tt 
-float
-}
-
-
-value of the field
-\vspace{0.3cm}
-\vspace{0.3cm}
-\vspace{0.3cm}
-\subsubsection{RPC name:~get\_IO\_bandwidth\_outgoing\_kbs}
-
-{\bf Overview:} 
-get accessor message derived from field IO\_bandwidth/outgoing\_kbs of object 
VIF
-
- \noindent {\bf Signature:} 
-\begin{verbatim} float get_IO_bandwidth_outgoing_kbs (session_id s, VIF ref 
self)\end{verbatim}
+\subsubsection{RPC name:~get\_io\_write\_kbs}
+
+{\bf Overview:} 
+get accessor message derived from field io/write\_kbs of object VIF
+
+ \noindent {\bf Signature:} 
+\begin{verbatim} float get_io_write_kbs (session_id s, VIF ref 
self)\end{verbatim}
 
 
 \noindent{\bf Arguments:}
@@ -8147,11 +7947,45 @@ Quals & Field & Type & Description \\
 $\mathit{RW}$ &  {\tt device} & string & device seen by the guest e.g. hda1 \\
 $\mathit{RW}$ &  {\tt mode} & vbd\_mode & the mode the disk should be mounted 
with \\
 $\mathit{RW}$ &  {\tt driver} & driver\_type & the style of driver \\
-$\mathit{RO}_\mathit{run}$ &  {\tt IO\_bandwidth/incoming\_kbs} & float & Read 
bandwidth (Kb/s) \\
-$\mathit{RO}_\mathit{run}$ &  {\tt IO\_bandwidth/outgoing\_kbs} & float & 
Write bandwidth (Kb/s) \\
+$\mathit{RO}_\mathit{run}$ &  {\tt io/read\_kbs} & float & Read bandwidth 
(KiB/s) \\
+$\mathit{RO}_\mathit{run}$ &  {\tt io/write\_kbs} & float & Write bandwidth 
(KiB/s) \\
 \hline
 \end{longtable}
 \subsection{Additional RPCs associated with class: VBD}
+\subsubsection{RPC name:~media\_change}
+
+{\bf Overview:} 
+Change the media in the device for CDROM-like devices only. For other devices, 
detach the VBD and attach a new one
+
+ \noindent {\bf Signature:} 
+\begin{verbatim} void media_change (session_id s, VBD ref vbd, VDI ref 
vdi)\end{verbatim}
+
+
+\noindent{\bf Arguments:}
+
+ 
+\vspace{0.3cm}
+\begin{tabular}{|c|c|p{7cm}|}
+ \hline
+{\bf type} & {\bf name} & {\bf description} \\ \hline
+{\tt VBD ref } & vbd & The vbd representing the CDROM-like device \\ \hline 
+
+{\tt VDI ref } & vdi & The new VDI to 'insert' \\ \hline 
+
+\end{tabular}
+
+\vspace{0.3cm}
+
+ \noindent {\bf Return Type:} 
+{\tt 
+void
+}
+
+
+
+\vspace{0.3cm}
+\vspace{0.3cm}
+\vspace{0.3cm}
 \subsubsection{RPC name:~get\_uuid}
 
 {\bf Overview:} 
@@ -8514,13 +8348,13 @@ void
 \vspace{0.3cm}
 \vspace{0.3cm}
 \vspace{0.3cm}
-\subsubsection{RPC name:~get\_IO\_bandwidth\_incoming\_kbs}
-
-{\bf Overview:} 
-get accessor message derived from field IO\_bandwidth/incoming\_kbs of object 
VBD
-
- \noindent {\bf Signature:} 
-\begin{verbatim} float get_IO_bandwidth_incoming_kbs (session_id s, VBD ref 
self)\end{verbatim}
+\subsubsection{RPC name:~get\_io\_read\_kbs}
+
+{\bf Overview:} 
+get accessor message derived from field io/read\_kbs of object VBD
+
+ \noindent {\bf Signature:} 
+\begin{verbatim} float get_io_read_kbs (session_id s, VBD ref 
self)\end{verbatim}
 
 
 \noindent{\bf Arguments:}
@@ -8546,13 +8380,13 @@ value of the field
 \vspace{0.3cm}
 \vspace{0.3cm}
 \vspace{0.3cm}
-\subsubsection{RPC name:~get\_IO\_bandwidth\_outgoing\_kbs}
-
-{\bf Overview:} 
-get accessor message derived from field IO\_bandwidth/outgoing\_kbs of object 
VBD
-
- \noindent {\bf Signature:} 
-\begin{verbatim} float get_IO_bandwidth_outgoing_kbs (session_id s, VBD ref 
self)\end{verbatim}
+\subsubsection{RPC name:~get\_io\_write\_kbs}
+
+{\bf Overview:} 
+get accessor message derived from field io/write\_kbs of object VBD
+
+ \noindent {\bf Signature:} 
+\begin{verbatim} float get_io_write_kbs (session_id s, VBD ref 
self)\end{verbatim}
 
 
 \noindent{\bf Arguments:}

_______________________________________________
Xen-changelog mailing list
Xen-changelog@xxxxxxxxxxxxxxxxxxx
http://lists.xensource.com/xen-changelog

<Prev in Thread] Current Thread [Next in Thread>
  • [Xen-changelog] [xen-unstable] Fix network model by moving Network.NIC and Network.VLAN onto a new PIF class., Xen patchbot-unstable <=