ATOS(1)                                                   ATOS(1)



NAME
       atos - numeric/symbolic address conversion tool

SYNOPSIS
       atos  [ -p pid ] [ -o executable ] [ -f file ] [ address |
       symbol ...  ]

DESCRIPTION
       The atos command converts numeric addresses  to  and  from
       their  symbolic  equivalents.   It  must  be supplied with
       either the process id of a currently executing process, or
       else  the  path to a Mach-O executable.  (Multiple process
       ids or paths can also be supplied if  necessary,  and  the
       two  can be mixed in any order.)  When working with a pro-
       cess id, atos considers addresses and symbols  defined  in
       all executables currently loaded by that process, at their
       loaded locations.  When working with a Mach-O  executable,
       atos  considers addresses and symbols defined in that exe-
       cutable, at their default locations, as well as those from
       both statically and dynamically linked libraries loaded at
       startup by that executable, at  their  default  locations.
       In  this case, however, it does not take into account pos-
       sible relocation, nor does it use the  additional  library
       and framework search paths available to dyld (1).

       Additional  arguments  may  be  either numeric or symbolic
       addresses.  A numeric address will be converted  into  the
       symbol  (if  any)  whose  corresponding range of addresses
       contains the specified address.  A  symbol  will  be  con-
       verted  into its numeric starting address.  If an argument
       cannot be converted in either way using the first  process
       or  executable  specified, any other processes or executa-
       bles specified will be used, in the order  specified.   If
       an   argument  still  cannot  be  converted,  it  will  be
       reprinted unchanged.  Results are printed  out  one  to  a
       line,  with numeric addresses given in hexadecimal format.

       Numeric arguments may be given in decimal format, or  they
       may  be prefixed by 0x or 0X and given in hexadecimal for-
       mat.  Symbolic arguments may need to be quoted to get them
       past  the  shell.  With the -f flag, addresses and/or sym-
       bols may optionally be taken from a file,  which  will  be
       read  as  if  it  contained  whitespace-separated  numeric
       and/or symbolic address arguments.  Quoting may  still  be
       necessary for symbols which contain spaces.  If no address
       or symbol arguments are given on the  command  line,  atos
       enters  an  interactive  mode, in which it takes addresses
       from stdin as if it were reading them from a file.



Apple Computer, Inc.      June 19, 1998                   ATOS(1)