qnm -- print QOF file information

Synopsis

     qnm [-PADFMU] [ [-m module] [-n name] [-a arity]]
         [-p proc#] [-o] filename ...
     

Description

qnm prints information about each QOF file named in the argument list. The command line options specify the information required. The default behavior, if no command line option is given, is identical to the behavior of the -P option. Except where noted, only the first valid command line option is accepted per invocation of qnm; subsequent options are ignored. Each filename must be a QOF file.

Options

-P

Print information about all procedures that are defined or called in each QOF file.

Information for a procedure is preceded by a decimal number that is unique for that QOF file. This is followed by letter codes indicating the procedure state and properties. The letter codes are:

U

undefined

S

static

D

dynamic

M

multifile

F

foreign

V

volatile

L

locked

If the procedure is neither foreign nor multifile, the second letter is omitted.

The state and property information is followed by the module, name and arity of the procedure, in the format module:name/arity. Procedure information is sorted alphabetically by procedure name. Internal procedure names and modules that have been made anonymous are printed as $anon.

-A

Print all atoms referenced in each QOF file. Each atom is preceded by a number that is unique for that QOF file. Atoms are sorted alphabetically. Internal atoms that have been made anonymous are printed as $anon.

-D

Print the names of all QOF or object files and library directories on which each QOF file depends.

-F

Print the number of source files contained in the QOF file.

-M

Print information about modules contained in the QOF file. This information consists of the name of each module, its export list, and its meta-predicates.

-U

Print information about all procedures that are called but not defined in each QOF file. Information about undefined procedures is in the same format as when using the -P flag.

-m module

Print information about procedures in module module. This option may be used in conjunction with the -n and -a options.

-n name

Print information about procedures named name. This option may be used in conjunction with the -m and -a options.

-a arity

Print information about procedures with arity arity. This option may be used in conjunction with the -m and -n options.

-p proc#

Print information about the procedure numbered proc#. Procedure numbers are as given by the -P option.

-o

Prepend to each output line the name of its QOF file. The -o flag may be used in addition to any valid combination of options.

See Also

nm(1), qpc(1), qld(1)