ranlib Command

Commands Reference, Volume 4

ranlib Command

Purpose

Converts archive libraries to random libraries.

Syntax

ranlib [ -t ] [ -X {32|64|32_64}] Archive ...

Description

The ranlib command converts each Archive library to a random library. A random library is an archive library that contains a symbol table.

If given the -t option, the ranlib command only touches the archives and does not modify them. This is useful after copying an archive or using the -t option of the make command in order to avoid having the ld command display an error message about an out-of-date symbol table.

Flags

-t

Touches the named archives without modifying them.

-X mode

Specifies the type of object file ranlib should examine. The mode must be one of the following:

32: Processes only 32-bit object files
64: Processes only 64-bit object files
32_64: Processes both 32-bit and 64-bit object files

The default is to process 32-bit object files (ignore 64-bit objects). The mode can also be set with the OBJECT_MODE environment variable. For example, OBJECT_MODE=64 causes ranlib to process any 64-bit objects and ignore 32-bit objects. The -X flag overrides the OBJECT_MODE variable.

Examples

To randomize the archive file genlib.a, enter:

ranlib genlib.a

Files

/usr/ccs/bin/ranlib

Contains the ranlib command.

Related Information

The Subroutines Overview in AIX General Programming Concepts: Writing and Debugging Programs.

The ld command, ar command, lorder command, make command.