OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

virtio-comment message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: [PATCH RESEND] Documentation: virtio: Add emergency write (emerg_wr) config register in virtio console.


This patch updates virtio spec lyx for adding emergency write to 
virtio console.

Original patch series related to this is -:
http://lkml.org/lkml/2013/5/6/167

Signed-off-by: Pranavkumar Sawargaonkar <pranavkumar@linaro.org>
Signed-off-by: Anup Patel <anup.patel@linaro.org>
Signed-off-by: Rusty Russell <rusty@rustcorp.com.au>
---

diff --git a/virtio-spec.lyx b/virtio-spec.lyx
index 73e22e7..adec0a5 100644
--- a/virtio-spec.lyx
+++ b/virtio-spec.lyx
@@ -6835,6 +6835,17 @@ VIRTIO_CONSOLE_F_SIZE
 VIRTIO_CONSOLE_F_MULTIPORT(1) Device has support for multiple ports; configurati
 on fields nr_ports and max_nr_ports are valid and control virtqueues will
  be used.
+\change_inserted 1112500848 1368412890
+
+\end_layout
+
+\begin_layout Description
+
+\change_inserted 1112500848 1368412929
+VIRTIO_CONSOLE_F_EMERG_WRITE(2) Device has support for emergency write.
+ Configuration field emerg_wr is valid.
+\change_unchanged
+
 \end_layout
 
 \end_deeper
@@ -6851,6 +6862,14 @@ layout The size of the console is supplied in the configuration space if
  the VIRTIO_CONSOLE_F_SIZE feature is set.
  Furthermore, if the VIRTIO_CONSOLE_F_MULTIPORT feature is set, the maximum
  number of ports supported by the device can be fetched.
+
+\change_inserted 1112500848 1368412999
+ If VIRTIO_CONSOLE_F_EMERG_WRITE is set then one can use emergency write
+ to output single character without initializing virtio queues, or even
+ acknowledging the feature.
+ 
+\change_unchanged
+
 \begin_inset listings
 inline false
 status open
@@ -6877,6 +6896,17 @@ struct virtio_console_config {
 \begin_layout Plain Layout
 
 	u32 max_nr_ports;
+\change_inserted 1112500848 1368413026
+
+\end_layout
+
+\begin_layout Plain Layout
+
+\change_inserted 1112500848 1368413032
+
+    u32 emerg_wr;
+\change_unchanged
+
 \end_layout
 
 \begin_layout Plain Layout
@@ -6894,6 +6924,16 @@ Device Initialization
 \end_layout
 
 \begin_layout Enumerate
+
+\change_inserted 1112500848 1368413220
+If the VIRTIO_CONSOLE_F_EMERG_WRITE feature is offered, the emerg_wr field
+ of the configuration can be written at any time.
+ Thus it should work for very early boot debugging output as well as catastophic
+ OS failures (eg.
+ virtio ring corruption).
+\end_layout
+
+\begin_layout Enumerate
 If the VIRTIO_CONSOLE_F_SIZE feature is negotiated, the driver can read
  the console dimensions from the configuration fields.
 \end_layout



[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]