Ninf Server Package

Description

This package provides

The ninf server 'ninf_serv_tcp'.
Stub generator 'ninf_gen'.
'ninf_register' which register executables to the server.
Libraries for ninf client programs.
Libraries for ninf executables.
Include files for Your Makefile.

This package currently supports the following architectures.

solaris : Solaris 2.2 or later.
sunos: Solaris 1.1.3 or later
linux: linux on x86
j90: Cray super computer J90 or C90
alpha: OSF for DEC Alpha
AIX: AIX

However, our programs are written in a portable way, so it will be very easy to port them.

Ninf Usage

1. Make Ninf Package

First of all, uncompress and untar the package. In the top directory of this package, type:

   >./MAKE ARCHITECTURE_TYPE

ARCHITECTURE_TYPE must be one of the following architectures: sunos, solaris, j90, linux, alpha and AIX. The MAKE script makes a directory with the architecture name, and links source files in the directory, and then executes 'make'. This script will make three directories, 'bin', 'lib' and 'include'. You can install them by typing,

    >./MAKE install INSTALL_DIR

If you want to make Ninf for different architecture, first, install Ninf in the other directory, secondly, clean up this directory by typing,

    >./MAKE clean

thirdly, make Ninf again for another architecture.

2. How to 'Make' Ninf Client Programs

2.1 Set environment variable 'NINF_DIR'

Set NINF_DIR environment variable to point to the architecture directory. For example, if you untared the package /usr/local/ninf and your architecture is 'solaris', you should set NINF_DIR to point to /usr/local/ninf/solaris, like this.

  setenv NINF_DIR /usr/local/ninf/solaris

NOTE: If you installed them to the other directory, of course you should specify the directory.

2.2 Write your Makefile

Write the following line on top of your Makefile.

include $(NINF_DIR)/template

The 'template' file provides macros 'NINF_CFLAGS' and 'NINF_LDFLAGS'. These are needed to link Ninf Libraries. Typical rule for ninf client program is like this.

test: test.c
	$(CC) $(CFLAGS) $(NINF_CFLAGS) -o test test.c $(LDFLAGS) $(NINF_LDFLAGS)

3. How to make Ninf Executable

3.1 Set environment variable

As same as 2.1, set the variable.

3.2 Write your Makefile

As same as 2.2, include the template file.

include $(NINF_DIR)/lib/template

Then, you can use NINF_GEN macro. This macro gives you a program which produce makefile and stub programs. For example, your IDL file is 'ep.idl' and your routine is provided by 'ep_slave.o', then Makefile should contain following lines.

_stub_ep: ep_slave.o ep.mak
	make -f ep.mak

ep.mak: ep.idl
	$(NINF_GEN) $<

Included Documents

Send your comments or questions to ninf@apgrid.org
Ninf Home Page