--- /dev/null
+
+\documentclass[11pt]{article}
+
+\usepackage{calc}
+\usepackage{graphics}
+%\usepackage{latex8}
+\usepackage{times}
+\usepackage{epsf}
+\usepackage{epsfig}
+\usepackage{graphicx}
+\usepackage{changebar}
+\usepackage{portland}
+\usepackage{lscape}
+
+\setlength{\textheight}{8.50in}
+\setlength{\textwidth}{6.5in}
+\setlength{\topmargin}{-0.3in}
+%\setlength{\leftmargin}{2.9in}
+%\setlength{\rightmargin}{-2.9in}
+\setlength{\oddsidemargin}{0in}
+\setlength{\parindent}{0.5in}
+
+
+\begin{document}
+
+\title{
+\includegraphics[height=1.5in]{v3vee.pdf}
+\includegraphics[height=1.5in]{palacios.pdf} \\
+\vspace{0.5in}
+Palacios Internal Developer Manual
+}
+\author{Jack Lange \hspace{0.5in} Lei Xia}
+
+\maketitle
+
+
+\section{Organization}
+
+
+\section{Checking out Palacios}
+
+Checkout or clone the devel branch of Palacios from the master
+repository. You should have the read permission to these branches.
+
+
+\section{Checking out Kitten}
+
+hg clone /home/palacios/kitten
+
+git clone /home/palacios/palacios
+
+/opt/vmm-tools/bin/checkout\_branch devel
+
+
+\section{Compiling Palacios}
+cd palacios/build/
+
+
+This will build Palacios as a library, libv3vee.a in the palacios/palacios/build/.
+
+
+\section{Compiling Kitten}
+\subsection{Configuration}
+Kitten building can be configured by either text or graph configure interface, which is similar to the Linux kernel configure, By one of the following commands:
+
+make xconfig
+make config
+make menuconfig
+
+Make sure turn on the network device driver, networking, and input kernel command 'console=serial net=rtl8139'
+\subsection{Compilation}
+
+Build Palacios as a module for Kitten
+In the first time, make sure to build Kitten before you building the Palacios as the module to kitten.
+Palacios now is built as a module of the Kitten. You can find the palacios.c and palacios.h in the kitten/palacios/. Enter the directory, build the palacios module.
+
+cd kitten/palacios
+make -C .. M=`pwd`
+cp built-in.o ../modules/palacios-mod.o
+Build Kitten
+Go back to kitten root directory, and build the Kitten again.
+
+make isoimage
+
+\section{Running Palacios/Kitten}
+Run the whole stuff built above in Qemu using following command:
+
+/usr/local/qemu/bin/qemu-system-x86\_64 -smp 1 -m 1024 -serial file:./serial.out -cdrom ./arch/x86\_64/boot/image.iso -net tap, ifname=tap0 < /dev/null
+
+
+\section{networking}
+
+\section{Configuring the development host's Qemu network}
+Set up Tap interfaces:
+
+/root/util/tap\_create tapX
+
+Bridging tapX with eth1 will only work (work = send packet and also make packet visible on localhost) if the IP address is set correctly (correctly = match network it is connected to e.g., network of eth1) so bring up the network inside of the VM / QEMU as 10-net, and it should route through the eth1 rule and be visible both on the host and in the physical network
+
+
+\subsection{Configuring Kitten}
+
+How to set ip address in kitten:
+
+Kitten ip address setting is in file drivers/net/ne2k/rtl8139.c, in the code below which is located in function rtl8139\_init.
+
+ struct ip\_addr ipaddr = { htonl(0 | 10 << 24 | 0 << 16 | 2 << 8 | 16 << 0) };
+ struct ip\_addr netmask = { htonl(0xffffff00) };
+ struct ip\_addr gw = { htonl(0 | 10 << 24 | 0 << 16 | 2 << 8 | 2 << 0) };
+
+This sets the ip address as 10.0.2.16, netmask 255.255.255.0 and gateway address 10.0.2.2, change it as you need.
+
+
+
+\subsection{Running with networking}
+
+\paragraph*{Tap Interface}
+In which, the command line:
+
+-net tap, ifname=tap2
+
+specifies Qemu to use the host's tap0 as its network interface, then Qemu can access the host's physical network.
+
+\paragraph*{Redirection}
+
+Also you can use the following command instead to redirect host's 9555 port to Qemu's 80 port.
+
+-net user -net nic,model=rtl8139 -redir tcp:9555::80
+
+In this case, you can access Qemu's 80 port in the host like:
+
+telnet localhost 9555
+
+Qemu has many options to build up a virtual or real networking. See http://www.h7.dion.ne.jp/~qemu-win/HowToNetwork-en.html for more information.
+
+
+
+
+For more questions, talk to Jack or Lei.
+
+\end{document}
+++ /dev/null
-This is pdfeTeX, Version 3.141592-1.21a-2.2 (Web2C 7.5.4) (format=pdflatex 2007.11.27) 27 FEB 2009 13:22
-entering extended mode
-**paper.tex
-(./paper.tex
-LaTeX2e <2003/12/01>
-Babel <v3.8d> and hyphenation patterns for american, french, german, ngerman, b
-ahasa, basque, bulgarian, catalan, croatian, czech, danish, dutch, esperanto, e
-stonian, finnish, greek, icelandic, irish, italian, latin, magyar, norsk, polis
-h, portuges, romanian, russian, serbian, slovak, slovene, spanish, swedish, tur
-kish, ukrainian, nohyphenation, loaded.
-(/usr/share/texmf/tex/latex/base/article.cls
-Document Class: article 2004/02/16 v1.4f Standard LaTeX document class
-(/usr/share/texmf/tex/latex/base/size11.clo
-File: size11.clo 2004/02/16 v1.4f Standard LaTeX file (size option)
-)
-\c@part=\count79
-\c@section=\count80
-\c@subsection=\count81
-\c@subsubsection=\count82
-\c@paragraph=\count83
-\c@subparagraph=\count84
-\c@figure=\count85
-\c@table=\count86
-\abovecaptionskip=\skip41
-\belowcaptionskip=\skip42
-\bibindent=\dimen102
-)
-(/usr/share/texmf/tex/latex/tools/calc.sty
-Package: calc 1998/07/07 v4.1b Infix arithmetic (KKT,FJ)
-\calc@Acount=\count87
-\calc@Bcount=\count88
-\calc@Adimen=\dimen103
-\calc@Bdimen=\dimen104
-\calc@Askip=\skip43
-\calc@Bskip=\skip44
-LaTeX Info: Redefining \setlength on input line 59.
-LaTeX Info: Redefining \addtolength on input line 60.
-\calc@denominator=\count89
-)
-(/usr/share/texmf/tex/latex/graphics/graphics.sty
-Package: graphics 2001/07/07 v1.0n Standard LaTeX Graphics (DPC,SPQR)
-
-(/usr/share/texmf/tex/latex/graphics/trig.sty
-Package: trig 1999/03/16 v1.09 sin cos tan (DPC)
-)
-(/usr/share/texmf/tex/latex/graphics/graphics.cfg
-File: graphics.cfg 2005/02/03 v1.3 graphics configuration of teTeX/TeXLive
-)
-Package graphics Info: Driver file: pdftex.def on input line 80.
-
-(/usr/share/texmf/tex/latex/graphics/pdftex.def
-File: pdftex.def 2002/06/19 v0.03k graphics/color for pdftex
-\Gread@gobject=\count90
-))
-(/usr/share/texmf/tex/latex/psnfss/times.sty
-Package: times 2004/09/15 PSNFSS-v9.2 (SPQR)
-)
-(/usr/share/texmf/tex/generic/epsf/epsf.tex
-This is `epsf.tex' v2.7k <10 July 1997>
-\epsffilein=\read1
-\epsfframemargin=\dimen105
-\epsfframethickness=\dimen106
-\epsfrsize=\dimen107
-\epsftmp=\dimen108
-\epsftsize=\dimen109
-\epsfxsize=\dimen110
-\epsfysize=\dimen111
-\pspoints=\dimen112
-\epsfnoopenhelp=\toks14
-) (/usr/share/texmf/tex/latex/graphics/epsfig.sty
-Package: epsfig 1999/02/16 v1.7a (e)psfig emulation (SPQR)
-
-(/usr/share/texmf/tex/latex/graphics/graphicx.sty
-Package: graphicx 1999/02/16 v1.0f Enhanced LaTeX Graphics (DPC,SPQR)
-
-(/usr/share/texmf/tex/latex/graphics/keyval.sty
-Package: keyval 1999/03/16 v1.13 key=value parser (DPC)
-\KV@toks@=\toks15
-)
-\Gin@req@height=\dimen113
-\Gin@req@width=\dimen114
-)
-\epsfxsize=\dimen115
-\epsfysize=\dimen116
-)
-(/usr/share/texmf/tex/latex/changebar/changebar.sty
-Package: changebar 2004/02/20 v3.4g Indicate changes with marginal bars
-\cb@nextpoint=\count91
-\cb@topleft=\count92
-\cb@topright=\count93
-\cb@botleft=\count94
-\cb@botright=\count95
-\cb@cnta=\count96
-\cb@cntb=\count97
-\cb@dima=\dimen117
-\cb@curbarwd=\dimen118
-\cb@page=\count98
-\cb@pagecount=\count99
-\cb@odd@left=\dimen119
-\cb@odd@right=\dimen120
-\cb@even@left=\dimen121
-\cb@even@right=\dimen122
-\changebarwidth=\skip45
-\deletebarwidth=\skip46
-\changebarsep=\skip47
-\c@changebargrey=\count100
-\cb@write=\write3
-\cb@read=\read2
-\openout3 = `paper.cb'.
-
-)
-(/usr/share/texmf/tex/latex/portland/portland.sty
-\paperheight=\dimen123
-\phoffset=\dimen124
-\pvoffset=\dimen125
-\ptextwidth=\dimen126
-\ptextheight=\dimen127
-\ptopmargin=\dimen128
-\poddsidemargin=\dimen129
-\pevensidemargin=\dimen130
-\lhoffset=\dimen131
-\lvoffset=\dimen132
-\ltextwidth=\dimen133
-\ltextheight=\dimen134
-\ltopmargin=\dimen135
-\loddsidemargin=\dimen136
-\levensidemargin=\dimen137
-)
-(/usr/share/texmf/tex/latex/graphics/lscape.sty
-Package: lscape 2000/10/22 v3.01 Landscape Pages (DPC)
-)
-No file paper.aux.
-\openout1 = `paper.aux'.
-
-LaTeX Font Info: Checking defaults for OML/cmm/m/it on input line 24.
-LaTeX Font Info: ... okay on input line 24.
-LaTeX Font Info: Checking defaults for T1/cmr/m/n on input line 24.
-LaTeX Font Info: ... okay on input line 24.
-LaTeX Font Info: Checking defaults for OT1/cmr/m/n on input line 24.
-LaTeX Font Info: ... okay on input line 24.
-LaTeX Font Info: Checking defaults for OMS/cmsy/m/n on input line 24.
-LaTeX Font Info: ... okay on input line 24.
-LaTeX Font Info: Checking defaults for OMX/cmex/m/n on input line 24.
-LaTeX Font Info: ... okay on input line 24.
-LaTeX Font Info: Checking defaults for U/cmr/m/n on input line 24.
-LaTeX Font Info: ... okay on input line 24.
-LaTeX Font Info: Try loading font information for OT1+ptm on input line 24.
-(/usr/share/texmf/tex/latex/psnfss/ot1ptm.fd
-File: ot1ptm.fd 2001/06/04 font definitions for OT1/ptm.
-)
-(/usr/share/texmf/tex/context/base/supp-pdf.tex
-(/usr/share/texmf/tex/context/base/supp-mis.tex
-loading : Context Support Macros / Miscellaneous (2004.10.26)
-\protectiondepth=\count101
-\scratchcounter=\count102
-\scratchtoks=\toks16
-\scratchdimen=\dimen138
-\scratchskip=\skip48
-\scratchmuskip=\muskip10
-\scratchbox=\box26
-\scratchread=\read3
-\scratchwrite=\write4
-\zeropoint=\dimen139
-\onepoint=\dimen140
-\onebasepoint=\dimen141
-\minusone=\count103
-\thousandpoint=\dimen142
-\onerealpoint=\dimen143
-\emptytoks=\toks17
-\nextbox=\box27
-\nextdepth=\dimen144
-\everyline=\toks18
-\!!counta=\count104
-\!!countb=\count105
-\recursecounter=\count106
-)
-loading : Context Support Macros / PDF (2004.03.26)
-\nofMPsegments=\count107
-\nofMParguments=\count108
-\MPscratchCnt=\count109
-\MPscratchDim=\dimen145
-\MPnumerator=\count110
-\everyMPtoPDFconversion=\toks19
-) (./paper.aux) )
-Here is how much of TeX's memory you used:
- 1232 strings out of 94500
- 15342 string characters out of 1176765
- 62957 words of memory out of 1000000
- 4434 multiletter control sequences out of 10000+50000
- 4447 words of font info for 16 fonts, out of 500000 for 2000
- 580 hyphenation exceptions out of 1000
- 30i,1n,21p,221b,79s stack positions out of 1500i,500n,5000p,200000b,5000s
-PDF statistics:
- 0 PDF objects out of 300000
- 0 named destinations out of 131072
- 1 words of extra memory for PDF output out of 65536
-
-No pages of output.
