IBM Support

AIX Open Source: Member libiconv.so.2 is not found in archive

Question & Answer


Question

How can I resolve libiconv errors for an AIX Open Source command?

For example:
#rsync

Could not load program rsync:
Dependent module /usr/lib/libiconv.a(libiconv.so.2) could not be loaded.
Member libiconv.so.2 is not found in archive

# echo $LIBPATH /usr/lib:/opt/freeware/lib64:/opt/freeware/lib


Cause

The system default libiconv.a was loaded before the Open Source libiconv.a, which was required by the 'rsync' command.

The Open Source GNU libiconv package,  available on the AIX Toolbox for Linux Applications download site, provides the following:
/opt/freeware/lib/libiconv.a(libiconv.so.2)

The AIX libiconv  provides:
/usr/lib/libiconv.a(shr.o)
/usr/lib/libiconv.a(shr4.o)
/usr/lib/libiconv.a(shr4_64.o)

Some Open Source packages are built to depend on the GNU library.  For example, rsync-3.1.3-3 requires GNU libiconv >= 1.14 libiconv.a(libiconv.so.2).

# dump -X64 -Hov  /opt/freeware/bin/rsync
                        ***Import File Strings***
INDEX  PATH                          BASE                MEMBER
0      /opt/freeware/lib64:/opt/freeware/lib:/usr/lib
1                                    libc.a              shr_64.o
2                                    libiconv.a          libiconv.so.2



Answer

You need to unset LIBPATH, so the command will load the /opt/freeware/lib/libiconv.a first. 

NOTE: The AIX Toolbox for Linux Applications rsync package has a hard coded library dependency, effective in 3.2.3-1 and later versions, so this error will not occur.

# dump -X64 -Hov  /opt/freeware/bin/rsync
                        ***Import File Strings***
INDEX  PATH                          BASE                MEMBER
0      /opt/freeware/lib64:/opt/freeware/lib:/usr/lib
1                                    libc.a              shr_64.o
2      /opt/freeware/lib             libiconv.a          libiconv.so.2
3                                    liblz4.a            liblz4.so.1
4                                    libcrypto.a         libcrypto.so.1.0.2

The AIX Open Source Development team strives to hard code library dependencies where AIX and Open Source libraries might conflict. They build new packages as these dependencies are introduced, or identified. If your open source package has LIBPATH errors, make sure you have downloaded the latest version from the AIX Toolbox for Linux Applications download site. If you have the latest package, but still encounter libiconv conflicts, consult with the team on the AIX Open Source Community Discussion forum.


SUPPORT

A) For all questions or issues with AIX Toolbox for Linux Application ("AIX Toolbox") packages, support is provided through the following options:

1) The AIX Open Source Community Discussion forum: 

2) IBM Technology Support Services ("TSS") offers Open Source Software ("OSS") Support for select AIX Toolbox packages.

Cases opened to address AIX Toolbox problems are canceled and users are referred to the Open Source Forum or TSS Marketing unless the case is entitled for TSS OSS Support.

If you experience technical issues accessing the AIX Open Source community or forum, refer to the footer of the IBM Community forum page.
There is email, and "Contact Us" information for community support

B) If there is a problem with installing rpm.rte, or executing the rpm binary file, open an AIX Case (See the following C section) for assistance.

Examples of rpm.rte issues supported through AIX Support:
- Errors updating or migrating the rpm.rte file set
- Commands from the rpm.rte file set core dump, or have runtime errors.

Example of an rpm.rte rpm loading issue:

# rpm -qa
    exec(): 0509-036 Cannot load program /usr/opt/freeware/bin/rpm because of the following errors:
    0509-150 Dependent module libnss3.so could not be loaded.
    0509-022 Cannot load module libnss3.so.
    0509-026 System error: A file or directory in the path name does not exist.

 
This example would be handled through an IBM AIX Support case, and the support team would help resolve the missing modules.
To learn what is provided and supported by the rpm.rte file set:

# lslpp -f rpm.rte

C) Opening an AIX Support Case

If additional assistance is required due to issues with rpm.rte file set (see preceding B section), use the following step-by-step instructions to contact IBM to open a case for software with an active and valid support contract.  

1.  Document (or collect screen captures of) all symptoms, errors, and messages related to your issue.

2.  Capture any logs or data relevant to the situation.

3.  Contact IBM to open a case:

   -For electronic support, see the IBM Support Community:
     https://www.ibm.com/mysupport
   -If you require telephone support, see the web page:
      https://www.ibm.com/planetwide/


[{"Line of Business":{"code":"LOB08","label":"Cognitive Systems"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SWG10","label":"AIX"},"ARM Category":[{"code":"a8m0z000000cw3dAAA","label":"RPMS: AIX Toolbox for Linux"}],"ARM Case Number":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Version(s)"}]

Document Information

More support for:
AIX

Component:
RPMS: AIX Toolbox for Linux

Software version:
All Version(s)

Document number:
6437969

Modified date:
30 March 2021

UID

ibm16437969

Manage My Notification Subscriptions