R&S 1129.7246.03, Operating Manual

Page: 386 / 855

Operating Manual 1302.6163.12 - 03 4.355
R&S ESU Instrument Functions
RSIB Protocol
4.13.1.2 UNIX Environment
To access the measuring equipment via the RSIB interface, copy the
librsib.so.X.Y
file to a directory for which the control application has read
rights.
X.Y
in the file name indicates the version number of the library, for example
1.0
.
The
librsib.so.X.Y
library is created as a shared library . The applications using
the library need not consider its version. They simply link the library with the
lrsib
option. The following instructions have to be observed so that linking can be suc-
cessfully performed and the library can be found during program execution:
File link:
• Use the operating system command In to create a file with the link name
librsib.so
and pointing to
librsib.so.X.Y
in a directory for which the
control application has read rights. Example:
$ ln –s /usr/lib/librsib.so.1.0 /usr/lib/librsib.so
Linker options for creating applications:
•
-lrsib
: import library
• -
Lxxx
: path information where the import library can be found. This is where the
above file link has been created. Example:
-L/usr/lib
.
Additional linker options for creating applications (only under Solaris):
•
-Rxxx
: path information where the library is searched for during the program run:
-R/usr/lib
.
Run-time environment:
• Set environment variable
LD_RUN_PATH
to the directory in which the file link has
been created. This is necessary only if
librsib.so
cannot be found in the
default search path of the operating system and the
-R
linker option (only Solaris)
was not specified.
For C/C++ programming, the declarations of the library functions and the definition
of error codes are contained in:
C/C++:
'RSIB.H' (D:\R_S\Instr\RSIB)