3 Creating and setting up server-side programs

3.1 Creating a Ninf-G Executable

3.2 Setting up the Ninf-G Executable operating environment

3.3 Specifications for the configuration file used by Ninf-G Executable

3.3.1 Structure of the configuration file

The Ninf-G Executable configuration file is a text file which contains the settings information that is required for operation of Ninf-G Executable.

An example of entries in the Ninf-G Executable configuration file is shown below.


attribute    value    # comment

attribute    value    # comment
attribute    value    # comment


The following description produces an error.

        #  No delimiter between attribute and attribute value

Attribute    Value    Attribute    Value
        # Multiple attributes on a line

        #  attribute value extend across more than one line

        #  No attribute value

tmp_dir /tmp
tmp_dir /var/tmp
        # Overlapping of the attribute values of an attribute
        #  that can not have multiple definitions

3.3.2 Attributes and attribute values

The attributes and their attribute value definitions are listed below.

tmp_dir                        Directory
loglevel                       [0-5]
loglevel_ninfgProtocol         [0-5]
loglevel_ninfgInternal         [0-5]
log_filePath                   File name
log_suffix                     Suffix
log_nFiles                     Number of files
log_maxFileSize                Number of bytes
log_overwriteDirectory         [true/false]
commLog_enable                 [true/false]
commLog_filePath               PathFile name
commLog_suffix                 Suffix
commLog_nFiles                 FilesNumber of files
commLog_maxFileSize            FileSizeNumber of bytes
commLog_overwriteDirectory     [true/false]
save_stdout                    File name
save_stderr                    File name
handling_signals               Signals ...
continue_on_error              [true/false]
communication_proxy_log_filePath path of logfile

The definable attributes and attribute values are listed below.

Attribute Attribute value Default value Multiple Explanation
tmp_dir For temporary files /tmp No The directory in which temporary files are placed Directory
loglevel [0-5] 2 No Overall log level
loglevel_ninfgProtocol [0-5] 2 No Error concerning the Ninf-G protocol
loglevel_ninfgInternal [0-5] 2 No Internal Ninf-G error
log_filePath File name stderr No Log file name
log_suffix Suffix Sequence number No Log file suffix
log_nFiles Number of files 1 No Number of log output files
log_maxFileSize Number of bytes 1M/unlimited No Maximum number of bytes for log file
log_overwriteDirectory [true/false] False No Over-write permission for log directory
commLog_enable [true/false] False No Communication log output enabled/disabled
commLog_filePath File name stderr No Communication log file name
commLog_suffix Suffix Sequence number No Communication log file suffix
commLog_nFiles Number of files 1 No Number of files for outputting communication log
commLog_maxFileSize Number of bytes 1M/unlimited No Maximum number of bytes for communication log file
commLog_overwriteDirectory [true/false] False No Over-write communication log directory enabled/disabled Permitted
save_stdout File name None No Save stdout to file
save_stderr File name None No Save stderr to file
handling_signals Signal names/numbers SIGHUP SIGINT SIGTERM No Handling signals
continue_on_error [true/false] False No continue computation if an error occurs
communication_proxy_log_filePath path None No log file path

The meanings of the log level values are described below.

Value Meaning Explanation
0 Off Nothing is output.
1 Fatal A fatal error is output.
2 Error A nonfatal error is output.
3 Warning A warning error is output.
4 Information Guidance or other such information is output.
5 Debug Debugging information is output.

last update : $Date: 2008-11-11 18:22:06 +0900 (火, 11 11月 2008) $