1 ******************************************************************************
5 * Author: Robert Story <rstory@freesnmp.com>
7 * $Id: README.build-scripts,v 1.6.2.1 2003/03/05 22:58:35 rstory Exp $
9 ******************************************************************************
15 The automated build script will automatically run configure, 'make all',
16 'make test' and 'make install'. Log files are kept for each step, and the
17 scripts should abort when errors occur.
19 The usage of nsb-package is:
21 Usage: nsb-package [-c] [-d] [-p] [-s SRCD] [-b BUILDD] [-i INSTALLD] VERSION
23 VERSION : relase number (eg 5.0.3)
24 -s SRCDIR : soure directory [$HOME/src/net-snmp-VERSION]
25 -b BUILDD : build directory [$HOME/build/]
26 NOTE-platform will be appended to build directory
27 -i INSTALLD: install directory [$HOME/build/\$PLATFORM/usr/local]
30 -d : dirty build (don't make distclean)
32 -p : don't pause at prompts in between stages
36 The defaults assume you have a 'src', 'build' and 'binaries' directory in
44 1) Log into Sourceforge Compile Farm Server
46 2) Update source (this will likely be automated in the future)
48 For example, for release 5.0.3:
51 $ CVS_RSH=ssh cvs -d $USER@cvs.net-snmp.org:/cvsroot/net-snmp \
52 -q co -r Ext-5-0-3 -d ~/src/net-snmp-Ext-5-0-3 net-snmp
54 3) Run the package script.
56 $ $HOME/src/net-snmp-cvs/dist/nsb-package -r \
57 -s $HOME/src/net-snmp-5.0.5 5.0.5
59 4) Create tarball (assuming no errors; see next section if there are errors)
61 $ cd ~/build/`nsb-platform`
62 $ tar cvf net-snmp-5.0.3-`nsb-platform`.tar usr
65 5) Copy tarball to Sourceforge shell sever
67 $ scp *.gz net-snmp.sourceforge.net:~/binaries/
69 6) Log out of compile farm server, log into shell server
71 7) Upload to Sourceforge
73 $ ftp upload.sourceforge.net
77 8) Update binaries vi Sourceforge admin page
84 Should you encounter a build error, you will most likely want to skip the
85 'make distclean' and configure step (assuming the problem wasn't with
86 configure!). To do this, specify the 'dirty' and 'skip configure' options:
88 $ nsb-package -p -d -c Ext-5-0-3
91 Should the build succeed, but some tests fail during 'make test', you probably
92 can to skip the test step to get to the install step:
94 $ nsb-package -p -d -c -t Ext-5-0-3
99 * "Cannot find nsb-functions"
101 It's a hack, but symlink nsb-functions and nsb-package to your local
102 bin directory ($HOME/bin). I'm trying to think of a better solution.
104 * "gcc: snmp_version.lo: No such file or directory"
106 This is a good indication that you have previously built in your
107 source directory. 'make distclean' in your source directory, or
108 check out a fresh new version from CVS.