You are currently viewing a snapshot of www.mozilla.org taken on April 21, 2008. Most of this content is highly out of date (some pages haven't been updated since the project began in 1998) and exists for historical purposes only. If there are any pages on this archive site that you think should be added back to www.mozilla.org, please file a bug.

Skip to main content

Netscape Messaging Access SDK: Build Instructions
<prasad@netscape.com>
Last Updated: August 25, 1998

For information on the Netscape Message Access SDK source release, see http://www.mozilla.org/msgsdk/

Build Instructions (Java SDK)

System Requirements:

32MB of RAM, recommended 64MB of RAM.

Platforms:

Solaris 2.5.1, HPUX 11.0, IRIX6.2, AIX 4.2.1, OSF1 4.0 and Windows NT 4.0. The SDK was also successfully built and unit tested on other platforms like Solaris 2.6 and HPUX 10.x. Windows NT binaries were used on Win95 successfully. We have not built on other platforms (e.g. Linux) but that could be accomplished with limited effort. Look at the make configuration files in the directory CONFIG under the source root. You can add platform specific defines to the msgsdk.mk and getarch files.

Tool Requirements:

JDK 1.1.3 or above and equivalent environments like VisualCafe 2.0 or above. Please see also the Tool Requirements for Windows NT environment in the "Build Instructions (C SDK)" section below for dependency on gmake etc. Those are applicable here also, but are not repeated.

Instructions:

1) Uncompress and extract the source files from the gzipped gtar file in the directory of your choice (<src-root>).

2) Set CLASSPATH to include <src-root>/java/built/<platform>/protocol, where <src-root> is the directory you extracted the msg-sdk sources into and <platform> is the build platform (SOLARIS HPUX IRIX IRIX64 OSF1 AIX and WINNT).

For example, on UNIX if the root of the message sdk sources is at: /u/mydir/msgsdk, and your build platform is Solaris 2.5.1, your CLASSPATH should include /u/mydir/msgsdk/java/built/SOLARIS/protocol directory.

3) On NT, make sure the environment is set-up to pick up gnu versions of make (gmake) uname etc. as described in the Tool Requirements for Windows NT part, in the "Build Instructions (C SDK)" section below.

4) Change directory to the <src-root> and enter the following command:

gmake buildJava
This step compiles and creates all the class files under the directory <src-root>/java/built/<platform>.

5) When the gmake in step above finishes successfully, package the binaries and examples by entering the following command from the <src-root> directory.

gmake packageJava
This step creates the javadocs, and two jar files proapi.jar (protocol API classes) and coapi.jar (convenience API classes) and creates a gzipped tar (UNIX) or zip (NT) file in the directory <src-root>/release/<date>/java/<platform>. On UNIX the name of the gzipped tar file is mjdk35_1.tar.gz. On Windows NT, the name of the zip file is mjdk35_1.zip.

Build Instructions (C SDK)

System Requirements:

32MB of RAM, recommended 64MB of RAM.

Platforms:

Solaris 2.5.1, HPUX 11.0, IRIX6.2, AIX 4.2.1, OSF1 4.0 and Windows NT 4.0. The SDK was also successfully built and unit tested on other platforms like Solaris 2.6 and HPUX 10.x. Windows NT binaries were used on Win95 successfully. We have not built on other platforms (e.g. Linux) but that could be accomplished with limited effort. Look at the make configuration files in the directory CONFIG under the source root. You can add platform specific defines to the msgsdk.mk and getarch files.

Tool Requirements (UNIX platforms):

Native C compiler or C++ compiler recommended.
GNU make 3.74 or a more recent version.

Tool Requirements (Windows NT):

Microsoft Visual C++ version 4.2 or a more recent version.
winzip32
MKS Toolkit (or equivalent) for Windows. Specifically, you'll need:

rm.exe
mv.exe
cp.exe
GNU Tools for Windows could probably used in place of MKS Toolkit. Here are some sample download sites to find these:
Cygnus (http://www.cygnus.com/misc/gnu-win32)
GNU (http://www.gnu.org/order/ftp.html)
MIT (ftp://prep.ai.mit.edu/pub/gnu)
Netscape uses internally modified versions of the following tools:
gmake.exe
shmsdos.exe
uname.exe
You can download them from Mozilla download page (click the "Windows Build Tools" link). When you unzip the file, the tools will be located in the windows\bin\x86 directory.

All of these tools need to be put in your PATH.

Instructions:

1) Uncompress and extract the source files from the gzipped gtar file in the directory of your choice (<src-root>).

2) On NT make sure the environment is set-up to pick up gnu versions of make (gmake) uname etc. as described in the Tool Requirements for Windows NT part above.

3) Change directory to the <src-root> and enter the following command:

gmake buildC
This step compiles and creates all the libraries (and dlls) under the directory <src-root>/C/built/<platform>.

4) When the gmake in step above finishes successfully, package the binaries and examples by entering the following command from the <src-root> directory.

gmake packageC
This step creates creates a gzipped tar (UNIX) or zip (NT) file in the directory <src-root>/release/<date>/C/<platform>. On Windows NT the name of the zip file will be msdk35_1.zip. On UNIX it is named <platform-specific-prefix>.tar.gz.