From: Jack Lange Date: Fri, 27 Feb 2009 20:55:59 +0000 (-0600) Subject: reorganized things, pasted in old text X-Git-Url: http://v3vee.org/palacios/gitweb/gitweb.cgi?p=palacios.git;a=commitdiff_plain;h=0c6100cc41d0f94332a32ed47ca437d85a5352d5 reorganized things, pasted in old text --- diff --git a/manual/Makefile b/manual/Makefile index d42bba5..27cd1b6 100755 --- a/manual/Makefile +++ b/manual/Makefile @@ -4,7 +4,7 @@ DVIPS = dvips XDVI = xdvi PS2PDF = ps2pdf -dMaxSubsetPct=100 -dCompatibilityLevel=1.2 -dSubsetFonts=true -dEmbedAllFonts=true -dPDFSETTINGS=/prepress -TEXDOCS = paper.tex +TEXDOCS = manual.tex WORDDOCS= DVIDOCS = $(TEXDOCS:.tex=.dvi) ERASEABLEPSDOCS=$(TEXDOCS:.tex=.ps) @@ -26,12 +26,9 @@ all: $(PDFDOCS) $(LATEX2E) $< bib: - $(LATEX2E) paper - $(LATEX2E) paper - $(BIBTEX) paper - $(LATEX2E) paper - $(LATEX2E) paper + $(LATEX2E) manual + $(LATEX2E) manual clean: - -rm -f *.dvi paper.pdf $(ERASEABLEPSDOCS) + -rm -f *.dvi manual.pdf $(ERASEABLEPSDOCS) diff --git a/manual/manual.tex b/manual/manual.tex new file mode 100755 index 0000000..0536c84 --- /dev/null +++ b/manual/manual.tex @@ -0,0 +1,141 @@ + +\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} diff --git a/manual/paper.log b/manual/paper.log deleted file mode 100644 index 45279f0..0000000 --- a/manual/paper.log +++ /dev/null @@ -1,198 +0,0 @@ -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 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. diff --git a/manual/paper.tex b/manual/paper.tex deleted file mode 100755 index 1d59a8a..0000000 --- a/manual/paper.tex +++ /dev/null @@ -1,34 +0,0 @@ - -\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} - -\end{document}