man(1) Manual page archive


     KSYM(3)                                                   KSYM(3)

     NAME
          ksym - kernel symbols

     SYNOPSIS
          bind -a '#N' /dev

          /dev/ksym

     DESCRIPTION
          Ksym is intended to aid native kernel and emu(1) monitoring
          and debugging.  It maps kernel addresses to symbolic names
          obtained from the symbol table of a kernel executable.  It
          also arranges that the format `%N' if used by the kernel
          print(10.2) will produce a symbolic address instead of a
          hexadecimal number when a known address is printed.

          Ksym serves a directory containing a single file, ksym.

          A write to the file must provide UTF-encoded lines contain-
          ing commands or map entries, each line ended by a newline
          character.  A line may be split across two writes to allow a
          symbol file to be copied into the device by cat(1) or cp(1).
          There are two commands:

          clear
               Empty the current map. The map is also emptied by each
               write to file offset 0.

          kernel
               Make entries for `_kzero' and `etext', representing the
               start and end of the kernel text segment.

          Each map entry has the form:

               address name

          where address is an 8 digit unsigned hexadecimal number and
          name is a UTF encoded string giving the symbolic name to be
          associated with that address in the current map.

          The file may be read to see the contents of the current map.
          Each read returns as many lines of the following form as
          will fit in the caller's buffer:

               address name

          where address and name are as defined above for a write
          request.

     SOURCE

     KSYM(3)                                                   KSYM(3)

          /emu/devksym.c
          /os/port/devksym.c

     SEE ALSO
          kprof(3), acid(10.1), nm(10.1)