04.06.2013 Views

iRMX C Library Reference - tenAsys

iRMX C Library Reference - tenAsys

iRMX C Library Reference - tenAsys

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

Supplied C <strong>Library</strong> Files<br />

The <strong>iRMX</strong> OS provides header (include) files containing declarations for C library<br />

functions and definitions of related macros and data types. The shared C library<br />

loadable job is clib.job.<br />

32-bit interface libraries are provided, as well as cstart modules which initialize<br />

processes and call main().<br />

There are a variety of interface libraries supplied with the OS for the interface to C<br />

library functions and <strong>iRMX</strong> system calls. For different Intel and non-Intel tools you<br />

must bind (link) to different libraries.<br />

See also: Cstart, iC-386 Compiler User's Guide,<br />

Cstart modules to use with non-Intel compilers, Programming<br />

Techniques,<br />

Interface libraries, System Call <strong>Reference</strong>s, for a complete list of<br />

interface libraries for different compilers,<br />

Header files for a description of the include libraries, in this chapter,<br />

clib.job, System Configuration and Administration<br />

The Cstart Module<br />

Each application must link to the cstart module. This code makes library calls that<br />

set up an internal C environment for your application. To make initialization changes<br />

in earlier (individually linked) versions of the C library, you would change source<br />

code for the cstart module and reassemble it before linking to your code. With the<br />

shared C library it is rarely necessary to make initialization changes in cstart.<br />

However, there are two configuration changes you can make.<br />

The source code for the cstart module defines values for two literals used in parsing<br />

of command lines. Edit and re-assemble a copy of the cstart source code to change<br />

these values:<br />

• _ARGV_MAX, the maximum number of command-line parameters (argv)<br />

• _COMMAND_MAX, the maximum number of characters in a command line<br />

DOS Syntax<br />

You can use DOS syntax or <strong>iRMX</strong> syntax in all C library calls that require a<br />

pathname argument. DOS backslashes are converted to <strong>iRMX</strong> forward slashes and<br />

DOS device names are converted to <strong>iRMX</strong> logical names.<br />

C <strong>Library</strong> <strong>Reference</strong> Chapter 1 5

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!