2Unix Environment - R&S ESU Series Operating Manual

R&S ESU
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++:
Operating Manual 1302.6163.12 - 03
'RSIB.H' (D:\R_S\Instr\RSIB)
Instrument Functions
RSIB Protocol
4.355