NAME

nidl_to_idl - Translates files written in Network Interface Definition Language (NIDL) to files written in NCS 2.0 Interface Definition Language (IDL)

SYNOPSIS

nidl_to_idl filename [argument]...

ARGUMENTS

-confirmDisplays all the nidl_to_idl command arguments you choose but does not translate the source IDL file. 

-defname[=definition]Defines a symbol name, and an optional value to be passed to the C preprocessor. You can use this method of defining a symbol on the command line instead of using #define in the source code. You can use more than one -defname argument on the command line. 

-exts extension_name
Specifies a filename extension other than the default filename extension for the output interface definition file. The default filename extension is _v2.idl. 

-acf_exts acf_extension_name
Specifies a filename extension for the output ACF (if an ACF is needed) other than the default filename extension. The default ACF filename extension is _v2.acf. 

-idir directory_nameSpecifies a directory name that contains imported interface definition files. You can specify more than one directory by using additional -idir arguments. The translator searches the directories in the order you list them on the command line. If a file is present in more than one directory, the translator takes the first occurrence of the file.  The default behavior of the translator is to first search the current directory, then all directories you specify with -idir, then the system IDL directory. 

-no_def_idirSearches through only the current directory for imported interface definition files. When you use this argument with -idir, the translator searches through only the directories you list, not the current directory, and not the system IDL directory. 

-no_warnSuppresses translator warning messages. 

-out directoryPlaces the output files in the directory you specify. If you do not use the -out argument, the translator places the output files in the current working directory. 

-versionDisplays the current version of the translator. 

DESCRIPTION

The nidl_to_idl command translates interface definitions written in the Network Interface Definition Language (NIDL) to IDL interface definitions. The command also generates an attribute configuration file (ACF), if one is needed.  Use the IDL compiler to compile the translated files. These files are compatible with the NCS 2.0 RPC runtime library. 

The nidl_to_idl command accepts the following input:

       •An interface definition file that compiled successfully under the NCS Version 1 NIDL compiler

       •Arguments to indicate either special actions to be performed by the translator, or special properties of the input or output files

The translator cannot handle some NIDL features because no direct translation exists. When a feature cannot be translated, the translator issues a warning and you must manually correct the IDL output file. 

If the code translates without error, the automated translation is complete.  Use the IDL compiler to compile the translated output file. Errors issued by IDL are related to NIDL. You must correct these errors manually and make some changes in the application code.  NCS Version 1 compatibility is provided only for transitional purposes and is available for only a limited number of NCS update releases.  For new applications, use NCS 2.0 RPC. 

FILES

The nidl_to_idl command constructs the output filenames by keeping the name of the interface definition source file but adding a suffix to the newly generated output file. For example, the input file named test.idl is translated to test_v2.idl (and test_v2.acf, if an ACF is needed). 

EXAMPLE

Translate my_old.idl file to my_old_v2.idl file .  Search first through the sales directory, then through the credit directory for imported interface definition files, but do not search through the current directory or the system IDL directory. 

$ nidl_to_idl my_old.idl -idir sales -idir credit -no_def_idir