name argument (basic use)

At its simplest, a file is extracted by giving just the requested filename or routine as an argument to the extractor:

% scb name=dsa_data_size

or equivalently:

% scb dsa_data_size

finds the file which contains the routine `dsa_data_size' and prints it to standard output. It also prints to standard error the location of this file. The file can therefore be viewed using more, or printed, or saved to a local file, or searched with grep, or generally used in the usual Unix ways. For instance to save it to a local file file.f:

% scb dsa_data_size >file.f
figaro#figaro_dsa.tar>dsa/dsa_dat_sz.f

the second line here is the line printed to standard error by the program indicating the file in which the routine was found; it means that the file is part of the package FIGARO, is contained in the tar archive figaro_dsa.tar, and within that archive is called dsa/dsa_dat_sz.f. Files can be extracted by their filename instead, so that

% scb dsa_dat_sz.f >file.f
figaro#figaro_dsa.tar>dsa/dsa_dat_sz.f

has exactly the same effect as the former example.

Routine names are indexed by the names the Unix linker gives them. For C functions, this means the name of the function as in the source code should be used. For Fortran functions and subroutines, the indexed name is formed by appending an underscore to the lower case name of the routine. If the underscore is omitted however, and no routine by that name can be found, the extractor program will look for a routine with the underscore appended.