From: Stefan Hajnoczi <stefanha@redhat.com>
To: qemu-devel@nongnu.org
Cc: "Anthony Liguori" <aliguori@us.ibm.com>,
"Stefan Hajnoczi" <stefanha@redhat.com>,
"陳韋任 (Wei-Ren Chen)" <chenwj@iis.sinica.edu.tw>
Subject: [Qemu-devel] [PATCH 6/8] Use proper term in TCG README
Date: Fri, 22 Mar 2013 16:14:19 +0100 [thread overview]
Message-ID: <1363965261-22267-7-git-send-email-stefanha@redhat.com> (raw)
In-Reply-To: <1363965261-22267-1-git-send-email-stefanha@redhat.com>
From: 陳韋任 (Wei-Ren Chen) <chenwj@iis.sinica.edu.tw>
In TCG, "target" means the host architecture for which TCG generates
the code. Using "guest" rather than "target" to make the document more
consistent.
Signed-off-by: Chen Wei-Ren <chenwj@iis.sinica.edu.tw>
Reviewed-by: Peter Maydell <peter.maydell@linaro.org>
Signed-off-by: Stefan Hajnoczi <stefanha@redhat.com>
---
tcg/README | 14 +++++++++-----
1 file changed, 9 insertions(+), 5 deletions(-)
diff --git a/tcg/README b/tcg/README
index 934e7af..063aeb9 100644
--- a/tcg/README
+++ b/tcg/README
@@ -14,6 +14,10 @@ the emulated architecture. As TCG started as a generic C backend used
for cross compiling, it is assumed that the TCG target is different
from the host, although it is never the case for QEMU.
+In this document, we use "guest" to specify what architecture we are
+emulating; "target" always means the TCG target, the machine on which
+we are running QEMU.
+
A TCG "function" corresponds to a QEMU Translated Block (TB).
A TCG "temporary" is a variable only live in a basic
@@ -379,7 +383,7 @@ double-word product T0. The later is returned in two single-word outputs.
Similar to mulu2, except the two inputs T1 and T2 are signed.
-********* 64-bit target on 32-bit host support
+********* 64-bit guest on 32-bit host support
The following opcodes are internal to TCG. Thus they are to be implemented by
32-bit host code generators, but are not to be emitted by guest translators.
@@ -521,9 +525,9 @@ register.
a better generated code, but it reduces the memory usage of TCG and
the speed of the translation.
-- Don't hesitate to use helpers for complicated or seldom used target
+- Don't hesitate to use helpers for complicated or seldom used guest
instructions. There is little performance advantage in using TCG to
- implement target instructions taking more than about twenty TCG
+ implement guest instructions taking more than about twenty TCG
instructions. Note that this rule of thumb is more applicable to
helpers doing complex logic or arithmetic, where the C compiler has
scope to do a good job of optimisation; it is less relevant where
@@ -531,9 +535,9 @@ register.
inline TCG may still be faster for longer sequences.
- The hard limit on the number of TCG instructions you can generate
- per target instruction is set by MAX_OP_PER_INSTR in exec-all.h --
+ per guest instruction is set by MAX_OP_PER_INSTR in exec-all.h --
you cannot exceed this without risking a buffer overrun.
- Use the 'discard' instruction if you know that TCG won't be able to
prove that a given global is "dead" at a given program point. The
- x86 target uses it to improve the condition codes optimisation.
+ x86 guest uses it to improve the condition codes optimisation.
--
1.8.1.4
next prev parent reply other threads:[~2013-03-22 15:14 UTC|newest]
Thread overview: 9+ messages / expand[flat|nested] mbox.gz Atom feed top
2013-03-22 15:14 [Qemu-devel] [PULL 0/8] Trivial patches for 9 to 22 March 2013 Stefan Hajnoczi
2013-03-22 15:14 ` [Qemu-devel] [PATCH 1/8] MinGW: Replace setsockopt by qemu_setsocketopt Stefan Hajnoczi
2013-03-22 15:14 ` [Qemu-devel] [PATCH 2/8] memory: fix a bug of detection of memory region collision Stefan Hajnoczi
2013-03-22 15:14 ` [Qemu-devel] [PATCH 3/8] Advertise --libdir in configure --help output Stefan Hajnoczi
2013-03-22 15:14 ` [Qemu-devel] [PATCH 4/8] Fix typos and misspellings Stefan Hajnoczi
2013-03-22 15:14 ` [Qemu-devel] [PATCH 5/8] serial: Fix debug format strings Stefan Hajnoczi
2013-03-22 15:14 ` Stefan Hajnoczi [this message]
2013-03-22 15:14 ` [Qemu-devel] [PATCH 7/8] gitignore: ignore more files Stefan Hajnoczi
2013-03-22 15:14 ` [Qemu-devel] [PATCH 8/8] qdev: remove redundant abort() Stefan Hajnoczi
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=1363965261-22267-7-git-send-email-stefanha@redhat.com \
--to=stefanha@redhat.com \
--cc=aliguori@us.ibm.com \
--cc=chenwj@iis.sinica.edu.tw \
--cc=qemu-devel@nongnu.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).