home *** CD-ROM | disk | FTP | other *** search
/ ftp.uni-stuttgart.de/pub/systems/acorn/ / Acorn.tar / Acorn / riscos / unixtools / nmhelp.text < prev    next >
Text File  |  1992-03-09  |  2KB  |  73 lines
  1.  
  2. One future enhancement is to (optionally) display  debugger symbols.
  3. If anyone has any information about the layout of the C$$DEBUG
  4. area, I can get to work.
  5.  
  6. Lots of fun!
  7.  
  8. #include <std/disclaimer.h>
  9. | Colin Smale             ...!{hp4nl,mcvax}!gouldnl!csmale |
  10. | Gould Computer Systems BV               colin@gouldnl.uucp |
  11. | Maarssenbroek, The Netherlands         (USA)   ...!gould!csmale |
  12.  
  13. Arthur NM - Usage Notes
  14. =======================
  15.  
  16. Copyright 1989 Colin R. Smale
  17.  
  18. NM is a tool to examine the symbol table of object files and object
  19. libraries.  The names and attributes of all symbols are displayed.
  20.  
  21. Usage:
  22.     nm [-a] [-n] file ...
  23.  
  24. Options:
  25.     -a    uses alphanumeric sort (default)
  26.     -n    symbols are sorted numerically by value
  27.  
  28.     Options can be interspersed with filenames; they take effect
  29.     as from that point in the list of files.
  30.  
  31. If a file is a library created by LibFile and ObjLib, the information
  32. is displayed for each module contained in the library.
  33.  
  34. Output:
  35. One symbol is displayed on each line.  The fields are:
  36.  
  37.     Symbol value    - normally the address relative to an area
  38.             for external references, this field is blank
  39.  
  40.     Flags        - the letters have the following meanings:
  41.             l    local symbol
  42.             e    external reference
  43.             d    global definition
  44.             w    external reference is weak
  45.             s    global definition is strong
  46.             a    symbol is absolute
  47.             @    linker will use case-insensitive matching
  48.             c    common block
  49.  
  50.     Symbol name
  51.     
  52.     Area name    - displayed between parentheses if symbol is relative
  53.  
  54.     For more information, refer to the Acorn documentation on AOF and ALF
  55. available from the SID database.
  56.  
  57. Errors will occur if:
  58.     - the file is not a chunk file
  59.     - the file does not contain AOF object
  60.  
  61. Bugs:
  62.     As usual, none known.  The error checking could do with improvement.
  63.  
  64. If you find a problem or if you have a suggestion for improvement,
  65. please contact the author:
  66.         Colin Smale
  67.         Spechtenkamp 87
  68.         3607 KE  Maarssenbroek
  69.         The Netherlands
  70.         Tel: +31 3465 69038
  71.         Email: csmale@gouldnl.uucp  ..!hp4nl!gouldnl!csmale
  72.  
  73.