This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

The mig4nto Utility

mig4nto

Identify items in QNX 4 programs requiring attention (QNX)

Syntax:

mig4nto [-qsr] [-o output_directory] [file...]

Options:

-q

Be quiet; don't display progress information.

-s

Be strict; allow for only those functions that are ANSI/POSIX-compatible. This option reports on all functions covered by the migration library. If you don't specify this option, functions covered by the migration library aren't identified.

-r

Produce report only; don't produce a copy of marked-up source.

-o output_directory

The directory where you want annotated source files to be written.

file

The pathname of a file containing a C source program or header file.

Description

The mig4nto utility helps you identify areas in your programs that will need attention during the migration process. This utility copies source files, then inserts comments above each source line that contains a function name or C preprocessor manifest name requiring attention. These comments include brief suggestions as to a course of action.

The marked-up files are written to a directory other than the one from which their corresponding source files were read. You specify this directory with the -o option.

For each file it examines, the mig4nto utility also provides a summary report listing the items in the file that require attention and the lines on which these items are found. If you want to generate this summary report without also generating annotated program files, then specify the -r option.

While processing files, mig4nto normally keeps you informed of its progress. But if you want to run the utility in the background, you can specify the -q option to prevent status messages from being displayed.

For each input file, mig4nto creates an output file in the directory specified by the -o option. Each source line containing items that require attention is preceded by a special comment line or lines.

Examples:

Annotate all the C source files in the current directory, and place the output files in the /nto/src directory.

mig4nto -o /nto/src *.c

Annotate all the C source files in the current directory, and place the output in the /nto/src directory. Place the summary report in the report file.

mig4nto -o /nto/src -s *.c > report

Exit status:

0

No files needed attention.

1

One or more files contained items needing attention.

>1

An error occurred.

If a file can't be opened for reading or writing, or if an I/O error occurs while reading or writing a file, the output file is removed and processing is continued with the next file. The final exit status will be greater than one.