[PVFS2-CVS] commit by neill in pvfs2/doc: pvfs2-quickstart.tex
CVS commit program
cvs at parl.clemson.edu
Thu Mar 11 17:27:42 EST 2004
Update of /projects/cvsroot/pvfs2/doc
In directory parlweb:/tmp/cvs-serv5502
Modified Files:
pvfs2-quickstart.tex
Log Message:
- minor updates regarding the kernel module build to better reflect Pete's
latest change that builds it alongside the 'normal' build
Index: pvfs2-quickstart.tex
===================================================================
RCS file: /projects/cvsroot/pvfs2/doc/pvfs2-quickstart.tex,v
diff -p -u -r1.10 -r1.11
--- pvfs2-quickstart.tex 8 Mar 2004 16:00:23 -0000 1.10
+++ pvfs2-quickstart.tex 11 Mar 2004 22:27:41 -0000 1.11
@@ -619,65 +619,30 @@ http://www.kernel.org/pub/linux/kernel/v
\end{verbatim}
Once you're convinced the Linux kernel version is appropriate, it's
-time to compile the PVFS2 kernel module. This kernel module is built
-independently from the other parts of PVFS2. The first step in
-building this module is generating the Makefile. To generate the
-Makefile, you need to make sure that you run './configure' with the
+time to compile the PVFS2 kernel module. To generate the Makefile,
+you need to make sure that you run './configure' with the
'--with-kernel=path' argument. An example is provided here for your
convenience:
\begin{verbatim}
-gil:/usr/src/pvfs2# ./configure --with-kernel=/usr/src/linux-2.6.0-test4
+gil:/usr/src/pvfs2# ./configure --with-kernel=/usr/src/linux
\end{verbatim}
This example assumes that you've already downloaded, compiled, and are
-now running the kernel located in the /usr/src/linux-2.6.0-test4
-directory. After this command is issued, build the PVFS2 source tree
-if it has not yet been built.
+now running the kernel located in the /usr/src/linux directory. After
+this command is issued, build the PVFS2 source tree if it has not yet
+been built.
-Building the kernel module should now be a trivial task. From the top
-level PVFS2 source directory, you need to first change directory to
-the where the code is located, and then run make. You must perform
-this step as root so that the build process can access dependency
-information in the kernel source tree. You should see
-output similar to the following if your environment is properly
-configured:
-
-\begin{verbatim}
-gil:/usr/src/pvfs2# cd src/kernel/linux-2.6/
-gil:/usr/src/pvfs2/src/kernel/linux-2.6# make
-touch /usr/src/pvfs2/src/kernel/linux-2.6/pvfs2.mod.c
-make -C /usr/src/linux SUBDIRS=/usr/src/pvfs2/src/kernel/linux-2.6
-modules
-make[1]: Entering directory `/usr/src/linux-2.6.0-test4'
-make[2]: `arch/i386/kernel/asm-offsets.s' is up to date.
-*** Warning: Overriding SUBDIRS on the command line can cause
-*** inconsistencies
- CC [M] /usr/src/pvfs2/src/kernel/linux-2.6/pvfs2.mod.o
- CC [M] /usr/src/pvfs2/src/kernel/linux-2.6/pvfs2-utils.o
- CC [M] /usr/src/pvfs2/src/kernel/linux-2.6/waitqueue.o
- CC [M] /usr/src/pvfs2/src/kernel/linux-2.6/devpvfs2-req.o
- CC [M] /usr/src/pvfs2/src/kernel/linux-2.6/pvfs2-cache.o
- CC [M] /usr/src/pvfs2/src/kernel/linux-2.6/dcache.o
- CC [M] /usr/src/pvfs2/src/kernel/linux-2.6/file.o
- CC [M] /usr/src/pvfs2/src/kernel/linux-2.6/inode.o
- CC [M] /usr/src/pvfs2/src/kernel/linux-2.6/dir.o
- CC [M] /usr/src/pvfs2/src/kernel/linux-2.6/namei.o
- CC [M] /usr/src/pvfs2/src/kernel/linux-2.6/super.o
- CC [M] /usr/src/pvfs2/src/kernel/linux-2.6/pvfs2-mod.o
- CC [M] /usr/src/pvfs2/src/kernel/linux-2.6/pvfs2-bufmap.o
- LD [M] /usr/src/pvfs2/src/kernel/linux-2.6/pvfs2.o
- Building modules, stage 2.
- MODPOST
- CC /usr/src/pvfs2/src/kernel/linux-2.6/pvfs2.mod.o
- LD [M] /usr/src/pvfs2/src/kernel/linux-2.6/pvfs2.ko
-make[1]: Leaving directory `/usr/src/linux-2.6.0-test4'
-\end{verbatim}
+Building the kernel module should now be done automatically, though
+you must perform this step as root so that the build process can
+access dependency information in the kernel source tree. Optionally,
+you can build the module by changing directory into the
+src/kernel/linux-2.6 and typing 'make'.
At this point, we have a valid PVFS2 Kernel module. The module itself
is contained in the output file 'pvfs2.ko' located in the directory
-where the previous 'make' command was issued. You may copy this
-module to another location if it better suits your environment.
+src/kernel/linux-2.6/pvfs2.ko. You may copy this module to another
+location if it better suits your environment.
\section{Testing the PVFS2 Linux VFS Interface}
\label{sec:vfs-test}
More information about the PVFS2-CVS
mailing list