Return to nlist.3 CVS log

Up to [Research Unix] / researchv10dc / man / adm / man3

Annotation of researchv10dc/man/adm/man3/nlist.3, revision 1.1

1.1     ! root        1: .TH NLIST 3
        !             2: .CT 2 debug_tune
        !             3: .SH NAME
        !             4: nlist \(mi get entries from name list
        !             5: .SH SYNOPSIS
        !             6: .nf
        !             7: .B #include <nlist.h>
        !             8: .B nlist(filename, nl)
        !             9: .B char *filename;
        !            10: .B struct nlist nl[];
        !            11: .fi
        !            12: .SH DESCRIPTION
        !            13: .I Nlist
        !            14: examines the name list in
        !            15: the given executable output file
        !            16: and selectively extracts a
        !            17: list of values.
        !            18: The list is terminated with a null name.
        !            19: .nf
        !            20: .ftL
        !            21: .ta \w'\fLstruct 'u +\w'\fLunsigned long n_value; 'u
        !            22: struct nlist {
        !            23:        \fLchar *n_name;\fR     symbol name
        !            24:        \fLunsigned char n_type;\fP     type flag
        !            25:        \fLchar n_other;\fP     unused
        !            26:        \fLshort n_desc;\fP     unused
        !            27:        \fLunsigned long n_value;\fP    value (or offset) of this symbol 
        !            28: \fL};\fP
        !            29: .fi
        !            30: Each name is looked up in the name list of
        !            31: the file.
        !            32: If the name is found, the type and value of the
        !            33: name are inserted in
        !            34: .L n_type
        !            35: and
        !            36: .L n_value
        !            37: respectively.
        !            38: If the name is not found, both entries are set to 0.
        !            39: .PP
        !            40: This subroutine is useful for
        !            41: examining the system name list kept in
        !            42: .FR /unix .
        !            43: In this way programs can obtain system addresses
        !            44: that are up to date.
        !            45: .SH "SEE ALSO"
        !            46: .IR a.out (5)
        !            47: .SH DIAGNOSTICS
        !            48: All
        !            49: type entries are set to 0
        !            50: if the file cannot be found
        !            51: or if it is not a valid namelist.
        !            52: .SH BUGS
        !            53: On some
        !            54: .SM UNIX 
        !            55: systems you must include
        !            56: .F <a.out.h>
        !            57: rather than
        !            58: .FR <nlist.h> .
        !            59: This is unfortunate, but
        !            60: .F <a.out.h>
        !            61: can't be used on the
        !            62: VAX because it contains a union,
        !            63: which can't be initialized.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.